Sara Definition

Navigation:  Saras >

Sara Definition

Previous pageReturn to chapter overviewNext page

A Sara is essentially a "search and replace" command, that is saved in SaraSets for re-use.


Each Sara is composed of:


Find and Change

Text, with or without attributes, to be searched for and used as replacement. This is often some text being replaced by some other text, but it can also be only a set of attributes (change all 10pt Arial to 12pt Helvetica, regardless of what the text is) or a combination of both (change all occurrences of "February 29" to "February 29" in bold and red).

Page Range

The range of pages to which the Sara applies to. The page range can be defined in terms of the pages of the GridTemplate or the pages of the output file. Because Saras belong to SaraSets which can either be applied to DiaryGridLines or output files, internally, Q++Studio saves both types of page range information, and displays the appropriate one depending on the context

Advanced Options

A set of advanced search and replace options which let you narrow down the search based on the position of the text or the textbox in which it is, and expand the replacement by acting on attributes of the paragraph and/or textbox containing the found text..



The Find and Change sets of attributes are in turn made up of 4 elements, which appear in the Sara Editor:



Depending on the context, this is either the text that the Sara searches for, or the text it uses to replace found text.


The name of a font.


The font size. Allowed values range from 2 to 512.


All the possible attributes which can modify either the Find or Change text.



The Style family of attributes is by far the most extensive. These attributes follow the naming conventions used in QuarkXPress. For a definition of each of these terms see the QuarkXPress documentation or help file. The first 12 attributes are typographical and well known. The only exception is Plain, which is a particularity of QuarkXPress.


The remaining attributes are more complex, often but not always, measured with 2 decimals:




Represent horizontal and vertical scale; how "squished" or "squashed" each letter is. Their values are expressed in percentage and are limited to the range of 0.01 to 100.


Relates to the separation between pair of characters. Zero kerning means that 2 characters are spaced by the normal amount as defined by the current font. Negative kerning means letters are brought closer together, positive kerning means they are further apart. The allowed range is –326 to + 326.


Similar to kerning, but applies to an entire font rather than to pairs of letters. Tracking values are limited to the range of –326 to + 326.



Determines by how much the baseline of each character is moved up or down from the norm. The baseline is the "bottom" of any letter that has no "tail" (such as "a,b,c" as opposed to letters that have a tail such as "p,j,y,g"). Baseline shift is measured in points, and is limited to the range –24 to + 24 (+/- 2 picas).


Determines the intensity with which the current character's color will be displayed. It is measured in percentage and ranges from 0.01 to 100.


Determines the opacity with which the current character's color will be displayed. It is measured in percentage and ranges from 0.01 to 100.


The Color style attribute lets you specify to color of the text to find, or to change to. The colors available come either from a list of all the colors from all the scanned templates (if applying Saras to an entire output file), or from the colors defined and used in the current GridTemplate (if applying the Sara to a DiaryGridLine).

Topic 104265 updated on 14-Nov-2018.
Topic URL: