9.5

Table Of Contents
ID + the unique ID (more often than not, 1) + the sum of types of paren you wish to see
(for example, to see OPENPAREN and CLOSEPAREN, you would calculate 0x20 + 0x40 =
0x60). For example, if you wanted to get only hidden text from the Custom Underline
XTensions module, you would pass the request with the additional request parameter
opcode=51526B61. The data you receive in the deconstructed hidden text is a base64
encoded version of the binary data which is stored in the hidden text. To interpret this,
you must know the data structure which the XTension uses. Similarly, when you pass data
back to an XTensions module through a modify or construct request, the data passed
in the <HIDDEN> element must be base-64 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>
142 | A GUIDE TO QUARKXPRESS SERVER 9.5
USING QUARKXPRESS SERVER