A Guide to QuarkXPress Server 8.
CONTENTS Contents About this Guide...............................................................................6 What we're assuming about you............................................................................6 Where to go for help..............................................................................................6 Conventions............................................................................................................7 Getting started with QuarkXPress Server............
CONTENTS Preferences — Application — Full Res Preview............................................................26 Preferences — Application — Job Jackets...................................................................27 Preferences — Application — Modifier.........................................................................27 Preferences — Application — PDF...............................................................................28 Preferences — Application — PSD Import.......................
CONTENTS Creating URL requests....................................................................65 Understanding URL requests................................................................................65 Understanding QuarkXPress Server namespaces.................................................66 Looking up a namespace..............................................................................................66 Understanding QuarkXPress Server parameters............................................
CONTENTS QuarkXPress Server Monitor..........................................................86 QuarkXPress Server Manager.........................................................87 Understanding QuarkXPress Server Manager......................................................87 Load balancing..............................................................................................................87 Request timeout interval.................................................................................
ABOUT THIS GUIDE About this Guide You do not need to read this guide from cover to cover. Instead, use this guide to quickly look up information, find out what you need to know, and proceed with your work. Use the detailed table of contents at the beginning of the guide to find information quickly.
ABOUT THIS GUIDE 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.
GETTING STARTED WITH QUARKXPRESS SERVER Getting started with QuarkXPress Server QuarkXPress Server lets you render QuarkXPress projects in a variety of formats. 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.
GETTING STARTED WITH QUARKXPRESS SERVER 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.
GETTING STARTED WITH QUARKXPRESS SERVER 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.
GETTING STARTED WITH QUARKXPRESS SERVER • The same application preferences (each subrenderer 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 subrenderer) • 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 subrenderer unexp
GETTING STARTED WITH QUARKXPRESS SERVER As of version 8.0, the QuarkXPress Server XDK is Unicode-compliant.
GETTING STARTED WITH QUARKXPRESS SERVER • The -noui option makes the server run without any user interface. This is the normal mode for production use of QuarkXPress Server. • The -nonetwork parameter makes the server run without loading any network interfaces; in this mode, the only transactions a server can run are those passed to it by another process. • The -subrenders parameter lets you specify how many subrenderers to use.
GETTING STARTED WITH QUARKXPRESS SERVER • QUARKXPRESS SERVER_EXIT_RESTART (6971): The server exited as a result of a remotely requested restart. • QUARKXPRESS SERVER_EXIT_SHUTDOWN (6972): The server exited as a result of a remotely requested shutdown. 14 | A GUIDE TO QUARKXPRESS SERVER 8.
THE QUARKXPRESS SERVER USER INTERFACE The QuarkXPress Server user interface This chapter describes the QuarkXPress Server user interface and explains how you can use it to configure and customize your QuarkXPress Server application and manage your server XTensions modules. Menu items are covered in the same order they display in the user interface, from left to right and top to bottom.
THE QUARKXPRESS SERVER USER INTERFACE Server tab of Server Configuration dialog box Check Allow Memory Caching to store disk-based documents in a memory-resident cache. Documents from external document providers also use this cache. Allow Memory Caching is checked by default. In the Max Memory Cache Size field, enter the maximum memory size allocated to the cache memory. The default value is 100MB. The acceptable range of values is from 10MB to 1024MB.
THE QUARKXPRESS SERVER USER INTERFACE • PDF: Returns a PDF file • PNG: Returns a Portable Network Graphics (PNG) file • PostScript: Returns a PostScript file • PPML: Returns a PPML 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
THE QUARKXPRESS SERVER USER INTERFACE Check Force Served Documents Closed to make QuarkXPress Server close projects from the document pool after it renders them, regardless of the Telegraph XTensions software setting. Uncheck Force Served Documents Closed to keep such projects open on the server. This box is checked by default.
THE QUARKXPRESS SERVER USER INTERFACE Logging (Tab) Click the Logging tab in the Server Configuration dialog box (QuarkXPress Server > Server Configuration) to control how errors and transactions are logged. Logging tab of Server Configuration dialog box The log folder contains two log files: The transaction log and the error log.
THE QUARKXPRESS SERVER USER INTERFACE • Instantiate document time: The time required to carry out the dynamic publishing process. • Total of rendering process time: The total amount of time spent rendering a project. • Time required to generate an image of the QuarkXPress document: The time required for the generation of files that use JPEG, PNG, or any other compressed format. • Closing QuarkXPress document time: The time required to close a QuarkXPress project.
THE QUARKXPRESS SERVER USER INTERFACE Check Log Non-conformant SXT Dialog Messages to prevent server XTensions modules from displaying dialog boxes. HTTP (Tab) Click the HTTP tab in the Server Configuration dialog box (QuarkXPress Server > Server Configuration) to control port and connection settings. HTTP tab Check Enable HTTP Interface to activate the HTTP 1.0 server that is built in to QuarkXPress Server and enable the other controls in this area.
THE QUARKXPRESS SERVER USER INTERFACE In the Max Listens field, enter the maximum number of requests to be queued up for processing while waiting for an open connection. An alert displays if this value exceeds the maximum number of listens. The acceptable range of values is from 1 to 32. The default value for this field is 20. In the Default Buffer Size field, enter the total size (in kilobytes) of the HTTP buffer.
THE QUARKXPRESS SERVER USER INTERFACE Email tab Check SMTP Configuration to enable QuarkXPress Server to send an e-mail to an administrator when the application's QLA license expires. Checking this box enables the other controls in this area. This box is unchecked by default. In the SMTP Server field, enter the domain name or IP address of the e-mail server that QuarkXPress Server should use to send messages (for example, mail.quark.com).
THE QUARKXPRESS SERVER USER INTERFACE Changes to preferences in the Project category affect all layouts in the active project. If you change project preferences with no projects open, the new preferences become the default settings for all new projects. Changes to preferences in the Default Layout categories affect all layouts of that type created in QuarkXPress Server.
THE QUARKXPRESS SERVER USER INTERFACE To also allow OpenType® fonts to be scanned at print, check Enable OTF Printer Font Scan. Preferences — Application — Font Fallback Use the Font Fallback pane of the Preferences dialog box (Server/QuarkXPress Server > Preferences) to control what happens when the application opens a project that uses missing fonts. Check Font Fallback to activate the Font Fallback feature.
THE QUARKXPRESS SERVER USER INTERFACE Preferences — Application — Fonts Use the Fonts pane of the Preferences dialog box (Server/QuarkXPress Server > Preferences) to specify the following preferences. In the Font Mapping area: • To specify default replacement fonts, check Specify Default Replacement Font and choose options from the Roman and East Asian drop-down menu.
THE QUARKXPRESS SERVER USER INTERFACE • When Selected Full Resolution Previews is checked, pictures set to display at full resolution will only do so when they are selected. You may want to turn off Full Resolution Preview if you are experiencing a performance issue that you think might be related to this XTensions module. To turn off Full Resolution Preview when opening a project, check Disable Full Resolution Previews on Open.
THE QUARKXPRESS SERVER USER INTERFACE The value of the parameter does not override the value in the Amount by which the Text will Increase/Decrease field. Check Allow Text to Grow to allow the Modifier parameter to increase the font size of text in a text box. Check Adjust Other Font Attributes to enable the font attributes in this area.
THE QUARKXPRESS SERVER USER INTERFACE To create the cache in the preferences folder, click QuarkXPress Server Preferences. To create the cache in a different folder, click Other Folder and select a different folder. To set the size of the cache folder, enter a value in the Maximum Cache Folder Size field. You may want to clear the PSD Import cache if previews look incorrect. To clear this cache, click Clear Cache.
THE QUARKXPRESS SERVER USER INTERFACE Preferences — Application — Picture Effects You can sometimes get improved performance by specifying a cache folder located on a different drive from the drive or drives where the application and project are located. Use the Picture Effects pane of the Preferences dialog box (Server/QuarkXPress Server > Preferences) to specify the location of the cache folder for picture editing. The Picture Effects pane displays only if QuarkVista XTensions software is loaded.
THE QUARKXPRESS SERVER USER INTERFACE Use the Hyperlinks area to choose the color for anchor icons and hyperlinks. You might want to choose anchor and hyperlink colors for a Print layout if you are planning to export that layout as a PDF file. Use the Master Page Items area to control what happens to master items when master pages are applied.
THE QUARKXPRESS SERVER USER INTERFACE 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). Use the Item Coordinates buttons (Print layouts only) to specify whether the increments of the horizontal ruler repeat from zero for each Page or are continuous across a Spread. This setting determines the coordinates of items displayed in fields. The default option is Page.
THE QUARKXPRESS SERVER USER INTERFACE • Click Font Size (Em Box) to lock text to grid based on the size of the em boxes of the characters. For each language in the Hyphenation list, use the Method drop-down menu in the Hyphenation area to specify the method the application uses to automatically hyphenate paragraphs when no corresponding entry is found in your Hyphenation Exceptions dictionary.
THE QUARKXPRESS SERVER USER INTERFACE default value for both scales is 75% (range = 0 to 100%, measurement system = percentage, smallest increment = .1). • Use the Superior area to control the scale of superior characters. The VScale value determines the vertical size of the character and is measured as a percentage of font size. The HScale value determines width and is measured as a percentage of the normal character width (as specified by the font designer).
THE QUARKXPRESS SERVER USER INTERFACE Preferences — Layout — Trapping Use the Trapping pane of the Preferences dialog box (Server/QuarkXPress Server > Preferences) to set default trapping for Print layouts. 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.
THE QUARKXPRESS SERVER USER INTERFACE Preferences — Layout — Grid Cell Fill Use the Grid Cell Fill pane of the Preferences dialog box (Server/QuarkXPress Server > Preferences) to control how design grid cells are filled. To specify which cells will be filled, check Increment Fill and enter a value in the field. For example, to fill cells four, eight, and twelve, enter 4. To restart cell counting at the beginning of each line in a text box, click Start of Line.
THE QUARKXPRESS SERVER USER INTERFACE • To color manage vector content in imported EPS and PDF files, check Color Manage Vector EPS/PDF. Note that this preference applies only to EPS and PDF files imported after this box is checked. • To color manage vector content in EPS and PDF files that have already been imported in the active project, check Include Existing Vector EPS/PDF in Layout.
THE QUARKXPRESS SERVER USER INTERFACE Default style sheets can be applied to content in projects using Modifier XTensions software. For more information, see "Modifier XTensions software." Creating and editing character style sheets A character style sheet is a named package of character attributes. You can apply all of a character style sheet's formatting attributes to text by simply applying the style sheet to the text.
THE QUARKXPRESS SERVER USER INTERFACE Next, choose character attributes from the lower section of the Edit Character Style Sheet dialog box. When you're done, click OK. Creating and editing paragraph style sheets A paragraph style sheet is a named package of paragraph and character attributes. You can apply all of a paragraph style sheet's formatting attributes to text by simply applying the style sheet to the text.
THE QUARKXPRESS SERVER USER INTERFACE • If you define a keyboard equivalent for a style sheet with a key sequence that also defines an existing command, the style sheet command will override the existing command when the Content tool is selected and a text box is active. • Based on: To base the attributes of a new style sheet on an existing one, click the Based on drop-down menu and choose a style sheet from the list.
THE QUARKXPRESS SERVER USER INTERFACE Creating a color To create a color, choose (Server/QuarkXPress Server > Document Controls > Colors) to display the Default Colors dialog box, and click New to display the Edit Color dialog box. Then, enter a name in the Name field and specify the color model for your new color. Edit Color dialog box • RGB: This additive color system is most often used with slide recorders or color video monitors, and also works well for Web pages.
THE QUARKXPRESS SERVER USER INTERFACE Trap Specifications Click Edit Trap in the Default Colors dialog box (Server/QuarkXPress Server > Document Controls > Colors) to display the Trap Specifications dialog box for a chosen color. Use the Trap Specifications dialog box to specify trapping values for any object color relative to any background color.
THE QUARKXPRESS SERVER USER INTERFACE Trap drop-down menu • The Default option works like the Auto Amount (+/–) settings, but when Default is chosen, an algorithm determines which colors choke, which colors spread, and which colors overprint or knock out. The amount of a choke or spread is based on the Auto Amount value specified in the Trapping pane of the Preferences dialog box (QuarkXPress Server > Preferences). However, when Default is chosen, black always overprints and white always knocks out.
THE QUARKXPRESS SERVER USER INTERFACE If you specify a negative Custom value between the object color named in the dialog box title and the Indeterminate background color, text to which the object color is applied is not choked; instead, it is knocked out of the background without any trapping. The Dependent Traps/Independent Traps drop-down menu determines whether the Trap and Reverse drop-down menu settings directly affect each other.
THE QUARKXPRESS SERVER USER INTERFACE H&J drop-down menu in the Formats tab of the Edit Paragraph Style Sheet dialog box. Hyphenation and justification specifications are included in paragraph style sheets. Default H&Js dialog box Default H&Js come into play only when you create a project in QuarkXPress Server. You cannot directly create projects in the QuarkXPress Server user interface, but client requests can trigger the creation of projects.
THE QUARKXPRESS SERVER USER INTERFACE The Edit Hyphenation & Justification dialog box • Auto Hyphenation: Specify whether automatic hyphenation is allowed. • Smallest Word: Specify the minimum number of characters a word must contain to allow hyphenation. • Minimum Before: Specify the minimum number of characters before a hyphen. • Minimum After: Specify the minimum number of characters after a hyphen. • Break Capitalized Words: Specify whether hyphenation of capitalized words is allowed.
THE QUARKXPRESS SERVER USER INTERFACE • R Space: Specify the amount of space between words containing Roman characters in justified paragraphs. Specify the optimum amount of space between words containing Roman characters in all paragraphs, regardless of their alignment. • EA Punct: Specify the minimum and maximum amount of space between East Asian punctuation characters in justified paragraphs.
THE QUARKXPRESS SERVER USER INTERFACE Output Styles dialog box Working with EPS styles Use the the Edit EPS Style dialog box to create or edit EPS output styles. To display the Edit EPS Style dialog box, choose EPS from the New drop-down button or click Edit or Duplicate in the Default Output Styles dialog box (Server/QuarkXPress Server > Document Controls > Output Styles). Edit EPS Style dialog box To specify a name for the EPS style, enter the name in the EPS Style drop-down menu.
THE QUARKXPRESS SERVER USER INTERFACE Use the General pane to specify the scale of the EPS file, the format of the EPS file's preview, whether to treat the page's white areas as transparent or opaque in the EPS file, and whether to output the EPS file as a spread. Use the Color pane to choose an output setup for the EPS file and to select which plates should be included in the output. Use the Fonts pane to specify which fonts are embedded within the exported EPS file.
THE QUARKXPRESS SERVER USER INTERFACE Edit PPML Style dialog box In the PPML Style field, enter a name for a new PPML output style or rename an existing PPML output style. Choose the target PPML consumer from the Consumer drop-down menu. Use the Device pane to control device-specific settings, including PostScript Printer Description (PPD) selection and page positioning. Use the Pages pane to specify various methods of rendering pages.
THE QUARKXPRESS SERVER USER INTERFACE Working with PDF Styles Use the the Edit PDF Style dialog box to create or edit EPS output styles. To display the Edit PDF Style dialog box, choose PDF from the New drop-down button or click Edit or Duplicate in the Default Output Styles dialog box (Server/QuarkXPress Server > Document Controls > Output Styles). Edit PDF Style dialog box In the PDF Style field, enter a name for a new PDF output style or rename an existing PDF output style.
THE QUARKXPRESS SERVER USER INTERFACE To use PDF/X verification, choose an option from the Verification drop-down menu. Available options include PDF/X 1a and PDF/X 3. Note that PDF/X 1a verification permits only CMYK and spot colors, while PDF/X 3 verification allows you to include colors and pictures that use other color spaces, along with ICC color profiles (which are defined in the source and output setups for color management).
THE QUARKXPRESS SERVER USER INTERFACE Edit Print Style dialog box In the Print Style field, enter a name for a new print output style or rename an existing print output style. From the Sequence drop-down menu, choose one of the following options: • All to print all related pages • Odd to print only odd-numbered pages • Even to print only even-numbered pages To make output smaller or larger than the original, enter a percentage in the Scale field. The default is 100%.
THE QUARKXPRESS SERVER USER INTERFACE Use the Fonts pane to specify which fonts are included in output. Note that many of the options in this pane are available only when printing to a PostScript output device. Use the Color pane to control color output. Use the Marks pane to include crop marks, registration marks, and bleed marks in the output. Crop marks are short vertical and horizontal lines printed outside the page's final trim size, indicating where to cut the page.
THE QUARKXPRESS SERVER USER INTERFACE To edit a font-mapping rule, select the rule and click Edit to display the Edit Font Mapping dialog box, then choose a replacement font from the Replacement drop-down menu. Click Export to export the current set of font mapping rules as an XML file. Click Import to import an XML file that contains font-replacement rules.
THE QUARKXPRESS SERVER USER INTERFACE 1 Click New in the Default Source Setups dialog box to display the Edit Source Setup dialog box. Edit Source Setup dialog box 2 In the Name field, enter a name. 3 In the RGB, CMYK, LAB, and Gray tabs, review and make changes to the Profile and Rendering Intent selected for Solid Colors and Images.
THE QUARKXPRESS SERVER USER INTERFACE Output setups The Source command (Server/QuarkXPress Server > Document Controls > Color Setups > Source) displays the Default Output Setups dialog box, which enables you to create and manage output setups. Default Output Setups dialog box An output setup describes the capabilities of various types of output devices and determines how colors are handled in various output scenarios. You can think of an output setup as "where colors are going.
THE QUARKXPRESS SERVER USER INTERFACE Edit Output Setup dialog box 2 In the Name field, enter a name. 3 Select an option from the Mode drop-down menu to specify the type of output: Composite or Separations. 4 If you select Composite mode, you can specify an output color space from the Model drop-down menu: Grayscale, RGB, CMYK, As Is, or DeviceN. If you select Separations mode, you can select Host-based Separations or In-RIP Separations from the Model drop-down menu.
THE QUARKXPRESS SERVER USER INTERFACE PPML Consumers dialog box Working with PPML consumers A PPML consumer describes a particular application or device that accepts PPML input. Use the the Edit PPML Consumers dialog box to create or edit PPML consumers. To display the Edit PPML Consumers dialog box, click New, Edit, or Duplicate in the PPML Consumers dialog box (Server/QuarkXPress Server > Edit PPML Consumers). A GUIDE TO QUARKXPRESS SERVER 8.
THE QUARKXPRESS SERVER USER INTERFACE Edit PPML Consumers dialog box In the Name field, enter a name for the PPML consumer. In the Element pane, check the options that are appropriate for this PPML consumer. In the Edit PPML Consumers pane, check options to determine how various types of pictures are handled by the PPML consumer. Server XTensions Manager The Server XTensions Manager command (Server/QuarkXPress Server menu ) displays the Server XTensions Manager dialog box.
THE QUARKXPRESS SERVER USER INTERFACE XTensions Manager dialog box A set is a group of specific XTensions modules that load together. For example, you might make sets of third-party XTensions software that are required only for specific projects or for certain clients. From the Set drop-down menu, choose an XTensions software set to load: • All XTensions Enabled loads all your XTensions software. • All XTensions Disabled does not load any XTensions software.
THE QUARKXPRESS SERVER USER INTERFACE Click About to display detailed information about the selected XTensions software. Status Monitor The Status Monitor command (Server/QuarkXPress Server menu) displays the Status Monitor dialog box, which shows the status of the server. Because the status monitor consumes resources, Quark recommends that you use it for debugging and investigating specific issues rather than leaving it open at all times.
THE QUARKXPRESS SERVER USER INTERFACE The Connections field displays the maximum number of simultaneous connections that are allowed. Set this value in the HTTP tab of the Server Configuration dialog box (QuarkXPress Server menu). The In Use field displays the current number of simultaneous connections. The Queued field displays the current number of connections waiting for a renderer to become available. The Memory Usage field displays the amount of memory used by memory-cached projects.
THE QUARKXPRESS SERVER USER INTERFACE To check the QuarkXPress Server license out of Quark License Administrator, choose the Check Out License command. To pause the QuarkXPress Server HTTP server, choose the Pause Server command. To start the server again, choose Server/QuarkXPress Server > HTTP Server > Start Server. To start the HTTP server, choose Server/QuarkXPress Server > HTTP Server > Start Server.
CREATING URL REQUESTS Creating URL requests You can use URL requests to make QuarkXPress Server render projects in a variety of formats, to use the features of server XTensions modules, and to control the server. The topics below provide an overview of how to construct server requests and use URL parameters. This chapter also lists functions that let you control the server. For detailed information about constructing other types of URL requests, see the QuarkXPress Server Web Integration Guide.
CREATING URL REQUESTS http://QXPServer:8080/PDF/MyProject.qxp?includehyperlinks=1&embedallfonts=1 Some URL parameters require Boolean arguments. For such parameters, valid values include 1 or 0, true or false, y or n, and yes or no. You can also send requests to QuarkXPress Server using the HTTP GET and POST protocols and using XML with XSLT. For more information about these approaches, see the QuarkXPress Server Web Integration Guide.
CREATING URL REQUESTS Understanding QuarkXPress Server parameters Parameters let you control the details of how a request is executed. For example, you can use the page parameter to create a request that returns only the third page of a project: http://QXPServer:8080/jpeg/project1.qxp?page=3 You can include multiple parameters in the same request; simply separate them with an ampersand (&).
CREATING URL REQUESTS For more information, see the QuarkXPress Server Web Integration Guide. Specialized parameters Specialized parameters are parameters that serve special purposes. Some of these parameters work by asking the server to read the contents of XML files. For more information, see the QuarkXPress Server Web Integration Guide.
CREATING URL REQUESTS Attribute Type Description LoggingEnabled Boolean Controls whether transactions and errors are logged. LogFolder string Specifies the path to the log folder, which contains the error and transaction log files. LogErrors Boolean Specifies whether to log error conditions. LogTransactions Boolean Specifies whether to log all successful transactions.
CREATING URL REQUESTS Attribute Type Description VerificationPassword string Lets you supply a password. Minimum length is 4 characters; maximum length is 32 characters. ConfirmPassword string Confirms a password. Minimum length is 4 characters; maximum length is 32 characters. GenerateHierarchy Boolean On an OnAddfile request, specifies whether to create a new file hierarchy as files are added to the document pool.
MODIFYING LAYOUTS WITH XML Modifying layouts with XML The xml namespace deconstructs a project according to the Modifier DTD. The construct namespace lets the server turn an XML representation of a QuarkXPress project back into an actual project. With these namespaces, you can deconstruct a project into an XML representation, change the XML in accordance with the Modifier DTD, and then have the server generate an updated version of the QuarkXPress project.
QUARKXPRESS SERVER XTENSIONS SOFTWARE QuarkXPress Server XTensions software Just as XTensions software provides additional functionality to QuarkXPress, XTensions software enables QuarkXPress Server to do things it can't do by default.
QUARKXPRESS SERVER XTENSIONS SOFTWARE For example, to export the article named "Article1" from the project named "Project1.qxp," you could use a URL like the following: http://QXPServer.8080/qcddoc/Project1.qxp?article=Article1 You cannot export an article from a QuarkXPress project unless the article has been created and named in QuarkXPress using CopyDeskArticleXT XTensions software. To export an article in a particular format, use the format parameter.
QUARKXPRESS SERVER XTENSIONS SOFTWARE To delete the component named "New Component" from the article named "Article1.qcd," you could use XML like the following: PAGE 75QUARKXPRESS SERVER XTENSIONS SOFTWARE Modifier XTensions software Modifier XTensions software lets clients perform all of the following tasks using XML: • Modify the properties of pictures in a QuarkXPress project • Modify the text in text boxes within a QuarkXPress project • Modify the properties of text boxes and picture boxes in a QuarkXPress project • Create and delete picture boxes and text boxes in a QuarkXPress project • Import text or text strings into text boxes within a QuarkXPress project • Impo
QUARKXPRESS SERVER XTENSIONS SOFTWARE Using Modifier XTensions software To use Modifier XTensions software: 1 Create a QuarkXPress project. Note the IDs or names of any text and picture boxes you want to manipulate. 2 Upload the project to the QuarkXPress Server document pool. 3 Create XML that describes the changes you want, as described in "Creating XML for Modifier XTensions software.
QUARKXPRESS SERVER XTENSIONS SOFTWARE Creating preset files To create a preset file, open a project in a copy of QuarkXPress that is running QuarkVista XTensions software, select a picture box that contains a picture, apply effects to the picture, and then click the Save Preset button on the Picture Effects palette. The effects you apply are saved in a preset (.vpf) file at the location you indicate.
QUARKXPRESS SERVER XTENSIONS SOFTWARE Removing QuarkVista effects Clients can remove all QuarkVista effects applied to images using the deletevistaeffect parameter. Consider the following example: http://QXPServer:8080/abc.qxp?deletevistaeffect=pb2 This URL removes any QuarkVista effects applied to the picture in the picture box named pb2. Clients can remove a QuarkVista effect applied to multiple images from a single URL. Consider the following example: http://QXPServer:8080/abc.
QUARKXPRESS SERVER XTENSIONS SOFTWARE If Suppress Output is selected for a layer, QuarkXPress Server does not render that layer when producing PDF, EPS, or PostScript files. InteractiveDesignerSXT Server XTensions software InteractiveDesignerSXT XTensions software allows QuarkXPress Server to render both Print and Interactive layouts in QuarkXPress projects as SWF (Flash) files.
TELEGRAPH XTENSIONS SOFTWARE Telegraph XTensions software Unlike the other XTensions software described in this guide, Telegraph XTensions software works with QuarkXPress, rather than with QuarkXPress Server. You can use Telegraph XTensions software to create QuarkXPress projects that can serve as templates in QuarkXPress Server.
TELEGRAPH XTENSIONS SOFTWARE QuarkXPress Server pane of Preferences dialog box (QuarkXPress/Edit menu) For information on adding a server, see "Adding a server." To edit the properties of a server in the Server list, select the server name and then click Edit. To remove a server from the Server Setup list, select the server and then click Remove. To allow projects checked in from this copy of QuarkXPress to remain open on the server after it has been served, check Allow Document to Stay Open.
TELEGRAPH XTENSIONS SOFTWARE Add Server dialog box 2 Enter an identifying name for the server in the Server Name field. 3 Enter the server's address in the Address field. You can enter either an IP address or the name of the server. 4 Enter the server's port number in the Port field. The default port number is 8080. Valid values are from 1 to 65535. 5 In the Document Pool Path field, enter the path to the document pool directory on the server, or to a subdirectory within the document pool.
TELEGRAPH XTENSIONS SOFTWARE Box Identifiers palette To edit the name of an item or group, select its name in the Box Modifiers palette and then click Edit Box Name . To scroll to the location of a named item or group, double-click the target item or group’s name in the Box Modifiers palette. Alternatively, you can select the name and click Go To . To delete an item’s or group’s name (without deleting the item or group itself), select the name in the Box Modifiers palette and then click Delete .
TELEGRAPH XTENSIONS SOFTWARE 4 Click OK. The name of the item or group displays on the Box Identifiers palette, next to the item’s item ID and page number. In addition to items on layout pages, you can also name items on master pages. Items on layout pages that are based on items on master pages have a default name of "- " Uploading templates Telegraph QuarkXTensions software can upload a project to the QuarkXPress Server computer in one simple step.
TELEGRAPH XTENSIONS SOFTWARE To specify authentication information for a QuarkXPress Server application, display the HTTP tab of the QuarkXPress Server Preferences dialog box, check the Realm Verif. for Admin. Requests box and enter a user name and password. 5 To collect and upload fonts used by the project, check Fonts. 6 To collect and upload pictures used by the project, check Pictures. This will upload highor low-resolution pictures that are linked to or embedded in the project.
QUARKXPRESS SERVER MONITOR QuarkXPress Server Monitor QuarkXPress Server Monitor is no longer included with QuarkXPress Server. All QuarkXPress Server Monitor functionality is available in QuarkXPress Server Manager. For more information, see "QuarkXPress Server Manager." 86 | A GUIDE TO QUARKXPRESS SERVER 8.
QUARKXPRESS SERVER MANAGER QuarkXPress Server Manager QuarkXPress Server Manager is a server application that efficiently routes rendering requests in an environment that uses one or more QuarkXPress Server applications. QuarkXPress Server Manager uses load-balancing methods to determine which server in the QuarkXPress Server pool can best process a document request, and uses caching to improve speed and efficiency.
QUARKXPRESS SERVER MANAGER • Round robin: Requests are sent to servers in a set order. For example, if you have three QuarkXPress Server instances and QuarkXPress Server Manager receives ten rendering requests, the requests are distributed as follows: Request QuarkXPress Server instance used 1 1 2 2 3 3 4 1 5 2 6 3 7 1 • Dynamic: The QuarkXPress Server Manager server considers file size and throughput requirements for each request.
QUARKXPRESS SERVER MANAGER instance might be unable to process a request in a reasonable amount of time (for example, if the server is working on a large rendering job, or if the server computer has stopped functioning). If you specify a certain period of time as the request timeout interval, QuarkXPress Server Manager will wait for the response until that period of time elapses, and then send the request to a different QuarkXPress Server instance.
QUARKXPRESS SERVER MANAGER • Information about events (such as alerts) that occur during the render-request process • Details about requests that were sent to a different QuarkXPress Server instance after the first assigned QuarkXPress Server instance was unable to process the request Within the logs, each QuarkXPress Server instance is identified by its IP address and port number. You can export log files in XML (Extensible Markup Language) or comma-separated values (CSV) format.
QUARKXPRESS SERVER MANAGER 3 Launch the QuarkXPress Server Manager Console application (see Starting the Manager server application"). 4 From the QuarkXPress Server Manager Console application, start the Server Manager server application (see Starting the Manager server application"). 5 Launch the QuarkXPress Server Manager client application (see Starting the Manager client application").
QUARKXPRESS SERVER MANAGER QuarkXPress Server Manager diagram Starting the Manager server application To launch the QuarkXPress Server Manager server application: • Mac OS: Open the QuarkXPress Server Manager/Server folder inside the applications folder and double-click "tomcat_start.command." • Windows: Choose Start > Programs > QuarkXPress Server Manager > Start QuarkXPress Server Manager.
QUARKXPRESS SERVER MANAGER Log On dialog box To log on to a particular QuarkXPress Server Manager server: 1 Do one of the following things: • Choose the server name or IP address from the Server Name/IP Address drop-down menu. • Choose Add Server from the Server Name/IP Address drop-down menu, and then enter the server's DNS name or IP address, followed by the server's port number, in the fields below the drop-down menu. 2 Click OK. The QuarkXPress Server Manager window displays.
QUARKXPRESS SERVER MANAGER Manage QuarkXPress Server pane Adding and enabling a QuarkXPress Server instance When you add and enable a QuarkXPress Server instance in the Manage QuarkXPress Server pane of the QuarkXPress Server Manager window, the QuarkXPress Server Manager server begins routing rendering requests to that QuarkXPress Server instance.
QUARKXPRESS SERVER MANAGER Add QuarkXPress Server dialog box 3 Enter the QuarkXPress Server instance's DNS name or IP address in the Name/IP Address field. 4 Enter the QuarkXPress Server instance's port number in the Port Number field. 5 To specify an alternate name for the server, enter a value in the Alias field. The Alias value displays in the Manage QuarkXPress Server pane of the QuarkXPress Server Manager window.
QUARKXPRESS SERVER MANAGER 8 To restrict this server to one or more particular types of rendering, check the appropriate boxes in the Request Binding area. To add additional render types (for example, render types provided by QuarkXPress Server XTensions software), check Other and enter the appropriate namespaces in the corresponding field as a comma-separated list. For more information, see "Request handler binding.
QUARKXPRESS SERVER MANAGER Manage QuarkXPress Server pane Displaying information about a QuarkXPress Server instance To display information about a QuarkXPress Server instance, double-click the server's name in the Manage QuarkXPress Server pane of the QuarkXPress Server Manager window. The QuarkXPress Server Details dialog box displays.
QUARKXPRESS SERVER MANAGER The cache stores only the results of requests that do not deliberately bypass the cache. Viewing a QuarkXPress Server Manager server cache To view the list of files in the QuarkXPress Server Manager server's cache, display the Manage Cache pane of the QuarkXPress Server Manager window. This pane lists the URL of each file in the cache, the file's size, and the date and time of the file's generation. To view a cache file, double-click the file name in the list.
QUARKXPRESS SERVER MANAGER Configuring cache options To configure cache options, display the Cache Settings pane in the Global Settings pane of the QuarkXPress Server Manager window. • To set the maximum number of files allowed in the cache, enter a value in the Cache Count field. When the number of files in the cache reaches the number you set here, QuarkXPress Server Manager begins deleting the least recently used files to make room in the cache.
QUARKXPRESS SERVER MANAGER To control what information is stored in the logs, use the Log Settings pane in the Global Settings pane of the QuarkXPress Server Manager window. For more information, see "Configuring logging options." Manage Logs pane Exporting log files You can export log files to your local file system in XML and CSV format.
QUARKXPRESS SERVER MANAGER 4 To delete only the selected files, uncheck Delete all log files and then click OK. To delete all log files, check Delete all log files and then click OK. Configuring logging options To configure logging options, display the Log Settings pane in the Global Settings pane of the QuarkXPress Server Manager window. To set the maximum log file size, enter a value in the Max Log File Size field.
QUARKXPRESS SERVER MANAGER Log Settings pane Controlling load balancing Load balancing ensures that each rendering request is sent to a QuarkXPress Server instance that is most likely to be able to handle it quickly. To define a load-balancing setting for the QuarkXPress Server Manager server, display the Load Balancer Method pane in the Global Settings pane of the QuarkXPress Server Manager window and then choose an option from the Choose Load Balancer drop-down menu.
QUARKXPRESS SERVER MANAGER Load Balancer Method pane Using a proxy server Some networks route network traffic through a proxy server for reasons of efficiency or security. To use a proxy server for all requests and responses between QuarkXPress Server Manager and QuarkXPress Server: 1 Display the Proxy Server Settings pane in the Global Settings pane of the QuarkXPress Server Manager window. 2 Check Use a Proxy Server for my LAN. 3 Enter the proxy server's DNS name or IP address in the Address field.
QUARKXPRESS SERVER MANAGER Proxy Server Settings pane Generating automatic e-mail messages You can configure a QuarkXPress Server Manager server to automatically generate and send e-mail messages if particular events occur. To configure the QuarkXPress Server Manager server to automatically send e-mail messages: 1 Display the SMTP Settings pane in the Global Settings pane of the QuarkXPress Server Manager window.
QUARKXPRESS SERVER MANAGER SMTP Settings pane Two events can cause QuarkXPress Server Manager to generate an e-mail message: • If Inactive Host E-mail Notification is checked (see "Using other global settings"), a message is sent when a QuarkXPress Server instance goes from the active state to the inactive state. • If you have set up custom error messages (as described in "Using custom error messages"), certain QuarkXPress Server errors result in e-mail messages.
QUARKXPRESS SERVER MANAGER • Max Total Connections: To specify the maximum number of connections the QuarkXPress Server Manager server should open for all hosts before it begins queuing requests, enter a value in this field. • Ping Interval: To set the amount of time the QuarkXPress Server Manager server should wait between ping attempts (see "Determining QuarkXPress Server instance availability"), enter a value in this field.
QUARKXPRESS SERVER MANAGER Other Settings pane Saving a server configuration Changes that you make to a server configuration in the QuarkXPress Server Manager client are not made to the QuarkXPress Server Manager server until you click Save at the bottom of the QuarkXPress Server Manager window. To discard any changes you have made since logging on to the QuarkXPress Server Manager server, click Refresh. The configuration of the QuarkXPress Server Manager server remains as it was.
QUARKXPRESS SERVER MANAGER Creating a custom error code To create a custom error code: 1 On the computer where the QuarkXPress Server Manager server application is running, open the following file in a text-editing application: [application folder]\server\apache-tomcat-6.0.18\webapps\quark\ WEB-INF\classes\Manager_Server_ErrorCodeMapping.
QUARKXPRESS SERVER MANAGER [application folder]\server\apache-tomcat-6.0.18\webapps\quark\WEB-INF\ classes\ManagerErrorCodeMessage.properties 3 Create a new line containing the unique custom error code you defined in step 2. Follow the custom error code with a tab and then enter the custom text to be returned for that error. 4 Save and close the file. This change will not take effect until you quit and restart the QuarkXPress Server Manager server application.
QUARKXPRESS SERVER MANAGER • qxpsm_responseredirect: If you use servlet methodology to send a request to QuarkXPress Server Manager with qxpsm_responseasurl=true, QuarkXPress Server Manager returns a frameset page with one or more frames. If the response is not multipart, the frameset contains a single page with a URL pointing to a response file in the temporary cache. This can be problematic if, for example, you want to use the returned URL as an image link in an HTML page.
QUARKXPRESS SERVER MANAGER SCRIPTING ENVIRONMENT QuarkXPress Server Manager Scripting Environment A script is a set of commands written in an interpreted language to automate certain application tasks. You can use server-side scripts with QuarkXPress Server Manager. The QuarkXPress Server Manager Scripting Environment application allows you to manage automated scripts that perform actions without requiring another application or user intervention.
QUARKXPRESS SERVER MANAGER SCRIPTING ENVIRONMENT Working with the Scripting Environment The QuarkXPress Server Manager Scripting Environment user interface includes commands for creating, editing, and checking the syntax of scripts for QuarkXPress Server Manager. You can also can execute scripts manually or schedule scripts to run at certain times.
QUARKXPRESS SERVER MANAGER SCRIPTING ENVIRONMENT Whether your execute a script manually, according to a schedule, or when triggered by an event, the script is executed on the QuarkXPress Server Manager server computer. Consequently, not all of the console output displays in QuarkXPress Server Manager Scripting Environment result window. Only the final result or error returned by the script execution displays in QuarkXPress Server Manager Scripting Environment.
QUARKXPRESS SERVER MANAGER SCRIPTING ENVIRONMENT Scheduling a script You can execute scripts in two ways. You can run a script manually from within QuarkXPress Server Manager Scripting Environment or you can schedule a script to execute at specific intervals. To schedule a script: 1 Display the script in the Script Content area of the QuarkXPress Server Manager Scripting Environment window. 2 Save the script. 3 Click the Schedule Script button . The Schedule Script dialog box displays.
GLOSSARY Glossary Document pool: The document pool contains the projects that are available for rendering. By default, the document pool is a collection of discrete files or folders in a specific, identified folder located on the local server or on a connected network drive. When some type of external document provider (such as a content management system or database) is used, projects are not stored in the local document pool.
LEGAL NOTICES Legal notices ©2010 Quark, Inc. as to the content and arrangement of this material. All rights reserved. ©1986–2010 Quark, Inc. and its licensors as to the technology. All rights reserved. Protected by one or more of U.S. Patent Nos. 5,541,991; 5,907,704; 6,005,560; 6,052,514; 6,081,262; 6,947,959 B1; 6,940,518 B2; 7,116,843; and other patents pending.
LEGAL NOTICES INDIRECT, INCIDENTAL, CONSEQUENTIAL OR PUNITIVE DAMAGES, INCLUDING, BUT NOT LIMITED TO, ANY LOST PROFITS, LOST TIME, LOST SAVINGS, LOST DATA, LOST FEES, OR EXPENSES OF ANY KIND ARISING FROM INSTALLATION OR USE OF THE QUARK PRODUCTS/SERVICES, IN ANY MANNER, HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY.
LEGAL NOTICES for private use or for sale, is strictly forbidden. Contact FOCOLTONE, Ltd. for specific patent information. Toyo Ink Mfg. Co., Ltd. is the copyright owner of TOYO INK COLOR FINDER™ SYSTEM AND SOFTWARE which is licensed to Quark, Inc. to distribute for use only in connection with QuarkXPress. TOYO INK COLOR FINDER™ SYSTEM AND SOFTWARE shall not be copied onto another diskette or into memory unless as part of the execution of QuarkXPress.
LEGAL NOTICES languages. Johan Vromans The RPM file. Petr Titera The Unicode map format with names, the forced Unicode option. Frank M. Siegert Port to Windows Lei Wang Chen Xiangyang Translation maps for Chinese fonts. Zvezdan Petkovic The Unicode translation tables for the Cyrillic alphabet. Rigel
LEGAL NOTICES This software is based in part on the work of the Independent JPEG Group. As to Microsoft technology, ©1988–2008 Microsoft Corporation. All rights reserved. As to Nodeka software, ©1999–2002 Justin Gottschlich. All rights reserved. As to STLport technology, Copyright 1999,2000 Boris Fomitchev. This material is provided “as is”, with absolutely no warranty expressed or implied. Any use is at your own risk.
LEGAL NOTICES As to cascading menus based on menu.js. by Gary Smith, July 1997, Copyright ©1997–1999 Netscape Communication Corp. Netscape grants you a royalty free license to use or modify the cascading menus software provided that this copyright notice appears on all copies. This software is provided "AS IS," without a warranty of any kind. Portions of this software is based on the work of Jean-loup Gailly and Mark Adler and is ©1995–1998 Jean-loup Gailly and Mark Adler [ZIP library].
LEGAL NOTICES express or implied, including but not limited to, warranties of merchantability or fitness for any particular purpose or that the use of the software or documentation will not infringe any third party patents, copyrights, trademarks or other rights. The copyright holders and contributing author(s) will not be liable for any direct, indirect, special or consequential damages arising out of any use of the software or documentation, even if advised of the possibility of such damage.
LEGAL NOTICES OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Copyright 2001–2005 ©MetaStuff, Ltd. All Rights Reserved. As to Jaxen technology: Copyright 2003–2006 The Werken Company. All Rights Reserved. License Text $Id: LICENSE.txt,v 1.5 2006/02/05 21:49:04 elharo Exp $ Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1.
INDEX Index A G articles 72, 73 grids 36 B H binding 93 H&Js 32, 44, 45 HTTP settings 21 C caching 9, 97, 98, 99 character style sheets 38 color management 36, 55, 57 colors 40, 41 hyperlinks 30 hyphenation 32, 44, 45 I Interactive Designer 79 components 73 connection queue 10 construct 71 copydesk 68, 72, 73 custom error messages 107, 108 D deconstruct 71 default render type 15 J Job Jackets 27 K keepalive.
INDEX Modifier 27, 75, 76 monitoring server status 62 monitorsubrenderers option 12 N R render type, default 15 render types 67 request handler binding 93 routing 96 namespaces 66 nonetwork option 12 noui option 12 O output styles 47, 48, 49, 51, 52 S scripting 111, 112, 113, 114 server configuration 94, 107 server templates 9 small caps 33 SMTP configuration 22 P paragraph style sheets 39 parameters 67, 68, 109 passwords 109 PDF 28, 51, 74 picture effects 30, 76, 77, 78 ping 105 placeholders 29 plat
