Some parameters, defined in the DocBook Project XSL stylesheets to tweak the PDF output done by FO engines, are also handled by dbcontext to customize the layout. This feature allows to share some of the settings between different translators, even if dbcontext has some specificities.
The feature is activated when the fo.setup
parameter is set to 1. When set to 0 the parameters, even if defined, are
ignored.
dbcontext -P fo.setup=1 myfile.xml
The supported parameters are listed below. Some of them are different from the original ones. The last column ("Cp" for compiance) means the following:
Compliant with the original FO parameter.
Changed parameter. The value must be specific to dbcontext, or the nature of the parameter is different.
New parameter specific to dbcontext. Most of them are added to replace some FO parameters not suited to dbcontext, like attribute-sets.
| Parameter | Description | Cp |
|---|---|---|
alignment | Body text alignment. | |
appendix.autolabel | Set to 1 the appendix titles are (automatically) numbered | |
body.font.family | Default is "serif". Be sure to use a value supported by ConTeXt. | |
body.font.master | Font size in points, but without the unit. "10" means 10pts. | |
body.font.size | Its value can be deduced from body.font.master. In this case the "pt" unit is simply added. | |
body.margin.bottom | Space between the bottom of the body text and the bottom of the footer. | |
body.margin.top | Space between the top of the header and the top of the body text. | |
body.start.indent | Indentation added to the text body from the left margin. | |
chapter.autolabel | Set to 1 the chapter titles are (automatically) numbered. | |
chapter.title.properties | Specific to dbcontext, this attribute-set defines the chapter font size. | N |
double.sided | Default is "0". | |
footer.even.frame | Defines the frame of an even footer. The value must be a valid ConTeXt frame option combination. | N |
footer.even.left | A footer is in three parts of same size (left, middle, right). The left part is aligned to the left, and the right part is aligned to the right. These parameters define the content of each part, for an even footer. | N |
footer.even.middle | ||
footer.even.right | ||
footer.odd.frame | Defines the frame of a odd footer. The value must be a valid ConTeXt frame option combination. | N |
footer.odd.left | Left content of a odd footer. | |
footer.odd.middle | Centered content of a odd footer | |
footer.odd.right | Right content of a odd footer | |
footnote.font.size | Footnote text font size. | |
footnote.number.format | How the footnote numbers are formatted (numbers, roman numerals, etc.). | |
header.even.frame | Like the footer.{odd|even}.* parameters these parameters are specific to dbcontext. The role of each parameter is the same as for footers. | N |
header.even.left | ||
header.even.middle | ||
header.even.right | ||
header.odd.frame | ||
header.odd.left | ||
header.odd.middle | ||
header.odd.right | ||
line-height | Height of a text line. Currently supports only 'normal' | C |
normal.para.spacing | In dbcontext it is a parameter rather than an attribute-set | C |
page.margin.bottom | Space between the bottom of the footer and the bottom of the page | |
page.margin.inner | In single sided documents, left margin. In double sided document, left margin for odd pages. | |
page.margin.outer | In single sided documents, right margin. In double sided document, right margin for odd pages. | |
page.margin.top | Space between the top of the page and the top of the header. | |
page.orientation | Portrait or landscape. | |
paper.type | A4, A3, etc. | |
region.after.extent | Height of the footer | |
region.before.extent | Height of the header | |
sans.font.family | Default is "helvetica". The value must be a valid font family supported by ConTeXt. If you have troubles with sans-serif fonts, you can set the parameter to "serif" to use the default supported font. | |
section.autolabel | Set to 1, the section titles are (automatically) numbered | |
section.title.level1.properties | Attribute-sets used to specify the font size of each level of section titles. | |
section.title.level2.properties | ||
section.title.level3.properties | ||
section.title.level4.properties | ||
section.title.level5.properties | ||
title.font.family | Font family used to render the titles. Only chapter and section titles use this font. Others (like document title or float titles) use the default font. |