| 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 |
|
|---|
