Quark QuarkXPress Server - 10.1 Operation Manual
A Guide to QuarkXPress
Server 10.1
CONTENTS
Contents
Conventions..................................................................................9
Getting started with QuarkXPress Server.................................10
QuarkXPress Server architecture....................................................................10
Understanding QuarkXPress Server...............................................................10
Server templates and static projects.......................................................................11
The document pool and the Streaming Document Provider..................................11
Projects and layouts................................................................................................12
Job Jackets and resources......................................................................................12
Caching...................................................................................................................13
QuarkXPress Server preferences.............................................................................13
Quark License Administrator...................................................................................13
Master-renderer environment.................................................................................13
Changing logging levels in "log4j.xml"..................................................................14
Understanding QuarkXPress Server XTensions software...............................15
The QuarkXPress Server XTensions API..................................................................15
Configuring QuarkXPress Server for launch...................................................16
Launching QuarkXPress Server.......................................................................16
Quitting QuarkXPress Server..........................................................................17
The QuarkXPress Server user interface.....................................18
Navigation pane..............................................................................................18
Administration menu.......................................................................................20
General Preferences dialog box..............................................................................20
Renderer Preferences dialog box............................................................................23
Job Jackets dialog box...........................................................................................31
App Studio preferences..........................................................................................32
Check Out License dialog box................................................................................32
Using QuarkXPress Server.........................................................33
Creating URL requests....................................................................................33
Understanding URL requests...................................................................................34
Understanding QuarkXPress Server namespaces...................................................34
Understanding QuarkXPress Server parameters.....................................................35
Supported interfaces.......................................................................................35
The Dynamic Publishing Process (DPP)...........................................................36
Getting started................................................................................................36
Getting started: HTTP and HTTPS..........................................................................36
ii | A GUIDE TO QUARKXPRESS SERVER 10.1
CONTENTS
Getting started: Web services.................................................................................41
QXP Server Manager...............................................................................................49
Using the Web interface..................................................................................49
Understanding rendering........................................................................................50
Understanding logging...........................................................................................51
Understanding render types...................................................................................51
Understanding render modifiers.............................................................................73
Using content modifiers..........................................................................................82
Using XML modify...................................................................................................89
Using XML deconstruct and construct..................................................................106
Creating and using hyperlinks...............................................................................141
Using the Streaming Document Provider..............................................................142
Using administrative request handlers..................................................................143
Using the QXPSM SDK..................................................................................163
Writing a Java QXPSM client................................................................................163
Writing a .NET QXPSM client................................................................................165
Writing an Objective-C client for Mac OS or iOS..................................................167
Extending QuarkXPress Server Manager..............................................................170
Sample applications.......................................................................................175
Sample applications: QXP Server Manager..........................................................175
Sample applications legal notice..........................................................................177
QuarkXPress Server Features..................................................185
Dynamic Pagination and Flow.......................................................................185
Dynamic Pagination and Flow Problem................................................................186
Dynamic Pagination and Flow Solution.................................................................187
Landscape pagination....................................................................................190
Modifier schema (annotated)....................................................194
Entities (Modifier DTD).................................................................................194
ADDCELLS (Modifier schema).......................................................................196
ALIGNHORSETTINGS (Modifier schema)......................................................197
ALIGNVERSETTINGS (Modifier schema).......................................................198
ALLOWBOXOFFPAGE (Modifier schema).....................................................198
ALLOWBOXONTOPASTEBOARD (Modifier schema)....................................198
ANCHOREDBOXREF (Modifier schema).......................................................199
ARTICLE (Modifier schema)...........................................................................200
AUTHOR (Modifier schema)..........................................................................200
BNSTYLE (Modifier schema)..........................................................................200
BOTTOM (Modifier schema)..........................................................................201
BOTTOMGRID (Modifier schema).................................................................201
BOX (Modifier schema).................................................................................202
BOXATTRIBUTE (Modifier schema)...............................................................204
BOXREF (Modifier schema)...........................................................................205
CALLOUTANCHOR (Modifier schema)..........................................................206
A GUIDE TO QUARKXPRESS SERVER 10.1 | iii
CONTENTS
CALLOUTBOXREF (Modifier schema)...........................................................206
CELL (Modifier schema).................................................................................206
CHILDID (Modifier schema)...........................................................................208
CLIPPING (Modifier schema).........................................................................208
COLGROUP (Modifier schema)......................................................................211
COLSPEC (Modifier schema).........................................................................211
COLUMN (Modifier schema).........................................................................211
COMPONENT (Modifier schema)..................................................................212
COMPOSITIONZONE (Modifier schema)......................................................214
CONDITIONALMASTERPAGEREFERENCE (Modifier schema).....................216
CONTENT (Modifier schema)........................................................................216
CONTENTPH (Modifier schema)...................................................................217
CONTINUEDHEADER (Modifier schema)......................................................218
CONTINUEDTROWSTYLE (Modifier schema)................................................218
CONTOUR (Modifier schema).......................................................................219
CONTOURS (Modifier schema).....................................................................219
COPYFIT (Modifier schema)..........................................................................220
COPYRIGHT (Modifier schema).....................................................................220
DATAPROVIDER (Modifier schema)..............................................................220
DEL (Modifier schema)..................................................................................221
DELETECELLS (Modifier schema)..................................................................221
DESCRIPTION (Modifier schema)..................................................................221
DROPCAP (Modifier schema)........................................................................222
EBOOKMETADATA (Modifier schema).........................................................222
ENTRY (Modifier schema)..............................................................................222
EVENTCOLSTYLE (Modifier schema)............................................................223
EVENTROWSTYLE (Modifier schema)...........................................................223
FIRSTTCOLSTYLE (Modifier schema).............................................................224
FIT (Modifier schema)....................................................................................224
FITTEXT (Modifier schema)...........................................................................225
FOOTER (Modifier schema)...........................................................................226
FOOTERTROWSTYLE (Modifier schema).......................................................226
FORMAT (Modifier schema)..........................................................................227
FRAME (Modifier schema).............................................................................229
GEOMETRY (Modifier schema)......................................................................230
GRID (Modifier schema)................................................................................231
GRIDLINE (Modifier schema).........................................................................231
GROUP (Modifier schema)............................................................................232
GROUPCHARACTERS (Modifier schema)......................................................233
GROWACROSS (Modifier schema)................................................................234
GROWDOWN (Modifier schema)..................................................................234
HEADER (Modifier schema)...........................................................................234
HEADTROWSTYLE (Modifier schema)...........................................................234
HEIGHT(Modifier schema).............................................................................235
HIDDEN (Modifier schema)...........................................................................235
HYPERLINK (Modifier schema)......................................................................236
iv | A GUIDE TO QUARKXPRESS SERVER 10.1
CONTENTS
ID (Modifier schema).....................................................................................237
INLINEBOX (Modifier schema)......................................................................237
INLINETABLE (Modifier schema)...................................................................239
INS (Modifier schema)...................................................................................239
INSET (Modifier schema)...............................................................................239
INTERACTIVITY (Modifier schema)...............................................................240
ISBN (Modifier schema).................................................................................241
KEEPLINESTOGETHER (Modifier schema)....................................................241
KEYWORDS (Modifier schema).....................................................................241
LASTTCOLSTYLE (Modifier schema)..............................................................241
LAYER (Modifier schema)..............................................................................242
LAYOUT (Modifier schema)...........................................................................243
LAYOUTREF (Modifier schema).....................................................................244
LEFT (Modifier schema).................................................................................245
LEFTCONTROLPOINT (Modifier schema)......................................................245
LEFTGRID (Modifier schema)........................................................................245
LINESTYLE (Modifier schema).......................................................................246
LINKEDBOX (Modifier schema).....................................................................247
LIST (Modifier schema)..................................................................................248
LOCATION (Modifier schema).......................................................................248
LOCKTOGRID (Modifier schema)..................................................................248
MASTERPAGESEQUENCE (Modifier schema)...............................................249
MAX (Modifier schema).................................................................................249
METADATA (Modifier schema).....................................................................249
MIN (Modifier schema)..................................................................................249
MOVEDOWN (Modifier schema)...................................................................250
MOVELEFT (Modifier schema)......................................................................250
MOVERIGHT (Modifier schema)....................................................................250
MOVEUP (Modifier schema)..........................................................................250
NOTE (Modifier schema)...............................................................................250
ODDTROWSTYLE (Modifier schema)............................................................251
ODDTCOLSTYLE (Modifier schema)..............................................................251
ORIGIN (Modifier schema)............................................................................252
OVERMATTER (Modifier schema).................................................................252
PAGE (Modifier schema)...............................................................................252
PAGEBREAK (Modifier schema)....................................................................253
PAGEREF (Modifier schema).........................................................................254
PAGESEQUENCE (Modifier schema).............................................................254
PARAGRAPH (Modifier schema)...................................................................256
PARENTTABLE (Modifier schema).................................................................257
PICTURE (Modifier schema)...........................................................................257
PLACEHOLDER (Modifier schema)................................................................260
POSITION (Modifier schema)........................................................................260
PROJECT (Modifier schema)..........................................................................260
PUBLICATION (Modifier schema)..................................................................261
PUBLICATIONCHANNEL (Modifier schema).................................................262
A GUIDE TO QUARKXPRESS SERVER 10.1 | v
CONTENTS
PUBLISHER (Modifier schema)......................................................................262
RELPOSITION (Modifier schema)..................................................................262
REPEATABLEMASTERPAGEALTERNATIVES (Modifier schema)...................262
REPEATABLEMASTERPAGEREFERENCE (Modifier Schema).......................263
RGBCOLOR (Modifier schema)......................................................................263
RICHTEXT (Modifier schema)........................................................................264
RIGHT (Modifier schema)..............................................................................272
RIGHTCONTROLPOINT (Modifier schema)...................................................272
RIGHTGRID (Modifier schema)......................................................................273
ROW (Modifier schema)................................................................................273
RUBI (Modifier schema).................................................................................275
RUBITEXT (Modifier schema)........................................................................275
RULE (Modifier schema)................................................................................276
RUNAROUND (Modifier schema)..................................................................278
SAVEAS (Modifier schema)...........................................................................280
SCALETO (Modifier schema).........................................................................281
SECTION (Modifier schema)..........................................................................282
SECTIONNUMBERFORMAT (Modifier schema)............................................282
SHADOW (Modifier schema).........................................................................282
SHRINKACROSS (Modifier schema)..............................................................284
SHRINKDOWN (Modifier schema)................................................................285
SINGLEMASTERPAGEREFERENCE (Modifier schema).................................285
SIZE (Modifier schema)..................................................................................285
SPINEIMAGE (Modifier schema)...................................................................286
SPLINESHAPE (Modifier schema)..................................................................286
SPREAD (Modifier schema)...........................................................................287
STACKINGORDER (Modifier schema)...........................................................287
STATICCONTENT (Modifier schema)............................................................287
STORY (Modifier schema)..............................................................................288
SUPPRESSOUTPUT (Modifier schema)..........................................................289
TAB (Modifier schema)..................................................................................289
TABLE (Modifier schema)..............................................................................289
TABLEBREAK (Modifier schema)...................................................................291
TABLESTYLE (Modifier schema)....................................................................292
TABSPEC (Modifier schema)..........................................................................292
TBODY (Modifier schema).............................................................................292
TCOL (Modifier schema)................................................................................293
TCOLSTYLE (Modifier schema)......................................................................293
TCONTINUED (Modifier schema)..................................................................293
TEXT (Modifier schema)................................................................................294
TEXTATTRIBUTE (Modifier schema)..............................................................295
TEXTNODEPH (Modifier schema).................................................................295
TEXTPH (Modifier schema)............................................................................296
TFOOT (Modifier schema).............................................................................297
THEAD (Modifier schema).............................................................................297
TITLE (Modifier schema)................................................................................297
vi | A GUIDE TO QUARKXPRESS SERVER 10.1
CONTENTS
TOP (Modifier schema)..................................................................................297
TOPGRID (Modifier schema).........................................................................297
TROW (Modifier schema)..............................................................................298
TROWSTYLE (Modifier schema)....................................................................299
VALUE (Modifier schema).............................................................................299
VERTEX (Modifier schema)............................................................................300
VERTEXPOINT (Modifier schema).................................................................300
VERTICES (Modifier schema).........................................................................301
WIDTH (Modifier schema).............................................................................301
Using SSL..................................................................................302
Secure Sockets Layer (SSL) support..............................................................302
Enabling SSL..........................................................................................................302
Enabling HTTP and HTTPS....................................................................................303
Verifying and using SSL.........................................................................................303
Keystores and SSL certificates...............................................................................303
QuarkXPress Server XTensions software.................................304
CopyDeskArticle XTensions software...........................................................304
Rendering articles..................................................................................................304
Exporting articles...................................................................................................304
Adding articles to projects....................................................................................305
Creating and deleting components......................................................................305
PDF Filter XTensions software......................................................................306
Modifier XTensions software........................................................................306
Using Modifier XTensions software.......................................................................307
Creating XML for Modifier XTensions software....................................................307
Layer XTensions software.............................................................................308
App Studio XTensions software....................................................................308
Telegraph XTensions software.................................................310
Setting Telegraph preferences......................................................................310
Specifying a server for template upload...............................................................311
Using Telegraph XTensions software............................................................312
Identifying QuarkXPress items and groups...........................................................312
Naming items and groups.....................................................................................313
Uploading templates.............................................................................................313
Uploading missing or modified pictures...............................................................315
QuarkXPress Server Manager..................................................316
Understanding QuarkXPress Server Manager..............................................316
Load balancing......................................................................................................316
Request timeout interval.......................................................................................317
Determining QuarkXPress Server instance availability..........................................318
Logging with QXP Server Manager.......................................................................318
A GUIDE TO QUARKXPRESS SERVER 10.1 | vii
CONTENTS
Caching.................................................................................................................319
Web services.........................................................................................................319
Working with QuarkXPress Server Manager................................................319
Starting QuarkXPress Server Manager..................................................................320
Request handler binding.......................................................................................321
Configuring QuarkXPress Server instances...........................................................321
Managing the cache..............................................................................................325
Managing logs.......................................................................................................327
Using a proxy server..............................................................................................330
Generating automatic e-mail messages................................................................330
Using other global settings...................................................................................331
Saving a server configuration................................................................................332
Using custom error messages...............................................................................333
Sending requests from a browser.........................................................................334
The XTensions Developer Kit (XDK).........................................336
Glossary....................................................................................337
Legal notices.............................................................................338
viii | A GUIDE TO QUARKXPRESS SERVER 10.1
Conventions
Formatting conventions highlight information to help you quickly find what you
need.
• Bold type style: The names of all dialog boxes, fields, and other controls are set in bold
type. For example: "Click OK."
• References: In descriptions of features, parenthetical references guide you in accessing
those features. For example: "The Find/Change dialog box (Edit menu) lets you find
and replace text."
CONVENTIONS
• Arrows: You will often see arrows (>), which map out the menu path to a feature. For
example: "Choose Edit > Style Sheets to display the Style Sheets dialog box."
• Icons: Although many tools and buttons are referenced by name, which you can see
by displaying ToolTips, in some cases icons are shown for easy identification. For
example, "Click the button on the Measurements palette to center text."
• Cross-platform issues: This application is quite consistent across operating systems.
However, some labels, buttons, key combinations, and other aspects of the application
must differ between Mac OS® and Windows® because of user interface conventions
or other factors. In such cases, both the Mac OS and Windows versions are presented,
separated by a slash, with the Mac OS version presented first. For example, if the
Mac OS version of a button is labeled Select, and the Windows version is labeled
Browse, you are directed to "Click Select/Browse." More complex cross-platform
differences are mentioned in notes or parenthetical statements.
A GUIDE TO QUARKXPRESS SERVER 10.1 | 9
GETTING STARTED WITH QUARKXPRESS SERVER
Getting started with
QuarkXPress Server
QuarkXPress Server lets you render QuarkXPress projects in a variety of formats.
QuarkXPress Server architecture
The QuarkXPress Server architecture is shown in the following diagram.
QuarkXPress Server architecture diagram
Understanding QuarkXPress Server
QuarkXPress Server lets you output customized QuarkXPress layouts in a variety of
formats — including JPEG, Portable Document Format (PDF), and PostScript® — from
a centralized QuarkXPress Server application. To send a request to a QuarkXPress Server
10 | A GUIDE TO QUARKXPRESS SERVER 10.1
GETTING STARTED WITH QUARKXPRESS SERVER
application, all you need to do is enter a URL into your Web browser's address field.
For example, the following URL instructs the QuarkXPress Server application named
"QXPServer" to return the file "MyProject.qxp" as a PDF file:
http://QXPServer:8080/pdf/MyProject.qxp
The QuarkXPress Server application receives these requests, renders (creates) the
requested projects in the requested formats, and then returns the rendered file to the
client application (in this case, the Web browser).
The format of QuarkXPress Server URL requests is described in detail in "Creating URL
requests" and in "Using QuarkXPress Server."
You can also create custom applications that communicate with a QuarkXPress Server
application using HTTP, Simple Object Access Protocol (SOAP), or another protocol.
For more information, see "Using QuarkXPress Server."
You can think of QuarkXPress Server as a special version of QuarkXPress that runs on
a server with the following main differences:
• Instead of accepting input from a keyboard and mouse, QuarkXPress Server accepts
input in the form of URLs and other types of requests.
• Instead of sending a project to a printer, QuarkXPress Server renders (creates) output
in a particular format and sends the rendered file to a client.
Server templates and static projects
QuarkXPress Server can open, render, and serve two types of projects:
• Static projects are QuarkXPress projects that can be rendered and served as-is in a variety
of formats by the QuarkXPress Server application. For example, you might make a
product manual available as a static project and allow customers to download that
manual in a variety of formats.
• Server templates are QuarkXPress projects that can be manipulated by the
QuarkXPress Server application before being rendered and served. For example, you
might make a sales piece available as a server template so that each person who
downloads it receives a personalized copy.
QuarkXPress Server can open QuarkXPress documents, projects, and templates created
in any language edition of QuarkXPress 7.0 or later. QuarkXPress Server can save and
export projects in QuarkXPress 8.x, 9.x and 10.x format.
The document pool and the Streaming Document Provider
QuarkXPress Server has two main ways to find or receive content for rendering.
• The document pool
• The Streaming Document Provider
QuarkXPress Server can read templates and static projects from a directory called the
document pool. The document pool can be any directory that is available to
A GUIDE TO QUARKXPRESS SERVER 10.1 | 11
GETTING STARTED WITH QUARKXPRESS SERVER
QuarkXPress Server through a file system or an FTP server. You can use any of the
following methods to place files in the document pool:
• Drag the files to the document pool directory.
• Use the Add Files command in the Document Pool screen of the QuarkXPress Server
Web interface.
• Upload the files using FTP to the document pool directory.
• Use Telegraph XTensions® software to upload the files to the document pool from
within QuarkXPress. (For more information about Telegraph XTensions software, see
"Telegraph XTensions software.")
For more information about the document pool, see "The QuarkXPress Server user
interface."
The document pool directory cannot be an encrypted directory.
QuarkXPress Server can also receive templates, projects, and other files as part of a
multipart HTTP request. For more information, see "Using the Streaming Document
Provider."
In addition, QuarkXPress Server can serve documents from a database, a content
management system, or other sources. Collectively, the document pool and any other
source of files to be served are referred to as document providers.
Projects and layouts
QuarkXPress projects can contain one or more layouts, and only one layout can be
rendered at any given time. If you do not specify a layout when you send a rendering
request, QuarkXPress Server renders the first layout in the project.
Job Jackets and resources
In QuarkXPress, resources are things such as style sheets, colors, H&Js, output styles,
and item styles. Resources are stored in a Job Jackets structure, which can be either
embedded in a project or stored in a separate Job Jackets file.
QuarkXPress Server uses a default Job Jackets file to make a default set of resources
available to all projects handled by QuarkXPress Server, regardless of whether they are
included in the projects and articles you render. You can update this file in two ways:
• Using the QuarkXPress Server Web interface. For more information, see "Job Jackets
dialog box."
• Using request handlers. For more information, see "Jobjacket" and "updateprefsfromjj."
Once you've downloaded the default Job Jackets file, you can update its resources using
QuarkXPress. For more information, see "Job Jackets" in A Guide to QuarkXPress.
The location of the default Job Jackets file is stored in the QuarkXPress Server
preferences folder. For more information, see "QuarkXPress Server preferences."
12 | A GUIDE TO QUARKXPRESS SERVER 10.1
Caching
To maximize efficiency, QuarkXPress Server uses cached versions of all rendered projects
whenever possible. You can configure projects so that they are never cached, so that
they are cached for a particular amount of time, or so that they are rendered every
time they are served.
QuarkXPress Server preferences
When you launch QuarkXPress Server, the application creates preferences files that
are functionally and structurally equivalent to the preferences files created by
QuarkXPress. These preferences files reside in the QuarkXPress Server "Preferences"
folder. QuarkXPress Server also creates a "QuarkXPress Server.prf" file in the "Preferences"
folder. This file contains preference settings that are specific to QuarkXPress Server.
QuarkXPress Server uses these preferences the same way QuarkXPress uses them. If an
XTensions module creates a project in QuarkXPress Server, that project draws its
settings from the QuarkXPress Server preferences just as a new QuarkXPress project
draws its settings from the QuarkXPress preferences.
Preferences files are stored in the following locations:
GETTING STARTED WITH QUARKXPRESS SERVER
•
Mac OS: [User]/Library/Preferences/Quark/QuarkXPress Server Renderer
10.0/
• Windows Vista, Windows 2008, or Windows 2008 R2 64-bit when QuarkXPress Server
is running normally or as a service under a domain user account: C:\Users\[user
name]\AppData\Roaming\Quark\QuarkXPress Server Renderer 10.0\
• Windows 2008 or Windows Vista, when QuarkXPress Server is running as a service
under a local user account:
C:\Windows\System32\config\systemprofile\AppData\Roaming\Quark\QuarkXPress
Server Renderer 10.0\
• Windows 2008 R2 64-bit, when QuarkXPress Server is running as a service under a
local user account:
C:\Windows\SysWOW64\config\systemprofile\AppData\Roaming\Quark\QuarkXPress
Server Renderer 10.0
For more information about preferences, see "Administration menu."
Quark License Administrator
To prevent unauthorized use, QuarkXPress Server requires the presence of a Quark®
License Administrator (QLA) server to launch. QuarkXPress Server follows the
configuration and control rules that are enforced by QLA. For more information about
QLA, see the QLA documentation included with QuarkXPress Server.
Master-renderer environment
Requests for project renders are stored in a connection queue. The requests in the
rendering queue can be processed by a single QuarkXPress Server application, or by a
master QuarkXPress Server application and several renderers (additional instances of
QuarkXPress Server). The master QuarkXPress Server application launches the available
number of renderers and then passes the requests in the connection queue to those
A GUIDE TO QUARKXPRESS SERVER 10.1 | 13
GETTING STARTED WITH QUARKXPRESS SERVER
renderers as they become available. The number of renderers available for launch is
determined by the number of licenses available from the QLA server.
The master QuarkXPress Server process and all of the renderers it launches share the
following elements:
• The same application preferences (each renderer has its own preferences files, but
QuarkXPress Server keeps them synchronized)
• The same document cache in memory
• The same memory cache
• The same server XTensions modules (a separate instance of each XTensions module
runs with each renderer)
• The same server document pool (if defined in the QuarkXPress Server preferences or
if a document provider is used in place of the document pool)
If a renderer unexpectedly quits, the master QuarkXPress Server restarts the renderer
without requiring any action from you.
Changing logging levels in "log4j.xml"
You can change the logging levels for QuarkXPress Server. Options include ERROR,
INFO, WARN, DEBUG, and TRACE.
•
ERROR = includes messages that indicate disrupted and failed requests.
•
INFO = includes messages that indicate the state of services.
•
WARN = includes non-critical service error messages
•
DEBUG = includes messages that indicate server resource usage.
•
TRACE = includes messages according to activity related to requests.
Refer to Java documentation for more information about logging levels.
To change logging levels:
Open the "conf" folder in your QuarkXPress Server folder.
1
Open "log4j.xml" in a text-editing application.
2
To define the logging level for QuarkXPerss Server errors, scroll to <logger
3
name=com.quark.qxps. The structure is as follows:
<logger name="com.quark.qxps">
<level value="ERROR" />
</logger>
To define the logging level for QuarkXPress Server transactions, scroll to <logger
4
name=QXPSTransactionLogger. The structure is as follows:
<logger name="com.quark.qxps" additivity="false">
<level value="INFO" />
<appender-ref ref="QxpsTransactionFileAppender" />
</logger>
14 | A GUIDE TO QUARKXPRESS SERVER 10.1
GETTING STARTED WITH QUARKXPRESS SERVER
To define the logging level for other activity, scroll to the <root>. The structure is as
5
follows:
<root>
<priority value="ERROR" />
<appender-ref ref="QxpsServerAsyncAppender" />
</root>
Save and close "log4j.xml."
6
Understanding QuarkXPress Server XTensions software
QuarkXPress Server ships with a collection of XTensions software that adds capabilities
to QuarkXPress Server. For example, PDF Export XTensions software lets
QuarkXPress Server serve content in PDF format; Modifier XTensions software lets you
retrieve, manipulate, and reconstruct XML representations of projects; and
QuarkCopyDesk® Renderer XTensions software lets you create QuarkCopyDesk articles.
Telegraph XTensions software works with QuarkXPress to allow designers to name
boxes in template files so that those boxes can be addressed by URLs.
For more information about XTensions software included with QuarkXPress Server,
see "QuarkXPress Server XTensions software" and "Telegraph XTensions software."
The QuarkXPress Server XTensions API
In addition to the XTensions modules included with QuarkXPress Server, developers
can create custom XTensions software that add features. The complete server XTensions
Application Programming Interface (API) documentation is available in the
QuarkXPress Server XTensions Developer's Kit (XDK).
As of version 8.0, the QuarkXPress Server XDK is Unicode-compliant.
The QuarkXPress Server XDK lets you create XTensions modules that provide the
following abilities:
• The ability to register request handlers
• The ability to register project providers
• The ability to register new render formats
• The ability to add items to the list of response properties, cookies, and HTTP header
items
• The ability to log messages in log files
• The ability to initiate a new transaction to be processed by the server
• The ability to completely control how projects are processed by the server
In addition, QuarkXPress Server XTensions software can register for the following basic
callbacks:
• Pre-processing
• Content loading
• Layout modification
A GUIDE TO QUARKXPRESS SERVER 10.1 | 15
GETTING STARTED WITH QUARKXPRESS SERVER
• Post-processing
• Removing slugs while running the QuarkXPress project renderer
• Analyzing the server after a transaction is complete
• Pre- and post-transaction callback
Configuring QuarkXPress Server for launch
To configure QuarkXPress Server prior to launch, open the file [QuarkXPress Server
application folder]/conf/ServerApp.properties folder) and modify it as
follows:
•
To make the server run without loading any network interface, use the -nonetwork
option with the qxpservercore.serverRendererParameters. In this mode, the
only transactions a server can run are those passed to it by another process.
• To control whether renderers are monitored, set
qxpservercore.monitorrenderers.value to true or false.
• To specify the query interval for monitoring renderers, set
qxpservercore.monitorrenderers.queryinterval.value to a value in seconds.
• To specify the number of retries for monitoring renderers, set
qqxpservercore.monitorrenderers.noofretries.value to an integer. If a
renderer process has been attempting to fulfill a request for the specified number of
retries (with the specified query interval in seconds between retries), the renderer
monitor recyles that process.
• To control how many renderers the master process launches, specify a number for
qxpserver.subrenders. Note that the number of renderers you can launch depends
on your license.
• To force the renderers to restart on a periodic basis, specify a value in hours for
qxps.render.recycle.interval. The default value is 24, or 24 hours. Decimal
values are permitted. Renderers restart serially, so one renderer doesn't restart until
the other is finished restarting. If a renderer is busy, the master process waits for 15
minutes, and then if the renderer is till busy, postpones the restart until the next
interval elapses. Set this value to zero to turn the automatic restart feature off.
Launching QuarkXPress Server
On Windows, you can install QuarkXPress Server as an application or as a service
(Quark recommends that you always run it as a service). On Mac OS, QuarkXPress
Server always runs as an application.
If you install QuarkXPress Server on Windows as an application, you can launch it
using the Start menu or by double-clicking the "ServerStartup.bat" in the QuarkXPress
Server application folder.
If you want to launch QuarkXPress Server as an application on Windows Server 2008
Quark recommends executing "ServerStartup.bat" as an administrator.
16 | A GUIDE TO QUARKXPRESS SERVER 10.1
For information on launching QuarkXPress Server in a separate Tomcat installation,
see "Deploying QuarkXPress Server externally" in the QuarkXPress Server ReadMe.
QuarkXPress Server offers a browser-based user interface instead of a conventional user
interface.
Quitting QuarkXPress Server
To quit QuarkXPress Server, press Control+C.
GETTING STARTED WITH QUARKXPRESS SERVER
A GUIDE TO QUARKXPRESS SERVER 10.1 | 17
THE QUARKXPRESS SERVER USER INTERFACE
The QuarkXPress Server user interface
QuarkXPress Server offers a browser-based user interface instead of a conventional user
interface. This chapter describes that interface and explains how you can use it to
configure and customize your QuarkXPress Server application and manage your server
XTensions modules.
To view the QuarkXPress Server welcome page, launch a Web browser and enter the
URL http://[server]:[port] (where [server] is the IP address or domain name
of the server and [port] is the TCP/IP port on which the server is running). The
welcome screen displays.
The QuarkXPress Server welcome page
To display the administrative client, click Open Admin Client. If the server has realm
verification enabled, you will be asked to enter your user name and password. The
administrative client displays.
Navigation pane
The navigation pane on the left side of the has two areas. The Server Information
area lets you view server information and the transaction log, and the Document Pool
area lets you view the contents of the document pool. You can collapse and expand
this pane with the button at the right end of the Navigation Pane header.
If you click Server Information, the Status Monitor screen displays. The fields in the
top area provide information about the server. The icons in the area below represent
the renderers that are currently running and show which requests are being processed
by each renderer in real time. This screen also shows how many active and idle renderers
there are.
18 | A GUIDE TO QUARKXPRESS SERVER 10.1
THE QUARKXPRESS SERVER USER INTERFACE
Status Monitor screen
If you click Manage Logs, the Logs screen displays the current transaction log.
Logs screen
• To download the active log, including recent crash reports, click Download Logs at
the top of the Logs header.
• To make the log scroll automatically as events occur, check Auto Scroll.
• To clear all logs, click Clear All Logs.
• To clear the current log, click Clear Log.
• To display the Log Settings dialog box, click Log Settings. In this dialog box, you can
change the maximum log file size, the maximum rolling count, and the logging level
for the general QuarkXPress Server log, the QuarkXPress Server transaction log, and
the QuarkXPress Server fatal log.
• To view a particular log file, choose an option from the Select Log File drop-down
menu.
If you click Show XTensions Information, the XTensions Information screen displays,
allowing yout o view the status of all installed XTensions modules.
If you click Manage Fonts, a list of fonts installed on the Server machine is displayed.
A GUIDE TO QUARKXPRESS SERVER 10.1 | 19
THE QUARKXPRESS SERVER USER INTERFACE
Fonts screen
To search fonts, use the list search box in the top right corner.
To add fonts to the Server machine, click the Add Fonts button. This will copy the
fonts to the "privatefonts" folder in the QuarkXPress Renderer folder.
Administration menu
The administration menu lets you manage QuarkXPress Server.
You do not have to restart the server in GUI mode to set preferences.
General Preferences dialog box
The General Preferences dialog box (Administration > Preferences > General) lets
you set preferences that are not related to rendering. It includes the tabs described in
the following topics.
You can also set general preferences using the setprefs request handler. For more
information, see "Setprefs."
General Preferences — Server
The Server tab (Administration > Preferences > General > Server) includes the
following controls.
Use the Document Root Folder field to specify the location of the document pool.
Putting the document pool on a network connected drive is not recommended, because
this negatively impacts the performance of QuarkXPress Server.
20 | A GUIDE TO QUARKXPRESS SERVER 10.1
THE QUARKXPRESS SERVER USER INTERFACE
Use the Allow Memory Caching check box to control whether memory is cached.
Use the Max Memory Cache Size field to specify the maximum memory size allocated
to the cache memory. Valid values are from 10MB to 1024MB.
Use the Force Served Documents Closed check box to control whether
QuarkXPress Server closes projects from the document pool after it renders them,
regardless of the Telegraph XTensions software setting. Uncheck this box to keep such
projects open on the server.
Use the Default Renderer Type drop-down menu to specify the default rendering
format for the server.
• Appstudio: Returns a .zip file containing an HTML5 App Studio article.
• Appstudio Upload: Exports an HTML5 App Studio article and uploads it to the App
Studio Publishing Portal.
• AVE: Returns a .zip file containing an AVE issue (.zave) file and its manifest.
• ePUB: Returns an ePUB file.
• EPS Document: Returns an Encapsulated PostScript (EPS) file.
• JPEG: Returns a JPEG file.
• PDF: Returns a PDF file.
• PNG: Returns a Portable Network Graphics (PNG) file.
• PostScript: Returns a PostScript file.
• QCDDOC: Returns a QuarkCopyDesk article.
• QuarkXPress Document: Returns a QuarkXPress project.
• Raw Custom: Returns a file in internal QuarkXPress format for use by server XTensions
software developers.
• RLE Raw Custom: Returns a file in internal QuarkXPress format (compressed using
Run Length Encoding) for use by server XTensions software developers.
• SWF: Returns a SWF (Flash) file.
Use the Scale field to specify the default scale percentage at which QuarkXPress Server
should render projects.
Use the Disable QXD Return check box to specify whether QuarkXPress Server can
return QuarkXPress projects to clients.
General Preferences — Log
The Log tab (Administration > Preferences > General > Log) includes the following
controls.
Use the Log Document Problems check box to specify whether to include problem
descriptions in transaction log files. The "Log" folder inside the QuarkXPress Server
application folder contains three log files:
• QuarkXPress Server Fatal Log.log: This log lists all fatal errors.
A GUIDE TO QUARKXPRESS SERVER 10.1 | 21
THE QUARKXPRESS SERVER USER INTERFACE
• QuarkXPress Server Log.log: The log for the Java process. This log contains source
code-level logging information that can be useful in troubleshooting.
• QuarkXPress Server Transaction Log.log: This log lists all transactions and all errors.
Detailed application logging is enabled for these log files only if it is enabled in the
"log4j.xml" file.
To log detailed transaction timing data, check Log Timing Data.
Logged problems include the following:
• Missing Fonts: If fonts are missing from a project that has been requested for rendering,
a one-line description of each missing font is added to the error log. If
QuarkXPress Server receives a request to render a project and does not have access to
the fonts required by the project, it uses the fonts specified in the Fonts tab of the
Preferences dialog box (Administration > Preferences > General). If these fonts are
also unavailable, QuarkXPress Server substitutes Helvetica (Mac OS) or Arial (Windows).
This behavior is the same as it is in QuarkXPress.
• Missing Pictures
• Missing SXTs: If a required server XTensions module is missing when a rendering
request is received, a one-line description of each missing module is added to the error
log. If the name of the missing module is not returnable, the XTensions module ID
number is returned.
• Text Encoding/Character Set Problems: If text is sent to a text box in the template
and the system does not have access to the correct font glyph, the issue is logged. The
log data indicates the character set that the system attempted to convert. For example,
the log entry might show that a request for Japanese characters was sent to an English
project.
Information about missing fonts and missing pictures is also recorded in the
"QuarkXPressServerRenderer.log" file. This file also contains detailed timing information,
including the transaction UID for each transaction. This log file can be found here:
•
Mac OS: [drive]/Users/[user name]/Library/Logs/Quark
•
Windows: [drive]:\Users\[user name]\AppData\Quark\Log or
[drive]:\Documents and Settings\[user name]\Application
Data\Quark\Log
To download all logs to a non-server computer, click Show Transaction Log in the
QuarkXPress Server Web interface, then click Download Logs on the home page.
General Preferences — Email
QuarkXPress Server can automatically notify someone by e-mail when the checked-out
QLA license is about to expire. The Email tab (Administration > Preferences > General
> Email) lets you specify where such e-mail messages should be sent.
Use the Server field to specify the domain name or IP address of the e-mail server that
QuarkXPress Server should use to send messages (for example, mail.quark.com).
22 | A GUIDE TO QUARKXPRESS SERVER 10.1
Use the Port field to specify the port number of the e-mail server that
QuarkXPress Server should use to send messages. Valid values are from 0 to 255.
Use the From to specify the source e-mail address the QuarkXPress Server application
should use to send messages (for example, QXPSserver1@quark.com).
Use the To to specify the e-mail address to which the QuarkXPress Server application
should send messages (for example, QXPServerAdmin@quark.com).
General Preferences — Authentication
The Authentication tab (Administration > Preferences > General > Authentication)
includes the following controls.
Check Authenticate For Admin Requests to enable the Username and Password
fields. These fields let you control access to administrative parameters and features.
You can enter up to 32 characters.
Renderer Preferences dialog box
Use the renderer Preferences dialog box (Administration > Preferences > Renderer)
to set up default preferences for use when projects are created in QuarkXPress Server.
It includes the tabs described in the following topics.
THE QUARKXPRESS SERVER USER INTERFACE
Many of these preferences come into play only when you create a project in
QuarkXPress Server, either using a construct request or through a request handled
by a custom QuarkXPress Server XTensions module.
You can also set renderer preferences using the setrendererprefs request handler.
For more information, see"Setrendererprefs."
In versions of QuarkXPress Server prior to 9.0, these resources were accessed through
the Document Controls submenu.
Preferences — Display
The Display pane (Administration > Preferences > Renderer > Display) includes the
following controls.
Use the Color TIFFs drop-down list to specify the color depth of screen previews created
for color TIFFs when they are imported.
Use the Gray TIFFs drop-down list to specify the resolution of screen previews created
for grayscale TIFFs when they are imported.
Choose a profile that corresponds to your monitor from the Monitor Profile drop-down
menu, or choose Automatic. Profiles can be placed in the "Profiles" folder in the
QuarkXPress Server application folder.
Preferences — Input Settings
The Input Settings tab (Administration > Preferences > Renderer > Input Settings)
includes the following controls.
A GUIDE TO QUARKXPRESS SERVER 10.1 | 23
THE QUARKXPRESS SERVER USER INTERFACE
Check Smart Quotes to force QuarkXPress to replace feet (')and inches (") marks
automatically with the specified quotation marks.
Use the Format drop-down menu to specify the default characters to be used with the
Smart Quotes feature and Convert Quotes option in the Get Text dialog box (File >
Get Text).
To change the separators used for indicating sequential ranges for output, enter a value
in the Sequential Page Range Separator. This value override the preferences set for
a project.
To change the separators used for indicating nonsequential ranges for output, enter
a value in the Non Sequential Page Range Separator. This value override the
preferences set for a project.
Preferences — Font Fallback
The Font Fallback pane (Administration > Preferences > Renderer > Font Fallback)
includes the following controls.
Check Font Fallback to activate the Font Fallback feature. When this feature is active,
if the application encounters a character it cannot display in the current font, it
attempts to find a font that can display the character.
If the application encounters a missing font when opening a project, it uses the
preferences in this pane to determine which substitute fonts to use.
If you add characters to an exising project and the font cannot support those characters,
the application will search the system for a font that can display the characters.
Check Search to have the application search for a suitable font that is used in the
active project. To restrict the search to a particular range, choose an option from the
Search Type drop-down menu. To search the entire story where a missing font occurs,
choose Active Story. To search a particular number of paragraphs in both directions,
choose Paragraph and enter a number in the Search Limit field.
To indicate which fallback fonts should be used when no other font can be found
(taking the Search settings into account), choose options from each of the drop-down
menus in the Font List area.
To indicate which font should be used for the slug line when a layout is printed with
registration marks turned on, choose an option from the Slug Line Font drop-down
menu.
Preferences — Open and Save
The Open and Save pane (Administration > Preferences > Renderer > Open and
Save) includes the following controls.
Choose an option from the Encoding drop-down menu to indicate how the
applications should display characters in non-Unicode text.
Preferences — Fonts
The Fonts pane (Administration > Preferences > Renderer > Fonts) includes the
following controls.
24 | A GUIDE TO QUARKXPRESS SERVER 10.1
THE QUARKXPRESS SERVER USER INTERFACE
To specify default replacement fonts, check Specify Default Replacement Font and
choose options from the Roman and East Asian drop-down menu.
To highlight characters that are in a Traditional Chinese encoding's UDA/VDA (User
Defined Area/Vendor Defined Area) range so that these characters can be visually
verified, check Highlight character ranges defined by Traditional Chinese font
vendors.
Preferences — EPS
The EPS pane (Administration > Preferences > Renderer > EPS) includes the following
controls.
To control whether the application should generate a preview of an EPS file or use the
preview (if any) embedded in the file, choose an option from the Preview drop-down
list. The option specified in this pane is used only when the EPS preview is being
created. If you change the preference, you need to reimport the EPS file.
Preferences — PDF
Use the PDF pane of the Preferences dialog box (Administration > Preferences >
Renderer > PDF) to set preferences for rendering in PDF format.
The PDF pane displays only if PDF Filter XTensions software is loaded. For more
information, see "PDF Filter XTensions software"
Use this pane to specify a PDF workflow:
• Click DirectPDF to generate PDF output in the browser. This is the default option.
• Click PDFtoFolder to generate and save PDF files to a folder. Click Select/Browse to
specify a location for the folder in the Watched Folder field.
• Click PS4D (PostScript File for Later Distilling) to generate a PostScript file. Click
Select/Browse to specify a location for the folder in the Watched Folder field.
Use this pane to set the desired PDF output style. Choose from the following output
styles:
• Default PDF Output Style
• Print - Medium Quality/Medium Resolution
• PDF/X-1a:2001
• PDF/X-3:2002
• Press - High Quality/High Resolution
• Print - Medium Quality/Medium Resolution
• Screen - Low Quality/Low Resolution
• Screen - Medium Quality/Low Resolution
Use this pane to specify the folder path for the distiller error log file. The path is used
by the PDFFilter XTension software to create the log file to log the errors that occur
during the distillation process.
A GUIDE TO QUARKXPRESS SERVER 10.1 | 25
THE QUARKXPRESS SERVER USER INTERFACE
The default path to the log file is <users>/Documents. If you choose to change the
default, the log folder specified must be a pre-existing folder on the system.
Preferences — Project General Settings
The Project General Settings pane (Administration > Preferences > Renderer >
Project General Settings) includes the following controls.
Check Use OpenType Kerning to activate the default kerning values for OpenType
fonts. When OpenType kerning is active, it overrides any kerning specified through
Kerning Table Edit (Utilities menu) for OpenType fonts.
To disable OpenType kerning for full-width characters, check Do Not Kern Full Width
Characters.
Preferences — Print Layout Settings
The Print Layout Settings pane (Administration > Preferences > Renderer > Print
Layout Settings) includes the following controls.
Use the Master Page Items drop-down menu to control what happens to master items
when master pages are applied.
• Click Keep Changes if you intend modified master items on your layout pages to
remain when a new master page is applied. The items that are kept are no longer master
items.
• Click Delete Changes if you want modified master items on your layout pages to be
deleted when a new master page is applied.
Use the Framing drop-down menu to specify whether frames are placed inside or
outside text and picture boxes.
• When you click Inside, the distance between the text and the frame is determined by
the box's Text Inset values (Item > Modify). When you place a frame inside a picture
box, the frame overlaps the picture.
• When you click Outside, the frame is placed outside the box, increasing the box's
width and height. The frame cannot extend beyond a constraining box or the
pasteboard.
Use the Auto Page Insertion drop-down menu (Print layouts only) to determine
whether pages are inserted automatically to contain text overflow from an automatic
text box or a chain of text boxes (on a page associated with a master page that contains
an automatic text box). The drop-down menu also enables you to determine where
any pages will be inserted.
Preferences — Print Layout Measurements
The Print Layout Measurements pane (Administration > Preferences > Renderer >
Default Print Layout Measurements) includes the following controls.
Use the Horizontal and Vertical drop-down menus to specify the measurement system
for the rulers displayed along the top and left of the layout window. Horizontal
corresponds to the top ruler; Vertical corresponds to the left ruler.
26 | A GUIDE TO QUARKXPRESS SERVER 10.1
THE QUARKXPRESS SERVER USER INTERFACE
Use the Points/Inch field to override the default value of 72 points per inch. The
application uses the value here as the basis for all point and pica measurements, as
well as for all point- and pica-to-inch conversions. The desktop publishing standard
for points per inch is 72. However, the traditional typographic standard used on most
metal typographic rulers is usually approximately 72.27 or 72.307 points per inch
(range = 60 to 80 pt, measurement system = points, smallest increment = .001).
Use the Ciceros/cm field to specify a ciceros-to-centimeter conversion value different
from the standard 2.1967 (range = 2 to 3 c, measurement system = ciceros, smallest
increment = .001).
Preferences — Paragraph
The Paragraph pane (Administration > Preferences > Renderer > Paragraph) includes
the following controls.
Use the Auto Leading feature to automatically set line spacing. Unlike paragraphs
with absolute leading (identical line spacing above every line), paragraphs with auto
leading may include lines with different leading when fonts and font sizes are mixed
in the same paragraph.
Auto leading starts with a base amount of leading, which the application calculates
by examining the ascent and descent values built into the fonts used in an auto-leaded
line and the line above it; however, the user-specified text size plays the largest part
in determining this base amount. Finally, a value specified by the user in the Auto
Leading field is added to the base amount to arrive at the total amount of leading.
To specify percentage-based auto leading, enter a value from 0% to 100% in 1%
increments. This value determines the amount of leading between two lines of text
as follows: The largest font size in the line above is multiplied by the percentage value.
This outcome is added to the base amount of auto leading between the two lines.
Although the design of certain fonts complicates the process, here is a simplified
example: 10-point text styled consistently in a "standard" font with Auto Leading set
to 20% has 12 points of leading (10 pts + [20% of 10] = 12 pts).
Use the Maintain Leading check box to control the placement of a line of text that
falls immediately below an obstruction in a column or box. If Maintain Leading is
checked, the line's baseline is placed according to its applied leading value. If Maintain
Leading is unchecked, the ascent of the line will abut the bottom of the obstruction
or any applied runaround value.
In the Lock to Grid Based On area:
• Click Ascent and Descent to lock text to grid based on the ascenders and descenders
of characters.
• Click Font Size (Em Box) to lock text to grid based on the size of the em boxes of the
characters.
Preferences — Character
The Character pane (Administration > Preferences > Renderer > Character) includes
the following controls.
A GUIDE TO QUARKXPRESS SERVER 10.1 | 27
THE QUARKXPRESS SERVER USER INTERFACE
Use the Superscript fields to control the placement and scale (size) of superscript
characters. The Superscript Offset value determines how far below the baseline the
application places a superscript character. The Superscript Offset value is measured
as a percentage of font size. The default value is 33%. The Superscript VScale value
determines the vertical size of the character and is a percentage of font size. The
Superscript HScale value determines width and is a percentage of the normal character
width (as specified by the font designer). The default value for both scales is 60%
(range = 0 to 100%, measurement system = percentage, smallest increment = .1).
Use the Subscript fields to control the placement and scale (size) of subscript characters.
The Subscript Offset value determines how far above the baseline the application
places a subscript character. The Subscript Offset value is measured as a percentage
of font size. The default value is 33%. The Subscript VScale value determines the
vertical size of the character and is a percentage of font size. The Subscript HScale
value determines width and is a percentage of the normal character width (as specified
by the font designer). The default value for both scales is 100% (range = 0 to 100%,
measurement system = percentage, smallest increment = .1).
Use the Small Caps fields to control the scale of characters with the Small Caps type
style applied to them. The Small Caps VScale value determines the vertical size of the
character and is measured as a percentage of font size. The Small Caps HScale value
determines width and is measured as a percentage of the normal character width (as
specified by the font designer). The default value for both scales is 75% (range = 0 to
100%, measurement system = percentage, smallest increment = .1).
Use the Superior fields to control the scale of superior characters. The Superior VScale
value determines the vertical size of the character and is measured as a percentage of
font size. The Superior HScale value determines width and is measured as a percentage
of the normal character width (as specified by the font designer). The default value
for both scales is 60% (range = 0 to 100%, measurement system = percentage, smallest
increment = .1).
Use the Ligatures Break Above field to use ligatures built into a font. A ligature is a
typographic convention in which certain characters are combined into a single glyph.
Most fonts contain ligatures for the characters "f" followed by "i" and "f" followed by
"l". The Ligatures Break Above field enables you to specify the kerning or tracking
value (measured in 1/200 em space increments) above which characters will not be
combined into ligatures. For example, a headline with a large tracking value would
probably not contain ligatures. The default value is 1 (range = 0 to 10, measurement
system = .005 [1/200] em space, smallest increment = .001). To prevent the second
two letters in "ffi" and "ffl" (as in office and waffle) from being combined into ligatures,
check Not "ffi" or "ffl". Three-character ligatures for these combinations, common in
traditional typesetting systems, are not standardized in fonts designed for Mac OS, so
some typographers prefer to keep all three letters separate rather than combine only
two of them. Note that many PostScript fonts do not have "ffi" and "ffl" ligatures, but
most OpenType fonts do. This option is unchecked by default.
Check Auto Kern to specify that the application should use kerning tables, which are
built into most fonts, to control intercharacter spacing. The Auto Kern Above field
enables you to specify the point size above which automatic kerning must be used.
The Auto Kern Above feature also implements custom tracking information specified
in the Tracking Values dialog box for a selected font (Utilities > Edit Tracking) in
28 | A GUIDE TO QUARKXPRESS SERVER 10.1
THE QUARKXPRESS SERVER USER INTERFACE
QuarkXPress. This option is checked by default, with a 4-point threshold (range = 0
to 72 pt, measurement system = various [", pt, cm, etc.], smallest increment = .001).
Check Standard Em Space to specify an em-space equivalent to the point size of the
text (for example, 24pt text has a 24pt em space). If Standard Em Space is unchecked,
the application uses the width of the two zeros in the current font as the em-space
width. This option is checked by default. You can insert an em space in text by pressing
Option+space/Ctrl+Shift+6.
Use the Flex Space Width field to change the 50% default width of a flexible space.
To create a breaking flexible space, press Option+Shift+space/Ctrl+Shift+5; to create a
nonbreaking flexible space, press Command+Option+Shift+space/Ctrl+Alt+Shift+5.
The Flex Space Width value is expressed as a percentage of the normal en space for
a given font and font size (range = 0 to 400%, measurement system = percentage,
smallest increment = .1).
Use the Accents for All Caps check box to specify whether to include accent marks
on accented characters with the All Caps type style applied. This option is checked by
default.
Use the Space between CJK & R field to indicate how much space should be included
by default between a Chinese, Japanese, or Korean character and an adjacent Roman
character.
Preferences — Trapping
The Trapping pane (Administration > Preferences > Renderer > Trapping) includes
the following controls.
Select a Trapping Method:
• Click Absolute to trap using the values in the Auto Amount and Indeterminate fields
according to the object and background colors involved. If the object color is darker,
the object is choked by the background using the Auto Amount value. If the object
color is lighter, the object is spread into the background using the Auto Amount value.
• Click Proportional to trap using the value in the Auto Amount field multiplied by
the difference between the luminance (lightness or brightness) of the object color and
the background color.
• Click Knockout All to turn off trapping and print objects with a zero trap amount.
Check Process Trapping to trap each process separation plate individually when a
page contains overlapping process colors.
Check Ignore White to specify that an object color in front of multiple background
colors (including white) does not take white into account when trapping.
Enter a trapping value in the Auto Amount field or choose Overprint:
• Enter a value in the Auto Amount field to control the amount of trapping that
QuarkXPress applies to object and background colors that have an Auto Amount
specified in the Trap Specifications dialog box (Edit > Colors > Edit Trap), and to
control the amount of trapping applied to items with an Auto Amount (+) Trap
Information or (–) specified in the Trap Information palette (Window > Trap
Information).
A GUIDE TO QUARKXPRESS SERVER 10.1 | 29
THE QUARKXPRESS SERVER USER INTERFACE
• Choose Overprint to cause overprinting for object and background colors with an
Auto Amount specified in the Trap Specifications dialog box (Edit > Colors > Edit
Trap), as well as for items with an Auto Amount (+) or (–) specified in the Trap
Information palette (Window > Trap Information).
Enter a trapping value in the Indeterminate field or choose Overprint:
• Enter a value in the Indeterminate field to control the amount of trapping that
QuarkXPress applies to object colors that are in front of indeterminate backgrounds
(multiple colors with conflicting trapping relationships).
• Choose Overprint to cause an object color to overprint an indeterminate background.
Enter a Knockout Limit value. The knockout limit is the value (expressed as a
percentage of darkness of the object color) that enables you to control the point at
which an object color knocks out a background color.
Enter an Overprint Limit value. Overprint limit is a trapping setting that allows an
object set to overprint to trap according to the Auto Amount value if the object's
shade is less than a particular percentage.
Preferences — Color Manager
The Color Manager pane (Administration > Preferences > Renderer > Color Manager)
includes the following controls.
To specify an engine for color transformation, choose an option from the Color Engine
drop-down menu.
To achieve the darkest possible blacks in all output methods, check Black Point
Compensation.
Use the Source Setup drop-down menu to specify the source color space of pictures
and colors used in the application.
To enable the Profile Information command in the Window menu and the Color
Management tab in the Import Picture dialog box, check Enable Access to Picture
Profiles. This option allows you to view information about profiles.
To specify a default proof output setup, choose an option from the Proof Output
drop-down menu.
To specify a rendering intent for soft proofing, choose an option from the Rendering
Intent drop-down list. Perceptual scales all the colors in the source gamut so that
they all fit within the destination gamut. Relative Colorimetric retains colors that
are in both the source gamut and the destination gamut. The only source colors that
are changed are those that are not within the destination gamut. Saturation considers
the saturation of source colors and changes them to colors with the same relative
saturation in the destination gamut. Absolute Colorimetric retains colors that are in
both the source gamut and the destination gamut. Colors that are outside the
destination gamut are adjusted in relation to how they would look when printed on
white paper. Defined by Sources uses the rendering intents defined in source setup
for all colors and images.
30 | A GUIDE TO QUARKXPRESS SERVER 10.1
Loading...