Paragraph Styles
Starter Template
If you just want to get started, you can download this template that showcases most features available:
Paragraph_Starter_Template.docx
Structure
All paragraph styles are defined within a table
having a header row (ignored), and
in the leftmost column are the names of the referenced word styles
further columns are ignored and can be used to add examples or any other supporting information.
Name | Example |
|---|---|
P_Header_1 | P_Header_1 |
P_Header_2 | P_Header_2 |
Behavior
Paragraph styles define a reference to word styles that can then be used in various nodes (such as paragraph nodes and section nodes).
They allow the definition of a default style that is used whenever no style is given.
Usually paragraph nodes are produced as plaintext with an optional style applied to them.
If the content is surrounded with <html></html> though, it is produced as HTML.
Paragraph nodes
The logic for using a style in paragraph nodes is as follows:
If the paragraph node is a direct child of a layout node and no style is specified, use the style of the slot it is in
If a style is specified, use it
If a style is specified but it doesn’t exist, generate a warning and use no style at all
If no style is specified, use the default style. If no default style exists, use none at all.
If the special “none” style is specified, use no style at all
Section nodes
The logic for using a style in section nodes is as follows:
If a style is specified, use it
If a style is specified but it doesn’t exist, generate a warning and use the style “Header x” where x is the level of the section node in the abstract report tree
If no style is specified, use the default one. If no default style exists, use the style “Header x” where x is the level of the section node in the abstract report tree
If the special “none” style is specified, use the “Header x” algorithm for finding a style.
Important
The “Header x” logic for setting the style based on the level of the section node works with the levels in the tree, not the section nodes themselves. This means that the first section node has to be the root of the abstract report, the second level the child of the root and so forth. If there is a NoOpNode first and after that a section node, this rule is not applied.
Metadata
The metadata comment must be set on the referenced style in the table.
The available options are default and noStyle. The default option define which style to use if no style is given:
The noStyle option defines the marker style that can be used to override the default style and use no style at all:
Examples
Example 1: Showing a simple case for paragraph styles
abstract-report-paragraph_simple.json output-paragraph_simple.docx template-paragraph_simple.docx
Example 2: Showing how the style based on the level of the section is used
abstract-report-paragraph_section_levels.json template-paragraph_section_levels.docx output-paragraph_section_levels.docx