Use a consistent scheme to define the height and width of GridTemplates

Make sure that you are consistent on the definition that you use to determine what the size of a GridTemplate refers to. Is it the image size ? The untrimmed page size, or the final trimmed page size ? Each of the above is a valid choice, but you must always be consistent, mostly if you will be importing non-dated Quark pages as info pages.

Do not use facing pages in GridTemplates

When creating a new QuarkXPress document to be used as a GridTemplate, always make sure that the 3 options shown on the right are unchecked.

If the Allow Odd Pages on Leftbox is grayed-out, then this means that you still have one or more facing pages master pages. Remove these master pages and then this option will be enabled (this option only exists in QuarkXPress version 8 and above).

Even though GridTemplates should not use facing pages, output files can use facing pages, which is almost always the case.

Do not use sections in your GridTemplate

The problem with the use in Q++Studio of QuarkXPress pages that belong to a section, is that, even after they are copied to the output file, they keep on thinking that their page number is the page number set in the section of the original file.

So, for example, using a 2-page GridTemplate where the first page is 55 and the second is 56, generates an output file where all the pages are either 55 or 56, instead of 1, 2, 3, 4 ...

This causes errors in tokens replacement and Saras since the entire file is only made up of pages 55 and 56.

You should therefore never create GridTemplates with sections, and if you are using an existing QuarkXPress file, you should remove sections from any QuarkXPress files that you want to use as GridTemplate (as well as for plain Quark Files).

Textboxes or groups should not straddle 2 pages

When a GridTemplate is scanned, each textbox is associated with a unique page number, and this relationship is used to convert the DayValues of each token, based on the starting date of the page that contains its textbox.

Groups of objects in QuarkXPress are essentially a collection of objects bounded by an additional box, as shown above. Therefore groups should also not straddle 2 pages.

Use master pages only for margins

The tokenized pages of your GridTemplates already serve the same purpose as QuarkXPress master pages, in a much more powerful manner.

Having 2 levels of "masters" can only lead to user (and sometimes QuarkXPress) confusion.

The only information that should be specified in your GridTemplate's master pages are the page margins, as shown in the image on the right.

Do not mix tokens of different DayValues in the same textbox

Generally, each textbox should only contain tokens of the same DayValue.

One possible exception is when the tokens are really part of a combined token where multiple DayValues are the essence of what is being displayed, such as:

[1Week] [1w] [1d] [1mmm] - [7d] [7mmm]

which would result in "Week 37: 7 sep - 13 sep".

Make sure Q++Studio can guess what DayValues belong to which page

Q++Studio guesses by looking for tokens of the form [d] on each page. If there is a risk of confusion, use DayValue marker tokens.

Confusion can arise, for example, in a daily diary, where on each page you show the first and last days of the current week with the tokens [1Week] [1w] [1d] [1mmm] – [7d] [7mmm]. Q++Studio will think you have a 7 days on 2 pages diary (ie a weekly) even though you have a day on the left page and a day on the right page. By placing a [1*] token on the left page and a [2*] token on the right page, you tell Q++Studio unambiguously that DayValue 1 is on the left page and DayValue 2 on the right page.

Use linked textboxes only when necessary

In general, there is seldom the need to use linked textboxes in GridTemplates, and it is generally discouraged, with a few exceptions where linked boxes are useful and even sometimes necessary.

Try to limit grouping/locking of textboxes, in particular nested grouping

You should only group objects together when grouping is necessary (for example when wishing to group delete as the result of a zap token or a macro).

Although Q++Studio is able to selectively delete objects that are grouped, when the grouping is nested (ie. a set of grouped objects is grouped with another set of grouped objects), then QuarkXPress can get confused, generating strange messages during token replacement, or even causing QuarkXPress to crash, during diary generation.

Make sure Style Sheet and/or Color names are unique across all the GridTemplates of your Script

During diary generation, pages, from all the Quark documents used in the current script, are copied into the same output file. Attributes from incoming pages are added to the output file by name.

If a style sheet of a given name, such as Months, for example, already exists in the output file and pages from another Quark file are copied, which also contain the style sheet Months, then what happens is unpredictable, and often depends on the version of QuarkXPress that you are using.

The same unpredictable results would occur, for colors, if 2 Quark files used in a script both used a color of the same name.

You should be pro-active and ensure your that attributes such as colors and style sheets are uniquely named across all the Quark files used in a script.

Do not use textboxes for bleed

Quark can assign an unexpected page number to textboxes which extend beyond the boundaries of a page, in particular objects extending to the left of the left-most page of a spread (but this can also happen to rotated object to the right of the right-most page of a spread).

In such cases, it can make it impossible to relate the page number of a scanned token when it comes to diary generation, leading to error messages.

Therefore, if you need shade to bleed off the page, use a box of content "none" rather than a text box.

You can then put any related text in a separate textbox which should not need to bleed, as shown in the example on the right.