| Elements configuration reference | ||
|---|---|---|
| Element | Description | Children |
| doc | This is the root element of source doc (consisting in a 'metadata' and a 'body' section) | ( body ) [1-1] ( metadata | meta ) [1-1] |
| metadata | Contains the meta informations of the document (roughly comparable to a HTML 'head' element) | ( info , header , footer , header-ext , footer-ext , background , bookmark-tree ) [1-1] |
| meta | Contains the meta informations of the document ('meta' is kept for compatibility, better use 'metadata') | ( info , header , footer , header-ext , footer-ext , background , bookmark-tree ) [1-1] |
| body | The body of the document (roughly comparable to a HTML 'body' element) | ( para | table | list | image | phrase | nbsp | br | barcode | h | page-break ) [0-unbounded] |
| info | This is a key/value element containing informations for document generations, the attribute 'name' is the key, while the text content is the value. | mixed |
| header | A header made of a complex elements (not includes tables) | ( para | image | phrase | h ) [0-unbounded] |
| footer | A footer made of simple elements (not includes tables) | ( para | image | phrase | h ) [0-unbounded] |
| header-ext | A header made of a complex elements (includes tables) | ( para | table | image | phrase | barcode | h ) [0-unbounded] |
| footer-ext | A footer made of complex elements (includes tables) | ( para | table | image | phrase | barcode | h ) [0-unbounded] |
| background | A background image to use for the document | ( image ) [1-1] |
| bookmark-tree | The root of the bookmark tree for the document | ( bookmark ) [1-1] |
| bookmark | A bookmark for the document | mixed |
| para | A document paragraph (roughly comparable to a HTML 'p' element) , Depending on type handler support it is possible to use some constants (usually in header or footer) , ${currentPage} to display the current page (starts at 1) , ${pageCount} to display the last page number | mixed ( phrase | para | h ) [0-unbounded] |
| table | A document table (roughly comparable to a HTML 'table' element) | ( row ) [1-1] |
| row | A table row (roughly comparable to a HTML 'tr' element) | ( cell ) [1-1] |
| cell | A row cell (roughly comparable to a HTML 'th' or 'td' element) | ( para | table | image | phrase | nbsp | br | barcode | h ) [1-unbounded] |
| list | A list in the document (roughly comparable to a HTML 'ul' pr 'ol' element) | ( li ) [1-1] |
| li | A item of a list (roughly comparable to a HTML 'li' element) | ( list ) [1-2] ( para | h | pl ) [1-1] |
| pl | A phrase list contained in a list item | ( phrase ) [1-unbounded] |
| image | An image to include in the document (roughly comparable to a HTML 'image' element) | |
| phrase | A phrase of the document (roughly comparable to a HTML 'span' element) | mixed |
| nbsp | Simple spacing (roughly comparable to a HTML 'nbsp' entity) | |
| br | A line break (roughly comparable to a HTML 'br' element) | |
| barcode | Create a barcode (this element is kept for compatibility, but it's better to generate barcode as images) | |
| h | A document heading (roughly comparable to a HTML 'h1', 'h2' etc. element) | mixed ( phrase | para | h ) [0-unbounded] |
| page-break | A page break heading | |
| Element : doc | ||
|---|---|---|
| This is the root element of source doc (consisting in a 'metadata' and a 'body' section) | ||
| Attribute | Description | Note |
| This element does not have attributes | ||
| Element : metadata | ||
|---|---|---|
| Contains the meta informations of the document (roughly comparable to a HTML 'head' element) | ||
| Attribute | Description | Note |
| This element does not have attributes | ||
| Element : meta | ||
|---|---|---|
| Contains the meta informations of the document ('meta' is kept for compatibility, better use 'metadata') | ||
| Attribute | Description | Note |
| This element does not have attributes | ||
| Element : body | ||
|---|---|---|
| The body of the document (roughly comparable to a HTML 'body' element) | ||
| Attribute | Description | Note |
| This element does not have attributes | ||
| Element : info | ||
|---|---|---|
| This is a key/value element containing informations for document generations, the attribute 'name' is the key, while the text content is the value. | ||
| Attribute | Description | Note |
| name | Contains the value of this document information (see the link https://venusdocs.fugerit.org/docs/html/doc_meta_info.html for possible values) | string |
| Element : header | ||
|---|---|---|
| A header made of a complex elements (not includes tables) | ||
| Attribute | Description | Note |
| align | Header horizontal alignment | alignType , base : string , enumeration : [ center , right , left , justify , justifyall ] |
| numbered | 'true' is the header should add page number | boolean |
| border-width | The size of the border | borderWidthType , base : int , minInclusive : 0 , maxInclusive : 32 |
| expected-size | Expected header size | int |
| A footer made of simple elements (not includes tables) | ||
|---|---|---|
| Attribute | Description | Note |
| align | Footer horizontal alignment | alignType , base : string , enumeration : [ center , right , left , justify , justifyall ] |
| numbered | 'true' is the footer should add page number | boolean |
| border-width | The size of the border | borderWidthType , base : int , minInclusive : 0 , maxInclusive : 32 |
| expected-size | Expected footer size | int |
| Element : header-ext | ||
|---|---|---|
| A header made of a complex elements (includes tables) | ||
| Attribute | Description | Note |
| align | Header horizontal alignment | alignType , base : string , enumeration : [ center , right , left , justify , justifyall ] |
| numbered | 'true' is the header should add page number | boolean |
| border-width | The size of the border | borderWidthType , base : int , minInclusive : 0 , maxInclusive : 32 |
| expected-size | Expected header size | int |
| A footer made of complex elements (includes tables) | ||
|---|---|---|
| Attribute | Description | Note |
| align | Footer horizontal alignment | alignType , base : string , enumeration : [ center , right , left , justify , justifyall ] |
| numbered | 'true' is the footer should add page number | boolean |
| border-width | The size of the border | borderWidthType , base : int , minInclusive : 0 , maxInclusive : 32 |
| expected-size | Expected footer size | int |
| Element : background | ||
|---|---|---|
| A background image to use for the document | ||
| Attribute | Description | Note |
| This element does not have attributes | ||
| Element : bookmark-tree | ||
|---|---|---|
| The root of the bookmark tree for the document | ||
| Attribute | Description | Note |
| This element does not have attributes | ||
| Element : bookmark | ||
|---|---|---|
| A bookmark for the document | ||
| Attribute | Description | Note |
| ref | The reference to the element id to link | idType , base : string , minLength : 1 , maxLength : 64 |
| Element : para | ||
|---|---|---|
| A document paragraph (roughly comparable to a HTML 'p' element) , Depending on type handler support it is possible to use some constants (usually in header or footer) , ${currentPage} to display the current page (starts at 1) , ${pageCount} to display the last page number | ||
| Attribute | Description | Note |
| id | An element id (should be unique in the document) | idType , base : string , minLength : 1 , maxLength : 64 |
| style | Font style of the element | styleType , base : string , enumeration : [ normal , bold , underline , italic , bolditalic ] |
| align | Horizontal alignment of the element | alignType , base : string , enumeration : [ center , right , left , justify , justifyall ] |
| font-name | The name of the font to use | fontNameType , base : string , minLength : 1 , maxLength : 64 |
| leading | The leading between lines | leadingType , base : decimal , minInclusive : 0 , maxInclusive : 2048 |
| back-color | A color representation in HTML RGB format | colorType , base : string , pattern : #([A-Fa-f0-9]{6}) |
| fore-color | A color representation in HTML RGB format | colorType , base : string , pattern : #([A-Fa-f0-9]{6}) |
| type | Data type contained in the element | dataType , base : string , enumeration : [ string , number , date ] |
| format | Data format | formatType , enumeration : [ yyyy-MM-dd , yyyy-MM-dd hh:mm:ss , yyyy-MM-dd'T'HH:mm:ss.SSSZ , iso ] , base : string , minLength : 1 , maxLength : 128 |
| size | The size of the font to use | fontSize , base : int , minInclusive : 0 , maxInclusive : 256 |
| text-indent | Text indentation (currently ignored) | textIndentType , base : decimal , minInclusive : 0 , maxInclusive : 2048 |
| space-before | The spacing of the element (possibly in a given direction) | spaceType , base : decimal , minInclusive : 0 , maxInclusive : 2048 |
| space-after | The spacing of the element (possibly in a given direction) | spaceType , base : decimal , minInclusive : 0 , maxInclusive : 2048 |
| space-left | The spacing of the element (possibly in a given direction) | spaceType , base : decimal , minInclusive : 0 , maxInclusive : 2048 |
| space-right | The spacing of the element (possibly in a given direction) | spaceType , base : decimal , minInclusive : 0 , maxInclusive : 2048 |
| white-space-collapse | Value is 'true' if the white spaces must be trimmed | whiteSpaceCollapsType , base : boolean |
| Element : table | ||
|---|---|---|
| A document table (roughly comparable to a HTML 'table' element) | ||
| Attribute | Description | Note |
| id | An element id (should be unique in the document) | idType , base : string , minLength : 1 , maxLength : 64 |
| columns | Number of columns in a table | columnsType , base : int , minInclusive : 1 , maxInclusive : 2048 |
| width | The width in percentage of the table | percentageType , base : int , minInclusive : 1 , maxInclusive : 100 |
| back-color | A color representation in HTML RGB format | colorType , base : string , pattern : #([A-Fa-f0-9]{6}) |
| fore-color | A color representation in HTML RGB format | colorType , base : string , pattern : #([A-Fa-f0-9]{6}) |
| spacing | This should be a integer value representing the table cell spacing (for some format like fo/pdf and html, it represents the margin) (Is it possible to set a default for the document : https://venusdocs.fugerit.org/docs/html/doc_meta_info.html#default-table-spacing) | spaceType , base : decimal , minInclusive : 0 , maxInclusive : 2048 |
| padding | This should be a integer value representing the table cell padding (Is it possible to set a default for the document : https://venusdocs.fugerit.org/docs/html/doc_meta_info.html#default-table-padding) | spaceType , base : decimal , minInclusive : 0 , maxInclusive : 2048 |
| colwidths | The sizes of the columns of the table as percentages separated by semicolons (for instance '30;30;40' are three columns if size 30%, 30% and 40%) | string |
| space-before | The spacing of the element (possibly in a given direction) | spaceType , base : decimal , minInclusive : 0 , maxInclusive : 2048 |
| space-after | The spacing of the element (possibly in a given direction) | spaceType , base : decimal , minInclusive : 0 , maxInclusive : 2048 |
| render-mode | Table render mode (if 'inline' the handler will try to render the table as a flow of element) | tableRenderModeType , base : string , enumeration : [ normal , inline ] |
| caption | The caption to be used for the table (basically an alternate description) Note : different type handlers may render it in different ways | string |
| Element : row | ||
|---|---|---|
| A table row (roughly comparable to a HTML 'tr' element) | ||
| Attribute | Description | Note |
| id | An element id (should be unique in the document) | idType , base : string , minLength : 1 , maxLength : 64 |
| header | Set to 'true' if the row is a header for the table | boolean |
| Element : cell | ||
|---|---|---|
| A row cell (roughly comparable to a HTML 'th' or 'td' element) | ||
| Attribute | Description | Note |
| id | An element id (should be unique in the document) | idType , base : string , minLength : 1 , maxLength : 64 |
| colspan | The column span size of the cell (default value is '1') | spanType , base : int , minInclusive : 1 |
| rowspan | The row span size of the cell (default value is '1') | spanType , base : int , minInclusive : 1 |
| align | Horizontal alignment of the element | alignType , base : string , enumeration : [ center , right , left , justify , justifyall ] |
| valign | Vertical alignment of the element | valignType , base : string , enumeration : [ middle , top , bottom ] |
| header | Set to 'true' if the cell is a header for the table | boolean |
| border-color | A color representation in HTML RGB format | colorType , base : string , pattern : #([A-Fa-f0-9]{6}) |
| border-color-top | A color representation in HTML RGB format | colorType , base : string , pattern : #([A-Fa-f0-9]{6}) |
| border-color-bottom | A color representation in HTML RGB format | colorType , base : string , pattern : #([A-Fa-f0-9]{6}) |
| border-color-left | A color representation in HTML RGB format | colorType , base : string , pattern : #([A-Fa-f0-9]{6}) |
| border-color-right | A color representation in HTML RGB format | colorType , base : string , pattern : #([A-Fa-f0-9]{6}) |
| border-width | The size of the border | borderWidthType , base : int , minInclusive : 0 , maxInclusive : 32 |
| border-width-top | The size of the border | borderWidthType , base : int , minInclusive : 0 , maxInclusive : 32 |
| border-width-bottom | The size of the border | borderWidthType , base : int , minInclusive : 0 , maxInclusive : 32 |
| border-width-left | The size of the border | borderWidthType , base : int , minInclusive : 0 , maxInclusive : 32 |
| border-width-right | The size of the border | borderWidthType , base : int , minInclusive : 0 , maxInclusive : 32 |
| back-color | A color representation in HTML RGB format | colorType , base : string , pattern : #([A-Fa-f0-9]{6}) |
| fore-color | A color representation in HTML RGB format | colorType , base : string , pattern : #([A-Fa-f0-9]{6}) |
| type | Data type contained in the element | dataType , base : string , enumeration : [ string , number , date ] |
| Element : list | ||
|---|---|---|
| A list in the document (roughly comparable to a HTML 'ul' pr 'ol' element) | ||
| Attribute | Description | Note |
| id | An element id (should be unique in the document) | idType , base : string , minLength : 1 , maxLength : 64 |
| list-type | The type fo the list ( 'uld' - unordered with dots, 'ulm' - unordered with mius, 'oln' - ordered with numbers, 'uld' - ordered with letters ) | listType , base : string , enumeration : [ ul , uld , ulm , ol , oln , oll ] |
| Element : li | ||
|---|---|---|
| A item of a list (roughly comparable to a HTML 'li' element) | ||
| Attribute | Description | Note |
| id | An element id (should be unique in the document) | idType , base : string , minLength : 1 , maxLength : 64 |
| Element : pl | ||
|---|---|---|
| A phrase list contained in a list item | ||
| Attribute | Description | Note |
| This element does not have attributes | ||
| Element : image | ||
|---|---|---|
| An image to include in the document (roughly comparable to a HTML 'image' element) | ||
| Attribute | Description | Note |
| url | Valid values are : cl://pathinjar (Path inside the class loader, safest way to load the image) http://imageurl (but generating machine should be able to access the url) file://imagepath (Path should be absolute, but you can use, for instance, free marker templating to make it more generic.) In case of base64 just provide the type (png,jpg etc.) | urlType , base : string , minLength : 0 , maxLength : 2048 |
| type | The type of the image | imageType , base : string , enumeration : [ png , jpg , gif , svg ] |
| scaling | The scaling percentage (can be higher than 100) | scalingType , base : int , minInclusive : 1 |
| base64 | Base 64 representation of a resource | base64Type , base : base64Binary |
| alt | Alternate description of the element | altType , base : string , minLength : 0 , maxLength : 2048 |
| align | Horizontal alignment of the element | alignType , base : string , enumeration : [ center , right , left , justify , justifyall ] |
| Element : phrase | ||
|---|---|---|
| A phrase of the document (roughly comparable to a HTML 'span' element) | ||
| Attribute | Description | Note |
| id | An element id (should be unique in the document) | idType , base : string , minLength : 1 , maxLength : 64 |
| font-name | The name of the font to use | fontNameType , base : string , minLength : 1 , maxLength : 64 |
| style | Font style of the element | styleType , base : string , enumeration : [ normal , bold , underline , italic , bolditalic ] |
| leading | The leading between lines | leadingType , base : decimal , minInclusive : 0 , maxInclusive : 2048 |
| size | The size of the font to use | fontSize , base : int , minInclusive : 0 , maxInclusive : 256 |
| link | string | |
| white-space-collapse | Value is 'true' if the white spaces must be trimmed | whiteSpaceCollapsType , base : boolean |
| anchor | string | |
| Element : nbsp | ||
|---|---|---|
| Simple spacing (roughly comparable to a HTML 'nbsp' entity) | ||
| Attribute | Description | Note |
| length | The length of the spacing | lengthType , base : int , minInclusive : 1 |
| Element : br | ||
|---|---|---|
| A line break (roughly comparable to a HTML 'br' element) | ||
| Attribute | Description | Note |
| This element does not have attributes | ||
| Element : barcode | ||
|---|---|---|
| Create a barcode (this element is kept for compatibility, but it's better to generate barcode as images) | ||
| Attribute | Description | Note |
| size | The size of the font to use | fontSize , base : int , minInclusive : 0 , maxInclusive : 256 |
| type | string | |
| text | Alternate description of the element | altType , base : string , minLength : 0 , maxLength : 2048 |
| Element : h | ||
|---|---|---|
| A document heading (roughly comparable to a HTML 'h1', 'h2' etc. element) | ||
| Attribute | Description | Note |
| id | An element id (should be unique in the document) | idType , base : string , minLength : 1 , maxLength : 64 |
| style | Font style of the element | styleType , base : string , enumeration : [ normal , bold , underline , italic , bolditalic ] |
| align | Horizontal alignment of the element | alignType , base : string , enumeration : [ center , right , left , justify , justifyall ] |
| font-name | The name of the font to use | fontNameType , base : string , minLength : 1 , maxLength : 64 |
| leading | The leading between lines | leadingType , base : decimal , minInclusive : 0 , maxInclusive : 2048 |
| back-color | A color representation in HTML RGB format | colorType , base : string , pattern : #([A-Fa-f0-9]{6}) |
| fore-color | A color representation in HTML RGB format | colorType , base : string , pattern : #([A-Fa-f0-9]{6}) |
| type | Data type contained in the element | dataType , base : string , enumeration : [ string , number , date ] |
| format | Data format | formatType , enumeration : [ yyyy-MM-dd , yyyy-MM-dd hh:mm:ss , yyyy-MM-dd'T'HH:mm:ss.SSSZ , iso ] , base : string , minLength : 1 , maxLength : 128 |
| size | The size of the font to use | fontSize , base : int , minInclusive : 0 , maxInclusive : 256 |
| text-indent | Text indentation (currently ignored) | textIndentType , base : decimal , minInclusive : 0 , maxInclusive : 2048 |
| space-before | The spacing of the element (possibly in a given direction) | spaceType , base : decimal , minInclusive : 0 , maxInclusive : 2048 |
| space-after | The spacing of the element (possibly in a given direction) | spaceType , base : decimal , minInclusive : 0 , maxInclusive : 2048 |
| space-left | The spacing of the element (possibly in a given direction) | spaceType , base : decimal , minInclusive : 0 , maxInclusive : 2048 |
| space-right | The spacing of the element (possibly in a given direction) | spaceType , base : decimal , minInclusive : 0 , maxInclusive : 2048 |
| white-space-collapse | Value is 'true' if the white spaces must be trimmed | whiteSpaceCollapsType , base : boolean |
| head-level | The level of the headings, from 1 (most relevant) to 7 (less relevant) (roughly comparable to a HTML 'h1', 'h2' etc.) | headLevelType , base : int , minInclusive : 1 , maxInclusive : 7 |
| Element : page-break | ||
|---|---|---|
| A page break heading | ||
| Attribute | Description | Note |
| This element does not have attributes | ||