install:dokuwiki_on_a_stick
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revision | Next revisionBoth sides next revision | ||
install:dokuwiki_on_a_stick [2017-03-22 03:26] – added requirements section 45.72.147.100 | install:dokuwiki_on_a_stick [2017-03-24 13:39] – [Tips] 213.219.188.215 | ||
---|---|---|---|
Line 31: | Line 31: | ||
* [[http:// | * [[http:// | ||
+ | |||
+ | ==== Creating a Dokuwiki USB stick for Ubuntu and Windows execution ==== | ||
+ | |||
+ | If you also want the usb stick to run under 64bit Ubuntu then you will need to create an extra partition on your usb stick. Its probably best to do this prior to installing the windows solution but if you already did this then you can copy the files to a temporary location, re-format your usb stick and then copy them back. You may also use something like GParted which allows you to resize your existing partition. | ||
+ | |||
+ | These are the partitions | ||
+ | * A FAT32 partition to hold the wiki. Name this " | ||
+ | * An ext3 partition of around 240mb. Name this " | ||
+ | * Install the windows Dokuwiki on the fat32 partition named WIKI. Follow the instructions above to achieve this. | ||
+ | |||
+ | ==== Linux Execution. To be installed on the linuxWiki partition ==== | ||
+ | |||
+ | === HTTP Interpretor === | ||
+ | To execute the wiki you need a small server that can interpret http format. The chosen server needs to execute from the stick. One that works out of the box is Mongoose https:// | ||
+ | The download page is https:// | ||
+ | The binary file **mongoose-lua-sqlite-ssl-static-x86_64-5.1** is required. It will process the http requests on localhost: | ||
+ | The suffix php will then require a PHP interpretor. | ||
+ | |||
+ | ==== PHP Interpretor === | ||
+ | The version I downloaded was 5.5.38. http:// | ||
+ | The newer version (7.1.3) also works fine but seemed slower. | ||
+ | |||
+ | unzip the download to obtain dir php-5.5.38 | ||
+ | |||
+ | To build into a directory php | ||
+ | < | ||
+ | cd php-5.5.38/ | ||
+ | ./ | ||
+ | make | ||
+ | make install | ||
+ | </ | ||
+ | |||
+ | Once built we only need the one executable file located at **$HOME/ | ||
+ | |||
+ | ==== Layout of files in partition linuxWiki ==== | ||
+ | |||
+ | < | ||
+ | / | ||
+ | . | ||
+ | ├── linuxStart.sh | ||
+ | ├── server | ||
+ | │ | ||
+ | │ | ||
+ | │ | ||
+ | │ | ||
+ | └── startWiki.desktop | ||
+ | </ | ||
+ | |||
+ | === File startWiki.desktop === | ||
+ | This is a .desktop file that allows execution of the shell script file linuxStart.sh from the Nautilus file browser. | ||
+ | |||
+ | The content of the file is | ||
+ | < | ||
+ | [Desktop Entry] | ||
+ | Type=Application | ||
+ | Terminal=true | ||
+ | Name=Start Dokuwiki | ||
+ | Icon=utilities-terminal | ||
+ | Exec=bash -c 'cd " | ||
+ | Categories=Application; | ||
+ | </ | ||
+ | Once created set its permissions to allow execute | ||
+ | chmod +x startWiki.desktop | ||
+ | |||
+ | === File linuxStart.sh === | ||
+ | |||
+ | This also needs its execution bit set and can be started from command line of a terminal if you prefer not to use Nautilus. Its content is | ||
+ | |||
+ | < | ||
+ | #!/bin/bash | ||
+ | |||
+ | cd server | ||
+ | echo "Open a browser to address 127.0.0.1: | ||
+ | echo "Leave this terminal window running until you no longer need the http server to access the wiki" | ||
+ | echo "close the terminal when finished so that you can unmount the usb stick" | ||
+ | ./ | ||
+ | </ | ||
+ | |||
+ | This will start the mongoose http server. This server needs a configuration file. | ||
+ | |||
+ | === File server/ | ||
+ | |||
+ | This configuration file directs mongoose to use the php-cgi program to interpret http links to files of type *.php. It also sets the document_root to directory dokuWiki which we see in the moment is a symbolic link to the dokuWiki directory on the fat32 partition and the defult run file becomes index.php which calls doku.php to start the wiki engine. | ||
+ | |||
+ | < | ||
+ | cgi_interpreter ./php-cgi | ||
+ | enable_directory_listing no | ||
+ | document_root dokuwiki | ||
+ | </ | ||
+ | |||
+ | The other command setting directory listings off is a security measure to stop the display of a directory list for any paths which don't contain an index.php or index.html file. See https:// | ||
+ | |||
+ | === Dir server/ | ||
+ | This links back to the fat32 partition where the dokuwiki installation resides. Create it via command | ||
+ | ln -s ../ | ||
+ | | ||
+ | === The http and php server files === | ||
+ | These were created in the first two steps. Copy both mentioned files to the server directory and set the execution bit on both files. | ||
+ | |||
+ | ==== Current Issues ==== | ||
+ | If you use ' | ||
+ | |||
===== Old Releases ===== | ===== Old Releases ===== |
install/dokuwiki_on_a_stick.txt · Last modified: 2023-07-29 15:53 by michaelsy