About Arbortext Styler > Arbortext Styler Window and Editors > Breaks Category > Breaks Category - HTML Chunking
  
Breaks Category - HTML Chunking
The HTML chunking sub-category provides options for classing an element as a chunk boundary, at which the document will break when publishing chunked HTML output (EPUB, HTML Help, and Web formats). You can also set a persistent filename for the chunk created from the element and its content.
The following table describes the properties on the HTML chunking sub-category.
* 
The properties in this category are unavailable if
the stylesheet is destined for non-chunked HTML outputs, i.e. if the Outputs to edit field is set to a value other than Base (All Outputs), HTML Help, Web, or EPUB.
the Element HTML chunking properties option in the HTML tab of the Stylesheet Properties dialog box has not been checked.
Property
Description
Default Value
HTML chunking properties
Chunk boundary
Specifies whether the element acts as a chunk boundary. The available options are Yes, No, and <Derive>. When the field is set to <Derive>, and the value can be resolved, a tool tip for the field describes the origin of the chunk boundary setting and the shortcut menu lists the locations in the derivation chain. If you choose a location from the derivation chain you will be taken to the required location in the Elements list, without having to exit the HTML Chunking dialog box.
The label of this field will be displayed in blue text if the field contains an explicit setting. Settings made in this field for an individual element interact with chunk boundary settings made for the stylesheet in the HTML tab of the Stylesheet Properties dialog:
When the Element HTML chunking properties option in the HTML tab of the Stylesheet Properties dialog box is checked, chunk boundaries will be created based on the settings made for each individual element in the document via this Chunk boundary field. Settings made for the element in this field will be disregarded if Element HTML chunking properties is not checked in the Stylesheet Properties dialog box.
Explicit settings made here take precedence over any DITA chunk boundary setting identified for the element with the activation of the DITA topic file boundaries setting in the HTML tab of the Stylesheet Properties dialog box. When there is not an explicit setting for the element in this field, and if one does not exist in the entire derivation chain, the activation of the DITA topic file boundaries option will determine the chunk boundary for the element, otherwise the element will not form a chunk boundary.
Persistent file name
Defines the filename for the chunk created from the element and its content, if the element has been identified as a chunk boundary. The available options are Yes, No, and <Derive>. When the field is set to <Derive>, and the value can be resolved, a tool tip for the field describes the origin of the filename setting and the resolved value is displayed in either the From attribute or the From XPath field, depending on the way in which it was extracted originally.
When the field is set to Yes, the From attribute and From XPath controls are activated, allowing you to define the object from which the filename should be extracted:
When this field is set to No, the publishing process will generate filenames for the chunks based on their hierarchy within the document. For DITA documents, this means that persistent filenames is supplied by the DITA composition pipeline, based on source topic filenames.
From attribute - select this option to indicate that the chunk's filename will be extracted from one of the element's attributes. Enter the attribute name manually or select it from the drop down menu. Note that, if you enter an invalid attribute name here, Arbortext Styler will display an error message when you click OK to exit the dialog box.
From XPath - select this option to indicate that the chunk's filename will be extracted from a specified location. Enter an XPath expression in the field - note that, if you enter an invalid XPath expression here, Arbortext Styler will display an error message when you click OK to exit the dialog box.
* 
If you enter the name of a namespaced element in this field, you will not be prompted to declare the namespace if it does not already exist. Ensure you have declared the namespace for the stylesheet by creating an element with the applicable prefix, or the XPath expression you enter in this field will not be valid
This field and its controls will be disabled if the Chunk boundary field is set to No. The From attribute and From XPath fields are disabled if the Persistent filename field is set to No, regardless of the setting in the Chunk boundary field.
The label of this field will be displayed in blue text if the field contains an explicit setting.