Ideas: Print Customizations

[tomschr]

Moved from https://sourceforge.net/p/doccookbook/tickets/22/

---

These are some of the ideas about print customizations. The list is no guarantee that all will be implemented.

• Restarting page number on each chapter
• Designing Title Pages
• Designing Pages for Novels
• Designing Pages for Lexicons, Referene Book and Catalogs
• Designing Pages for Magazines and News Papers
• Designing Pages for Technical Books
• Adapting Chapter and Sections Titles
• Make Font Sizes Consistent / Standardizing Font Sizes (Le Corbusier)
• Index
• Designing TOCs
• Colorizing Table Rows
• Adding Graphics in Title Page
• Adding Logos in Header or Footer
• Adding Current Time and Date Information
• Separating Chapter Number from Title
• Footnotes
• Marginalia
• Endnotes
• Adorning Paragraphs with Initials (Openings)
• Formatting Titles
• Numbering Titles
• Choosing Open Source Fonts
• Adding Change Bars
• Initials/Drop Caps
• Influence Leading in Flow Text (=line-height in paras)
• Hyphenating in Verbatim Environments (long lines in screen, programlisting)
• Showing Cropmarks
  http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/examples/fo/advanced/bleed-and-crop-marks.fo?view=markup&pathrev=800143
• Barcode
• Add Typographical Superiors and Inferiors
• Adding Fonts to FO Formatter
• Creating Page Definitions with Inkscape
• Styling Labels Differently than Titles (Separating Labels and Titles)
• Using Text Figures http://en.wikipedia.org/wiki/Text_figures
• Using MathML in Formulas
• Influencing the TOC Bookmark Levels in PDF
• Finding the correct Font Name
• Hyphenating URLs

[eduardtibet]

Tom, I began a long-term project regarding print customization of DocBook documents. The will be a several bunch of projects, helping authors to get a typography friendly PDF output. This mostly will related to a technical documentation (manuals, books. etc) and, maybe, marketing brochures.

The first project, that is already available, fixes the common problem regarding non-Latin characters (i.e. Cyrillic) in PDF output while using Apache FOP as a formatter. It is available here: https://github.com/eduardtibet/foponts

I want to add the appropriate recipe as a:

• Adding Fonts to FO Formatter

Where I should add this topic? Yes, I'm aware about fo/ directory. But maybe there are some rules that I need to know before making a patch?

Thanks!

[tomschr]

Hi Eduard,

@eduardtibet

I began a long-term project regarding print customization of DocBook documents. [...]

Great to hear that! 👍 Wish you great success for your project.

Adding Fonts to FO Formatter
Where I should add this topic? Yes, I'm aware about fo/ directory. But maybe there are some rules that I need to know before making a patch?

I should have better documented how to contribute. 😉 Ok, anyway. I would suggest to proceed as follows:

1. Please open a new issue especially for this feature. Describe a bit what you would like to add.
2. Fork this repository and create a new branch from develop. I use git flow for that, but it's not mandatory.
3. Start with copying the file en/xml/topic.empty.xml to en/xml/fo/topic.<NAME>.xml. Replace <NAME> with something that relates to your topic. It's ok to abbreviate it. You can find more examples in the en/xml/fo/ directory.
4. Start working on the new file. In most cases you can remove the content inside <info>.
5. Integrate your new file into en/xml/dbc-fo.xml with a new <xi:include href="..."/> line.
6. Validate it. 😉
7. Commit all your changes. Refer to the issue number you've created in the first step.
8. Submit a pull request against the develop branch for this repo.

Hope I didn't forget anything. Let me know if you need help here or there.

Thanks a lot for your contribution! 👍

[eduardtibet]

Thomas, please, edit the following topic to extend one:

• Adding Fonts to FO Formatter (Apache FOP, RenderX XEP, Antenna House XSL Formatter)

The point is, that the topic I'm going to write about, covers only Apache FOP. Other formatters are out of the scope of my article. Thanks!

[tomschr]

The point is, that the topic I'm going to write about, covers only Apache FOP

@eduardtibet That's perfectly fine! 👍