Configuration

Configuration manual for PageSeeder

PSML document labeling

This article describes how to use the <labeling> element in the PSML document-config.xml file to control what labels are available in PSML documents.

It follows the structure below:

<labeling [override="true"]>
  <labels type="..." ... />*
</labeling>

The valid label types are "content-block", "content-inline", "xref", "edit-note", "document".

Behavior

By default, the labels configuration extends the default configuration so that labels defined here are added to the project labels. To override the labels configuration, use the @override boolean attribute.

If the <labeling> element is not defined or the document-config.xml doesn't exist, the labels are automatically inherited from the project labels.

Details

Each <labels> element should define:

AttributeDescription
typeThe type of label to define ("content-block", "content-inline", "xref", "edit-note", "document")

Each <labels> element can have one or more <label> elements which define:

AttributeDescription
nameThe name of the label
descriptionA description for this label (optional)
fragmenttypesA comma separated list of fragment types to restrict the label to - does not apply to type="document"  (optional)
colorThe color of the label in the document view (optional - only applies to type "content-block" or "content-inline" ) - can be black, navy, blue, green, yellow, orange, pink or purple.

Example

<labeling>
  <labels type="content-block">
    <label name="deprecated" description="Feature no longer supported"/>
    <label name="note"       description="Displayed in a special box"/>
    <label name="warning"    description="Big and red"
           fragmenttypes="outcome,question"/>
  </labels>
  <labels type="content-inline">
    <label name="parameter" description="A function parameter"/>
  </labels>
  <labels type="xref">
    <label name="glossary" description="Link to a glossary item"
           fragmenttypes="question"/>
  </labels>
  <labels type="edit-note">
    <label name="spelling" description="Spelling correction"/>
  </labels>
  <labels type="document">
    <label name="important" description="An important document"/>
  </labels>
</labeling>

Created on , last edited on