| 1 | |
1 | |
| 2 | WeBWorK |
2 | WeBWorK |
| 3 | Online Homework Delivery System |
3 | Online Homework Delivery System |
| 4 | Version 2.0 |
4 | Version 2.0.1 |
| 5 | |
5 | |
| 6 | Copyright 2000-2004, The WeBWorK Project |
6 | Copyright 2000-2004, The WeBWorK Project |
| 7 | All rights reserved. |
7 | All rights reserved. |
| 8 | |
8 | |
| 9 | Introduction |
9 | Introduction |
| 10 | |
10 | |
| 11 | The [1]WeBWorKTeam is pleased to announce the final release of WeBWorK |
11 | This release fixes two bugs in WeBWorK 2.0. |
| 12 | 2.0. After two years of work, WeBWorK 2 is stable and ready for |
|
|
| 13 | general use. The WeBWorK 1.x series has been end-of-lifed, and we |
|
|
| 14 | recommend that all users upgrade to WeBWorK 2. |
|
|
| 15 | |
12 | |
| 16 | This release includes almost all of the functionality of WeBWorK 1.9, |
13 | 1. When course databases were upgraded, sets, but not problems, were |
| 17 | and contains new functionality beyond what it possible with 1.9. New |
14 | assigned to the global user. This caused sets appear to be empty |
| 18 | feature since WeBWorK 1.9 include: |
15 | when it was assigned to a user after the upgrade. Bugzilla bugs |
| 19 | |
16 | [1]#611 and [2]#614 are related to this issue. |
| 20 | * An improved database system. |
17 | 2. The date calculation routines before() and after(), used to |
| 21 | + Problem sets can be manipulated in the abstract without being |
18 | compare the current time to the set dates, were not inclusive. |
| 22 | assigned to students. |
|
|
| 23 | + Sets can be easily assigned and unassigned |
|
|
| 24 | + Problem set defaults are stored once, making it easy to |
|
|
| 25 | change defaults without distubing values overridden for |
|
|
| 26 | particular students. |
|
|
| 27 | + Support for both WeBWorK 1.x databases and SQL databases. |
|
|
| 28 | * A more consistent and easier to use user interface. |
|
|
| 29 | + Breadcrumbs show your current location in the system relative |
|
|
| 30 | to the root. |
|
|
| 31 | + Login message indicates who you are logged in as and who you |
|
|
| 32 | are acting as. |
|
|
| 33 | + Links bar allows quick access to many featuers of the system. |
|
|
| 34 | + Siblings list allows one-click access to other problems in |
|
|
| 35 | the same set or other sets in the same course. |
|
|
| 36 | * Look of pages is fully-customizeable look due to HTML template |
|
|
| 37 | system and CSS support. |
|
|
| 38 | * Global Act As feature allowing instructors to view the system from |
|
|
| 39 | the point of view of a student. |
|
|
| 40 | * Web-based course administration tools. |
|
|
| 41 | + Create and delete courses. |
|
|
| 42 | + Export course databases to standard XML format, import |
|
|
| 43 | exported databases. |
|
|
| 44 | * Architectural improvements make it easy to add features to the |
|
|
| 45 | system. |
|
|
| 46 | + Object-based content generation system enables addition of |
|
|
| 47 | new components easy. |
|
|
| 48 | + Table-driven virtual heirarchy of system components allows |
|
|
| 49 | for customization of system URLs. |
|
|
| 50 | + Modular database layer enables support for additional |
|
|
| 51 | database backends. |
|
|
| 52 | |
|
|
| 53 | New features since [2]PreviewRelease4 include: |
|
|
| 54 | |
|
|
| 55 | * New display modes: [3]jsMath and [4]ASCIIMathML (DavideCervone). |
|
|
| 56 | * Support for problem library metadata database (JohnJones). |
|
|
| 57 | * Improved Statistics and Student Progress functionality. |
|
|
| 58 | * Improved Apache configuration and CourseEnvironment seeding. |
|
|
| 59 | * Lockdown of authorization system. |
|
|
| 60 | * Behavior of interactive problem processor customizable. |
|
|
| 61 | * Published flag for problem sets. |
|
|
| 62 | * Hmwk Set Editor updated to match UI of Classlist Editor. |
|
|
| 63 | * User interface improvements. |
|
|
| 64 | * Set Maker improvements (JohnJones). |
|
|
| 65 | * dvipng baseline support for equation images (JohnJones). |
|
|
| 66 | * Automatic upgrading of databases from WeBWorK 1.x courses. |
|
|
| 67 | * Improved sorting of problem sets (WilliamWheeler). |
|
|
| 68 | * Enable upload/download/delete problem files. |
|
|
| 69 | |
|
|
| 70 | (Contributiors: please feel free to add anything I've forgotten.) |
|
|
| 71 | |
19 | |
| 72 | Availability |
20 | Availability |
| 73 | |
21 | |
| 74 | The complete system is distributed as two tarballs. One for the |
22 | WeBWorK 2.0.1 is available our CVS repository. Read |
| 75 | WeBWorK system itself, and one for the PG system, including a standard |
23 | [3]WeBWorKCVSReadOnly for more information. |
| 76 | set of PG modules and macro files. |
|
|
| 77 | |
24 | |
| 78 | Files are available below and on our SourceForge project page: |
25 | WeBWorK 2.0.1 is also available in tarball form from our SourceForge |
|
|
26 | project page: |
| 79 | [5]http://sourceforge.net/project/showfiles.php?group_id=93112 |
27 | [4]http://sourceforge.net/project/showfiles.php?group_id=93112 |
| 80 | |
|
|
| 81 | Installation directly from CVS is also possible. Refer to the |
|
|
| 82 | [6]InstallationManual for more information. |
|
|
| 83 | |
28 | |
| 84 | Installation |
29 | Installation |
| 85 | |
30 | |
| 86 | Documentation on installing and configuring WeBWorK is available in |
31 | Read the section in the section in the installation manual on |
| 87 | the [7]InstallationManual. Instructions on [8]CourseCreation and |
32 | [5]Upgrading WeBWorK. |
| 88 | [9]CourseUpgrade are also available. |
|
|
| 89 | |
33 | |
| 90 | Upgrading SQL course databases |
34 | Fixing courses upgraded with WeBWorK 2.0 |
| 91 | |
35 | |
| 92 | The structure of SQL databases changed slightly with this release. As |
36 | To fix corruption of courses upgraded with WeBWorK 2.0: |
| 93 | a result, you must modify any SQL course databases that were created |
|
|
| 94 | with an earlier version of WeBWorK 2. Specifically, you must change |
|
|
| 95 | the name of the problem_header field to hardcopy_header. If you are |
|
|
| 96 | using MySQL, you can use the following tiny script: |
|
|
| 97 | echo "ALTER TABLE set_not_a_keyword CHANGE COLUMN problem_header hardcopy_heade |
|
|
| 98 | r TEXT;" \ |
|
|
| 99 | "ALTER TABLE set_user CHANGE COLUMN problem_header hardcopy_header TEXT;" | |
|
|
| 100 | mysql -u root -p webwork_CourseID |
|
|
| 101 | |
37 | |
| 102 | Replace CourseID with the name of the course you want to modify. |
38 | 1. Log into the course with WeBWorK 1.9 and delete the global user |
|
|
39 | (usually called global_user). |
|
|
40 | 2. Log into the course with WeBWorK 2.0.1. You will be prompted to |
|
|
41 | upgrade the database. Do so. |
|
|
42 | 3. If you had assigned sets to any users with WeBWorK 2.0, unassign |
|
|
43 | and reassign the sets to each user. |
| 103 | |
44 | |
| 104 | Help |
45 | Help |
| 105 | |
46 | |
| 106 | If you need help installing or using WeBWorK 2.0, visit the |
47 | If you need help installing or using WeBWorK 2.0, visit the [6]WeBWorK |
| 107 | [10]WeBWorK discussion group and post your question there. The |
48 | discussion group and post your question there. The developers monitor |
| 108 | developers monitor this forum. |
49 | this forum. |
| 109 | |
50 | |
| 110 | Bug Reports & Feature Requests |
51 | Bug Reports & Feature Requests |
| 111 | |
52 | |
| 112 | Submit bug reports and feature requests at |
53 | Submit bug reports and feature requests at |
| 113 | [11]http://bugs.webwork.rochester.edu/. We can't fix bugs and add |
54 | [7]http://bugs.webwork.rochester.edu/. We can't fix bugs and add |
| 114 | features if you don't tell us about them! |
55 | features if you don't tell us about them! |
| 115 | |
56 | |
| 116 | Patches |
57 | Patches |
| 117 | |
58 | |
| 118 | While we welcome patches of any sort, by patching against the latest |
59 | While we welcome patches of any sort, by patching against the latest |
| 119 | CVS code, you save us and yourself time. A bug in this release may be |
60 | CVS code, you save us and yourself time. A bug in this release may be |
| 120 | fixed in CVS, and we can more easily handle patches against the latest |
61 | fixed in CVS, and we can more easily handle patches against the latest |
| 121 | code. Check out the latest development version from CVS and patch |
62 | code. Check out the latest development version from CVS and patch |
| 122 | against that. Consult the [12]WeBWorKCVS topic for more information. |
63 | against that. Consult the [8]WeBWorKCVS topic for more information. |
| 123 | |
64 | |
| 124 | References |
65 | References |
| 125 | |
66 | |
| 126 | 1. http://devel.webwork.rochester.edu/twiki/bin/view/Webwork/WeBWorKTeam |
67 | 1. http://bugs.webwork.rochester.edu/show_bug.cgi?id=611 |
| 127 | 2. http://devel.webwork.rochester.edu/twiki/bin/view/Webwork/PreviewRelease4 |
68 | 2. http://bugs.webwork.rochester.edu/show_bug.cgi?id=614 |
| 128 | 3. http://www.math.union.edu/~dpvc/jsMath/ |
69 | 3. file://localhost/twiki/bin/view/Webwork/WeBWorKCVSReadOnly |
| 129 | 4. http://www1.chapman.edu/~jipsen/asciimath.html |
|
|
| 130 | 5. http://sourceforge.net/project/showfiles.php?group_id=93112 |
70 | 4. http://sourceforge.net/project/showfiles.php?group_id=93112 |
| 131 | 6. http://devel.webwork.rochester.edu/twiki/bin/view/Webwork/InstallationManual |
71 | 5. file://localhost/twiki/bin/view/Webwork/InstallationManual#Upgrading_WeBWorK |
| 132 | 7. http://devel.webwork.rochester.edu/twiki/bin/view/Webwork/InstallationManual |
|
|
| 133 | 8. http://devel.webwork.rochester.edu/twiki/bin/view/Webwork/CourseCreation |
|
|
| 134 | 9. http://devel.webwork.rochester.edu/twiki/bin/view/Webwork/CourseUpgrade |
|
|
| 135 | 10. http://webhost.math.rochester.edu/webworkdocs/discuss/ |
72 | 6. http://webhost.math.rochester.edu/webworkdocs/discuss/ |
| 136 | 11. http://bugs.webwork.rochester.edu/ |
73 | 7. http://bugs.webwork.rochester.edu/ |
| 137 | 12. http://devel.webwork.rochester.edu/twiki/bin/view/Webwork/WeBWorKCVS |
74 | 8. file://localhost/twiki/bin/view/Webwork/WeBWorKCVS |