2017

Table Of Contents
USING QUARKXPRESS SERVER
A Guide to QuarkXPress Server 2017 | 155
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”>