A Guide to XPress Tags 2016
CONTENTS Contents Understanding XPress Tags.........................................................4 Importing tagged text......................................................................................4 Generating tagged text in another application.................................................4 General information on XPress tags.................................................................4 Character and paragraph formatting...........................................6 Character attributes...
CONTENTS Specifying index tag information....................................................................24 Legal notices...............................................................................
UNDERSTANDING XPRESS TAGS Understanding XPress Tags With XPress Tags Filter XTensions® software, you can use plain text files to import and export text into QuarkXPress® layouts with paragraph and character attributes already applied. Because the plain text file format doesn't actually support attributes, the formatting is indicated with codes that are translated by the XPress Tags filter.
UNDERSTANDING XPRESS TAGS • XPress Tags codes are case-sensitive. • XPress Tags codes for character and paragraph attributes must begin and end with angle brackets (< >). For example, the XPress Tags code for boldface text is . • To combine character attribute codes, begin with a left angle bracket, then enter the codes you want to specify, and complete the code with a right angle bracket. For example, the code for bold italic text is .
CHARACTER AND PARAGRAPH FORMATTING Character and paragraph formatting When you specify type styles using XPress Tags codes,
always sets the type style to Plain. When you specify any other type style (for example, for Bold), that style is applied if it isn't already specified, and is removed if it has been specified. For example, the first time you specify , the Bold type style is applied to the text that follows.
CHARACTER AND PARAGRAPH FORMATTING • Horizontal scale*: in percentage of scale • Kern*: in 1/200 em space • Track*: in 1/200 em space • Send†: Same tag as tracking but with a value in points added to the end • Set baseline shift*: in points • Vertical scale*: in percentage of scale • Ligatures: to turn on, or to turn off • Opacity*:
CHARACTER AND PARAGRAPH FORMATTING • English (US): • Estonian: • Finnish: • French: • German: • German (Reformed): • German (Swiss Reformed): • German (Swiss): • Greek: • Hungarian: • Icelandic: • Italian: • Japanese: • Korean: • Latvian: • Lithuanian: • Norwegian (Bokmal): • Norwegian (Nynorsk: • Polish: • Portuguese (Brazilian): • Portuguese (European): • Romanian: • Russian:
CHARACTER AND PARAGRAPH FORMATTING <\#9Rubi text\#132,50,C,A,0,2,B,T)> The contents of this tag are as follows: • encloses the tag. • /#68 and /#36 mark the beginning and end of the base text. • <@> lets you style the rubi text (see "Character attributes"). • \#n marks the beginning of the rubi text, where n = the number of rubi characters (in the above example, 9). • \#132 marks the end of the rubi text and the beginning of the rubi
CHARACTER AND PARAGRAPH FORMATTING Like style sheet definitions, font set definitions are stored in XPress Tags files. For example, if you export text that uses a font set named "Fontset 1," the definition of Fontset 1 is exported in the form of a tag like the following, at the beginning of the XPress Tag file: @Fontset 1=[F]<"HiraMinPro-W3",100,0,h100,"GrecoStd-DB",100,0,h100, "Corbel",100,0,h100,"HiraMinPro-W3",89.999,-5,h105,"Times-Roman",100,0,h100> In text, font set tags are as follows:
CHARACTER AND PARAGRAPH FORMATTING • Standard Ligatures: liga • Numerators: numr • Ordinals: ordn • Ornaments*: ornm • Proportional Lining: plin • Proportional Oldstyle: pold • Ruby Notation Forms†: ruby • Scientific Inferiors: sinf • Stylistic Alternates*: salt • Small Caps: smcp • Subscript: subs • Superscript: sups • Swash: swsh • Titling Alternates: titl • Tabular Lining: tlin • Tabular Oldstyle: told • Slashed Zero*: zero • Vertical Kana Alternates†: vkna *This is a glyph attribute; see above.
CHARACTER AND PARAGRAPH FORMATTING Alternate metrics • Full Widths†: fwid • Half Widths†: hwid • Third Widths†: twid • Quarter Widths†: qwid • Proportional Widths†: pwid • Alternate Vertical Metrics†: valt • Proportional Alternate Widths†: palt • Proportional Alternate Vertical Metrics†: vpal • Alternate Half Widths†: halt • Alternate Vertical Half Metrics†: vhal *This is a glyph attribute; see above. †This feature can be applied only in a language edition of QuarkXPress that supports East Asian features.
CHARACTER AND PARAGRAPH FORMATTING 36 point First Line Indent, 16 point Right Indent, 14 point Leading, 9 point Space Before, 18 point Space After, and does not lock to the baseline grid. You can specify the first line of a paragraph as a percentage of an em space by using a decimal percentage value in the First Line Indent position (for example, use 0.6 for 60%).
CHARACTER AND PARAGRAPH FORMATTING • Bullet style: <*bb"Bullet Style Name"(7.2,0,0)>. If the layout does not contain a bullet style by this name, no bullet style is applied. In the parenthesized list, the first number is the minimum distance between the bullet and the text, the second number is the Start At value, and the third number is the Restart Numbering flag (0 = false, 1=true). Note that the last value is irrelevant for bullet styles. • Numbering style: <*bb"Numbering Style Name"(7.2,0,0)>.
CHARACTER AND PARAGRAPH FORMATTING Turn on/off styling • Turn on feature "a": • Turn on features "x", "y", and "z": • Turn on features "a" and "b", then turn on feature "c" and turn off feature "b": some text • Turn on features "a" and "y": Revert styling to style sheets • Revert features "x" and "y" to the character attributes in the currently applied paragraph style sheet:
STYLE SHEETS Style sheets You can use XPress Tags to apply character style sheets and establish a relationship between paragraph and character style sheets. Defining style sheets Style sheet definitions may include paragraph attributes only, character attributes only, or both paragraph and character attributes.
STYLE SHEETS preceding @ with an "x." This clears any existing character attribute overrides. For example, applies the Normal character style sheet, erasing any existing character attributes.
STYLE SHEETS • Set type style according to character attributes in the applied paragraph style sheet: <$> • Set type style according to character attributes in the currently applied character style sheet: <$$> • Set all character attributes according to character attributes in the applied paragraph style sheet.
COLORS Colors A non-process color needs to be accurately defined in order to be accurately interpreted upon import. For these colors, a definition is placed at the top of the XPress Tag file similar to style sheet definitions. Defining a custom color @colorname=[C]<"colorclass",colorspec> Where: colorname = name of the color [C] = denotes a custom color colorspec = "libraryname",S or P,#,"colorsubclass" #.##,#.##,#.##,#.##,#.##,#.
COLORS colorspec = S or P,#,#.##,#.##,#.##,#.## Example: @CMYK-M50Y100spotY=[C]<"CMYK",S,3,0,0.5,1,0> if colorclass = "DIC", "FOCALTONE", "PANTONE®…", "TOYO", "TRUMATCH" then colorspec = "libraryname",S or P,#,"colorsubclass",#.##,#.##,#.##,#.##,#.##,#.## Example1: @DIC 399p spotB=[C]<"DIC","DIC 399p",S,4,"CMYK",0.55,0.14,0.47,0> Example2: @PANTONE 259 HexC=[C]<"PANTONE® solid in hexachrome® coated","PANTONE 259 HC",S,4,"Hexachrome",0.4,1,0,0.
SPECIAL CHARACTERS Special characters XPress Tags lets you specify character encoding and insert and manipulate special characters such as discretionary hyphens and nonbreaking spaces. Encoding One of the following three extended character set indicators is automatically placed at the top of an XPress Tags file you create using the Save Text command (File menu).
SPECIAL CHARACTERS Other special characters Some special characters have their own XPress Tags codes. Use the following codes to define these characters. • New line (Soft return): <\n> • Discretionary return: <\d> • Hyphen*: <\-> • Indent Here: <\i> • Right-indent tab: <\t> • Standard space*: <\s> • En space*: <\e> • Punctuation space*: <\p> • Flex space*: <\f> • Em dash*: <\_> • En dash*: <\a> • Discretionary hyphen: <\h> • Previous Text Box Page Number character: <\2> • Current Page Number character: <\3
SPECIAL CHARACTERS is <\#decimal value>. The # symbol is part of the code. The XPress Tags code must be three digits for the ASCII code; when entering a four-digit ASCII code, do not enter the leading zero. The following list defines the ASCII decimal codes for some common characters. • Decimal ASCII code for a character*: <\#decimal value> • New paragraph (Hard return): <\#13> • Tab: <\#9> • En dash: <\#208> • Em dash: <\#209> • Open double quotation marks: <\#210> • Close double quotation marks: <\#211>
INDEXING Indexing You can import and export QuarkXPress index tags in XPress Tags format. Text might be tagged by writers or indexers using a word processing application, and then imported into QuarkXPress for layout purposes. Alternatively, text might be exported from QuarkXPress with index tags for editing. Marking text for an index The XPress Tags for indexing let you insert index markers at the text insertion point or specify ranges of text to be indexed.
INDEXING • Style information: "stylesheetname" or "" for Entry's Style • Scope: 0, 1, 2, 3, 4, 5, or 6 (Selection Start = 0, Selection Text = 1, To Style = 2, Specified number of paragraphs = 3, To End Of = 4, Suppress Page Number = 5, Cross-Reference = code) • Sort As: "sort as text" • Selection Start: 0 • Selection Text: 1 • To Style: stylesheetname • Specified # of ¶s: Number of paragraphs • Suppress Page #: 0 • To End Of: 0, 1 (Story = 0, Document = 1) • Suppress Page #: 0 • Cross-Reference: 0, 1, 2 (S
LEGAL NOTICES Legal notices ©2016 Quark Software Inc. and its licensors. All rights reserved. Protected by the following United States Patents: 5,541,991; 5,907,704; 6,005,560; 6,052,514; 6,081,262; 6,633,666 B2; 6,947,959 B1; 6,940,518 B2; 7,116,843; 7,463,793; and other patents pending. Quark, the Quark logo, QuarkXPress, and QuarkCopyDesk are trademarks or registered trademarks of Quark Software Inc. and its affiliates in the U.S. and/or other countries.
