1 | Installation
|
---|
2 |
|
---|
3 | 1. Checkout the gsdl-docs package out of SVN
|
---|
4 |
|
---|
5 | 2. Go to <gsdl-docs>/lib/dokuwiki/ and untar the dokuwiki tarball (currently the stable version Ricewind)
|
---|
6 |
|
---|
7 | 3. Go back up to <gsdl-docs>/ and create a symlink to the folder you just unpacked called just dokuwiki:
|
---|
8 |
|
---|
9 | ln -s ./lib/dokuwiki/dokuwiki-<version> ./dokuwiki
|
---|
10 |
|
---|
11 | 4. Copy all of the archive files in <gsdl-docs>/lib/dokuwiki/plugins/ into <gsdl-docs>/dokuwiki/lib/plugins/, then unpack
|
---|
12 | * note you may need to rename the plugin foldersâyou'll find Dokuwiki will complain about incorrectly named folders at startup
|
---|
13 |
|
---|
14 | 5. Similarly, copy the monobook template archive from <gsdl-docs>/lib/dokuwiki/templates to <gsdl-docs>/dokuwiki/lib/tpl/ and unpack
|
---|
15 |
|
---|
16 | 6. Setup your webserver (as needed) so you can access this dokuwiki directory and run the PHP scripts therein
|
---|
17 |
|
---|
18 | 7. Visit the dokuwiki installer page in a web browser. For example, if you're webserver is running on localhost, at port 8080, and the path to <gsdl-docs>/ is /gsdl-docs, then visit:
|
---|
19 |
|
---|
20 | http://localhost:8080/gsdl-docs/dokuwiki/install.php
|
---|
21 |
|
---|
22 | 8. Follow the setup instructions, and then follow the recommended security settings for Dokuwiki, including renaming the install.php file
|
---|
23 |
|
---|
24 | 9. Overwrite the default configuration by copying the file <gsdl-docs>/lib/dokuwiki/conf/local.php to <gsdl-docs>/dokuwiki/conf/ overwriting the existing file
|
---|
25 |
|
---|
26 | 10. Recursively copy the starting pages file into place, overwriting existing files if prompted
|
---|
27 |
|
---|
28 | cp -r <gsdl-docs>/lib/dokuwiki/pages/ <gsdl-docs>/dokuwiki/data/pages/
|
---|
29 |
|
---|
30 | * note there is a copy of these instructions in the starting files, located at development
|
---|
31 |
|
---|
32 | 11. Enter <gsdl-docs>/lib/php/
|
---|
33 |
|
---|
34 | 12. Run each of these commands in order to transform the manual's XML files into Dokuwiki pages:
|
---|
35 |
|
---|
36 | php gs-manuals-import.php -m user
|
---|
37 | php gs-manuals-import.php -m install
|
---|
38 | php gs-manuals-import.php -m develop
|
---|
39 | php gs-manuals-import.php -m paper
|
---|
40 |
|
---|
41 | * note these require a command line version of PHP to be available on the path
|
---|
42 |
|
---|
43 | 13. Enter the wiki again, log in using the administrator account you created when installing, and then visit each manual wiki page, 'edit' it and click approve
|
---|
44 |
|
---|