A page layout (style:page-layout, see
Styles) holds
style:page-layout-properties for the page and
style:header-footer-properties for its header and footer. Section styles
hold style:section-properties. Pages, sections and text boxes can be
divided into columns with style:columns. This page lists every attribute
of these elements from OpenDocument 1.3 part 3, sections 17.2 to 17.5 and 17.11 to
17.14, with chapters 19 and 20. Borders, padding, shadow, margins and background work
as for paragraphs (see paragraph
formatting).
Page layout properties
Children: style:background-image, style:columns (text
columns on the page) and style:footnote-sep. Also allowed: the
fo:background-color, fo:border*,
style:border-line-width*, fo:padding*,
fo:margin* (page margins) and style:shadow attributes.
| Attribute | Values | Meaning |
|---|---|---|
fo:page-width, fo:page-height | length | Paper size (XSL §7.25.15, §7.25.13). |
style:print-orientation | portrait, landscape | Orientation. |
style:writing-mode | lr-tb, rl-tb, tb-rl, tb-lr, lr, rl, tb, page | Direction of the page, and the order of page columns. |
style:num-format, style:num-letter-sync, style:num-prefix, style:num-suffix | as for lists | Format of page numbers (1, a, A, i, I, other, or empty). |
style:first-page-number | positive integer or continue | Number of the first page; continue carries on from the previous page. Default 1. |
style:footnote-max-height | length | Most space footnotes may take on a page; 0cm means no limit. |
style:paper-tray-name | default or a name | Printer tray (names depend on the printer). |
style:register-truth-ref-style-name | paragraph style name | The style whose line spacing is the reference for register-true paragraphs. |
style:print | list of headers, grid, annotations, objects, charts, drawings, formulas, zero-values | Spreadsheets: what to print. |
style:print-page-order | ttb, ltr | Spreadsheets: page order, down first or across first. |
style:scale-to | percent | Print at this scale (100% is none). |
style:scale-to-pages | positive integer | Shrink to fit this many pages. |
style:scale-to-X, style:scale-to-Y | positive integer | Shrink to fit this many pages across or down. With none of the four, no scaling. |
style:table-centering | horizontal, vertical, both, none | Spreadsheets: centre tables on the page. Default: top corner, by writing direction. |
Asian layout grid
| Attribute | Values | Meaning |
|---|---|---|
style:layout-grid-mode | none, line, both | No grid; a fixed number of lines (no space between them, the grid centred on the page); lines divided into cells, at most one Asian character per cell, wider characters and non-Asian text centred over several cells. (The value list says line; the description calls it lines.) |
style:layout-grid-lines | positive integer | Lines per page (fewer if they do not fit). |
style:layout-grid-base-height | length | Line height for the base text. |
style:layout-grid-ruby-height | length | Extra height for ruby text; only when standard mode is false. |
style:layout-grid-ruby-below | true, false | Ruby below rather than above the base text. |
style:layout-grid-standard-mode | true, false | Only in the default page layout. false: square cells, sized from base plus ruby height. true (“standard paper mode”): rectangular cells, style:layout-grid-base-width wide; ruby height ignored. |
style:layout-grid-base-width | length | Cell width in standard mode. |
style:layout-grid-snap-to | true, false | Snap text to the grid (mode both with standard mode only). |
style:layout-grid-display, style:layout-grid-print | true, false | Show and print the grid lines. |
style:layout-grid-color | colour | Colour of the grid lines. |
Footnote separator
style:footnote-sep is the line between the text and the footnotes.
| Attribute | Values | Meaning |
|---|---|---|
style:width | length | Line thickness. |
style:rel-width | percent | Line length as a percentage of the text area width. |
style:color | colour, default #000000 | Line colour. |
style:line-style | none, solid, dotted, dash, long-dash, dot-dash, dot-dot-dash, wave | none: no line; the look of the others is up to the program. |
style:adjustment | left (default), center, right | Alignment of the line. |
style:distance-before-sep | length | Space between the text and the line. |
style:distance-after-sep | length | Space between the line and the footnotes. |
Columns
style:columns may be in page layout, section and graphic properties.
Without style:column children all columns are the same width.
| Element and attribute | Values | Meaning |
|---|---|---|
style:columns fo:column-count | positive integer | Number of columns. |
style:columns fo:column-gap | length | Gap when there are no style:column children. |
style:column style:rel-width | number followed by * | Relative width; the space is shared out in proportion. |
style:column fo:start-indent, fo:end-indent | length, default 0cm | Space at the column’s left and right; one column’s end indent plus the next one’s start indent is the gap. |
style:column fo:space-before, fo:space-after | length, default 0cm | Space above and below (XSL §7.10.5, §7.10.6). |
style:column-sep style:style | none, solid (default), dotted, dashed, dot-dashed | Separator line between columns. |
style:column-sep style:width | length | Line thickness. |
style:column-sep style:height | 0% to 100%, default 100% | Line length as a percentage of the column height. |
style:column-sep style:vertical-align | top (default), middle, bottom | Where a shorter line sits. |
style:column-sep style:color | colour, default #000000 | Line colour. |
<style:columns fo:column-count="2" fo:column-gap="0.5cm">
<style:column-sep style:width="0.02cm" style:height="100%" style:style="solid"/>
<style:column style:rel-width="1*" fo:start-indent="0cm" fo:end-indent="0.25cm"/>
<style:column style:rel-width="1*" fo:start-indent="0.25cm" fo:end-indent="0cm"/>
</style:columns>Section properties
style:section-properties (in styles of family section)
has children style:background-image, style:columns and
text:notes-configuration (notes collected at the end of the section, see
Styles).
| Attribute | Values | Meaning |
|---|---|---|
fo:background-color | transparent or colour | Background. |
fo:margin-left, fo:margin-right | length or percent | Indents of the section. |
style:protect | true, false | The user may not change the section. Should be true by default for linked sections and indexes; edits to an unprotected linked section are lost when it is updated. |
style:editable | true, false | The section may be edited even in a read-only document. |
style:writing-mode | as for paragraphs | Order of the section’s columns. |
text:dont-balance-text-columns | true, false | Whether column content is spread evenly over the columns. The standard’s own definitions read true: spread evenly, false: not, the reverse of what the name suggests. |
Source
OpenDocument Version 1.3, OASIS Standard, 27 April 2021, part 3 (schema), sections 17.2 to 17.5 and 17.11 to 17.14 and the matching attributes in chapters 19 and 20; read in full for this page.