Holiday Symbols Display Options ([â]..[û] tokens)

Navigation:  ScriptLine Properties > Holidays (display) >

Holiday Symbols Display Options ([â]..[û] tokens)

Previous pageReturn to chapter overviewNext page

The Holiday Symbols options allow you to fine-tune the way the result of the [â]..[û] tokens is displayed (this will also work for the [fa]..[fu] tokens, if you have set the Display Symbol option to true in the Holiday Name display options).


The Holiday Symbols display options assume that the value of the Holidays Symbols, as specified in the Holidays Manager, is made up of single character symbols, with no spaces between each character :


The options are :



Separator : If this field is not blank, then Q++Studio will insert the text you have defined as separator, between each individual character of the Associated Symbols fields of recurring holidays and one-time-dates. Note that :


You can use Special Characters Tokens to insert tabs and carriage returns.


These separators will also be used to separate individual symbols, in the event of multiple recurring holidays or one-time-dates occurring on the same date.


The separators appear in whatever font is used in QuarkXPress for the token being converted, unless the Use symbol font option is checked, in which case the text specified in the Separator field will appear using the Symbol Font of the Holidays Sets of the particular aeiou-Holidays List


By default, the Default Holiday Font which you can specify in Preferences, is pre-selected in the Font ComboBox. You can change this selection, and this change will be saved along with this property, but it is important to note that this font is only a display aid, and does not influence the code generated by Q++Studio which uses the Symbol Font of each of the Holidays Sets of the particular aeiou-Holidays List.


Sorting : Use this option to tell Q++Studio if the symbols should be sorted and/or filtered. The 2 sorting options are :



The result of the holiday Special Characters Token conversion are not sorted (they are left in the order in which they appear in the Holidays Manager), but if the value of the separator above is not blank, then each symbol is separated using the text contained in separator.

Use Filter Below

Filters the result of the [â]..[û] tokens conversion, to match the order and selection of symbols specified in the ButtonEdit below.

No Duplicates

This option is similar to None, above, in that it does not filter, nor does it sort the holidays symbols. However it does remove duplicates from the list of symbols resulting from the evaluation of a symbols token. Note that the first occurrence of a symbol will be the one kept, and any subsequent duplicate will be removed.


The No Duplicates option is best used when each holiday has only one symbol, and each holidays set has only one symbol running through it. Then you can be sure that symbols will appear in the order of the sets in the aeiou-holidays property. Otherwise you should use the Use Filter Below option.


The Filter option is extremely powerful, because it allows you to make a single master list of holidays symbols, one possibly containing holidays from over a hundred countries, and have the symbols that appear be dependent on the Script, not the Holidays Set.


Suppose, for example, we had a single, master, Holidays Set that contained the symbols to holidays for 120 different countries. Using the filter below left, we could ensure that only the symbols for the US, Canada and the UK appeared when an [fâ] token is found in the current script. Using the filter, below right, and the same master Holidays Set, we could have another script that only displays the symbols of Belgium, France and Switzerland.




What's more, the filters also act as sorters. If we wanted the diaries above to display symbols in a different, customized, order, all we would need to do is to change the filters :




Note that the above 4 different ways of displaying symbols were accomplished using a single master Holidays Set, with no need to specify each holiday priority.


The Layout option can be used to better format the series of symbols, particularly when there are more than can fit on a single line.



These options are:


Break equally if too long

This option will break the series of symbols into 2 roughly equal substrings, if the string is too long to fit on a single line, and leaves orphaned symbols on the second line. This helps avoid unsightly results such as the first below, and instead produces results such as the second one below.




Note that to compensate for the width of the word Holiday, the above example uses an Offset value of 3, which tells Q++Studio that there is some text before the string of symbols, and that this text is roughly equivalent in width to the width of 3 of the symbols font characters.

Break after max char number

This option can be used to specify that a line of symbols should never contain more than a given number of symbols (determined by the value of Max char).




Additionally, the setting lets you specify if the partial (orphaned) lines should be at the top (see example above left) or the bottom (example above right).



See also : Holidays Abbreviation Display Options.

Topic 173520 updated on 03-May-2018.
Topic URL: