We work hard to make Prince work on multiple platforms (Windows, Linux, etc) and with multiple configurations. However things don't always work correctly the first time. You're very welcome to contact us for support or visit our forum. However if your facing a common problem you may be able to find an explanation and solution below.
internal error: no fallback glyph for character
U+00XX
i
Prince, or one of its libraries, may not be able to find the requested font. This can occur on Linux systems that do not have the msttcorefonts package installed.
Install the msttcorefonts package (see your operating system's documentation).
Redefine the CSS generic font families to use different TrueType
fonts by editing the
fonts.css
file in the Prince
installation.
See Fonts for more information about
redefining the CSS generic font families.
This problem may be a symptom of the Fontconfig.
Fontconfig error: Cannot load default config
file
Prince uses the Fontconfig library on Linux systems to search for fonts. Fontconfig is installed as a standard component on most desktop Linux distributions such as Ubuntu and recent versions of Red Hat Linux.
Some older Linux distributions do not come with fontconfig and this may cause the above error. This error will usually be followed by errors relating to Missing fonts that cannot be found due to the absence of Fontconfig.
install Fontconfig (see your operating system's documentation).
Redefine the CSS generic font families to use TrueType fonts that are specified directly by their filenames, avoiding the need to use Fontconfig at all. See Fonts for more information about redefining the CSS generic font families.
prince: ./picture.bmp
: warning: Unknown image format
Prince supports JPEG, PNG, TIFF and GIF images. If you try to format a document that includes images in a format that is not supported by Prince, such as BMP, you may see the above error message from Prince.
The solution is to convert the image file into a format that is supported by Prince. We suggest PNG, which is a well-supported general purpose image format with lossless compression.
/usr/local/stow/prince-9/lib/prince/bin/prince: error while loading shared
libraries: libtiff.so.4: cannot open shared object file: No such file or
directory
Shared object "libxml2.so.2" not found, required by "prince"
Prince uses some third-party shared libraries, these are used for things such as decoding TIFF, PNG or JPEG files and finding and loading fonts. If one or more of these shared libraries cannot be found on your system then Prince will not run. This can occur if Prince was installed from a tarball (FreeBSD, Solaris and Generic Linux).
Install the missing library software. Acknowledgements provides a list of the libraries that Prince uses. It is recommended to install them through your operating system's package management tool, see your operating system's documentation for more information.
If you're installing from a tarball,
choose a tarball with a statically linked version
of Prince (one with static
in its name).
We do not recommend this as you may not receive timely security
updates for the third party software that is compiled directly into
Prince.
PATH
issues-bash: prince: command not found
The command interpreter (bash
) does not
know how to find the prince
executable.
It was not found in any of the locations specified by the
PATH
environment variable.
Add Prince's bin/
subdirectory to your
PATH
and ensure that these changes are saved for future
shell sessions.
If Prince is installed in /opt/prince10
,
then add /opt/prince10/bin
to
PATH
.
There are many different types of command interpreters (also called
shells) and we cannot possibly document all of them.
The appropriate command for borne-style shells (the most common type)
is usually:
export PATH=/opt/prince10 /bin:$PATH
This should be added to your command interpreter's configuration. For more information see your operating system's documentation.