MindTouch uses Prince XML for generating PDFs from MindTouch content. In order to modify the look and feel of the generated PDF, you will have to adhere to Prince XML's guidelines for CSS customization on their Web site. In order to implement the changes in MindTouch, you can add prince.xml styles in the control panel. Here's how. You want custom CSS to dictate how your PDF export will look. First log in as an administrator, navigate to your control panel and get started from there.
Within the Control Panel we provide a text area that you have the ability to override the default PDF CSS to provide your own look and feel. In order to customize the PDF output though you have to see the default CSS that we ship with which you can access by appending the following to your MindTouch site:
For example, you would load the following for success.mindtouch.com:
This will show you the default CSS for PDF generation. From here you'll be able to see styles that you can tweak and modify to fit your own styling.
Adding new Styles
The customizations can be modified to add new styles that are supported by PrinceXML. You can see the default Prince documentation on what is supported that can be added here: http://www.princexml.com/doc/8.0/
Note that there are some elements that you should be aware of as you are reviewing the default CSS. If you see a content: value that means that information is being added to the PDF. If the content: parameter includes a flow value, then that means that there are elements that we are passing to the PDF that can't be modified, they can only be overridden with new content/styles.
Take a look at some of our sample styles to have a good starting point.
Navigate to the Custom PDF CSS page in your control panel
This is accessible by going to Tools > Control Panel > Custom PDF CSS.
Add the Custom CSS
Review our PDF customization documentation to review how to override the default CSS.
Optional Step - Download the Current CSS Code to Work with on your Desktop
If you click on the "Export CSS" link, you can download the CSS code already saved to work with using your desktop IDE instead.
A PDF book can contain up to 10 MindTouch articles. If more than 10 articles are added to a book, only the first 10 will be rendered within the PDF book.
Header and Footer
Within MindTouch, you can customize the header and footer for every PDF page, or just the first and last PDF pages.
Customizing the Header and Footer of every PDF page
If you'd like to add content to the Header and Footer of every MindTouch page, this can be accomplished by targeting specific CSS elements in the Control Panel. For more details on accomplishing this see Prince's documentation. Inserting custom content in this fashion will add an additional content block outside of your custom PDF header/footer templates, and additional spacing may need to be applied for your PDF styles.
Customizing the Header and Footer of the first and last PDF pages
This can be accomplished by using the Self-Service Branding regions. See the following documentation for more information.
After you save your custom PDF CSS, you will want to go back to the front end of your site and export a sample PDF to see if the new styles meet your expectations. If not, make modifications using the steps above and repeat the process. If you want to remove all of your custom styles and start over, just delete all of your styles, save and begin again.