This page assumes a knowledge of the Unix command line and some experience with administering your Unix or Linux server. Please consult your server’s system administrator for advice and support. She or he will greatly prefer that you consult them before attempting to install any software.
To help those who come after you, please describe your Installation Experiences, ideally with constructive descriptions of any problems you encountered and how you solved them. Mac users may find the OS X page helpful.
On this page… (hide)
Installing the above will require system administrator rights on your server. You can test whether you have the required Perl modules by entering the following from the server’s command line — no output will be produced by these commands if the modules are installed:
perl -e 'use Image::Magick' perl -e 'use LWP::Simple'
If you’re installing the server on a Linux system, most (or all) of the above will have been prepackaged by your distribution; you should use your distribution’s administration tools to install them. Note that the perl interface to ImageMagick is often packaged seperately to ImageMagick itself. On an Intel Mac, installing ImageMagick and PerlMagick from source seems the most robust method.
These instructions assume you have access to the command line on your server. If you only have FTP access, you will need to carry out the installation on a server to which you do have command line access, and then FTP the result to the intended destination server. A 1.1.n designation means the version is stable and substantially complete.
src
setting to reference the installation directory.
pdflatex
, xsltproc
, xmllint
settings to point to where pdflatex, xsltproc and xmllint are installed. The Unix “which” command will tell you where an executable is; for example, “which xsltproc” will tell you the path to xsltproc.
url
setting to point to your local PmWiki install. If you’re using a URL scheme that doesn’t support ?n=pagename, you’ll need to change the check_url
and splash_url
settings, too.
I needed to launch : sudo texhash and all goes well
Sunday, 30 September 2001 Marc
Once I started to use SSL on our site, our wikipublisher failed saying “Access denied. Invalid response from access control at: {someurl}”. Even though {someurl} gave me a “1 Approved.” message. After some debugging, I determined the problem to be related to the perl LWP module not working well with https urls. To fix the problem I did the following on our Fedora installation:
> yum install perl-LWP-Protocol-https perl-Crypt-SSLeay
and in the mkpdf.pl file that I put in my cgi-bin folder, I added the following:
$ENV{HTTPS_CA_FILE} = "/etc/pki/tls/certs/ca-bundle.crt";
Your ca-bundle.crt file may be at a different location. The purpose of the ca-bundle.crt file is so that the SSL layer of LWP can verify certificates from SSL enabled websites. It contains root level certificates for the major certificate signing authorities (VeriSign, GeoTrust, Thawte, etc.).
Thursday, 16 January 2014 LogicalOctopus
For some releases, an update only requires updating the file wikibook/xml/tblatex.xsl. If available, you can download the current Attach:tblatex.xsl file with the latest changes (272kB). Drop the file into the wikibook/xml directory, replacing the currently-installed version.
The 1.1.x Wikibook server series at present requires a full update.
The format of the configuration file changed in version 0.9.3f. Where the old configuration file set everything through variables, for example
$url = ‘http://your.wiki/pmwiki2/pmwiki.php?’;
the new format adds a new use
line near the top of the file, and uses a new config
function:
use WikiPublisher::Configuration; … config(url => ‘http://your.wiki/pmwiki2/pmwiki.php?’);
The good news is that if your leave your configuration file unchanged, then it will work with the new version of the server software. If you want to add new settings, for example to use the image maximum size options, you do not have to reformat the entire file. Simply add the use
line immediately after the package
line in the configuration file, and use the new config( name => “value” )
syntax for the new settings will work. The tarball has configuration examples in the new format.
The Wikipublisher server is distributed under the terms of the Artistic License, version 2.0. In accordance with the terms of the Artistic License, the distribution includes in the tbook-src directory a tarball of the original tbookdtd package. The compiled LATEX packages in wikibook/template are distributed under the LATEX Project Public License.
As of version 1.0.11, the original tbook-1.5.2 tarball is no longer included in the Wikibook distribution. It is available as a separate download instead (424kB):
If you like the software and find it useful, you may wish to Support Wikipublisher.
« Recipes | User Guide | Skins »
1 to get it working correctly on an Intel Mac, we had to compile from source — the pre-compiled binary doesn’t seem to include the Perl interface (↑)
2 We can provide a precompiled Mac OS X PPC version of tbrplent if required. Contact us for more information. (↑)