install:dokuwiki_on_a_stick
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision | ||
install:dokuwiki_on_a_stick [2017-03-24 13:39] – [Tips] 213.219.188.215 | install:dokuwiki_on_a_stick [2023-04-05 14:48] – [DokuWiki on a Stick] Of course also on a hard disk michaelsy | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== DokuWiki on a Stick ====== | ====== DokuWiki on a Stick ====== | ||
- | DokuWiki on a Stick is a [[wiki: | + | DokuWiki on a Stick is the portable version of [[wiki: |
===== Requirements ===== | ===== Requirements ===== | ||
- | Microsoft Visual Studio runtime libraries. | + | * The current (July 2022) latest stable version (incl. Apache 2.4.46 & PHP 7.4.12) requires Windows 7 or higher.((Earlier versions are available, see "Old Releases" |
+ | * Microsoft Visual Studio runtime libraries. | ||
===== Download ===== | ===== Download ===== | ||
Line 28: | Line 29: | ||
An even easier method is to install the [[plugin: | An even easier method is to install the [[plugin: | ||
- | ===== Tips ===== | + | ===== Tips and Technical Background |
* [[http:// | * [[http:// | ||
- | + | * [[dokuwiki_on_a_stick_Linux|Dokuwiki on a stick for windows | |
- | ==== Creating a Dokuwiki | + | * [[https://forum.dokuwiki.org/post/63251|DokuWiki |
- | + | * [[https://forum.dokuwiki.org/d/20200-many-instances-of-dokuwiki-on-a-stick/8|More than one instance | |
- | If you also want the usb stick to run under 64bit Ubuntu then you will need to create an extra partition | + | * [[https://forum.dokuwiki.org/ |
- | + | ||
- | 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 | + | |
- | 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 | + | |
- | The suffix php will then require | + | |
- | + | ||
- | ==== 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 install | + | |
- | </ | + | |
- | + | ||
- | Once built we only need the one executable file located at **$HOME/php/bin/ | + | |
- | + | ||
- | ==== Layout of files in partition linuxWiki ==== | + | |
- | + | ||
- | < | + | |
- | / | + | |
- | . | + | |
- | ├── linuxStart.sh | + | |
- | ├── server | + | |
- | │ | + | |
- | │ | + | |
- | │ | + | |
- | │ | + | |
- | └── startWiki.desktop | + | |
- | </code> | + | |
- | + | ||
- | === File startWiki.desktop === | + | |
- | This is a .desktop file that allows execution | + | |
- | + | ||
- | The content of the file is | + | |
- | < | + | |
- | [Desktop Entry] | + | |
- | Type=Application | + | |
- | Terminal=true | + | |
- | Name=Start | + | |
- | Icon=utilities-terminal | + | |
- | Exec=bash | + | |
- | 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 | + | |
- | + | ||
- | < | + | |
- | # | + | |
- | + | ||
- | 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://www.dokuwiki.org/ | + | |
- | + | ||
- | === Dir server/dokuWiki === | + | |
- | 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