Dossier Element (Data): Difference between revisions
No edit summary |
No edit summary |
||
| Line 39: | Line 39: | ||
|- | |- | ||
|default | |default | ||
|(Optional) Boolean – Indicates whether this dossier should be the default dossier that is pre-selected for the user when first outputting a dossier. Default: "no". | |(Optional) Boolean – Indicates whether this dossier should be the default dossier that is pre-selected for the user when first outputting a printed dossier. Default: "no". | ||
|- | |- | ||
|} | |} | ||
| Line 54: | Line 54: | ||
|} | |} | ||
===The "live" Element{{anchor|live}}=== | ===The "live" Element of "dossier_sheet"{{anchor|live}}=== | ||
The "live" element defines a [[Live Tag Expression]] for the dossier, which determines whether the dossier is shown to the user as a selection. The tag expression is compared against the tags assigned to the current actor. If the tag expression is satisfied, the dossier can be output, else it is hidden. This is ideal for situations like spellbooks that should only be shown for spellcasters. The complete list of attributes for this element is below. | The "live" element defines a [[Live Tag Expression]] for the dossier, which determines whether the dossier is shown to the user as a selection. The tag expression is compared against the tags assigned to the current actor. If the tag expression is satisfied, the dossier can be output, else it is hidden. This is ideal for situations like spellbooks that should only be shown for spellcasters. The complete list of attributes for this element is below. | ||
| Line 64: | Line 64: | ||
|} | |} | ||
===The "sheetref" Element{{anchor|sheetref}}=== | ===The "sheetref" Element of "dossier_sheet"{{anchor|sheetref}}=== | ||
The "sheetref" element specifies a sheet to be output as part of the dossier. The sequence in which the sheets are specified dictates the order in which they will be processed in the output. The complete list of attributes for this element is below. | |||
:{| class="infotable" | |||
|class="leftnormal"|sheet | |||
|Id – Specifies the unique id of the sheet to be included in the dossier output. | |||
|- | |||
|} | |||
==The "dossier_text" Element{{anchor|dossier_text}}== | |||
The "dossier_text" element defines the logic used in outputting a text-based dossier, such as a statblock. The complete list of attributes for this element is below. | |||
:{| class="infotable" | |||
|class="leftnormal"|grouping | |||
|Text – Specifies the name of the group into which this dossier should be placed for display. The groupings are used to logically organize multiple dossiers for presentation to the user, with the various groupings being sorted alphabetically. | |||
|- | |||
|styles | |||
|(Optional) Text – Specifies the output styles that are supported for this dossier. The various output styles you can specify are "plain", "html", and "bbcode". You can combine multiple styles by placing a '+' between them (e.g. "plain+bbcode"). If empty, the "plain" style is assumed. Default: Empty. | |||
|- | |||
|default | |||
|(Optional) Boolean – Indicates whether this dossier should be the default dossier that is pre-selected for the user when first outputting a text dossier. Default: "no". | |||
|- | |||
|} | |||
The "dossier_text" element also possesses child elements that describe its contents. The list of these child elements is below and must appear in the order shown. Click on the link to access the details for each element. | |||
:{| class="infotable" | |||
|class="leftnormal"|[[#live|live]] | |||
|An optional "live" element may appear as defined by the given link. This element defines a [[Live Tag Expression]] that determines whether the dossier is made available for selection. | |||
|- | |||
|[[#synthesize|synthesize]] | |||
|Zero or more "synthesize" elements may appear as defined by the given link. This element defines the [[Synthesize Script]] used to generate the text to be output. | |||
|- | |||
|} | |||
===The "live" Element of "dossier_sheet"{{anchor|live}}=== | |||
The "live" element defines a [[Live Tag Expression]] for the dossier, which determines whether the dossier is shown to the user as a selection. The tag expression is compared against the tags assigned to the current actor. If the tag expression is satisfied, the dossier can be output, else it is hidden. This is ideal for situations like spellbooks that should only be shown for spellcasters. The complete list of attributes for this element is below. | |||
:{| class="infotable" | |||
|class="leftnormal"|PCDATA | |||
|TagExpr – Specifies the code comprising the Live tag expression. | |||
|- | |||
|} | |||
===The "sheetref" Element of "dossier_sheet"{{anchor|sheetref}}=== | |||
The "sheetref" element specifies a sheet to be output as part of the dossier. The sequence in which the sheets are specified dictates the order in which they will be processed in the output. The complete list of attributes for this element is below. | The "sheetref" element specifies a sheet to be output as part of the dossier. The sequence in which the sheets are specified dictates the order in which they will be processed in the output. The complete list of attributes for this element is below. | ||
Revision as of 23:02, 3 December 2008
Context: HL Kit … Kit Reference … Data File Reference
The "dossier" Element
Dossiers represent a logical set of output for a portfolio, such as a character sheet, statblock, or even export data for use with another product. Each dossier is specified through the use of a "dossier" element. The complete list of attributes for this element is below.
id Id – Specifies the unique id of the dossier. This id is used in all references to the dossier. name Text – Public name associated with the dossier. Maximum length of 100 characters.
The "dossier" element also possesses child elements that define various facets of the dossier. The list of these child elements is below and must appear in the order shown. Click on the link to access the details for each element.
IMPORTANT! Exactly one of these child elements may be specified for each dossier. If multiple are given, a compiler error will be reported. The chosen child element dictates the type of dossier that is being defined and its characteristics.
dossier_sheet An optional "dossier_sheet" element may appear as defined by the given link. This element defines the structure of a printed dossier, such as a character sheet. dossier_text An optional "dossier_text" element may appear as defined by the given link. This element specifies text-based output, such as a statblock. dossier_export An optional "dossier_export" element may appear as defined by the given link. This element defines output that is tailored for use within another product, such as d20Pro.
The "dossier_sheet" Element
The "dossier_sheet" element defines the structure of a printed dossier, containing a collection of sheets. The complete list of attributes for this element is below.
grouping Text – Specifies the name of the group into which this dossier should be placed for display. The groupings are used to logically organize multiple dossiers for presentation to the user, with the various groupings being sorted alphabetically. default (Optional) Boolean – Indicates whether this dossier should be the default dossier that is pre-selected for the user when first outputting a printed dossier. Default: "no".
The "dossier_sheet" element also possesses child elements that describe its contents. The list of these child elements is below and must appear in the order shown. Click on the link to access the details for each element.
live An optional "live" element may appear as defined by the given link. This element defines a Live Tag Expression that determines whether the dossier is made available for selection. sheetref Zero or more "sheetref" elements may appear as defined by the given link. This element identifies a sheet to be included in the dossier output.
The "live" Element of "dossier_sheet"
The "live" element defines a Live Tag Expression for the dossier, which determines whether the dossier is shown to the user as a selection. The tag expression is compared against the tags assigned to the current actor. If the tag expression is satisfied, the dossier can be output, else it is hidden. This is ideal for situations like spellbooks that should only be shown for spellcasters. The complete list of attributes for this element is below.
PCDATA TagExpr – Specifies the code comprising the Live tag expression.
The "sheetref" Element of "dossier_sheet"
The "sheetref" element specifies a sheet to be output as part of the dossier. The sequence in which the sheets are specified dictates the order in which they will be processed in the output. The complete list of attributes for this element is below.
sheet Id – Specifies the unique id of the sheet to be included in the dossier output.
The "dossier_text" Element
The "dossier_text" element defines the logic used in outputting a text-based dossier, such as a statblock. The complete list of attributes for this element is below.
grouping Text – Specifies the name of the group into which this dossier should be placed for display. The groupings are used to logically organize multiple dossiers for presentation to the user, with the various groupings being sorted alphabetically. styles (Optional) Text – Specifies the output styles that are supported for this dossier. The various output styles you can specify are "plain", "html", and "bbcode". You can combine multiple styles by placing a '+' between them (e.g. "plain+bbcode"). If empty, the "plain" style is assumed. Default: Empty. default (Optional) Boolean – Indicates whether this dossier should be the default dossier that is pre-selected for the user when first outputting a text dossier. Default: "no".
The "dossier_text" element also possesses child elements that describe its contents. The list of these child elements is below and must appear in the order shown. Click on the link to access the details for each element.
live An optional "live" element may appear as defined by the given link. This element defines a Live Tag Expression that determines whether the dossier is made available for selection. synthesize Zero or more "synthesize" elements may appear as defined by the given link. This element defines the Synthesize Script used to generate the text to be output.
The "live" Element of "dossier_sheet"
The "live" element defines a Live Tag Expression for the dossier, which determines whether the dossier is shown to the user as a selection. The tag expression is compared against the tags assigned to the current actor. If the tag expression is satisfied, the dossier can be output, else it is hidden. This is ideal for situations like spellbooks that should only be shown for spellcasters. The complete list of attributes for this element is below.
PCDATA TagExpr – Specifies the code comprising the Live tag expression.
The "sheetref" Element of "dossier_sheet"
The "sheetref" element specifies a sheet to be output as part of the dossier. The sequence in which the sheets are specified dictates the order in which they will be processed in the output. The complete list of attributes for this element is below.
sheet Id – Specifies the unique id of the sheet to be included in the dossier output.
The "position" Element
The "position" element defines a Position Script for the sheet, which performs all the appropriate sizing and positioning of the contained layouts within the sheet. The complete list of attributes for this element is below.
PCDATA Script – Specifies the code comprising the Position script.
Example
The following example demonstrates what a "dossier" element might look like. All default values are assumed for optional attributes.
<dossier id="standard" name="Standard Character Sheet">
<dossier_sheet grouping="AtTop" default="yes">
<sheetref sheet="standard1"/>
<sheetref sheet="standard2"/>
</dossier_sheet>
</dossier>
