Diary Generation Options : Troubleshooting

Navigation:  Scripts > Diary Generation > Diary Generation Options >

Diary Generation Options : Troubleshooting

Previous pageReturn to chapter overviewNext page

The Troubleshooting Diary Generation Options below are usually only used whenever you are getting unexpected results or encountering an unexpected Quark crash (a link is provided whenever a property can be used to set this option for the current script or as a default).

 

Filter Holidays

When this option is set to true (the default, which should rarely, if ever, be changed), Q++Studio will filter the holidays and one-time-dates tables used to generate diaries so that only these necessary are copied from the server to your local disk during diary generation. Most of the time this works fine.

 

In some extremely rare cases you will find that some of the holidays sets you are using specifically in macros are not being used in the output file. In these cases your first reflex should be to add these sets to the Included Holidays property, as its use is much faster (much) than setting the present property to false.

Multi-pass token replacement

When this option is set to true, Q++Studio will start at the beginning of each textbox for each text replacement of tokens.

 

It is needed for case when complex recursion of tokens involving attributes (bold, italic, symbols, ...) lead to a Cannot Find Text ... run-time message, although the text was indeed present in the textbox. This occurs because Q++Studio searches through each textbox in a single-pass, assuming that text replacements are generated in the proper order. The single-pass saves time, but if the search/replace commands are in the wrong order (extremely rare) then some text to be replaced is missed.

 

Setting Multi-Pass to true is therefore only truly necessary if you generate a lot of text, with varying attributes, from a single token. However, the speed reduction from setting this option to true is minimal and therefore we recommend to always set this option to true to be safe.

Remove Hyphenation

Recommended default: true. This option is sometimes needed when complex typographical changes, as occurs in many GenTokens, can confuse QuarkXPress and cause it to crash during diary generation. When this option is set to true, before processing each token, Q++Studio removes the automatic hyphenation for that token text. This is equivalent to setting the H&J Format value to No Hyphenation.

 

Note that you can have some H&J assets' hyphenation setting be kept, by including "HYPH" (in uppercase, without the double-quotes) in the name of one or more H&J assets.

Unlink and relink textboxes

This option is sometimes needed when complex typographical changes in a chain of linked textboxes can confuse QuarkXPress and cause it to crash during diary generation.

 

When this option is set to true, before processing each textbox, Q++Studio checks if the textbox is linked and then breaks the link with the other textboxes so that all text replacement is done in one box. Then after all the token and text replacements are performed, the textbox chain is relinked.

Remove OPF layers

Setting this option to true means that, after diary generation, Q++Studio will tell QuarkXPress to move all objects from any non-default layer to the default layer, and will delete all non-default layers, in the output file. Note that this property has no use if you are using the default value of true for the Remove GridTemplate layers option as is recommended.

Verify page objects' sizes

This property is currently not implemented.

Force ANSI generation

This property, which only applies when using version 7 or above of QuarkXPress, forces Q++Studio to send ANSI text replacement instructions rather than the default Unicode text format used by all versions of QuarkXPress beginning with version 7. There is almost never any reason to set this property to true. Recommended default: false.

Break on NULL char

This option is internally set to always true, for the moment, and is used to warn of spurious NULL characters which can caused unexpected crashes of QuarkXPress.

Temp files deletion

This option (only available for QuarkXPress versions 4 and above) is used to tell QuarkXPress what to do, at the end of diary generation, with the temporary QXD/QXP files it generated in the c:\temp\qpp\tmpqxd\ folder:

 

Do not try to delete

The XNT will not try to delete any of the temporary files it created. This is the value to use in the extremely rare cases when the default, below, is not appropriate.

Use Windows

(default)

The XNT will try to delete the temporary files it created, using the Windows API call used to delete files. This is the default and should rarely need changing.

Use QuarkXPress

The XNT will try to delete the temporary files it created, using the internal QuarkXPress command available through the Quark Xtension API.

 

Note that this property/option specifies what the XNT should do after diary generation, prior to closing down. However, the XNT will always try to empty out the the c:\temp\qpp\tmpqxd\ temporary folder, prior to diary generation.

Seed pages deletion

This option should always be set to After page copying.

Buffer end pages

This property should always be set to None.

Delay - Page Copying

A delay, inserted after the page copying stage, used to give time to QuarkXPress to re-synchronize its internal threads and structures. The default value of 1000 milliseconds is usually sufficient for most cases.

Delay - Seed pages

A delay, inserted after the page copying stage, used to give time to QuarkXPress to re-synchronize its internal threads and structures before deleting the seed pages. The default value of 1000 milliseconds is usually sufficient for most cases.

Delay - OPF transfer

A delay, inserted after diary generation is complete, but before QuarkXPress closes down, used to give time to QuarkXPress to re-synchronize its internal threads and structures. The default value of 1000 milliseconds is usually sufficient for most cases.

 

If you want any of the above settings values to be standard for all new script created in the future, then you can change the default values of all the diary generation options that correspond to ScriptLine Property by going to the Execution Preferences.


Topic 177215 updated on 03-May-2018.
Topic URL: https://www.qppstudio.net/webhelp_xv4/index.html?diarygenerationtestingtroubles.htm