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.

 

At the top of the Sara definition, is a field where you can enter your own comments.

 

Comments

Comments are useful to remember the original situation that made the use of a SARA necessary, and any assumption made about font and font size, as well as links to online resources, such a in the example below:

Comments can be used to explain the purpose of the regular expression (something that is not always obvious at first glance) and to include a link to the saved online version of that regular expression, as well as the reason for the repeat values list (if any).

 

 

Each Sara is then composed of:

 

Find and Change

Text, with or without attributes, to be searched for and used as replacement.

 

 

Regular Expressions

 

The Find field can contain regular expressions and the Change field can contain capture groups from the Find's regular expression.

 

 

Repeated List of Values

 

In addition, if you have the need to use the same Sara but for a series of different find and/or change texts, then you can use repeated Sara markers to have the current Sara repeated for as many times as there are entries in the Repeat List, with the repeat marker(s) being replaced each time.

 

 

In the above example, which is a variation of the image just above it, instead of specifying that we want to search for Anzac Day followed by a parenthesis containing uppercase letters and/or * and/or -, we specify that we want to look for some text (represented by the <1> repeat marker) whose value will come from the repeat list, such as the one in the example to the right.

 

In the above example there is only one repeat marker, <1>, but you can have as many as you wish, <2>, <3>, <4>, ... In such cases, each line should contain the values for all these markers separated by a caret sign ^.

 

 

You need to ensure that all values for the same repetition are on the same line and, therefore, if you wish the values to be multiline and contain soft or hard returns, these must be replaced by the special character tokens &s and &c respectively.

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. Note that the search and replace text can include regular expressions.

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.

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

 

Text Background Shading

QuarkXPress 2017

Text Background Shading is similar to the effect obtained using the rule above/rule below paragraph attributes but have the added advantage that this is a text property meaning that this background shade can be applied to dis-contiguous text ranges, and even with different attributes for different text on the same line.

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

 

Advanced Search Options

 

QuarkXPress 2016

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 Sara Change Options

QuarkXPress 2016

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

 

SARAs Paragraph Options

SARAs Paragraph Options

Box Sara Change Options

QuarkXPress 2016

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 color, thickness and style

box-wide text elements:

othe number of columns

othe gutter width

othe vertical alignment

othe first baseline alignment

othe text inset.

replacing the textbox by an image

owhich can be set as transparent (for black & white and vector images)

owhose X/Y position offset can be specified

owhose X/Y scale change can also be specified

SARAs Picture Box Options

SARAs Picture Box Options

SARAs Frame/Background Options

SARAs Frame/Background Options

Saras Box-wide Text Options

Saras Box-wide Text Options

 

The textbox, by itself or along with all objects that are part of the same group, can be deleted, as well as all objects on the same page and layer, or the page containing the current textbox can be deleted.

 


Topic 104265 updated on 14-Nov-2018.
Topic URL: https://www.qppstudio.net/webhelp_xv4/index.html?theelementsthatmakeupasara.htm