Wikipublisher

 Installing Wikipublisher Addon

Download the addon to a tmp directory, and unpack it

cd /var/www/
sudo mkdir temp
sudo wget http://www.pmwiki.org/pmwiki/uploads/Cookbook/wikipublisher-2220.tar.gz
sudo tar -zxvf wikipublisher-2220.tar.gz

and we now need to move these into the correct directory. So, let's cd into the new directory we unpacked

cd wikipublisher-2220

and move the files across

sudo mv pub/skins/*   /var/www/pmwiki/pub/skins
sudo mv pub/css/*     /var/www/pmwiki/pub/css
sudo mv pub/images    /var/www/pmwiki/pub
sudo mv pub/latexrender /var/www/pmwiki/pub
sudo mv cookbook/*     /var/www/pmwiki/cookbook 

and set the sample config to our config, and edit the email settings, and the web settings in the new config

sudo cp sample-wp-config.php    /var/www/pmwiki/local/config.php
sudo nano /var/www/pmwiki/local/config.php

and we are now at the point where we can see a PDF icon on each page.  This submits the page to http://www.wikipublisher.org, and if we are registered on that site, returns a PDF to us.  If we want to generate our PDFs locally, we have more work to do.

First we get LaTeX

sudo apt-get install tetex-extra

sudo apt-get install perlmagick
sudo apt-get install  libxml2-utils
sudo apt-get install xsltproc

Now check that the required perl tools are installed by typing

perl -e 'use Image::Magick'
perl -e 'use LWP::Simple'

and there should be no output if they are installed correctly.

Download the wikipublisher server software, and move it to the www directory

cd /var/www/temp
sudo wget http://www.wikipublisher.org/wiki/uploads/Wikipublisher/wikibook-1.0.20.tar.gz
sudo wget http://www.wikipublisher.org/wiki/uploads/Wikipublisher/accesscontrol.tar.gz
sudo tar -xzvf wikibook-1.0.20.tar.gz
sudo tar -xzvf accesscontrol.tar.gz
sudo mv wikibook /var/www/wikibook
sudo mv accesscontrol/*.php /var/www/pmwiki/local/

Now move the perl script to cgi-bin

sudo mv /var/www/wikibook/mkpdf.pl   /usr/lib/cgi-bin/

Edit the mkpdf.pl 

 sudo nano /usr/lib/cgi-bin/mkpdf.pl

and change the two lines to

use lib '/var/www/wikibook';
require '/var/www/wikibook/mkpdf.inc';

From config-examples/ directory, copy the linux config to the wikibook directory

cd /var/www/wikibook/config-examples/
sudo cp mkpdf-linux.inc   ../mkpdf.inc

and edit it so that config (src => "/var/www/wikibook");

and pdflatex, xsltproc, xmllint all point to /usr/bin/pdflatex, /usr/bin/xsltproc/ and /usr/bin/xmllint

Edit the config(url => 'http://webservername/pmwiki/pmwiki.php?'); 

Now, with a browser, access your wiki at http://www.webservername/pmwiki/pmwiki.php and create a page named AccessControl.ApprovedWikiUrls and add a single value for the address of your wiki like this page http://www.wikipublisher.org/wiki/AccessControl/ApprovedWikiUrls.  The perl script examines this page to look at the list of allowed URLs that can create PDFs.

Also now create a page AccessControl.SplashScreen which is used to hold a screen that displays while pdflatex is creating the PDF. It can look like this

=|{$WBVersion} is composing pdf; please wait.

=|(:random:)

%center%%width=25pct%Attach:A_logo1.jpg | Copyright (c) 2005-{$Year} Affinity Limited.

(:noheader:)(:nofooter:)(:notitle:)(:noleft:)

You should be now able to create a PDF, or be pretty close to it!

Backup

We are going to use dropbox to save our entire website!

cd
wget http://www.dropbox.com/download?dl=packages/nautilus-dropbox_0.6.2_i386.deb

and for text based installation, see

http://wiki.dropbox.com/TipsAndTricks/TextBasedLinuxInstall

You might have to install the inotify-tools

sudo apt-get install inotify-tools

Once it is working, you'll find a Dropbox directory appear in your home directory ( note the capital D )

You want to link the pmwiki directory to that so it will back it all up for you

cd
cd Dropbox
ln -s /var/www/pmwiki pmwiki

and in your dropbox web view you should see that you've added this to your list of files