Diary Processing

Navigation:  ScriptLine Properties > Generation Options >

Diary Processing

Previous pageReturn to chapter overviewNext page

The options in the Diary Processing tab of the Generation Options ScriptLine property dialog are:


Facing Pages

When this option is set to true, the pages in the QuarkXPress output file are displayed facing one another, like in a normal book. By default this property is set to true since that best represents a physical diary.



There are 2 possible reasons to set this property to false :

Some dated products, such a wall calendars, do not lend themselves to a facing pages layout.

QuarkXPress spreads are limited to 48 inches (slightly less than 122 cm). This means, for facing pages a maximal page width of 24 inches. Therefore, if you need to generate documents with a page width larger than 24 inches, you need to set the Facing Pages option to false.

Highlight token errors

When this option is set to true, Q++ will highlight (in yellow), any textbox where it encounters a token processing error (token not found, translation not found, …). This is useful if the person proofing the output file does not have Q++, since the errors "jump out" visually.



However if the proofreader has Q++, it much easier to use the feature Viewing the Errors in QuarkXPress.

Keep log of errors

Setting this option to true causes Q++ to log all errors and warnings encountered while generating a diary, so that you can later view these messages. This error log is used extensively by Q++, and therefore this property should always be set to true.

Trim blank pages at the back

Setting this option to true causes Q++ to ignore all blank pages at the back of the diary when generating a diary. Note that by blank pages we mean, here, any of the following cases :

A page originating from a BlankPages script line.

A page that is undefined and comes from the difference, if any, between the number of signature pages and the number of defined pages (ie. any page that appears as Page not defined in the script preview).

A page originating from a PlaceHolder script line, whenever the Hide PlaceHolders execution option (see option below) is set to true (effectively turning these into visually blank pages).

Having this property set to true will speed up step 3 of diary generation and should always be set to true, unless you have a specific reason not to.

Hide PlaceHolder labels

By default, this option is set to false, and Q++ generates a textbox on each PlaceHolder page, displaying the page number within the PlaceHolder (ie. Page 3/8), the text of the Label Property and Comments property for all the PlaceHolder ScriptLines of the current Script.

Setting this property to true will leave the pages of the current PlaceHolder ScriptLine blank in the output file.

Test for text overflow

This option is extremely useful to alert you to any possible text overflows in an output file.

Text overflow, denoted by the symbol in QuarkXPress, usually occurs when inserting text of variable length such as holidays or slogans. But it can also occur the first time you generate a diary in a new language, particularly for languages with long weekday names such as German.


Any text overflow encountered by Q++ while generating an output file will be logged as an error and you will be able to inspect and modify these directly. This verification is only performed in the textboxes in which Q++ performs text replacement (if a textbox does not contain any tokens then any text overflow inside it is assumed to be know or voluntary on the part of the person who desined the GridTemplate).


You should always set this option to true, except in some rare cases, using QuarkXPress 3.3x, when the use of this option with a particular GridTemplate causes Quark to crash during diary generation (but even with Quark 3.3x, this is extremely rare).

Lock all objects

Use this option if you wish Q++ to lock all objects of the output file once it has finished generating it. This property is useful to make sure that any manual text editing of the output file does not inadvertently move/resize objects. This option is automatically disabled when the Break links to Master Pages option is activated.

Beep on completion

When this option is set to true, your PC will emit a single beeping sound when the generation of a script is complete. This option is true by default and is useful when generating a diary with many pages such as a daily. This beep uses the hardware beep available on all PCs, even those without a sound card.

Clear command table

When this option is set to true, Q++ clears the file that contains all the commands that were issued to QuarkXPress during scanning, generating, … You should always set this option to false, unless otherwise instructed by technical support.

Execute SARAs (if any)

If this option is set to true, after generating the output file, Q++ will perform all the Saras defined in the current script. The default for this property is true. The only reason to set this property to false is if you are trying to fix a problem which occurs when generating, and you do not wish to waste time performing SARAs on an incorrect output file. The value of this property is ignored if the current script does not contain any Saras.

Backup output before performing SARAs

When this option is set to true, Q++ makes a copy of the output file with the extension .QX_ (instead of the usual QXD for QuarkXPress files), before performing any Saras in the current Script. This property is useful if are having problems generating the output you want, and wish to decide if the problem lies with the diary generation or the Saras performed afterwards.


Setting this property to true will introduce a lag of a few seconds at the beginning of the Saras processing, as a copy of the output file has to be made. This effect is particularly noticeable if your output file is located on the Q++ Server and your network is slow.


This backup copy is placed in the same directory as the output file. You can then compare these 2 files either manually, or using the Quark File Comparison module.

Open output file (if no errors)

Use this property to have Q++ automatically open the output file in QuarkXPress, after diary generation. By default this property is false.

Export to PDF

This option exports the generated output file, if it contains no error, to PDF using the Quark Output Style specified below this option's checkbox.


Topic 179060 updated on 12-May-2016.
Topic URL: http://www.qppstudio.net/webhelp/index.html?diary_processing.htm