Quark XML Author 2015 October 2018 Update for Microsoft Word — System Admin Guide

Variable Reference Support

Reference Type and Section Type block level elements in Quark XML Author can now refer to variable content references.

Section Type Elements

For section type elements such as Lists, Tables, Paras and Container elements, the variable content reference attribute has been kept configurable.

The element defines the attribute that can hold variable content references. For DITA elements the attribute will be "@conkeyref“.

Example:

Configuration of the Block level element Para to be able to refer variable content references in addition to direct content references:

<ElementDef name="p" xmlname="p" friendly="Paragraph" referenceAttribute="conref"  variableReferenceAttribute="conkeyref“ style="Normal (XA Heading)" calloutAttribute="outputclass">
      <Section>
        <Para defaultHyperlink="xref@format='html'">
            ….
        </Para>
      </Section>
      <Attributes>
        <AttributeType name="conref"/>
        <AttributeType name="conkeyref"/>
        <AttributeType name="outputclass"/>
            ……
      </Attributes>
</ElementDef>

Reference Type Elements

For Reference Type Elements, such as DITA Topic Refs, keyref has been assumed as the variable reference attribute and “href” for direct referencing. The serialized name, however, is still configurable.

Example:

<ElementDef name="refLabel" xmlname="refLabel">
            <Reference>
                        <ComponentType name="reftitle" style="XA_Body Text Indent"
                                    excludeFromComponentContextMenu="true" xpath="//title[1]"/>
            </Reference>
            <Attributes>
                        <AttributeType name="format" fixed="dita"/>
                        <AttributeType name="navtitle" friendly="Title"/>                                       
                                                <AttributeType name="href" visible="false"/>
                                                <AttributeType name="keyref" visible="false"/>
            </Attributes>
</ElementDef>

Additional delegates

The following new delegates have been exposed to allow EIs to add and manage the reference variables for a Quark XML Author document.

  • AssignRefVariable

  • GetRefVariable

  • GetAllRefVariables

  • GetExportedXMLForRefVariables

  • RemoveRefVariable

The Quark XML Author Reference Resolution Engine now honors these variables while resolving variable content references. The reference resolution gives preference to Variable references (if the variables are defined) over direct references.