2015

Table Of Contents
The structure of a hidden text marker
In Modifier XML, hidden text is represented by the HIDDEN element. By default, hidden
text is not output from the xml namespace. To output hidden text, specify the opcode=
parameter in your request, like so:
http://server:port/xml/projectname.qxp?opcode=51434450
This example URL outputs all of the hidden text inserted by the XTensions software
with this ID. To avoid byte order issues when cross-platform rendering is enabled, the
XTID is represented decimally, rather than with the usual char[4] representation.
If you specify opcode=*, QuarkXPress Server returns all hidden text in the XML output.
If you want only specific opcodes for a particular developer ID, you must pass the
developer 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=
A GUIDE TO QUARKXPRESS SERVER 2015 | 137
USING QUARKXPRESS SERVER