source: documentation/trunk/wiki/dokuwiki-readme.txt@ 30312

Last change on this file since 30312 was 30134, checked in by jmt12, 9 years ago

Rescued from the second copy of dokuwiki that is bound for binary heaven

File size: 2.2 KB
Line 
1Installation
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
Note: See TracBrowser for help on using the repository browser.