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.
