ikiwiki bliki for a local (mobile) computer
Now, that we finished setting up [one] ikiwiki for multiple machines, let’s head for setting up the user interface. That is: head for getting the web frontend running. Note: As this here posting is somewhat lengthy, I put off setting up the actual web frontend to the next post.
For this here posting, we work on the local machine, i.e. the mobile computer.
First, as we already have set up ikiwiki’s core config file, we skip redoing that and instead just copy it from our remote machine to our local one, i.e. the mobile computer:
$ scp dagobart@remote-machine.com:/home/dagobart/.ikiwiki/ikiwiki.setup ~/.iki-test/ dagobart@remote-machine.com's password: ikiwiki.setup 100% 6836 6.7KB/s 00:00
SCP is the secure copy program. Probably yet installed on your machines if you use SSH (Secure Shell).
Now, let’s make sure we have a place where to put the ikiwiki script that’s going to get called whenever we’re changing the bliki by means of the web frontend:
$ mkdir -p ~/public_html/cgi-bin
…and then, go to the local ikiwiki directory and modify the ikiwiki.setup file so it’s going to meet our needs. — As before, I don’t direct you through the file to the things you need to update but rather just show the final diff between the untouched system original ikiwiki.setup file and the one we change:
$ cd ~/.iki-test/ $ emacs -nw ikiwiki.setup $ diff ikiwiki.setup /usr/share/doc/ikiwiki/html/ikiwiki.setup 14,15c14,15 < srcdir => "/home/dagobart/.iki-test/bliki/s", < destdir => "/home/dagobart/public_html/bliki", --- > srcdir => "/path/to/source", > destdir => "/var/www/wiki", 17,18c17,18 < url => "http://localhost/~dagobart/bliki", < cgiurl => "http://localhost/~dagobart/bliki/ikiwiki.cgi", --- > url => "http://example.org/wiki", > cgiurl => "http://example.org/wiki/ikiwiki.cgi",
You don’t necessarily need the -nw params for emacs — it’s just to keep emacs in the terminal window rather than allowing it to ‘pop out’ and spawn its own frame. Alternatively, you for sure can use your own preferred editor. If you need a simple one, try joe or nano, whereby in my opinion the latter one is too simple (so it becomes complicated again).
Then, we make ikiwiki aware of its changed setup file and examine the changes ikiwiki causes:
$ ikiwiki -setup ikiwiki.setup $ ls -al insgesamt 36 drwxr-xr-x 4 dagobart dagobart 4096 21. Mär 18:39 . drwxr-xr-x 84 dagobart dagobart 4096 21. Mär 18:44 .. drwxrwsr-x 9 dagobart dagobart 4096 21. Mär 17:45 bliki drwxr-xr-x 8 dagobart dagobart 4096 21. Mär 18:08 .git -rw-r--r-- 1 dagobart dagobart 25 21. Mär 17:42 .gitignore -rw-r--r-- 1 dagobart dagobart 6833 21. Mär 18:39 ikiwiki.setup -rw-r--r-- 1 dagobart dagobart 6836 21. Mär 18:34 ikiwiki.setup~ $ ls -al bliki/ insgesamt 48 drwxrwsr-x 9 dagobart dagobart 4096 21. Mär 17:45 . drwxr-xr-x 4 dagobart dagobart 4096 21. Mär 18:39 .. drwxrwsr-x 2 dagobart dagobart 4096 21. Mär 17:45 branches -rw-rw-r-- 1 dagobart dagobart 126 21. Mär 17:45 config drwxr-xr-x 2 dagobart dagobart 4096 21. Mär 17:45 d -rw-rw-r-- 1 dagobart dagobart 58 21. Mär 17:45 description -rw-rw-r-- 1 dagobart dagobart 23 21. Mär 17:45 HEAD drwxrwsr-x 2 dagobart dagobart 4096 21. Mär 17:45 hooks drwxrwsr-x 2 dagobart dagobart 4096 21. Mär 17:45 info drwxrwsr-x 7 dagobart dagobart 4096 21. Mär 17:45 objects drwxrwsr-x 4 dagobart dagobart 4096 21. Mär 17:45 refs drwxr-xr-x 4 dagobart dagobart 4096 21. Mär 18:47 s $ ls -al bliki/s/ insgesamt 20 drwxr-xr-x 4 dagobart dagobart 4096 21. Mär 18:47 . drwxrwsr-x 9 dagobart dagobart 4096 21. Mär 17:45 .. drwxr-xr-x 8 dagobart dagobart 4096 21. Mär 17:45 .git -rw-r--r-- 1 dagobart dagobart 25 21. Mär 17:45 .gitignore drwxr-xr-x 2 dagobart dagobart 4096 21. Mär 18:47 .ikiwiki $ ls -al /home/dagobart/public_html/ insgesamt 12 drwxr-xr-x 3 dagobart dagobart 4096 21. Mär 18:38 . drwxr-xr-x 84 dagobart dagobart 4096 21. Mär 18:44 .. drwxr-xr-x 17 dagobart dagobart 4096 21. Mär 18:47 bliki $ ls -al /home/dagobart/public_html/bliki/ insgesamt 88 drwxr-xr-x 17 dagobart dagobart 4096 21. Mär 18:47 . drwxr-xr-x 3 dagobart dagobart 4096 21. Mär 18:38 .. drwxr-xr-x 2 dagobart dagobart 4096 21. Mär 18:47 blog drwxr-xr-x 2 dagobart dagobart 4096 21. Mär 18:38 cgi-bin -rw-r--r-- 1 dagobart dagobart 371 21. Mär 18:47 favicon.ico drwxr-xr-x 2 dagobart dagobart 4096 21. Mär 18:47 helponformatting drwxr-xr-x 11 dagobart dagobart 4096 21. Mär 18:47 ikiwiki -rw-r--r-- 1 dagobart dagobart 1462 21. Mär 18:47 index.html -rw-r--r-- 1 dagobart dagobart 95 21. Mär 18:47 local.css drwxr-xr-x 2 dagobart dagobart 4096 21. Mär 18:47 markdown drwxr-xr-x 2 dagobart dagobart 4096 21. Mär 18:47 openid drwxr-xr-x 2 dagobart dagobart 4096 21. Mär 18:47 pagespec drwxr-xr-x 2 dagobart dagobart 4096 21. Mär 18:47 preprocessordirective drwxr-xr-x 2 dagobart dagobart 4096 21. Mär 18:47 recentchanges drwxr-xr-x 2 dagobart dagobart 4096 21. Mär 18:47 sandbox drwxr-xr-x 2 dagobart dagobart 4096 21. Mär 18:47 shortcuts -rw-r--r-- 1 dagobart dagobart 5164 21. Mär 18:47 style.css drwxr-xr-x 2 dagobart dagobart 4096 21. Mär 18:47 subpage drwxr-xr-x 4 dagobart dagobart 4096 21. Mär 18:47 templates drwxr-xr-x 2 dagobart dagobart 4096 21. Mär 18:47 wikiicons drwxr-xr-x 2 dagobart dagobart 4096 21. Mär 18:47 wikilink
In one word: This just set up our local bliki.
Next: Let’s actually make the ikiwiki web frontend run.
