Ideas: Print Customizations about dbcookbook HOT 4 OPEN

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!

from dbcookbook.

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! 👍

from dbcookbook.

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!

from dbcookbook.

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

@eduardtibet That's perfectly fine! 👍

from dbcookbook.