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:

 

Text

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

Font

The name of a font.

Size

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

Style

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:

 

H.Scale

V.Scale

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.

Kern

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.

Track

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.

Baseline

Shift

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).

Shade

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.

Opacity

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.

Text Framing

QuarkXPress 2017

Text Framing is a text property which allows framing to be applied to dis-contiguous text ranges, while remaining a single frame for the full extent of the text that has the same frame attributes.

Text Stroking

QuarkXPress 2017

 

Text Stroking is similar to the Outline face attribute, but it has the advantage that the color, shade, thickness and opacity of the outline can be controlled and, additionally, by setting the option NoFill to false, then the inside remains, allowing for the creating of 2-color text (as the result of stroking remains text and can be treated as text, not as vector shapes).

Color

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).

 

 

 

The Advanced Search Options allows you to specify, for each individual SARA, if it should only be performed on textboxes that have text overflow (or do not), and if they should be performed after the Boxfit or Boxgrow tokens (by default, SARAs are performed before Boxfit/Boxgrow tokens).

 

The multi-line text option allows you to search for text that has broken into two or more lines (or text that has not), such as in the example above right, where we wish to locate individual day lines that are too long, and apply a further SARA to them, but only those (to do this we use a regular expression to locate individual line, from return to return, before using the multi-line text option to determine if that "text" line is on one or more "visual" lines).

   

multi-line text option locating dates when there is not enough room to display all information, such as the week number

multi-line text option locating dates when there is not enough room to display all information, such as the week number

 

One important remark about the multi-line text option, QuarkXPress determines that text is over more than one line by using its LOS (Lines On Screen) structures which look at the displayed lines. So any text that is not visible, will be ignored, as is the case in the example below left, where the textbox is too small to display the 2-line text we are searching for. The solution is to extend the textbox as shown below right, so that the searched text over multiple lines is visible.

 

The Include/Exclude Matches setting, lets you specify, for each individual SARA, whether all found matches should be replaced (the default), or if the replacements should be limited to the first match (or not the first match) of each paragraph, or textbox, or page, or entire document.

 

 

 

 

Paragraph: You can apply many of QuarkXPress' paragraph attributes to the resulting text of a SARA (left, right, first indents, leading, space before, space after, horizontal alignment, ...).

 

Textbox: As part of the changes specified for each SARA, you can also specify that some of the attributes of the textbox containing the found text be changed (background color and shade, frame, or replacing the textbox by an image).

 

SARAs Paragraph Options

SARAs Paragraph Options

SARAs Textbox Options

SARAs Textbox Options

     

SARAs Picture Box Options

SARAs Picture Box Options

 

 


Topic 104265 updated on 12-Sep-2018.
Topic URL: https://www.qppstudio.net/webhelp_xe3/index.html?theelementsthatmakeupasara.htm