| 1 | readme.first file for WeBWorK version 1.7 |
1 | readme.first file for WeBWorK version 1.8 |
| 2 | |
2 | |
| 3 | ********************************************************************** |
|
|
| 4 | ### WeBWorK Version 1.7.01 October-16-2001 ### |
|
|
| 5 | ********************************************************************** |
|
|
| 6 | |
3 | |
| 7 | First you should connect to our server (http://webwork.math.rochester.edu) and |
4 | First you should connect to our server (http://webwork.math.rochester.edu) and |
| 8 | play around (as a practice user) in some actual or past WeBWorK courses. Most |
5 | play around (as a practice user) in some actual or past WeBWorK courses. Most |
| 9 | courses allow you to login as 'practice1' with password 'practice1'. |
6 | courses allow you to login as 'practice1' with password 'practice1'. |
| 10 | |
7 | |
| 11 | There is also a lot on line documentation which you can peruse. |
8 | There is also a lot on line documentation which you can peruse. |
| 12 | |
9 | |
| 13 | Assuming you like what you see (or have already done this), read on. |
10 | Assuming you like what you see (or have already done this), read on. |
| 14 | |
11 | |
| 15 | The basic requirements for setting up WeBWorK is a unix system running a |
12 | The basic requirements for setting up WeBWorK is a unix system running the |
| 16 | webserver, perl, TeX, and latex2html. Probably your system already has all these |
13 | apache webserver, perl, and LaTeX. Probably your system already has all these |
| 17 | (except possibly latex2html). You will need a system administrator to do some of |
14 | installed. In addition for the readable display of mathematical expressions you |
|
|
15 | will need tth, latex2html, and dvipng. You can make do with a subset of these, |
|
|
16 | but we recommend you install all of them. You will need a system administrator |
| 18 | the set up and it would be a good idea for him or her to be involved from the |
17 | to do some of the set up and it would be a good idea for him or her to be |
| 19 | beginning. Our system admin is Hoss Firooznia (hfir@math.rochester.edu) and he |
18 | involved from the beginning. Our system admin is Hoss Firooznia |
| 20 | would certainly be willing to answer questions. Similarly, Mike Gage |
19 | (hfir@math.rochester.edu) and he would certainly be willing to answer questions. |
| 21 | (gage@math.rochester.edu) or Arnie Pizer (apizer@math.rochester.edu) are willing |
20 | Similarly, Mike Gage (gage@math.rochester.edu) or Arnie Pizer |
| 22 | to help. We hope to port WeBWorK to win nt in the future, but we are not there |
21 | (apizer@math.rochester.edu) are willing to help. |
| 23 | yet. |
|
|
| 24 | |
22 | |
| 25 | Here is some information on installing WeBWorK. If you have any questions or |
23 | Here is some information on installing WeBWorK. If you have any questions or |
| 26 | problems, please email us. |
24 | problems, please email us. |
| 27 | |
25 | |
| 28 | |
26 | |
| … | |
… | |
| 30 | |
28 | |
| 31 | Mike Gage and Arnie Pizer |
29 | Mike Gage and Arnie Pizer |
| 32 | ****************************************************************** |
30 | ****************************************************************** |
| 33 | |
31 | |
| 34 | |
32 | |
| 35 | 1. Download the following files using a web browser (ftp access is not allowed). |
33 | 1. Download the following files using a web browser (ftp access is not allowed). |
| 36 | Connect to http://webhost.math.rochester.edu/webworkdocs/ and then click on |
34 | Connect to http://webhost.math.rochester.edu/webworkdocs/ and then click on |
| 37 | Download WeBWorK and follow the instructions. You will have to register to |
35 | Download WeBWorK and follow the instructions. You will have to register to |
| 38 | download files. If you have difficulty registering, contact Gage |
36 | download files. If you have difficulty registering, contact Gage |
| 39 | (gage@math.rochester.edu) or Pizer (gage@math.rochester.edu). |
37 | (gage@math.rochester.edu) or Pizer (gage@math.rochester.edu). |
| 40 | |
38 | |
| 41 | webwork_VERSION_SUBVERSION-MONTH-DAY-YEAR.tar.gz |
39 | webwork_VERSION_SUBVERSION-MONTH-DAY-YEAR.tar.gz |
| 42 | templates_VERSION_SUBVERSION-MONTH-DAY-YEAR.tar.gz |
40 | templates_VERSION_SUBVERSION-MONTH-DAY-YEAR.tar.gz |
| 43 | |
41 | |
| … | |
… | |
| 46 | readme.first |
44 | readme.first |
| 47 | readme.install |
45 | readme.install |
| 48 | readme.upgrade |
46 | readme.upgrade |
| 49 | overview.html |
47 | overview.html |
| 50 | linux.html (really instructions for setting up WeBWorK on any unix system) |
48 | linux.html (really instructions for setting up WeBWorK on any unix system) |
| 51 | linux-redhat-7.1.html (instructions for setting up RedHat 7.1 as a WeBWorK server) |
49 | linux-redhat-8.0.html (instructions for setting up RedHat 8.0 as a WeBWorK server) |
| 52 | |
50 | |
| 53 | These six files are contained in webwork_X.X_XX-MONTH-XX-XXXX.tar.gz but you |
51 | These six files are contained in webwork_X.X_XX-MONTH-XX-XXXX.tar.gz but you |
| 54 | should look at |
52 | should look at |
| 55 | overview.html and |
53 | overview.html and |
| 56 | readme.install |
54 | readme.install |
| 57 | for information on where to install the files. |
55 | for information on where to install the files. |
| 58 | |
56 | |
| 59 | |
57 | |
| 60 | 2. If you are setting WeBWorK up for the first time, read the readme.install |
58 | 2. If you are setting WeBWorK up for the first time, read the readme.install |
| 61 | file. If you have already installed a previous version of WeBWorK, read both the |
59 | file. If you have already installed a previous version of WeBWorK, read both the |
| 62 | readme.install and readme.upgrade files. Even if you are not using RedHat, we |
60 | readme.install and readme.upgrade files. Even if you are not using RedHat, we |
| 63 | recommend that you read linux-redhat-7.1.html as this contained useful |
61 | recommend that you read linux-redhat-8.0.html as this contained useful |
| 64 | information. |
62 | information. |
| 65 | |
63 | |
| 66 | |
64 | |
| 67 | 3. Version 1.7 of WeBWorK contains several enhancements and bug fixes. Many |
65 | 3. Version 1.8 of WeBWorK contains several enhancements and bug fixes. Many |
| 68 | enhancements are internal (e.g. to the classlist and webwork databases and to |
66 | enhancements are internal and will not be apparent to students. The most |
| 69 | the answer evaluator macros) and will not be apparent to students. The setup |
67 | apparent change is the addition of a new display mode ("typeset2") which uses |
| 70 | procedure has also changed as have the the locations of some files (e.g. |
68 | dvipng to create png images of equations. The output is identical to the output |
| 71 | Global.pm). See Overview of WeBWorK system setup (overview.html) for details. |
69 | from LaTeX2HTML ("typeset") but it is almost as fast as tth. Thus precreation |
| 72 | Bugs related to Hints have been fixed and also "sticky answers" behave |
70 | is not required. We would like to express our sincere thanks to John Jones for |
| 73 | differently. |
71 | providing the code the added the typeset2 mode. |
| 74 | |
72 | |
| 75 | Courses running under WeBWorK 1.6 should run without change under WeBWorK 1.7. |
73 | Courses running under WeBWorK 1.5 or later should run without change under |
|
|
74 | WeBWorK 1.8. |
| 76 | |
75 | |
| 77 | |
76 | |
| 78 | 4. The templates_X.X_XX-MONTH-XX-XXXX.tar.gz file contains a library |
77 | 4. The templates_X.X_XX-MONTH-XX-XXXX.tar.gz file contains a library |
| 79 | approximately 2000 WeBWorK problems covering pre-calculus, first year calculus, |
78 | approximately 2500 WeBWorK problems covering pre-calculus, first year calculus, |
| 80 | vector calculus, differential equations, probability, and statistics. Note that |
79 | vector calculus, differential equations, probability, and statistics. Note that |
| 81 | some problems form older distributions have been renamed and/or moved to other |
80 | some problems form older distributions have been renamed and/or moved to other |
| 82 | locations in the library. We have incorporated over 100 problems contributed by |
81 | locations in the library. The current version of all problems (and WeBWorK |
| 83 | Prof. Fiedorowicz of Ohio State University. Professors Wheeler and Ziemer of |
|
|
| 84 | Indiana University have contributed prblems with solutions (these include both |
|
|
| 85 | new problems and old problems). The Indiana problems are not in the current tar |
|
|
| 86 | file. However, the current version of all problems (and WeBWorK system files if |
|
|
| 87 | you want to live on the bleeding edge) can be obtained by connecting to |
82 | system files if you want to live on the bleeding edge) can be obtained by |
| 88 | http://webhost.math.rochester.edu/webworkdocs/ , clicking on "Download WeBWorK" |
83 | connecting to http://webhost.math.rochester.edu/webworkdocs/ , clicking on |
| 89 | and then on "Experimental CVS for WeBWorK." The Indiana problems will be |
84 | "Software Download" and then on "Experimental CVS for WeBWorK." The Rochester |
| 90 | contained in a future tar filr release. |
85 | problem library is under the CVS Root Rochester and the system files are under |
|
|
86 | System. In addition at this site you can find problem libraries from Cal State |
|
|
87 | Long Beach (CSLB), Detroit County Day School (DCDS), Dartmouth, Indiana, Ohio |
|
|
88 | State, and Stony Brook. If you have written WeBWorK problems and are are |
|
|
89 | willing to share them, please contact us and we will add your problems to the |
|
|
90 | repository. |
|
|
91 | |
| 91 | |
92 | |
| 92 | |
93 | |
| 93 | 5. WeBWorK License |
94 | 5. WeBWorK License |
| 94 | |
95 | |
| 95 | Copyright (c) 1995-2001 University of Rochester |
96 | Copyright (c) 1995-2002 University of Rochester |
| 96 | All Rights Reserved |
97 | All Rights Reserved |
| 97 | |
98 | |
| 98 | |
99 | |
| 99 | Permission to use, copy, modify, and distribute this software and its |
100 | Permission to use, copy, modify, and distribute this software and its |
| 100 | documentation for educational, research and non-profit purposes, |
101 | documentation for educational, research and non-profit purposes, |