How do I...Install Prince for PDF Export?

Debian Etch

Make sure your /etc/apt/sources.list has the contrib section enabled.

deb http://ftp.debian.org/debian/ etch main contrib
deb http://security.debian.org/ etch/updates main contrib

Install PrinceXML prerequisites and package:

apt-get install msttcorefonts cabextract
wget http://www.princexml.com/download/prince_6.0r6-1_i386.deb
dpkg -i prince_6.0r6-1_i386.deb

Install additional fonts (for CJK support)

apt-get install ttf-arphic-bsmi00lp ttf-arphic-bkai00mp ttf-arphic-gbsn00lp ttf-arphic-gkai00mp ttf-arphic-ukai ttf-arphic-uming  ttf-kochi-gothic ttf-kochi-mincho

Configure DekiWiki to use PrinceXML

Edit your mindtouch.deki.startup.xml and add the following configuration element

<princexml-path>/usr/bin/prince</princexml-path>

CentOS 5, RHEL5

- Install PrinceXML static binary tarball:

wget http://www.princexml.com/download/prince-6.0r6-linux.tar.gz
tar xfzv prince-6.0r6-linux.tar.gz 
cd prince-6.0r6-linux
./install.sh

- Install the TrueType core fonts

NOTE: Deki 8.08 PDF export doesn't function properly if the TrueType fonts are not installed (see bug report for more info).  As a temporary workaround, you can edit the following file:

/var/www/dekiwiki/skins/common/prince.content.css

and add the following lines:

@font-face {
        font-family: sans-serif;
        src: url("/skins/fonts/gentium-basic/GenBkBasR.ttf");
}
@font-face {
        font-family: serif;
        src: url("/skins/fonts/gentium-basic/GenBkBasR.ttf");
}
@font-face {
        font-family: monospace;
        src: url("/skins/fonts/gentium-basic/GenBkBasR.ttf");
}

- Configure DekiWiki to use PrinceXML

Edit your mindtouch.deki.startup.xml and add the following configuration element

<princexml-path>/usr/local/bin/prince</princexml-path>

Windows Server 2003, Source Install

For the few people who installed source on Windows Server 2003, you may need to point to the prince.exe file. Edit mindtouch.deki.startup.xml and add this:

<princexml-path>C:\Program Files\Prince\Engine\bin\prince.exe</princexml-path>