docs/system-admin-guide/design/pdf-export-styles/timesheet/README.md
This document describes the style settings format for the PDF Export styling file.
| Key | Description | Data type |
|---|---|---|
page | Page settings | |
| Properties to set the basic page settings | ||
| See Page settings | object | |
page_logo | Page logo | |
| Styling for logo image in the page header. | ||
| See Page logo | object | |
page_header | Page headers | |
| See Page headers | object | |
page_footer | Page footers | |
| See Page footers | object | |
page_heading | Page heading | |
| The main page title heading | ||
| See Page heading | object | |
cover | Cover page | |
| Styling for the cover page of the PDF report export | ||
| See Cover page | object |
Styling for the cover page of the PDF report export
Key: cover
Example:
cover:
header: {}
footer: {}
hero: {}
| Key | Description | Data type |
|---|---|---|
header | Cover page header | |
| Styling for the cover page header | ||
| See Cover page header | object | |
footer | Cover page footer | |
| Styling for the cover page footer | ||
| See Cover page footer | object | |
hero | Cover page hero | |
| Styling for the hero banner at the bottom at the cover page | ||
| See Cover page hero | object |
Styling for the cover page footer of the PDF report export
Key: cover_footer
Example:
footer:
offset: 20
size: 10
color: 064e80
| Key | Description | Data type |
|---|---|---|
offset | Offset position from page bottom | |
| A number >= 0 and an optional unit | ||
Example: 30 | number or string | |
| See Units | ||
| … | See Font properties |
Styling for the cover page header of the PDF report export
Key: cover_header
Example:
header:
logo_height: 25
border: {}
| Key | Description | Data type |
|---|---|---|
spacing | Minimum spacing between logo and page header text | |
| A number >= 0 and an optional unit | ||
Example: 20 | number or string | |
| See Units | ||
offset | Offset position from page top | |
| A number >= 0 and an optional unit | ||
Example: 6.5 | number or string | |
| See Units | ||
logo_height | Height of the logo in the page header | |
| A number >= 0 and an optional unit | ||
Example: 25 | number or string | |
| See Units | ||
border | Cover page header | |
| Styling for the cover page header | ||
| See Cover page header border | object | |
| … | See Font properties |
Styling for the cover page header border of the PDF report export
Key: cover_header_border
Example:
border:
color: d3dee3
height: 1
offset: 6
| Key | Description | Data type |
|---|---|---|
spacing | Minimum spacing between logo and page header text | |
| A number >= 0 and an optional unit | ||
Example: 20 | number or string | |
| See Units | ||
offset | Offset position from page top | |
| A number >= 0 and an optional unit | ||
Example: 6 | number or string | |
| See Units | ||
height | Line height of the border | |
| A number >= 0 and an optional unit | ||
Example: 25 | number or string | |
| See Units | ||
color | Line color of the border | |
| A color in RRGGBB format | ||
Example: F0F0F0 | string | |
| … | See Font properties |
Styling for the hero banner at the bottom at the cover page
Key: cover_hero
Example:
header:
padding_right: 150
padding_top: 120
title: {}
heading: {}
subheading: {}
| Key | Description | Data type |
|---|---|---|
padding_right | Padding right | |
| Padding only on the right side of the hero banner | ||
Examples: 10mm, 10 | number or string | |
| See Units | ||
padding_top | Padding top | |
| Padding only on the top side of the hero banner | ||
Examples: 10mm, 10 | number or string | |
| See Units | ||
title | The first block in the hero | |
| See The first block in the hero | object | |
heading | The main block in the hero | |
| See The main block in the hero | object | |
dates | The dates block in the hero | |
| See The dates block in the hero | object | |
subheading | The last block in the hero | |
| See The last block in the hero | object |
Properties to set the font style
Key: font
Example:
font: OpenSans
size: 10
character_spacing: 0
styles: []
color: '000000'
leading: 2
| Key | Description | Data type |
|---|---|---|
font | string | |
size | A number >= 0 and an optional unit | |
Examples: 10mm, 10 | number or string | |
| See Units | ||
character_spacing | A number >= 0 and an optional unit | |
Examples: 10mm, 10 | number or string | |
| See Units | ||
leading | A number >= 0 and an optional unit | |
Examples: 10mm, 10 | number or string | |
| See Units | ||
color | Color | |
| A color in RRGGBB format | ||
Example: F0F0F0 | string | |
styles | Example: [bold] | |
| Valid values: | ||
bold, italic, underline, strikethrough, superscript, subscript | array of string |
Properties to set margins
Key: margin
Example:
margin: 10mm
margin_top: 15mm
| Key | Description | Data type |
|---|---|---|
margin | Margin | |
| One value for margin on all sides | ||
Examples: 10mm, 10 | number or string | |
| See Units | ||
margin_left | Margin left | |
| Margin only on the left side | ||
Examples: 10mm, 10 | number or string | |
| See Units | ||
margin_right | Margin right | |
| Margin only on the right side | ||
Examples: 10mm, 10 | number or string | |
| See Units | ||
margin_top | Margin top | |
| Margin only on the top side | ||
Examples: 10mm, 10 | number or string | |
| See Units | ||
margin_bottom | Margin bottom | |
| Margin only on the bottom side | ||
Examples: 10mm, 10 | number or string | |
| See Units |
Key: page_footer
Example:
page_footer:
offset: -30
size: 8
| Key | Description | Data type |
|---|---|---|
offset | Offset position from page bottom | |
| A positive or negative number and an optional unit | ||
Example: -30 | number or string | |
| See Units | ||
spacing | Minimum spacing between different page footers | |
| A number >= 0 and an optional unit | ||
Example: 8 | number or string | |
| See Units | ||
| … | See Font properties |
Key: page_header
Example:
page_header:
align: left
offset: 20
size: 8
| Key | Description | Data type |
|---|---|---|
align | Alignment | |
| How the element should be aligned | ||
Example: center | ||
| Valid values: | ||
left, center, right | string | |
offset | Offset position from page top | |
| A positive or negative number and an optional unit | ||
Example: -30 | number or string | |
| See Units | ||
| … | See Font properties |
The main page title heading
Key: page_heading
Example:
page_heading:
size: 14
styles:
- bold
margin_bottom: 10
| Key | Description | Data type |
|---|---|---|
| … | See Font properties | |
| … | See Margin properties |
Styling for logo image in the page header.
Key: page_logo
Example:
page_logo:
height: 20
align: right
| Key | Description | Data type |
|---|---|---|
height | Height of the image | |
| A number >= 0 and an optional unit | ||
Examples: 10mm, 10 | number or string | |
| See Units | ||
align | Alignment | |
| How the element should be aligned | ||
Example: center | ||
| Valid values: | ||
left, center, right | string | |
offset | Offset position from page top | |
| A positive or negative number and an optional unit | ||
Example: -30 | number or string | |
| See Units |
Properties to set the basic page settings
Key: page
Example:
page:
page_size: EXECUTIVE
margin_top: 60
margin_bottom: 60
margin_left: 36
margin_right: 36
page_break_threshold: 200
link_color: 175A8E
| Key | Description | Data type |
|---|---|---|
link_color | Link color | |
| Set the color of clickable links | ||
Example: F0F0F0 | string | |
page_layout | Page layout | |
| The layout of a page | ||
Example: portrait | ||
| Valid values: | ||
portrait, landscape | string | |
page_size | Page size | |
| The size of a page | ||
Example: EXECUTIVE | ||
| Valid values: | ||
EXECUTIVE, TABLOID, LETTER, LEGAL, FOLIO, A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, B0, B1, B2, B3, B4, B5, B6, B7, B8, B9, B10, C0, C1, C2, C3, C4, C5, C6, C7, C8, C9, C10, RA0, RA1, RA2, RA3, RA4, SRA0, SRA1, SRA2, SRA3, SRA4, 4A0, 2A0 | string | |
page_break_threshold | Page break threshold | |
| If there is a new section, start a new page if space less than the threshold is available | ||
Examples: 10mm, 10 | number or string | |
| See Units | ||
| … | Default font settings | |
| See Font properties | ||
| … | Page margins | |
| See Margin properties |
Key: dates
Example:
heading:
spacing: 10
max_height: 20
size: 32
color: 414d5f
styles:
- bold
| Key | Description | Data type |
|---|---|---|
max_height | Maximum height of the block | |
| A number >= 0 and an optional unit | ||
Example: 30 | number or string | |
| See Units | ||
spacing | Minimum spacing between dates and subheading | |
| A number >= 0 and an optional unit | ||
Example: 10 | number or string | |
| See Units | ||
| … | See Font properties |
Key: title
Example:
title:
max_height: 30
spacing: 10
font: SpaceMono
size: 10
color: 414d5f
| Key | Description | Data type |
|---|---|---|
spacing | Minimum spacing between title and heading | |
| A number >= 0 and an optional unit | ||
Example: 10 | number or string | |
| See Units | ||
max_height | Maximum height of the block | |
| A number >= 0 and an optional unit | ||
Example: 30 | number or string | |
| See Units | ||
| … | See Font properties |
Key: subheading
Example:
subheading:
max_height: 30
size: 10
color: 414d5f
styles:
- italic
| Key | Description | Data type |
|---|---|---|
max_height | Maximum height of the block | |
| A number >= 0 and an optional unit | ||
Example: 30 | number or string | |
| See Units | ||
| … | See Font properties |
Key: heading
Example:
heading:
spacing: 10
size: 32
color: 414d5f
styles:
- bold
| Key | Description | Data type |
|---|---|---|
spacing | Minimum spacing between heading and subheading | |
| A number >= 0 and an optional unit | ||
Example: 10 | number or string | |
| See Units | ||
| … | See Font properties |
available units are
mm - Millimeter, cm - Centimeter, dm - Decimeter, m - Meter
in - Inch, ft - Feet, yr - Yard
pt - Postscript point (default if no unit is used)