ADMIN and PORTAL_ADMIN users can configure a PDF template when authorized users perform the following actions:
- export a Personal book (users with the PDF_EXPORT_USER role)
- print topics directly from the Reader page (users with the PRINT_USER role or everyone if feature is enabled in the Reader page administration interface).
Adding a custom PDF template involves the following steps:
- Download the current template (it may be the default one or a previously modified template), or create a new Velocity file.
- Use CSS parameters to customize the Velocity file. More information is available on the W3C website.
- Go to the appropriate section of the Templates administration interface (export a Personal book or print topics from the Reader page).
- Select the Upload new template button.
- Select the archive containing the Velocity files for all of the tenant's interface languages as well as all related image files.
- Select the Save button.
All files must be at the root level of the archive.
Any headers and footers configured in the template for printing topics from the Reader page are not rendered in the final PDF output. Rather, they are replaced by the browser's default headers and footers. The margin areas can only be customized in the templates for exporting Personal books.
The former PDF template location (/usr/local/afs7/Fluid-Topics/conf/$TENANT_ID/pdf_templates/$TEMPLATE_DIRECTORY/) on the server is ignored as soon as the Templates administration interface is used to upload a new template.