Installing 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 Chinese, Japanese, Korean (CJK)

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 MindTouch to use PrinceXML

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

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

Restart dekihost for changes to take effect.

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: MindTouch 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 MindTouch to use PrinceXML

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

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

Restart dekihost for changes to take effect.

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>

Restart dekihost for changes to take effect.