2016

Table Of Contents
encoded, and must be a valid structure in the format which the XTensions module is
expecting.
You can use hidden text in different ways by using different hidden text types. For
example, the Notes XTensions module uses the OPENPAREN and CLOSEPAREN hidden
text type. This XTensions module lets users embed user comments at particular locations
in text and view these comments can in a sticky note window. To accomplish this,
the XTensions module embeds two hidden text markers in the text, and the text of
the note goes between them. The piece of hidden text at the start of the note has the
type OPENPAREN, and the piece at the end has the type CLOSEPAREN.
<PARAGRAPH MERGE="false" PARACHAR="HARDRETURN"
PARASTYLE="001-TEXT">
<RICHTEXT MERGE="false">
The population of Iceland is 500,000,000.
</RICHTEXT>
<HIDDEN DATALEN="100" OPCODE="51434450"
OWNER="514344" TYPE="CHARACTERTYPE">
<RICHTEXT LANGUAGE="USEnglish" MERGE="false">
VGhpcyBpcyB0aGUgdGV4dCBvZiBhIENvcHlEZXNrIG5vdGU=
</RICHTEXT>
</HIDDEN>
<RICHTEXT MERGE="false">
Iceland is located north of the Equator.
</RICHTEXT>
</PARAGRAPH>
The example XML extract above shows the output from the xml namespace of text
that contains a note inserted by the Notes XT XTensions software. The note contains
"This is the text of a CopyDesk note," which is represented as
VGhpcyBpcyB0aGUgdGV4dCBvZiBhIENvcHlEZXNrIG5vdGU=. If this text is passed
back to QuarkXPress Server in a modify or construct request, the hidden text inserted
by the Notes XT XTensions software is preserved and can be read by the Notes XT
XTensions software if the project is opened in QuarkXPress.
The Custom Underline XTensions module feature also uses this approach, but also
stores the custom underline definitions in a binary data structure within the data of
the CLOSEPAREN hidden text entry:
<PARAGRAPH MERGE="false" PARASTYLE="Normal">
<RICHTEXT MERGE="false">
The population of Iceland is 500,000,000.
</RICHTEXT MERGE="false">regular text</RICHTEXT>
<HIDDEN DATALEN="0" OPCODE="51526B41"
OWNER="51526B" TYPE="OPENPAREN">
</RICHTEXT MERGE="false">text with custom underline</RICHTEXT>
<HIDDEN DATALEN="20" OPCODE="51526B21"
OWNER="51526B" TYPE="CLOSEPAREN">
<RICHTEXT MERGE="false">/////wACAAAAAKj2AAIAAABqAAU=</RICHTEXT>
</HIDDEN>
<RICHTEXT MERGE="false">regular text</RICHTEXT>
</PARAGRAPH>
The data within the RICHTEXT element inside a HIDDEN element is a Base 64-encoded
representation of the raw data that is stored within the hidden text. Considering that
hidden text in QuarkXPress can contain any type of data, and the structure of that
data is specified by the XTensions software that creates it, this method ensures that
the data can be safely represented in XML. Also, this data can be converted back into
the same raw data structure so that it can be read by the destination XTensions software.
If the content is edited, the destination XTensions software may not be able to interpret
it. Only XTensions software developers should attempt to interpret data from their
own XTensions software.
A GUIDE TO QUARKXPRESS SERVER 2016 | 137
USING QUARKXPRESS SERVER