XSL/CSS Extensions

Antenna House Formatter V7.4 provides you with numerous XSL proprietary extension elements and properties. When you use the extension elements or properties in XSL, be sure to specify the namespace URL http://www.antennahouse.com/names/XSL/Extensions.

<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format"
         xmlns:axf="http://www.antennahouse.com/names/XSL/Extensions">

Antenna House Formatter V7.4 also provides many CSS extensions. In this document, CSS 2.1 or CSS3 properties with restrictions are written together with XSL properties. See also “XSL/CSS Properties”. Although many of CSS3 specifications are included, many of them are in the state before Recommendation. It is safer for these properties of CSS3 specifications to use by adding the -ah- prefix. It is written as (-ah-) in this document. Although the property without adding -ah- will work with Antenna House Formatter V7.4, the specification may change in the future. It is not necessary to add -ah- to the property of Recommendation (or Candidate Recommendation, Proposed Recommendation) such as CSS 2.1. For more details, see also Property Value Syntax.

Extended Elements

Extended elements are provided only for XSL.

Element nameDescription
<fo:change-bar-begin>Extends the child element so that <fo:float> can be described as the content of the element. no-LT
<axf:counter-style> / CSS @counter-style Defining Custom Counter Styles. no-LT
<axf:custom-property> / HTML <meta>Specifies the custom property. This information is embedded in PDF. no-LT
<axf:document-info> / HTML <meta>Specifies the document information. This information is embedded into the PDF.
<axf:font-face> / CSS @font-face Appends a font. no-LT
<axf:footnote-number> Generates a footnote number. no-LT
<axf:footnote-number-citation> Cites a footnote number. no-LT
<axf:form>Encloses the unit of the form action. no-LT
<axf:form-field>Generates a form field. no-LT
<axf:form-field-event>Defines the form action which corresponds to the event. no-LT
<axf:form-field-option>Specifies the component elements of the list box, combo box. no-LT
<axf:formatter-config>Specifies additional option setting information. no-LT
<axf:hyphenation-info>Specifies additional hyphenation information. no-LT
<axf:index-page-citation-range-f-suffix>Specifies the suffix when merge-sequential-page-numbers="merge-f". no-LT
<axf:index-page-citation-range-ff-suffix>Specifies the suffix when merge-sequential-page-numbers="merge-ff". no-LT
<axf:output-volume-info>Outputs PDF in Multiple Separate Volume. no-LT
<fo:page-sequence>Extends so that <fo:page-sequence> can be nested and described as a child element or otherwise an empty element is allowed. no-LT
<axf:ruby>Generates a ruby area.
<axf:ruby-base>Generates a ruby base area.
<axf:ruby-text>Generates a ruby text area.
<axf:script-font> Specifies the generic font according to the script.
<axf:space-end-punctuation>Specifies the amount of space after the punctuation in European Typography.
<axf:space-start-punctuation>Specifies the amount of space before the punctuation in European Typography.
<axf:space-between-digit-and-punctuation>Specifies the amount of space between the digit and the punctuation in European Typography.
<axf:space-between-punctuation-and-digit>Specifies the amount of space between the punctuation and digit in European Typography.
<axf:spread-page-master>Specifies a two-page spread. no-LT
<axf:spread-region>Specifies a region in a two-page spread. no-LT
<axf:tab>Inserts white spaces up to the tab stop position. no-LT
<axf:table-cell-repeated-marker>Specifies the contents to be displayed in the split cell. no-LT

Extended Values

Extended values are provided for one or both of XSL and CSS. Extended values may differ between XSL and CSS.

Property nameDescription
<border-style>Extended the dot-dash, dot-dot-dash, and wave, etc. properties defined in old CSS3. These styles are preferred in the following order:
  1. hidden
  2. thin-thick-thin
  3. triple
  4. thick-thin
  5. thin-thick
  6. double
  7. solid
  8. dashed
  9. dot-dash
  10. dot-dot-dash
  11. dotted
  12. ridge
  13. outset
  14. groove
  15. inset
  16. emboss
  17. imprint
  18. double-wave / double-wavy
  19. wave / wavy
This order is not described in CSS3.
<color>The value of <color> in XSL-FO is one of the following:
  • #RRGGBB or values in #RGB format
  • The sixteen basic color names; i.e., aqua, black, blue, fuchsia, gray, green, lime, maroon, navy, olive, purple, red, silver, teal, white and yellow
  • rgb(), rgb-icc(), system-color() functions
The following values are extended to be able to specify. In the CSS specification, transparent is equivalent to rgba(0,0,0,0). In Antenna House Formatter V7.4, transparent characters are not output, although the size is secured. rgba(0,0,0,0) outputs characters.
break-after, break-beforeExtends the value of the break-after and break-before property in CSS.
displayExtends the value of the display property in CSS.
display-alignExtends the value of the display-align property.
font-size-adjustExtends the value of the font-size-adjust property.
font-stretchExtends the value of the font-stretch property.
font-variantExtends the value of the font-variant property.
force-page-countExtends the value of the force-page-count property.
formatExtends the value of the format property.
hyphenateExtends the value of the hyphenate property.
hyphenation-push-character-countExtends the value of the hyphenation-push-character-count property.
hyphenation-remain-character-countExtends the value of the hyphenation-remain-character-count property.
initial-page-numberExtends the value of the initial-page-number property. no-LT
internal-destinationExtends the value of the internal-destination property. no-LT
leader-alignmentExtends the value of the leader-alignment property.
merge-sequential-page-numbersExtends the value of the merge-sequential-page-numbers property. no-LT
odd-or-evenExtends the value of the odd-or-even property. no-LT
overflowExtends the value of the overflow property.
page-positionExtends the value of the page-position property. no-LT
sizeExtends the value of the size property.
table-omit-footer-at-breakExtends the value of the table-omit-footer-at-break property. no-LT
table-omit-header-at-breakExtends the value of the table-omit-header-at-break property. no-LT
text-transformExtends the value of the text-transform property. no-LT

Extended Functions

Both FO and CSS functions are extended. For CSS3 functions, see also CSS3 Functions.

Function nameDescription
rgb-icc()Extends the rgb-icc() function.  <color>
rgb()The rgb() function is available with both CSS and FO. Its 3 arguments can be given like rgb(<R>,<G>,<B>). For <R>,<G>,<B>, % values, or values from 0 to 255 are given.  <color> Introduction to CSS for Paged Mediargb()
rgba()The rgba() function from CSS3 RGBA color values is available with both CSS and FO. Its 4 arguments can be given like rgba(<R>,<G>,<B>,<A>). For <R>,<G>,<B>, % values or values from 0 to 255 are given. For <A>, % values, or values from 0.0 to 1.0 are given. You can also give a color name instead of <R>,<G>,<B> and write it like rgba(green,0.5).  <color> Introduction to CSS for Paged Mediargba()
hsl()The hsl() function from CSS3 HSL color values is available with both CSS and FO. Its 3 arguments can be given like hsl(<H>,<S>,<L>). Unitless numbers are given to <H>. For <S>,<L>, % values, or values from 0.0 to 1.0 are given.  <color> XSL-FO Samples CollectionColors as Hue, Saturation, and Lightness
hsla()The hsla() function from CSS3 HSLA color values is available with both CSS and FO. Its 4 arguments can be given like hsla(<H>,<S>,<L>,<A>). Unitless numbers are given to <H>. For <S>,<L>, % values, or values from 0.0 to 1.0 are given. For <A> % values, or values from 0.0 to 1.0 are given.  <color> XSL-FO Samples CollectionColors as Hue, Saturation, and Lightness
cmyk()Available to use cmyk() function. 4 arguments can be given like cmyk(<C>,<M>,<Y>,<K>). For <C>,<M>,<Y>,<K>, % values, or values from 0.0 to 1.0 are given. cmyk(<C>,<M>,<Y>,<K>) is equivalent to rgb-icc(#CMYK,<C>,<M>,<Y>,<K>).  <color> Introduction to CSS for Paged Mediacmyk()
cmyka()Available to use cmyka() function. 5 arguments can be given like cmyka(<C>,<M>,<Y>,<K>,<A>). For <C>,<M>,<Y>,<K>,<A>, % values, or values from 0.0 to 1.0 are given.  <color> Introduction to CSS for Paged Mediacmyka()
linear-gradient()It is a function expressing the gradation. no-LT
radial-gradient()
repeating-linear-gradient()
repeating-radial-gradient()
counter()Extends the counter() function from CSS. It can be used only with CSS.
attr()The attr() function from the specification in CSS3 Values is available. It can be used only with CSS.
-ah-attr-img()Same as attr(), but provided for referencing the width/ height of an image such as <img>. It can be used only with CSS.
-ah-attr-from()Extends the attr() function. It can be used only with CSS.

Extended Units

Besides the units defined by the XSL specification, the following units can be used. These can also be applied to CSS.

Unit nameDescription
remUnit of em in the root element. It cannot be used for the value of the font-size property in the root element.  CSS Values and Units
dcemUnit of the value based on the font size of a dropped initial. It can be used in elements for which the axf:initial-letters property is specified. It cannot be used for the value of the axf:initial-letters property. When dcem is not available, it is treated as em.
exUnit of the value based on x-height of the font. When the font does not have x-height, a value of 0.5em should be used.  CSS Values and Units
capUnit of the value based on cap-height of the font. When the font does not have cap-height, a value of altitude of the font should be used.  CSS Values and Units
jptUnit of the absolute value defined by JIS Z 8305. 1jpt = 0.3514mm.
qUnit of the absolute value expressing Q (quarter) by JIS X 4052, JIS Z 8125. 1q = 0.25mm.
dpiUsed when expressing the resolution with axf:image-resolution.
dpcmUsed when expressing the resolution with axf:image-resolution.
emu Unit of the absolute value expressing English Metric Unit. 1emu = 1in/914400 = 1cm/360000.
chUnit of the length expressing the width of character "0" U+0030 to be 1. When the glyph is not in the font, a value of 0.5em should be used.  CSS Values and Units
icUnit of the length expressing the width of character "" U+6C34 to be 1. When the glyph is not in the font, a value of 1em should be used.  CSS Values and Units
lhUnit of the length expressing the line-height to be 1. Even if line-height="2" is specified, for example, lh is converted into the absolute value. It cannot be used for the value of the line-height property.  CSS Values and Units
rlhUnit of lh in the root element. It cannot be used for the value of the line-height property in the root element.  CSS Values and Units
vwUnit of the width expressing the viewport width as 100. It cannot be used with elements for which a viewport, such as the root element, has not been established.  CSS Values and Units
vhUnit of the height expressing the viewport height as 100. It cannot be used with elements for which a viewport, such as the root element, has not been established.  CSS Values and Units
vminEqual to the smaller length of vw or vh. It cannot be used with elements for which a viewport, such as the root element, has not been established.  CSS Values and Units
vmaxEqual to the larger length of vw or vh. It cannot be used with elements for which a viewport, such as the root element, has not been established.  CSS Values and Units
pvwUnit of the width expressing the page width as 100. It cannot be used with elements for which a viewport, such as the root element, has not been established.
pvhUnit of the height expressing the page height as 100. It cannot be used with elements for which a viewport, such as the root element, has not been established.
pvminEqual to the smaller length of pvw or pvh. It cannot be used with elements for which a viewport, such as the root element, has not been established.
pvmaxEqual to the larger length of pvw or pvh. It cannot be used with elements for which a viewport, such as the root element, has not been established.
grUnit to specify spanning columns. It cannot be used with elements that do not have a reference area such as the root element.
frFraction of the leftover space in a grid container. V7.4 no-LT

Other XSL Extensions

  1. In the XSL specification, the unit has to be put on the value which shows the length. In Antenna House Formatter V7.4, “0” without the unit is also acceptable only when the length value is zero.

  2. In the XSL Specification, the description order of <fo:region-*>XSL-FO Samples CollectionExplaining each region in a pageSpecify the border to the region is defined as follows:

    (region-body+,region-before?,region-after?,region-start?,region-end?)

    However its rendering order is not defined. For this reason, if a part of region overlaps, it's important to determine which region should appear first. (With z-index, the order between region-* cannot be controlled.) Antenna House Formatter V7.4 handles the <fo:region-*> elements in any description order and renders them exactly in that order. If you describe <fo:region-body> last of all, then the content can be rendered upper than the other <fo:region-*>.

  3. In the XSL Specification, the width of the padding or the border specified to <fo:region-body> or <fo:region-before>, etc. should be zero. Antenna House Formatter V7.4 can accept and process values other than zero. The following is sample code.

    <fo:region-body padding="1.5cm" border-color="red" border-style="solid" border-width="2pt"/>

  4. Although only xml:lang of the XML specification is explicitly stated in the XSL specification, Antenna House Formatter V7.4 accepts the following XML input. The same is applied to XHTML and XML+CSS.


Document Information

This section describes how to embed document information into PDF file.

<axf:document-info> / HTML <meta>XSL-FO Samples CollectionDocument Information embedded into PDFPage layout when PDF is openedIntroduction to CSS for Paged Media<meta>

Document information such as an author and title can be embedded in the PDF. Antenna House Formatter V7.4 generates document information automatically by adding the following extended elements. The information that was embedded into PDF can be seen by Adobe Acrobat or Reader.

Common Usage:

Specifies the document information. The information is not included in the generated areas. For example, this information is embedded into PDF.

Areas:

None.

Constraints:
<!ELEMENT axf:document-info EMPTY>
<!ATTLIST axf:document-info name  CDATA #REQUIRED>
<!ATTLIST axf:document-info value CDATA #REQUIRED>
Contents:

EMPTY

Examples:
<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format"
         xmlns:axf="http://www.antennahouse.com/names/XSL/Extensions">
 ...
 <fo:declarations>
  <axf:document-info name="document-title" value="The document title"/>
  <axf:document-info name="subject" value="The document subject"/>
  <axf:document-info name="author" value="The author"/>
  <axf:document-info name="keywords" value="Comma-separated keywords list"/>
 </fo:declarations>
 ...

In HTML, the setting equivalent to <axf:document-info> can be specified with the name attribute in the <meta> tag. The setting of <meta name="document-title"> will take precedence over the setting of <title>. See also (-ah-)display to learn more about <meta>.

  <meta name="document-title" content="The document title" />
  <meta name="subject" content="The document subject"/ >
  <meta name="author" content="The author" />
  <meta name="keywords" content="Comma-separated keywords list" />
  ...

The <axf:document-info> extension property can be placed as a child of <fo:declarations>, or as the first child element of <fo:page-sequence>. <axf:document-info> as a child of <fo:page-sequence> is effective only for PDF output in multi separate volume. <axf:document-info> as a child of <fo:page-sequence> overwrites <axf:document-info> as a child of <fo:declarations> and is utilized for an information of the document when outputting in separate volume. Therefore the same document information is embedded in all the separate volumes unless <axf:document-info> is specified to <fo:page-sequence>.

With Antenna House Formatter V7.4 Lite, <axf:document-info> specified to <fo:page-sequence> is ignored.

Properties of <axf:document-info> are name and value, both are required. The value of name must be one of the following. The information with “*” will be outputted either to the first document or all documents generated by multi-volume output by specifying the axf:document-info-include property. Other information will be always outputted to all documents generated by multi-volume output.

  • document-title

    Specifies the title of the document.

  • subject

    Specifies the subject (description) of the document.

  • author

    Specifies the author of the document.

  • author-title no-LT

    Specifies the title or some keywords of the author.

  • description-writer no-LT

    Specifies the author of the document description.

  • keywords

    Enumerates the comma-deliminated keyword.

  • copyright-status no-LT

    Specifies the status of the copyright using either of the following.

    • Unknown
    • Copyrighted
    • PublicDomain

    Effective with PDF1.4 or later.

  • copyright-notice no-LT

    Specifies the information of the copyright. Effective with PDF1.4 or later.

  • copyright-info-url no-LT

    Specifies the URL of the copyright information. This URL is treated just as a character string and the program does not access this URL. Effective with PDF1.4 or later.

  • xmp no-LT

    Specifies the URL of XMP. This URL follows <uri-specification> in the XSL specification. See also URI. The validity of a XMP file is checked simply whether it is well-formed or not. Effective with PDF1.4 or later.

    The following settings become invalid when XMP is specified.

    When <axf:document-info> has the following specifications, it will be compensated if there is no corresponding description in XMP.

    • document-title
    • subject
    • author
    • author-title
    • description-writer
    • keywords
    • copyright-status
    • copyright-notice
    • copyright-info-url

    In addition, the contents of Antenna House Formatter V7.4 or the current time is set to the following contents in XMP.

    • <pdf:Producer>
    • <xmp:CreatorTool>
    • <xmp:CreateDate>
    • <xmp:ModifyDate>

  • pagemode *

    Specifies the method of the display when the document is opened. The following one can be specified.

    • UseNone
      Neither document outline nor thumbnail images visible
    • UseOutlines
      Document outline visible
    • UseThumbs
      Thumbnail images visible
    • FullScreen
      Full-screen mode, with no menu bar, window controls, or any other window visible
    • UseOC
      Optional content group panel visible

    UseOC can be specified for PDF1.5 or later. The default is UseOutlines when the outline exists.

    “Document outline” is expressed as “bookmark” in Adobe Acrobat or Reader.

  • pagelayoutXSL-FO Samples CollectionPage layout when PDF is opened *

    Specifies the page layout when a document is opened. You can specify either of the following.

    • SinglePage
      Display one page at a time
    • OneColumn
      Display the pages in one column
    • TwoColumnLeft
      Display the pages in two columns, with odd-numbered pages on the left
    • TwoColumnRight
      Display the pages in two columns, with odd-numbered pages on the right
    • TwoPageLeft
      Display the pages two at a time, with odd-numbered pages on the left
    • TwoPageRight
      Display the pages two at a time, with odd-numbered pages on the right

    TwoPageLeft and TwoPageRight can be specified for PDF1.5 or later. When nothing is specified, it depends on the operation of the PDF viewer application.

  • hidetoolbar *

    Specifies whether to hide a tool bar or not when a document is opened with the value of true or false. The default value is false.

  • hidemenubar *

    Specifies whether to hide a menu bar or not when a document is opened with the value of true or false. The default value is false.

  • hidewindowui *

    Specifies whether to hide user interface elements (a scroll bar, the control for navigation, etc.). or not when a document is opened with the value of true or false. The default value is false.

  • fitwindow *

    Specifies whether to change the size of a document window to fit the page size or not when a document is opened with the value of true or false. The default value is false.

  • centerwindow *

    Specifies whether to arrange a document window in the center of a screen or not when a document is opened with the value of true or false. The default value is false.

  • displaydoctitle *

    Specifies whether to display the title of a document or not when a document is opened with the value of true or false. The default value is false. Effective with PDF1.4 or later.

  • openaction *

    Specifies the address displayed when the document is opened or the action executed. The value similar to <number-with-fragment> of internal-destination can be described here. See also Making Link too. Action with a name and JavaScript can also be specified at this time.

    • value="#Named=Print"
      The print dialog will be displayed when the document is opened.
    • value="#Named=LastPage"
      The last page is displayed when the document is opened.
    • value="#JavaScript=arbitrary JavaScript program"
      Executes the specified JavaScript.

    “#” Named coming right after or JavaScript are case insensitive. Actions which can be specified to Named correspond to the menu name of a viewer. The operation in the case where an unknown name is specified to Named, or in the case where the wrong program is specified to JavaScript are not guaranteed. JavaScript cannot be specified with PDF/A. If allow-javascript="false" is specified in the Option Setting File, the specified JavaScript is ignored.

  • createdate, modifydate

    Specifies “/CreationDate”, “/ModDate” in PDF. When modifydate is not specified, it is considered the current time. When createdate is not specified, it is considered modifydate. If modifydate is older than createdate, it will be adjusted to createdate.

    The date format is a string in the ISO 8601 format. The following format of this standard is accepted:

    • YYYY-MM-DD(Thh(:mm(:ss)?)?)?(Z|±hh(:mm)?)?

    The numbers 0 to 9 are given to Y, M, D, h, m and s, either “+” or “-” is given to “±”. Date “-” and time “:” separators may be omitted. For example, the following strings are acceptable:

    • 2018-04-13T12:34:56+09:00
    • 2018-04-13T12:34+09
    • 20180413T123456+09
    • 20180413T1234

    When time zone is omitted, it is considered the system time zone (local time). Even dates that do not exist are appropriately corrected. The setting is ignored for dates before 1970, invalid strings, and dates that cannot be corrected.

  • duplex

    Specifies whether to print on both sides. You can specify one of the following:

    • Simplex
      Single side
    • Vertical
      Both sides (Open left and right)
    • Horizontal
      Both sides (Open up and down)

    Effective only with <axf:document-info> which is a child of <fo:declarations>. Eeffective with PDF 1.7 or later.

  • binding

    Specifies how the pages are bound. You can specify one of the following:

    • Left
      Left binding
    • Right
      Right binding

    Effective with <axf:document-info> which is a child of <fo:declarations>.

<axf:custom-property> / HTML <meta> no-LT Introduction to CSS for Paged Media<meta>

Specifies the custom property in PDF. Effective with PDF1.4 or later. Invalid with PDF/A.

Common Usage:

Specifies the custom property. This element does not create an area.

Areas:

None.

Constraints:
<!ELEMENT axf:custom-property EMPTY>
<!ATTLIST axf:custom-property name  CDATA #REQUIRED>
<!ATTLIST axf:custom-property value CDATA #REQUIRED>
Contents:

EMPTY

In HTML, the setting equivalent to <axf:custom-property> can be specified with the itemprop attribute in the <meta> tag. If both the itemprop attribute and the name attribute are specified, the name attribute will be ignored.

  <meta itemprop="Custom-Prop" content="blah blah blah"/>
  ...

The <axf:custom-property> extension can be placed in the child of <fo:declarations>. Its properties are name and value, both of which are mandatory. Neither should be empty. The following cannot be specified to name. name is case sensitive. itemprop in <meta> is the same as name.

  • Title
  • Author
  • Subject
  • Keywords
  • Creator
  • Producer
  • CreationDate
  • ModDate
  • Trapped

This element is not available with Antenna House Formatter V7.4 Lite.

HTML <meta name="color-profile"> no-LT

Use <meta> in HTML to specify the same as <fo:color-profile> in FO. For example,

<fo:color-profile color-profile-name="#CMYK" src="JapanColor2001Coated.icc#OutputConditionIdentifier=JC200103"/>

is described as follows:

<meta name="color-profile" content="name='#CMYK' src='JapanColor2001Coated.icc#OutputConditionIdentifier=JC200103'"/>

content is a list of <name>=<value> separated by spaces, and one of the following can be specified:

  • name=<string>
  • src=<string>
  • rendering-intent=[auto | perceptual | relative-colorimetric | saturation | absolute-colorimetric]

This feature is not available with Antenna House Formatter V7.4 Lite.

axf:pdftag / CSS -ah-pdftag no-LT

Specifies the tag name of Tagged PDF.

Value:<string>
Initial:empty string
Applies to:all formatting objects
Inherited:no
Percentages:N/A

Customizes the tag name when outputting Tagged PDF. When you want to make the tag name of the relevant element “Paragraph”, e.g., specify as follows:

<fo:block axf:pdftag="Paragraph">

When new-tagging-mode is set to true, and an empty string is specified explicitly as shown below, that element does not create a tag but belongs to the tag to which the parent area belongs.

<fo:block axf:pdftag="''">

This property is not available with Antenna House Formatter V7.4 Lite.

axf:expansion-text / CSS -ah-expansion-text no-LT XSL-FO Samples CollectionSpecifying expansion text for tags in Tagged PDF

Specifies the expansion text for tags in Tagged PDF.

Value:<string>
Initial:empty string
Applies to:all formatting objects
Inherited:no
Percentages:N/A

Specifies the description for the abbreviation, etc. in Tagged PDF.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:require / CSS -ah-require no-LT

Specifies the version of Antenna House Formatter required for formatting.

Value:<string>
Initial:empty string
Applies to:root element
Inherited:no
Percentages:N/A

You can specify the required version of Antenna House Formatter when formatting FO, HTML, etc. Formatting will not be performed if the specified version is not reached. For example, if you specify as follows:

axf:require="7.3"

only 7.3 or later can format. If you specify as follows:

axf:require="7.3.2"

only 7.3.2 or later can format. Up to four numbers can be specified.

This property is not available with Antenna House Formatter V7.4 Lite.


Multiple Separate Volume no-LT

Antenna House Formatter V7.4 makes it possible to output PDF in Multiple Separate Volume. These features are not available in CSS. These features are not available with Antenna House Formatter V7.4 Lite.

<axf:output-volume-info>

Common Usage:

Makes it possible to output PDF in separate volume per <fo:page-sequence> when outputting the formatted result.

Areas:

None.

Constraints:
<!ELEMENT axf:output-volume-info EMPTY>
<!ATTLIST axf:output-volume-info initial-volume-number NMTOKEN "1"><!-- digits -->
<!ATTLIST axf:output-volume-info format                CDATA   "1">
<!ATTLIST axf:output-volume-info bookmark-include (first|all|separate) "separate">

The <axf:output-volume-info> is placed as a child of <fo:declarations>.

Contents:

EMPTY

Examples:
<axf:output-volume-info
  initial-volume-number="2"
  format="-1"
  bookmark-include="separate"
/>

<fo:page-sequence>
  PAGE-SEQUENCE-1
  ...
</fo:page-sequence>
<fo:page-sequence>
  PAGE-SEQUENCE-2
  ...
</fo:page-sequence>
<fo:page-sequence axf:output-volume-break="true">
  PAGE-SEQUENCE-3
  ...
</fo:page-sequence>

Effective only when outputting to files. It's not available for printing or stream output. At that time the file name should be given by GUI, command line parameter or etc. The file names of separate volumes are given automatically based on the output file names. This process is done by inputting the strings formatted by the format property right before the file extension of the output file name. In the above example, when document.pdf is given to the file name, PAGE-SEQUENCE-1 and PAGE-SEQUENCE-2 are outputted to document-2.pdf, PAGE-SEQUENCE-3 is outputted to document-3.pdf.

The numeric value applied to the format property can be given by the axf:initial-volume-number property as the initial value. The format property is the same as “7.26.1. format” in the XSL-FO specification.

The volume is separated by the axf:output-volume-break property specified to <fo:page-sequence>. If the axf:output-volume-filename property is specified, only the separated volumes can be outputted with the specified file name.

The book mark of PDF in multi separate volume can be set by the axf:bookmark-include from the following options. However it is invalid for bookmarks created by <fo:bookmark>. Use axf:outline-*.

  • Adds a bookmark to the first separate volume only.
  • Adds bookmarks to all the separate volumes.
  • Adds each bookmark to each separate volume.

The following conditions are required for the actual separate volume.

  • The <axf:output-volume-info> element should be included in FO.
  • The following items are set in each interface.
    GUIMulti Volume should be checked in the PDF Output Dialog.
    Command-lineThe -multivol parameter should be specified.
    .NETtrue should be specified to the MultiVolume property.
    COMtrue should be specified to the MultiVolume property.
    JavaThe separate volume should be specified by XfoObj::setMultiVolume().
    C/C++The separate volume should be specified by XfoObj::setMultiVolume().

When you want to specify the language for each PDF output in separate volume, specify the language in <fo:page-sequence> with the language property.

axf:bookmark-include no-LT

Specifies how to include bookmarks in multi separate volume.

Value:first | all | separate | separate-group
Initial:separate
Applies to:axf:output-volume-info
Inherited:no
Percentages:N/A

Values have the following meanings:

first

Adds a bookmark to the first separate volume.

all

Adds bookmarks to all the separate volumes.

separate

Adds each bookmark to each separate volume. Bookmarks are added to the volume where axf:outline-level="1" appears. The bookmark that goes across the volume is added to the previous volume. For that reason, the external link to the other volume may be included even though axf:bookmark-include="separate" is specified. Bookmarks grouped by axf:outline-group are attached to the last separate volume.

separate-group

Same as separate, but also adds grouped bookmarks to each volume.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:document-info-include no-LT

Specifies how to include document information in multi separate volume.

Value:first | all
Initial:first
Applies to:axf:output-volume-info
Inherited:no
Percentages:N/A

Values have the following meanings:

first

Adds document information to the first separate volume.

all

Adds document information to all the separate volumes.

See <axf:document-info>. This property is not available with Antenna House Formatter V7.4 Lite.

axf:initial-volume-number no-LT

Specifies the initial volume number in multi separate volume.

Value:<number>
Initial:1
Applies to:axf:output-volume-info
Inherited:no
Percentages:N/A

This value is applied for the format property and utilized for the PDF file name to output. In the following example, the file name of the separate volume is document-2.pdf, document-3.pdf, document-4.pdf, and so on.

<axf:output-volume-info
  initial-volume-number="2"
  format="-1"
/>

This property is not available with Antenna House Formatter V7.4 Lite.

axf:output-volume-break no-LT

Separates the file in multi volume.

Value:true | false
Initial:false
Applies to:fo:page-sequence
Inherited:no
Percentages:N/A

Values have the following meanings:

true

Separates the volume newly from this <fo:page-sequence>.

false

Do not separates the volume newly from this <fo:page-sequence>.

Specifies axf:output-volume-break="true" to <fo:page-sequence> where you want to start separating the volume. The document number increases one by one. When separating the volume, axf:output-volume-break="true" is considered to be always being specified to the first <fo:page-sequence>. If axf:output-volume-break="false" is specified explicitly, it is ignored.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:output-volume-filename no-LT

Specifies the document file name in multi separate volume.

Value:<string>
Initial:empty string
Applies to:fo:page-sequence
Inherited:no
Percentages:N/A

If nothing specified, the automatic file name using the format property is adopted. If this property is specified, the specified name is adopted. This property is effective only with the top <fo:page-sequence> or with the <fo:page-sequence> where axf:output-volume-break="true" is specified.

In the following example, suppose that if document.pdf is specified as the file name of the PDF output, the separated file names will be document-2.pdf, chapterX.pdf, document-4.pdf, and so on.

<axf:output-volume-info
  initial-volume-number="2"
  format="-1"
/>

<fo:page-sequence>
  ...
</fo:page-sequence>
<fo:page-sequence axf:output-volume-break="true" axf:output-volume-filename="chapterX.pdf">
  ...
</fo:page-sequence>
<fo:page-sequence axf:output-volume-break="true">
  ...
</fo:page-sequence>

The original PDF file name cannot be omitted even though axf:output-volume-filename is specified to all the <fo:page-sequence>. This property is not available with Antenna House Formatter V7.4 Lite.


This section describes how to create bookmark and link within the PDF file.

Making Bookmark

A PDF document has a function called bookmarks. Bookmarks in Adobe Acrobat or Reader consist of a tree-structured hierarchy which serve as a “visual table of contents”, allowing the user to navigate to the target place by clicking on items. You can also check how the bookmarks are displayed in the Bookmarks Window in GUI with Antenna House Formatter V7.4.

PDF bookmark

Antenna House Formatter V7.4 generates bookmarks automatically by adding the extended properties to the objects to have bookmarks.

The following sample illustrates how to create the bookmark of the above picture.

<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format"
         xmlns:axf="http://www.antennahouse.com/names/XSL/Extensions">
  ...
  <fo:block axf:outline-level="1"
            axf:outline-expand="false"
            axf:outline-title="Colophon">
    ...
  </fo:block>
  <fo:block axf:outline-level="1"
            axf:outline-expand="false"
            axf:outline-title="Table of Contents">
    ...
  </fo:block>
  <fo:block axf:outline-level="1"
            axf:outline-expand="true"
            axf:outline-title="1. Introduction and Overview">
    <fo:block axf:outline-level="2"
              axf:outline-expand="true"
              axf:outline-title="1.1. Processing a Stylesheet">
      <fo:block axf:outline-level="3"
                axf:outline-expand="false"
                axf:outline-title="1.1.1. Tree Transformations">
        ...
      </fo:block>
      <fo:block axf:outline-level="3"
                axf:outline-expand="false"
                axf:outline-title="1.1.2. Formatting">
        ...
      </fo:block>
    </fo:block>
    <fo:block axf:outline-level="2"
              axf:outline-expand="false"
              axf:outline-title="1.2. Benefits of XSL">
      ...
    </fo:block>
  </fo:block>
  <fo:block axf:outline-level="1"
            axf:outline-expand="false"
            axf:outline-title="2. XSL Transformation">
    ...
  </fo:block>
  ...

axf:outline-expand / CSS -ah-outline-expand

Specifies whether to display the lower hierarchy of bookmark items or not.

Value:true | false
Initial:true
Applies to:block-level formatting objects
Inherited:no
Percentages:N/A

true specifies to display the lower hierarchy in the expanded state. false specifies to display in the collapsed state. In CSS, (-ah-)bookmark-state is also available.

axf:outline-group / CSS -ah-outline-group

Groups bookmark items, and outputs them collectively.

Value:<string>
Initial:empty string
Applies to:block-level formatting objects
Inherited:no
Percentages:N/A

If this property is omitted or specifies empty string, bookmark items are not grouped. If this specifies any string, the string is used as the name of group. The group with the same name is outputted collectively. The non-grouped bookmark is outputted as the group without the group name.

axf:outline-level / CSS -ah-outline-level

Indicates the hierarchy level of bookmark items.

Value:<number>
Initial:0
Applies to:block-level formatting objects
Inherited:no
Percentages:N/A

The <number> must be a non-negative integer. Initial value is 0 and it means that bookmarks should not be created. The highest level of bookmarks is 1 and it becomes 2 or more according to the hierarchy level of the bookmarks. In CSS, (-ah-)bookmark-level is also available.

axf:outline-title / CSS -ah-outline-title

Specifies the string which appears as a title of bookmarks.

Value:<string>
Initial:empty string
Applies to:block-level formatting objects
Inherited:no
Percentages:N/A

If this property is omitted or has an empty string, the text of the object to which the property is added will become the title. In other words, the following two samples create the same bookmark.

<fo:block axf:outline-level="2" axf:outline-title="1. Introduction">...
<fo:block axf:outline-level="2">1. Introduction</fo:block>

In CSS, (-ah-)bookmark-label is also available.

axf:outline-color / CSS -ah-outline-color no-LT

Specifies the color which appears as a title of bookmarks.

Value:<color>
Initial:transparent
Applies to:block-level formatting objects
Inherited:no
Percentages:N/A

When transparent is specified, the color information is not set to PDF.

This property is effective with PDF1.4 or later. This property is not available with Antenna House Formatter V7.4 Lite.

axf:outline-font-style / CSS -ah-outline-font-style no-LT

Specifies the font style which appears as a title of bookmarks.

Value:normal | italic
Initial:normal
Applies to:block-level formatting objects
Inherited:no
Percentages:N/A

Values have the following meanings:

normal

Specifies normal style.

italic

Specifies italic.

This property is effective with PDF1.4 or later. This property is not available with Antenna House Formatter V7.4 Lite.

axf:outline-font-weight / CSS -ah-outline-font-weight no-LT

Specifies the font weight which appears as a title of bookmarks.

Value:normal | bold
Initial:normal
Applies to:block-level formatting objects
Inherited:no
Percentages:N/A

Values have the following meanings:

normal

Specifies normal weight.

bold

Specifies bold weight.

This property is effective with PDF1.4 or later. This property is not available with Antenna House Formatter V7.4 Lite.

Remarks

  • These properties have to be created in block areas or inline areas (<fo:block>, <fo:inline> ...). If you specify them in an <fo:wrapper>, for example, they are not effective.
  • When the language is not supported in Acrobat and the font that belongs to the unsupported language is specified for the bookmark, there may be a possibility of the font displaying incorrectly in Adobe Acrobat or Reader.

In XSL-FO, PDF links can be created easily by using <fo:basic-link>. In HTML, <a> is used to create links.

PDF links are classified either as an internal link to a specified position in the PDF document, or as an external link to an external document. The internal-destination property of <fo:basic-link> indicates a link to a position in the same document. The external-destination property indicates a link to an external document. Below are the examples of both.

The external link specified by the local file is transformed into either “Open the file” or “World Wide Web link” by the use-launch-for-local-file property in PDF Output Settings. The external link specified by the non-local file is always transformed into “World Wide Web link”.

Furthermore, it's possible to specify professional links as follows:

  • Specifies the following actions for the external link explicitly.
    • Moves the destination inside PDF (GoToR)
    • Opens the file (Launch)
    • World Wide Web link (URI)
  • Possible to specify ID (named destination) for an external link to another PDF.
  • Possible to specify ID (named destination) for an internal link.
  • Possible to specify the page number for the external link in PDF.
  • Possible to specify the page number for the internal link.
  • Possible to specify the type of destination for the external link.
  • Possible to specify the type of destination for the internal link.
  • Possible to specify the external link in the bookmark.
  • Possible to specify the internal link in the bookmark.

For further understanding see also ISO 32000-1 or ISO 32000-2. The professional links are not available with Antenna House Formatter V7.4 Lite.

The setting of external-destination for the external link in PDF conforms to the following specification of PDF parameters. Not all the parameters are effective with Antenna House Formatter V7.4. The invalid parameters are ignored.

  • The application/pdf Media Type (RFC3778)

For example, specify as follows:

  • http://mydocs/doc.pdf#nameddest=Chapter6
  • http://mydocs/doc.pdf#page=3
  • http://mydocs/doc.pdf#page=3&zoom=200,250,100
  • http://mydocs/doc.pdf#zoom=50
  • http://mydocs/doc.pdf#page=72&view=fitH,100
  • http://mydocs/doc.pdf#view=fitb&nameddest=Chapter3
  • http://mydocs/doc.pdf#page=3&pagemode=thumbs

Only the following parameters are effective with Antenna House Formatter V7.4. The case sensitivity is ignored.

  • nameddest
  • page
  • zoom
  • view
  • viewrect

For example, it's invalid to specify fitH, fitR and fitBH for an external link. These are effective only with an internal link. If the required values for the PDF parameters are omitted in fitH, etc., the values are considered to be 0.

For external links to PDFs, it's possible to specify whether to open a new window using the show-destination property. This only applies to a PDF link destination. If show-destination="new" is specified, a new window will be opened and the PDF will be displayed in the window. If show-destination="replace" is specified, a new window will not be opened and the PDF will be displayed in the current window. When nothing is specified, it depends on the behavior of the PDF viewer application. Although it is defined as replace in the XSL-FO specification when the property is omitted, Antenna House Formatter V7.4 complies with the specification a little differently. show-destination property is invalid under the following conditions:

  • Other than the case that axf:action-type is specified as gotor or as launch when the link destination is PDF.
  • In the internal link. There may be a case that an internal link is embedded as an external link when separating the volume. show-destination specified to the internal link is effective only in that case.

Antenna House Formatter V7.4 provides the following extension properties for the professional link.

axf:action-type / CSS -ah-action-type

Specifies the action of External Link. See also Form Actions.

Value:auto | gotor | launch | uri
Initial:auto
Applies to:fo:basic-link
Inherited:no
Percentages:N/A

Values have the following meanings:

auto

Dependent on the system setting.

gotor

Opens the link destination by the “GoToR” action as PDF. The URI of the link destination is considered PDF.

launch

Opens the link destination by the “Launch” action as the file.

uri

Opens the link destination by the “URI” action as URI (World Wide Web).

When the link destination is not a local file, such as http:, the action type is “URI” at any time. When axf:action-type="auto" specified, the external link specified by the local file is transformed into either “Open the file” or “World Wide Web link” by the use-launch-for-local-file property in PDF Output Settings. The external link specified by the non-local file is always transformed into “World Wide Web link”.

axf:destination-type / CSS -ah-destination-type no-LT XSL-FO Samples CollectionDisplay of a link destination

Specifies the way a link opens in a link destination.

Value:<string>
Initial:empty string
Applies to:block level formatting object
Inherited:no
Percentages:N/A

The destination type has the following options. If nothing specified, it's accounted as axf:destination-type="xyz-top". The case sensitivity is ignored. axf:destination-type can be specified together with ID in the External Link, ID in the Internal Link, Page Number in the External Link, Page Number in the Internal Link, Bookmark with the External Link and Bookmark with the Internal Link.

Destination Type of PDFHow to specify axf:destination-type
[page /XYZ left top zoom]Antenna House Formatter V7.4 calculates the value of left/top. However it's possible to specify null or non-null explicitly. The user can specify the arbitrary value for zoom.
axf:destination-type="xyz"Specifies left and top as null.
axf:destination-type="xyz-left"Specifies top as null.
axf:destination-type="xyz-top"Specifies left as null.
axf:destination-type="xyz-left-top"
If nothing is specified to zoom, it's accounted as null. Specifies % value to zoom as follows:
axf:destination-type="xyz-top 75"
If only the numbers are specified, the value is accounted for xyz-top.
axf:destination-type="75"
[page /Fit]
axf:destination-type="fit"
[page /FitH top]Antenna House Formatter V7.4 calculates the value of top. Effective only to specify in the internal link.
axf:destination-type="fith"
[page /FitV left]Antenna House Formatter V7.4 calculates the value of left.
axf:destination-type="fitv"
[page /FitR left bottom right top]Antenna House Formatter V7.4 calculates the value of left/bottom/right/top. Effective only to specify in the internal link.
axf:destination-type="fitr"
[page /FitB]
axf:destination-type="fitb"
[page /FitBH top]Antenna House Formatter V7.4 calculates the value of top. Effective only to specify in the internal link.
axf:destination-type="fitbh"
[page /FitBV left]Antenna House Formatter V7.4 calculates the value of left.
axf:destination-type="fitbv"

This property is not available with Antenna House Formatter V7.4 Lite.

axf:outline-external-destination / CSS -ah-outline-external-destination no-LT

Sets the external link in the PDF bookmark.

Value:<uri-specification>
Initial:empty string
Applies to:block-level formatting objects
Inherited:no
Percentages:N/A

Values have the following meanings:

<uri-specification>

Specifies the URI of the link destination.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:outline-internal-destination / CSS -ah-outline-internal-destination no-LT

Sets the internal link in the PDF bookmark.

Value: <idref> | <number-with-fragment>
Initial:empty string
Applies to:block-level formatting objects
Inherited:no
Percentages:N/A

Values have the following meanings:

<idref>

Specifies the ID of the link destination.

<number-with-fragment>

Specifies the page number of the link destination. This string is simple numeric characters or the following string that combines numeric characters and a fragment with “#”. See Making Link for the fragment.

123#zoom=50

The page number also can be specified in the fragment.

#page=123&zoom=50

When the page number is not specified, it is usually considered the 1st page. However, when the top position is specified, it is considered the head of the page of a block where axf:outline-internal-destination is contained. For example, it is specified as follows:

#view=fit
#view=fith
#zoom=,,0

This property is not available with Antenna House Formatter V7.4 Lite.

A link destination is created when axf:destination-type is set and the ID of the destination is specified in the id property.

<fo:block id="Chapter6" axf:destination-type="xyz-top">

The ID is specified in external-destination if the link destination is referred to from an external link in a different PDF. Only the nameddest parameter is valid in the URI.

<fo:basic-link external-destination="http://mydocs/doc.pdf#nameddest=Chapter6"
               axf:action-type="gotor">

A link destination is created when axf:destination-type is set and the ID of the destination is specified in the id property.

<fo:block id="Chapter6" axf:destination-type="xyz-top">

The ID is specified in internal-destination when creating an internal link.

<fo:basic-link internal-destination="Chapter6">

The page number can be accounted by the page parameter in the URI. If both page and nameddest are specified, nameddest takes priority. When specifying the page number, the destination information cannot be set to the link destination. Therefore the type of the destination is given by reading the parameter in the URI. The unreadable parameter is discarded.

<fo:basic-link external-destination="http://mydocs/doc.pdf#page=72&amp;view=fitH,100"
               axf:action-type="gotor">

When neither page nor nameddest are included in the parameter of the URI, it's accounted as page=1. The page number is accounted as physical in PDF.

Adds extension in order to specify the page number to the value of internal-destination.

<fo:basic-link internal-destination="72">

The type of the destination can be specified by adding the parameter of the external link URI.

<fo:basic-link internal-destination="72#view=fitH,100">

The page number is accounted as physical in PDF. If only the page number is specified, the type of the destination is accounted as view=fit.

To specify the external link to the bookmark, specify the axf:outline-external-destination property as follows:

<fo:block axf:outline-level="1"
          axf:outline-title="Chapter 6"
          axf:outline-external-destination="http://mydocs/doc.pdf#nameddest=Chapter6"
          axf:action-type="gotor"
          show-destination="new">

At that time, this bookmark becomes independent of the block such as fo:block, etc., which the bookmark belongs to.

To specify the internal link to the bookmark, specify the axf:outline-internal-destination property as follows:

<fo:block axf:outline-level="1"
          axf:outline-title="Chapter 6"
          axf:outline-internal-destination="Chapter6">

At that time, this bookmark becomes independent of the block such as fo:block, etc., which the bookmark belongs to.

  • Specify either internal-destination or external-destination.
  • There may be a case that an internal link is accounted as an external link when separating the multi volume. At that time, the action type of the link is accounted as axf:action-type="gotor".
  • When an unintended link is created, confirm the setting of your PDF viewer application first. For example, in Adobe Reader or Adobe Acrobat, the feature of “Create links from URLs” may create a link automatically.

Annotation no-LT

Annotations can be added to PDF with Antenna House Formatter V7.4. For more details, see also ISO 32000-1 or ISO 32000-2. Annotations which can be specified here are a part of those. This function is not available with Antenna House Formatter V7.4 Lite.

axf:annotation-type / CSS -ah-annotation-type no-LT XSL-FO Samples CollectionAnnotations in PDF document

Specifies the type of the annotation.

Value:<string>
Initial:empty string
Applies to:all block-level and inline-level formatting objects
Inherited:no
Percentages:N/A

Any of the following types of the annotation can be specified.

  • empty string

    No annotations.

  • Text

    Text annotation.

  • FreeText

    Free text annotation.

  • Stamp

    Rubber stamp annotation.

  • FileAttachment

    File attachment annotation.

Character strings are case insensitive.

<fo:basic-link> and HTML <a> always generate a Link annotation.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:annotation-author / CSS -ah-annotation-author no-LT XSL-FO Samples CollectionAnnotations in PDF document

Specifies the author of the annotation.

Value:<string>
Initial:empty string
Applies to:all block-level and inline-level formatting objects
Inherited:no
Percentages:N/A

This property is not available with Antenna House Formatter V7.4 Lite.

axf:annotation-title / CSS -ah-annotation-title no-LT XSL-FO Samples CollectionAnnotations in PDF document

Specifies the title of the annotation.

Value:<string>
Initial:empty string
Applies to:all block-level and inline-level formatting objects
Inherited:no
Percentages:N/A

This property is effective with PDF1.5 or later. This property is not available with Antenna House Formatter V7.4 Lite.

axf:annotation-contents / CSS -ah-annotation-contents no-LT XSL-FO Samples CollectionAnnotations in PDF document

Specifies the content of the annotation.

Value:<string>
Initial:empty string
Applies to:all block-level and inline-level formatting objects
Inherited:no
Percentages:N/A

Specifies the character string to be displayed for an <fo:basic-link> or HTML <a> or when axf:annotation-type specifies one of the following annotation types:

  • Text
  • FreeText
  • Stamp
  • FileAttachment

See Alternate descriptions are provided.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:annotation-color / CSS -ah-annotation-color no-LT XSL-FO Samples CollectionAnnotations in PDF document

Specifies the color used for the background of the annotation.

Value:<color> | none
Initial:none
Applies to:all block-level and inline-level formatting objects
Inherited:no
Percentages:N/A

This property is not available with Antenna House Formatter V7.4 Lite.

axf:annotation-flags / CSS -ah-annotation-flags no-LT XSL-FO Samples CollectionAnnotations in PDF document

Specifies the flag of the annotation.

Value:<string>
Initial:empty string
Applies to:all block-level and inline-level formatting objects
Inherited:no
Percentages:N/A

Specifies the following character sequences by enumerating using the white space. They are case insensitive.

  • Invisible
  • Hidden
  • Print
  • NoZoom
  • NoRotate
  • NoView
  • ReadOnly
  • Locked
  • ToggleNoView
  • LockedContents

See also ISO 32000-1 or ISO 32000-2 to learn more.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:annotation-open / CSS -ah-annotation-open no-LT XSL-FO Samples CollectionAnnotations in PDF document

Specifies the initial state of the annotation.

Value:true | false
Initial:false
Applies to:all block-level and inline-level formatting objects
Inherited:no
Percentages:N/A

Specifies whether it is displayed in the open state when the type of the annotation (axf:annotation-type) is as follows:

  • Text

Values have the following meanings:

true

Displays the annotation in the open state.

false

Displays the annotation in the closed state.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:annotation-icon-name / CSS -ah-annotation-icon-name no-LT XSL-FO Samples CollectionAnnotations in PDF document

Specifies the name of the icon used for displaying the annotation.

Value:<string>
Initial:empty string
Applies to:all block-level and inline-level formatting objects
Inherited:no
Percentages:N/A

Although arbitrary name can be specified for the icon used for the display of annotations, whether it can be displayed or not depends on the viewer application of a document. The annotation type (axf:annotation-type) shows the standard name which can be specified.

  • Text

    Standard names are as follows:

    • Comment
    • Help
    • Insert
    • Key
    • NewParagraph
    • Note
    • Paragraph

    Empty string is considered Note.

  • Stamp

    Standard names are as follows:

    • Approved
    • AsIs
    • Confidential
    • Departmental
    • Draft
    • Experimental
    • Expired
    • Final
    • ForComment
    • ForPublicRelease
    • NotApproved
    • NotForPublicRelease
    • Sold
    • TopSecret

    Empty string is considered Draft.

  • FileAttachment

    Standard names are as follows:

    • Graph
    • Paperclip
    • PushPin
    • Tag

    Empty string is considered PushPin.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:annotation-position-horizontal / CSS -ah-annotation-position-horizontal no-LT XSL-FO Samples CollectionAnnotations in PDF document

Specifies the horizontal position of the annotation.

Value:<length>
Initial:0pt
Applies to:all block-level and inline-level formatting objects
Inherited:no
Percentages:N/A

The position specified is the distance from the left edge of the region and is used for the position of pop-up or icons and the position of rubber stamp annotations.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:annotation-position-vertical / CSS -ah-annotation-position-vertical no-LT XSL-FO Samples CollectionAnnotations in PDF document

Specifies the vertical position of the annotation.

Value:<length>
Initial:0pt
Applies to:all block-level and inline-level formatting objects
Inherited:no
Percentages:N/A

The position specified is the distance from the top edge of the region and is used for the position of pop-up or icons and the position of rubber stamp annotations.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:annotation-width / CSS -ah-annotation-width no-LT XSL-FO Samples CollectionAnnotations in PDF document

Specifies the width of the annotation.

Value:<length> | auto
Initial:auto
Applies to:all block-level and inline-level formatting objects
Inherited:no
Percentages:N/A

This property is used for the width of pop-up and the width of rubber stamp annotations.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:annotation-height / CSS -ah-annotation-height no-LT XSL-FO Samples CollectionAnnotations in PDF document

Specifies the height of the annotation.

Value:<length> | auto
Initial:auto
Applies to:all block-level and inline-level formatting objects
Inherited:no
Percentages:N/A

This property is used for the height of pop-up and the height of rubber stamp annotations.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:annotation-font-family / CSS -ah-annotation-font-family no-LT XSL-FO Samples CollectionAnnotations in PDF document

Specifies the font family of the free text annotation.

Value:<string>
Initial:depends on user agent
Applies to:all block-level and inline-level formatting objects
Inherited:no
Percentages:N/A

This property is not available with Antenna House Formatter V7.4 Lite.

axf:annotation-font-size / CSS -ah-annotation-font-size no-LT XSL-FO Samples CollectionAnnotations in PDF document

Specifies the font size of the free text annotation.

Value:<absolute-size> | <relative-size> | <length> | <percentage>
Initial:depends on user agent
Applies to:all block-level and inline-level formatting objects
Inherited:no
Percentages:refer to the font size

This property is not available with Antenna House Formatter V7.4 Lite.

axf:annotation-font-weight / CSS -ah-annotation-font-weight no-LT XSL-FO Samples CollectionAnnotations in PDF document

Specifies the font weight of the free text annotation.

Value:normal | bold
Initial:normal
Applies to:all block-level and inline-level formatting objects
Inherited:no
Percentages:N/A

This property is not available with Antenna House Formatter V7.4 Lite.

axf:annotation-font-style / CSS -ah-annotation-font-style no-LT XSL-FO Samples CollectionAnnotations in PDF document

Specifies whether to make the font of the free text annotation italic.

Value:normal | italic
Initial:normal
Applies to:all block-level and inline-level formatting objects
Inherited:no
Percentages:N/A

This property is not available with Antenna House Formatter V7.4 Lite.

axf:annotation-text-color / CSS -ah-annotation-text-color no-LT XSL-FO Samples CollectionAnnotations in PDF document

Specifies the color of the free text annotation.

Value:<color>
Initial:depends on user agent
Applies to:all block-level and inline-level formatting objects
Inherited:no
Percentages:N/A

This property is not available with Antenna House Formatter V7.4 Lite.

axf:annotation-text-align / CSS -ah-annotation-text-align no-LT XSL-FO Samples CollectionAnnotations in PDF document

Specifies the alignment of the free text annotation.

Value:left | center | right
Initial:left
Applies to:all block-level and inline-level formatting objects
Inherited:no
Percentages:N/A

This property is not available with Antenna House Formatter V7.4 Lite.

axf:annotation-border-style / CSS -ah-annotation-border-style no-LT XSL-FO Samples CollectionAnnotations in PDF document

Specifies the border style of the free text annotation.

Value:<border-style>
Initial:solid
Applies to:all block-level and inline-level formatting objects
Inherited:no
Percentages:N/A

The following can be specified for <border-style>. If anything else is specified, it is considered solid.

  • solid
  • dotted
  • dashed
  • dot-dash
  • dot-dot-dash

This property is not available with Antenna House Formatter V7.4 Lite.

axf:annotation-border-width / CSS -ah-annotation-border-width no-LT XSL-FO Samples CollectionAnnotations in PDF document

Specifies the border width of the free text annotation.

Value:<border-width>
Initial:0pt
Applies to:all block-level and inline-level formatting objects
Inherited:no
Percentages:N/A

This property is not available with Antenna House Formatter V7.4 Lite.

axf:annotation-border-color / CSS -ah-annotation-border-color no-LT XSL-FO Samples CollectionAnnotations in PDF document

Specifies the border color of the free text annotation.

Value:<color>
Initial:axf:annotation-text-color
Applies to:all block-level and inline-level formatting objects
Inherited:no
Percentages:N/A

This property is not available with Antenna House Formatter V7.4 Lite.

axf:annotation-file-attachment / CSS -ah-annotation-file-attachment no-LT XSL-FO Samples CollectionAnnotations in PDF document

Specifies the file with which the file attachment annotation is related.

Value:<uri-specification>
Initial:empty string
Applies to:all block-level and inline-level formatting objects
Inherited:no
Percentages:N/A

The data: scheme can be specified. At that time, axf:annotation-file-name must be specified. V7.3MR1

This property is not available with Antenna House Formatter V7.4 Lite.

axf:annotation-file-name / CSS -ah-annotation-file-name V7.3MR1 no-LT XSL-FO Samples CollectionAnnotations in PDF document

Specifies the alternate file name to output when specifying the file attachment annotation.

Value:<string>
Initial:empty string
Applies to:all block-level and inline-level formatting objects
Inherited:no
Percentages:N/A

This property is not available with Antenna House Formatter V7.4 Lite.

axf:annotation-createdate / CSS -ah-annotation-createdate no-LT XSL-FO Samples CollectionAnnotations in PDF documentSpecifying the annotation creation and modification date.

Specifies the annotation creation date.

Value:<string>
Initial:empty string
Applies to:all block-level and inline-level formatting objects
Inherited:no
Percentages:N/A

It is the value of /CreationDate in the annotation dictionary. If omitted, it is considered the same as axf:annotation-modifydate. See The date format for the character string that can be specified.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:annotation-modifydate / CSS -ah-annotation-modifydate no-LT XSL-FO Samples CollectionAnnotations in PDF documentSpecifying the annotation creation and modification date.

Specifies the annotation modification date.

Value:<string>
Initial:empty string
Applies to:all block-level and inline-level formatting objects
Inherited:no
Percentages:N/A

It is the value of /M in the annotation dictionary. If omitted, it is considered the value of modifydate in <axf:document-info>. If axf:annotation-modifydate is older than axf:annotation-createdate, it will be adjusted to axf:annotation-createdate. See The date format for the character string that can be specified.

This property is not available with Antenna House Formatter V7.4 Lite.


Acroform no-LT

It's possible to create PDF forms with Antenna House Formatter V7.4. Forms consist of the field to fill in the text and buttons, etc. Moreover, the action can be specified.

Forms can be specified by describing <axf:form-field> inside <axf:form>.

<axf:form
  external-destination="http://www.antenna.co.jp/form-test.cgi"
  field-submit-method="post"
  field-submit-coordinates="true">
  <fo:block>
    Submit:
    <axf:form-field
      field-type="button"
      field-name="SubmitButton"
      action-type="submit"
      field-button-layout="caption"
      field-button-face="Submit!"
      width="5em"
      background-color="#eee"
      border="2px silver outset"
    />
  </fo:block>
  <fo:block>
    Text Field:
    <axf:form-field
      field-type="text"
      field-name="InputText"
      field-default-text="Input text here!"
      field-multiline="false"
      field-scroll="true"
      field-maxlen="32"
      width="10em"
      height="1.2em"
      background-color="#ff8"
      border="1pt silver inset"
    />
  </fo:block>
</axf:form>

When <axf:form-field> is not inside of <axf:form> and action-type is submit or reset, these do not function. <axf:form-field> other than these will work fine regardless of <axf:form>.

In the HTML form, the appearance of the following tags is specified by html.css. Tags other than these are ignored.

  • <form>
  • <input>
  • <button>
  • <textarea>
  • <select>
  • <option>

This function is not available with Antenna House Formatter V7.4 Lite.

<axf:form> / HTML <form> no-LT XSL-FO Samples CollectionAdds a page number to the field nameForm EventForm field

Common Usage:

Encloses the unit of the form action.

Areas:

Generates and returns a block-area.

Contents:

(#PCDATA | %inline; | %block;)*

axf:field-submit-method / CSS -ah-field-submit-method no-LT

Specifies the way to send the information when submitting a form field.

Value:get | post
Initial:get
Applies to:axf:form
Inherited:no
Percentages:N/A

Values have the following meanings:

get

Sends out a form as GET request.

post

Sends out a form as POST request.

axf:field-submit-coordinates / CSS -ah-field-submit-coordinates no-LT

Specifies whether to send out the coordinates of the mouse when submitting a form field.

Value:false | true
Initial:false
Applies to:axf:form
Inherited:no
Percentages:N/A

Values have the following meanings:

false

Does not send out the coordinates.

true

Sends out the coordinates.

<axf:form-field> / HTML <input> <button> <textarea> <select> no-LT XSL-FO Samples CollectionAdds a page number to the field nameForm EventForm field

Common Usage:

Generates a form field.

Areas:

Generates and returns a single normal inline-area.

Contents:

(axf:form-field-option | axf:form-field-event)*

The main constraints of form fields generated by HTML forms are as follows:

  • Not all attributes that can be specified for <input>, <button>, <textarea>, <select> are supported.
  • Not all type that can be specified for <input> are supported.
  • If search, tel, url, email, month, week, datetime-local are specified as the type of <input>, it is treated as -ah-field-type:text.
  • By <input type="button">, <button type="button">, the button will be displayed, but it will not function as a field. In addition, only the text is valid for the contents displayed on the <button>.

See the contents of html.css to know more about supported features. Features not explicitly stated in html.css are invalid even if they are not listed in the constraint.

axf:field-type / CSS -ah-field-type no-LT

Specifies the field type.

Value:text | button | checkbox | radio | listbox | combobox | signature
Initial:N/A, a value is required
Applies to:axf:form-field
Inherited:no
Percentages:N/A

Values have the following meanings:

text

Specifies the Text field.

button

Specifies the Push Button field.

checkbox

Specifies the Check Box field.

radio

Specifies the Radio Button field.

listbox

Specifies the List Box field.

combobox

Specifies the Combo Box field.

signature

Specifies the Digital Signature field.

axf:field-name / CSS -ah-field-name no-LT

Specifies the field name.

Value:<string>
Initial:N/A
Applies to:axf:form-field
Inherited:no
Percentages:N/A

If the name is omitted, an appropriate name will be generated.

axf:field-name-suffix-page-number no-LT XSL-FO Samples CollectionAdds a page number to the field name

Adds a page number to the field name.

Value:<string>
Initial:empty string
Applies to:axf:form-field
Inherited:no
Percentages:N/A

Adds a page number to the name specified by axf:field-name. It's invalid when axf:field-name is not specified. A character string that can be specified is the one that can be specified by format. A page number is formatted and added. If it's an empty string, nothing is added.

This property is specified when creating a form in <fo:static-content> and you want to make a separate form on each page.

axf:field-description / CSS -ah-field-description no-LT

Specifies the descriptive text of the field.

Value:<string>
Initial:empty string
Applies to:axf:form-field
Inherited:no
Percentages:N/A

The string that was specified here as a value is shown as a tooltip with Acrobat etc.

axf:field-value / CSS -ah-field-value no-LT

Specifies the value used when submitting a form field, etc.

Value:<string>
Initial:empty string
Applies to:axf:form-field, axf:form-field-option
Inherited:no
Percentages:N/A

axf:field-flags / CSS -ah-field-flags no-LT

Specifies the flag of the field.

Value:<string>
Initial:empty string
Applies to:axf:form-field
Inherited:no
Percentages:N/A

Specifies the following character sequences by enumerating using the white space. They are case insensitive.

  • ReadOnly
    Makes it a read-only field. Same as axf:field-readonly="true", but the axf:field-flags setting takes precedence.
  • Required
    Makes it a input-required field. Same as axf:field-required="true", but the axf:field-flags setting takes precedence.
  • Multiline
    Makes the text field multiple lines. Same as axf:field-multiline="true", but the axf:field-flags setting takes precedence.
  • Scroll
    Makes the text field scrollable. Same as axf:field-scroll="true", but the axf:field-flags setting takes precedence.
  • Password
    Makes the text field password-protected. Same as axf:field-password="true", but the axf:field-flags setting takes precedence.
  • Checked
    Makes the check box and radio button being checked. Same as axf:field-checked="true", but the axf:field-flags setting takes precedence.
  • Multiple
    Makes multiple items selectable in the list box. Same as axf:field-multiple="true", but the axf:field-flags setting takes precedence.
  • Editable
    Makes the value editable in the combo box. Same as axf:field-editable="true", but the axf:field-flags setting takes precedence.
  • Hidden
    Makes it a hidden field. However, the size of the field is secured. Backgrounds and borders are displayed.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:field-readonly / CSS -ah-field-readonly no-LT

Specifies whether the field is read-only or not.

Value:true | false
Initial:false
Applies to:axf:form-field
Inherited:no
Percentages:N/A

Values have the following meanings:

true

The field is read-only.

false

The field is not read-only.

axf:field-required / CSS -ah-field-required no-LT

Specifies whether the field is enter-required or not.

Value:true | false
Initial:false
Applies to:axf:form-field
Inherited:no
Percentages:N/A

Values have the following meanings:

true

The field is enter-required.

false

The field is not enter-required.

axf:field-default-text / CSS -ah-field-default-text no-LT

Specifies the text entered into the text field from the beginning.

Value:<string>
Initial:empty string
Applies to:axf:form-field
Inherited:no
Percentages:N/A

axf:field-multiline / CSS -ah-field-multiline no-LT

Specifies whether the text field is a single-line enterable field or a multi-line enterable field.

Value:false | true
Initial:false
Applies to:axf:form-field
Inherited:no
Percentages:N/A

Values have the following meanings:

false

The text field is a single-line enterable field.

true

The text field is a multi-line enterable field.

axf:field-scroll / CSS -ah-field-scroll no-LT

Specifies whether the text field is scrollable or not.

Value:false | true
Initial:false
Applies to:axf:form-field
Inherited:no
Percentages:N/A

Values have the following meanings:

false

The text field is not scrollable.

true

The text field is scrollable.

axf:field-password / CSS -ah-field-password no-LT

Specifies whether the text field requires the password or not.

Value:false | true
Initial:false
Applies to:axf:form-field
Inherited:no
Percentages:N/A

Values have the following meanings:

false

The text field does not require the password.

true

The text field requires the password. Entered characters are shown as “*”, etc.

axf:field-maxlen / CSS -ah-field-maxlen no-LT

Specifies the maximum number of characters which can be entered into the text field.

Value:<number>
Initial:0
Applies to:axf:form-field
Inherited:no
Percentages:N/A

When 0 or less is specified, the number of characters is not limited.

axf:field-format-category / CSS -ah-field-format-category no-LT

Specifies the format type of the text field.

Value:none | number | percentage | date | time
Initial:none
Applies to:axf:form-field
Inherited:no
Percentages:N/A

Values have the following meanings:

none

Does not specify the format.

number

Specifies the format for numerical values.

percentage

Specifies the format for percentage values.

date

Specifies the format for date values.

time

Specifies the format for time values.

Actual formats can be specified by axf:field-format.

axf:field-format / CSS -ah-field-format no-LT

Specifies the format of the text field.

Value:auto | [ [<string> | <number>] [<string> | <number> | true | false]* ]
Initial:auto
Applies to:axf:form-field
Inherited:no
Percentages:N/A

The setting of the format will differ depending on the type of formats specified by axf:field-format-category. When auto is specified, the default is adopted to all values. In other cases, values of axf:field-format-category can be specified as follows:

number

Values can be specified with a maximum of 5 as follows:

axf:field-format="2 0 1 '$ ' true"

These values have the following meanings in sequence.

  1. The number of digits after the decimal point. (default: 2)

    When the inputted value has many digit numbers after the decimal point, it is displayed by rounding off.

  2. How to display numbers with different separators. One of the following values can be specified. (default: 0)
    0.1,234.56
    1. 1234.56
    2.1.234,56
    3. 1234,56
    4.1'234.56
  3. How to display negative numbers. (default: 0)
    0.No processing.
    1.Display in red.
    2.Display with parentheses.
    3.Display in red with parentheses.
  4. Currency symbol. Any character strings can be specified. (default: empty)

    When putting a currency symbol before numbers, it's better to put a white space after the currency symbol like “$ ”. When putting it after numbers, put a white space before the currency symbol.

  5. Position of a currency symbol. If true is specified, it is displayed before numbers, if false is specified, it is displayed after numbers. (default: true)

percentage

Values can be specified with a maximum of 2 as follows:

axf:field-format="2 0"

Values have the same meaning as number.

date

Specifies the format by the numerical value or character strings. One of the following numerical values can be specified. (default: 0)

0.m/d
1.m/d/yy
2.mm/dd/yy
3.mm/yy
4.d-mmm
5.d-mmm-yy
6.dd-mmm-yy
7.yy-mm-dd
8.mmm-yy
9.mmmm-yy
10.mmm d, yyyy
11.mmmm d, yyyy
12.m/d/yy h:MM tt
13.m/d/yy HH:MM

The following 2 settings have the same meaning.

axf:field-format="2"
axf:field-format="'mm/dd/yy'"

Although an arbitrary format can be specified in the character string, the operation when specifying the mistaken format will not be guaranteed. See the specifications of JavaScript, etc. to learn the meaning of the character in the format.

time

Specifies the format by the numerical value or character strings. One of the following numerical values can be specified. (default: 0)

0.HH:MM
1.h:MM tt
2.HH:MM:ss
3.h:MM:ss tt

The following 2 settings have the same meaning.

axf:field-format="0"
axf:field-format="'HH:MM'"

Although an arbitrary format can be specified in the character string, the operation when specifying the mistaken format will not be guaranteed. See the specifications of JavaScript, etc. to learn the meaning of the character in the format.

axf:field-text-align / CSS -ah-field-text-align no-LT

Specifies the alignment of the text field.

Value:left | center | right
Initial:left
Applies to:axf:form-field
Inherited:no
Percentages:N/A

This property is not available with Antenna House Formatter V7.4 Lite.

axf:field-font-size / CSS -ah-field-font-size no-LT

Specifies the font size of the character string displayed in the form fields.

Value:font-size | auto | <length>
Initial:font-size
Applies to:axf:form-field
Inherited:no
Percentages:N/A

Values have the following meanings:

font-size

Sets the value specified by the font-size property.

auto

Sets the font size to auto without specifying the size.

<length>

Sets the font size explicitly.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:field-button-layout / CSS -ah-field-button-layout no-LT

Specifies the positioning between the caption and icon displayed in the push button field.

Value:caption | icon | caption-below-icon | caption-above-icon | icon-caption | caption-icon | caption-over-icon
Initial:caption
Applies to:axf:form-field
Inherited:no
Percentages:N/A

Values have the following meanings:

caption

Only a caption is displayed on the button. An icon is not displayed.

icon

Only an icon is displayed on the button. A caption is not displayed.

caption-below-icon

A caption is displayed under the icon.

caption-above-icon

A caption is displayed on top of the icon.

icon-caption

A caption is displayed on the right side of the icon.

caption-icon

A caption is displayed on the left side of the icon.

caption-over-icon

A caption is displayed on the icon in piles.

axf:field-button-face / CSS -ah-field-button-face no-LT

Specifies the caption displayed in the push button field.

Value:<string>
Initial:empty string
Applies to:axf:form-field
Inherited:no
Percentages:N/A

axf:field-button-icon / CSS -ah-field-button-icon no-LT

Specifies the icon displayed in the push button field.

Value:<uri-specification>
Initial:empty string
Applies to:axf:form-field
Inherited:no
Percentages:N/A

axf:field-button-face-down / CSS -ah-field-button-face-down no-LT

Specifies the caption displayed when pressing the push button.

Value:<string>
Initial:empty string
Applies to:axf:form-field
Inherited:no
Percentages:N/A

axf:field-button-icon-down / CSS -ah-field-button-icon-down no-LT

Specifies the icon displayed when pressing the push button.

Value:<uri-specification>
Initial:empty string
Applies to:axf:form-field
Inherited:no
Percentages:N/A

axf:field-button-face-rollover / CSS -ah-field-button-face-rollover no-LT

Specifies the caption displayed when rolling over the push button.

Value:<string>
Initial:empty string
Applies to:axf:form-field
Inherited:no
Percentages:N/A

axf:field-button-icon-rollover / CSS -ah-field-button-icon-rollover no-LT

Specifies the icon displayed when rolling over the push button.

Value:<uri-specification>
Initial:empty string
Applies to:axf:form-field
Inherited:no
Percentages:N/A

axf:field-checked / CSS -ah-field-checked no-LT

Specifies the initial state of the check box and the radio button.

Value:false | true
Initial:false
Applies to:axf:form-field
Inherited:no
Percentages:N/A

Values have the following meanings:

false

The initial state is unchecked.

true

The initial state is checked.

axf:field-checked-style / CSS -ah-field-checked-style no-LT

Specifies the style of the check box and the radio button.

Value:checkmark | circle | square | cross | star
Initial:checkmark
Applies to:axf:form-field
Inherited:no
Percentages:N/A

axf:field-top-index / CSS -ah-field-top-index no-LT

Specifies the first selected item in the list box, combo box.

Value:<number>
Initial:1
Applies to:axf:form-field
Inherited:no
Percentages:N/A

The specified value indicates what number of <axf:form-field-option> it is. The beginning number is 1. When less than 1 is specified or the specified number exceeds the number of elements contained, the value is considered 1.

axf:field-multiple / CSS -ah-field-multiple no-LT

Specifies whether multiple items can be chosen in the list box.

Value:false | true
Initial:false
Applies to:axf:form-field
Inherited:no
Percentages:N/A

Values have the following meanings:

false

Multiple items cannot be chosen.

true

Multiple items can be chosen.

axf:field-editable / CSS -ah-field-editable no-LT

Specifies whether the value can be edited with the combo box.

Value:false | true
Initial:false
Applies to:axf:form-field
Inherited:no
Percentages:N/A

Values have the following meanings:

false

The value cannot be edited.

true

The value can be edited.

axf:field-lock-document / CSS -ah-field-lock-document no-LT

Specifies whether to lock the document at the time of signing with the digital signature field.

Value:auto | false | true
Initial:auto
Applies to:axf:form-field
Inherited:no
Percentages:N/A

Values have the following meanings:

auto

The PDF viewer will display a user interface such as a dialog asking whether or not to lock the document.

false

Does not lock the document after signing.

true

Locks the document at the time of signing.

Effective with PDF1.7 or later.

<axf:form-field-option> / HTML <option> no-LT

Common Usage:

Specifies the component elements of the list box, combo box.

Areas:

No areas generated.

Contents:

#PCDATA

axf:field-selected / CSS -ah-field-selected no-LT

Specifies the first selected item in the list box, combo box.

Value:false | true
Initial:false
Applies to:axf:form-field-option
Inherited:no
Percentages:N/A

Values have the following meanings:

false

Does nothing.

true

Specifies the first selected item.

The axf:field-selected="true" setting overrides the axf:field-top-index setting. The behavior when multiple items specified is inconstancy.

Form Fields no-LT

These fields can be added to your forms:

These are all expressed by the <axf:form-field> extension element. <axf:form-field> is an inline element. Although many common extension properties can be specified to <axf:form-field>, the effective property differs depending on the field type. The size of the field can be specified with the width and the height properties. When omitted, a suitable size will be applied. Below shows the example of the setting for each form field.

Text field no-LT

Text field can be specified by field-type="text". The contents are empty. Whether it is a single line or not depends on the setting of field-multiline.

<axf:form-field
     field-type="text"
     field-default-text="TEXT"
     field-multiline="false"
     field-scroll="false"
     field-password="true"
     field-maxlen="100"
/>

The contents of field-default-text are not displayed in GUI.

Push Button field no-LT

Push Button field can be specified by field-type="button". The contents are empty. The Push button is usually an object used to perform an action.

<axf:form-field
     field-type="button"
     field-button-layout="caption"
     field-button-face="TEXT"
     field-button-icon="URI"
     field-button-face-down="DOWN"
     field-button-icon-down="URI"
     field-button-face-rollover="OVER"
     field-button-icon-rollover="URI"
/>

The contents of field-button-face are not displayed in GUI.

Check Box field no-LT

Check Box field can be specified by field-type="checkbox". The contents are empty.

<axf:form-field
     field-type="checkbox"
     field-checked="true"
     field-checked-style="checkmark"
/>

The status of field-checked="true" are not displayed in GUI.

Radio Button field no-LT

Radio Button field can be specified by field-type="radio". The contents are empty.

<axf:form-field
     field-type="radio"
     field-checked="true"
     field-checked-style="checkmark"
     field-name="Card"
     field-value="MasterCard"
/>

Radio buttons are usually arranged in groups of two or more. The group is identified as a radio button with the same field-name. Users can select only one of the radio buttons. Even if field-checked="true" is set multiply, only one button in a group is checked.

The status of field-checked="true" is not displayed in GUI.

List Box field no-LT

List Box field can be specified by field-type="listbox". <axf:form-field-option> is required for the contents. It should not be empty. <axf:form-field-option> expresses the contents of the list and these are lined up in the appearance order in the list. Neither the value of field-value nor the content text in <axf:form-field-option> should be empty or white-space characters.

<axf:form-field
     field-type="listbox"
     field-top-index="1"
     field-multiple="true"
>
 <axf:form-field-option field-value="M">MasterCard</axf:form-field-option>
 <axf:form-field-option field-value="V">Visa</axf:form-field-option>
 <axf:form-field-option field-value="A">AMEX</axf:form-field-option>
</axf:form-field>

The contents of the list box are not displayed in GUI.

Combo Box field no-LT

Combo Box field can be specified by field-type="combobox". <axf:form-field-option> is required for the contents. The contents should not be empty. <axf:form-field-option> is the same as that of the list box.

<axf:form-field
     field-type="combobox"
     field-top-index="1"
     field-editable="true"
>
 <axf:form-field-option field-value="M">MasterCard</axf:form-field-option>
 <axf:form-field-option field-value="V">Visa</axf:form-field-option>
 <axf:form-field-option field-value="A">AMEX</axf:form-field-option>
</axf:form-field>

The contents of the combo box are not displayed in GUI.

Digital Signature field no-LT

Digital Signature field can be specified by field-type="signature". The contents are empty. The appearance cannot be specified beforehand.

<axf:form-field
     field-type="signature"
     width="40pt"
     height="50pt"
/>

When performing the formatting process, the signature area is only secured and the signature field is not generated. The signature field is generated when generating PDF.

Form Actions no-LT

Form actions are realized by specifying the event to be triggered and the action corresponding to the event to each field. In Antenna House Formatter V7.4, the action can be specified to the field that is included in <axf:form>. The contents of <axf:form> are arbitrary and generate a block area. Usually, <axf:form-field> is included in <axf:form>. The form actions include the following:

axf:action-type is prepared for the external link, but Form actions have more contents that can be specified.

axf:action-type no-LT

Specifies the action of Form Actions.

Value:auto | goto | gotor | launch | uri | reset | submit | javascript
Initial:auto
Applies to:axf:form-field
Inherited:no
Percentages:N/A

Values have the following meanings:

auto

Dependent on the system setting. See also axf:action-type for external link.

goto

Moves to the internal link destination by the “GoTo” action.

gotor

Opens the external link destination by the “GoToR” action as PDF. The URI of the external link destination is considered PDF.

launch

Opens the external link destination by the “Launch” action as the file.

uri

Opens the external link destination by the “URI” action as URI (World Wide Web).

reset

Resets a form field as a form action.

submit

Submits a form field as a form action.

javascript

Generates the action by JavaScript. This setting is available only with axf:form-field-event. Ignored when allow-javascript="false" is set in the Option Setting File.

Reset no-LT

Reset initializes the value of all the fields included in <axf:form> to their initial state. Specify axf:action-type="reset" to the button to reset. The action is generated by releasing the button.

<axf:form>
 <axf:form-field field-type="button" action-type="reset"/>
 <axf:form-field field-type="text" field-default-text="XXX"/>
 ...
</axf:form>

Submit no-LT

Submit sends out the information by using HTTP. The contents of each field are sent out as GET or the POST request of HTTP. That is, the information is submitted using the same HTTP method of HTML. The action is generated by releasing the button.

<axf:form
     external-destination="URI"
     field-submit-method="post"
     field-submit-coordinates="false"
>
 <axf:form-field field-type="button" action-type="submit"/>
 <axf:form-field field-type="text" field-default-text="YYY"/>
 ...
</axf:form>

Link cannot be specified to <axf:form> but directly specified to the Button field. The method is the same as that of <fo:basic-link>. The internal link can be specified as follows:

<axf:form-field field-type="button" internal-destination="IDREF" 
                                    action-type="goto"/>

Specifies goto to action-type or omits the setting. The action is generated by releasing the button.

The external link can be specified as follows:

<axf:form-field field-type="button" external-destination="URI"
                                    action-type="gotor"/>

You can specify any one of gotor, launch or uri to action-type.

<axf:form-field-event> no-LT XSL-FO Samples CollectionForm Event

Common Usage:

Defines the form action which corresponds to the event.

Areas:

No areas generated.

Contents:
<!ELEMENT axf:form-field-event #PCDATA>
<!ATTLIST axf:form-field-event name        CDATA #REQUIRED>
<!ATTLIST axf:form-field-event action-type CDATA #REQUIRED>

It's possible to put the <axf:form-field-event> extension element as a child element of <axf:form-field>. The properties are name and action-type and both are required. One of the following event types can be specified to name. Case insensitive.

MouseUp

The action occurs when a mouse button is released on the form field.

MouseDown

The action occurs when a mouse button is pushed on the form field.

MouseEnter

The action occurs when a mouse cursor enters the form field.

MouseExit

The action occurs when a mouse cursor exits the form field.

OnFocus

The action occurs when a form field gets focus.

OnBlur

The action occurs when a form field loses focus.

The action occurred by <axf:form-field action-type> is the action by MouseUp. When both are specified like, <axf:form-field-event name="MouseUp">, <axf:form-field-event> will take precedence. When the same events are multiply specified to <axf:form-field-event>, it is indeterminate which one is adopted.

When action-type="javascript" is specified, the JavaScript program will be written in the content text. If an incorrect program is specified, the operation will not be guaranteed. However, when allow-javascript="false" is set in the Option Setting File, it's ignored.


Layer no-LT

Layers can be specified to PDF with Antenna House Formatter V7.4. Layer settings are effective only with PDF1.5 or later. By creating layers, you can toggle between showing and hiding when the PDF is opened in Adobe Acrobat or Reader, or create content that can be shown or hidden under certain conditions. You can also check the layer display in the Layer Window of GUI in Antenna House Formatter V7.4. This feature is not available with Antenna House Formatter V7.4 Lite.

axf:layer-settings / CSS -ah-layer-settings no-LT XSL-FO Samples CollectionLayer in PDF output

Defines layers.

Value: none | <layer-setting>#
Initial:none
Applies to:root element
Inherited:no
Percentages:N/A

<layer-setting> = <layer-name> [on | off]? [ intent [view | design] || view [on | off] || print [on | off] || export [on | off] || zoom <number> <number>? || lang <string> preferred? || locked ]?
<layer-name> = <string>

Values have the following meanings:

none

No definition.

<layer-setting>

Multiple layers can be defined by comma-separated items. What is essential for layer definition is <layer-name>. Other parameters are optional.

<layer-name>

Specifies a name to identify the layer. on or off specifies the default state of the layer when the document is opened. If omitted, it is considered on. If the same name exists more than once, the one specified first takes precedence.

intent

Specifies the intent of the layer. When view is specified, showing and hiding layers can be toggled. When design is specified, these cannot be toggled. If omitted, it is considered view.

view

Specifies whether to show or hide the layer. Displayed when the document is opened with on, it is hidden with off. If omitted, it is considered on.

print

Specifies whether to print the layer. It is printed by on and not printed by off. If omitted, it is considered on.

export

Specifies whether layers are included in the resulting document when you export from a PDF viewer application to a file format that supports PDF layers. It is included by on and not included by off. If omitted, it is considered on.

zoom

Specifies the minimum and maximum values of the magnification of the displayed layer. If only one value is specified, it is considered the minimum value. Negative values are not available. If omitted, it is considered unlimited.

lang

Specifies the language of the layer. Displays the layer if the language of the PDF viewer application matches the specified lang when the document is opened. preferred also displays the layer when the language of the viewer partially matches lang. Whether the string of lang is valid or not depends on the PDF viewer application.

locked

Locks the layer and disables editing. locked is effective with PDF1.6 or later.

In PDF/X, PDF/A and PDF/UA, the settings of view, print, and export are ignored.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:layer / CSS -ah-layer no-LT XSL-FO Samples CollectionLayer in PDF output

Specifies to which layer the area is arranged.

Value:none | <layer-name>
Initial:none
Applies to:formatting object that generates area
Inherited:yes
Percentages:N/A

Values have the following meanings:

none

The area is arranged to no layer.

<layer-name>

The area is arranged to the layer with the name specified by axf:layer-settings.

If you specify a name that is not in axf:layer-settings, it will not be output as a layer.

This property is not available with Antenna House Formatter V7.4 Lite.


Extension for European Rule

Antenna House Formatter V7.4 provides the extension for adjusting the amount of space before and after the punctuation in European Typography. Although these features cannot be used as a style in CSS, the setting of <space-end-punctuation> etc. in Option Setting File is effective.

<axf:space-end-punctuation>XSL-FO Samples CollectionSpecifying the amount of space between the punctuation and digit in European Typography

Specifies the amount of space end the punctuation.

<axf:space-start-punctuation>XSL-FO Samples CollectionSpecifying the amount of space between the punctuation and digit in European Typography

Specifies the amount of space start the punctuation.

<axf:space-between-digit-and-punctuation>XSL-FO Samples CollectionSpecifying the amount of space between the punctuation and digit in European Typography

Specifies the amount of space between the digit and the punctuation.

<axf:space-between-punctuation-and-digit>XSL-FO Samples CollectionSpecifying the amount of space between the punctuation and digit in European Typography

Specifies the amount of space between the punctuation and the digit.

These extension elements are all empty element and can be put on the right under <fo:declarations>. The area is not generated. The setting of <axf:space-between-digit-and-punctuation> or <axf:space-between-punctuation-and-digit> takes precedence over the setting of <axf:space-end-punctuation> or <axf:space-start-punctuation>. The following properties can be specified.

language

Specifies the language code (RFC3066). It is not possible to omit it.

Value:<language>
Initial:N/A
Inherited:no
Percentages:N/A

space

Specifies the amount of space. Specification is invalid when less than 0.

Value:<number> | <length> | <percentage> | figure | punctuation | thin | hair
Initial:N/A
Inherited:no
Percentages:refer to the font size

Values have the following meanings:

figure

Indicates the same amount as U+2007.

punctuation

Indicates the same amount as U+2008.

thin

Indicates the same amount as U+2009.

hair

Indicates the same amount as U+200A.

code

Specifies the code point to be applied.

Value:<string>
Initial:empty string
Inherited:no
Percentages:N/A

language and space are applied to all the specified code points.

For instance, the following would be specified to format French.

<axf:space-start-punctuation code="?" space="1 div 3" language="fr"/>
<axf:space-start-punctuation code="!" space="1 div 3" language="fr"/>
<axf:space-start-punctuation code=";" space="1 div 3" language="fr"/>
<axf:space-start-punctuation code=":" space="1 div 4" language="fr"/>
<axf:space-start-punctuation code="&#xBB;" space="1 div 4" language="fr"/>
<axf:space-end-punctuation   code="&#xAB;" space="1 div 4" language="fr"/>
<axf:space-between-punctuation-and-digit code="+" space="thin" language="fr"/>
<axf:space-between-punctuation-and-digit code="&#x2212;" space="thin" language="fr"/>
<axf:space-between-punctuation-and-digit code="&#xB1;" space="thin" language="fr"/>
<axf:space-between-digit-and-punctuation code="%" space="thin" language="fr"/>
<axf:space-between-digit-and-punctuation code="&#x2103;" space="thin" language="fr"/>
<axf:space-between-digit-and-punctuation code="&#x2109;" space="thin" language="fr"/>

These settings for European Typography can also be specified by the Option Setting File. The setting in FO overwrites it.


Appending Option Setting Information

Antenna House Formatter V7.4 can specify the additional option setting information used inside the document. These features are not available in CSS.

<axf:formatter-config> no-LT

Common Usage:

Specifies additional option setting information. This element does not generate an area. These features are not available with Antenna House Formatter V7.4 Lite.

Areas:

None.

Constraints:
<!ELEMENT axf:formatter-config (%axs-settings;)*>
<!ATTLIST axf:formatter-config src CDATA #IMPLIED>

The <axf:formatter-config> extension element can be set as many as you want right under fo:declarations.

The src property can optionally specify the external Option Setting File. It's an additional setting to the original settings and effective only in this document. It becomes base-uri for the relative path. A part of the element that is the same as %axs-settings; under the specified file is evaluated.

Contents:

%axs-settings; is an element which belongs to the name space http://www.antennahouse.com/names/XSL/Settings. The properties in the Option Setting File are included in the name space, however currently only the following elements and their child elements can be described. The other elements will be disregarded. Also, some specifications, such as those related to initialization, are ignored.

  • <formatter-settings>
  • <pdf-settings>
  • <text-settings>
  • <svg-settings>
  • <ps-settings>
  • <mathml-settings>
  • <cgm-settings>
Examples:
<fo:declarations>
 <axf:formatter-config src="add-settings.xml"
  xmlns:axs="http://www.antennahouse.com/names/XSL/Settings">
  <axs:pdf-settings pdf-version="PDF1.6" tagged-pdf="true"/>
 </axf:formatter-config>
</fo:declarations>

In this example, an additional option setting file, add-settings.xml is specified, and then PDF setting is added.

Remarks

Usually, the additional setting by <axf:formatter-config> never influences the formatting process of the following document. However, when the following settings are done by GUI, the additional settings will be reflected on the default settings, then reflected on the formatting of the following document.

The addition option setting information by <axf:formatter-config> is not reflected in the AreaTree.

When axf-formatter-config="false" is specified in the Option Setting File, the contents of <axf:formatter-config> will be ignored.


Printer Marks no-LT

Antenna House Formatter V7.4 can draw printer marks in PDF etc. Since printer marks are drawn outside of the actual page size (trim size) specified with the page-width and page-height properties, they have no effect on the contents of the document. This function is not available with Antenna House Formatter V7.4 Lite.

Printer Marks

axf:crop-offset / CSS -ah-crop-offset no-LT
axf:crop-offset-top / CSS -ah-crop-offset-top no-LT
axf:crop-offset-bottom / CSS -ah-crop-offset-bottom no-LT
axf:crop-offset-left / CSS -ah-crop-offset-left no-LT
axf:crop-offset-right / CSS -ah-crop-offset-right no-LT XSL-FO Samples CollectionPrinter Marks

Specifies the distance from the physical end to the trim size of the output medium.

Value:<length>
Initial:0pt
Applies to:fo:simple-page-master / CSS @page
Inherited:no
Percentages:N/A

The trim size is specified by the page-width and page-height properties (CSS size property). axf:crop-offset is for specifying how much the space is taken outside the trim size. In order to specify the same values vertically and horizontally, axf:crop-offset can be used. In order to specify individual values, axf:crop-offset-top, axf:crop-offset-bottom, axf:crop-offset-left and axf:crop-offset-right can be used. When axf:crop-offset and others are specified simultaneously, individual axf:crop-offset-* properties take priority.

These properties are not available with Antenna House Formatter V7.4 Lite.

axf:crop-area-visibility / CSS -ah-crop-area-visibility no-LT

Specifies whether to display the area that is extended beyond the trim size.

Value:hidden | visible
Initial:hidden
Applies to:fo:simple-page-master / CSS @page
Inherited:no
Percentages:N/A

Specifies whether the area that overflows on the margin specified with axf:crop-offset is clipped with the trim size, if there is a bleed area, clipped with the bleed area, or the extended area is displayed.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:bleed / CSS (-ah-)bleed no-LT
axf:bleed-top / CSS -ah-bleed-top no-LT
axf:bleed-bottom / CSS -ah-bleed-bottom no-LT
axf:bleed-left / CSS -ah-bleed-left no-LT
axf:bleed-right / CSS -ah-bleed-right no-LT XSL-FO Samples CollectionPrinter MarksIntroduction to CSS for Paged Mediableedbleed-topbleed-bottombleed-leftbleed-right

Specifies the width of the bleedIntroduction to CSS for Paged Mediableed area for cutting off. [CSS3-GCPM] Page marks and bleed area (“bleed” has been removed from GCPM on and after May 13, 2014)

Value:<length>
Initial:0pt
Applies to:fo:simple-page-master / CSS @page
Inherited:no
Percentages:N/A

The area of the bleed is taken outside the trim size. In order to specify the same values vertically and horizontally, axf:bleed can be used. In order to specify individual values, axf:bleed-top, axf:bleed-bottom, axf:bleed-left and axf:bleed-right can be used. When axf:bleed and others are specified simultaneously, individual axf:bleed-* properties take priority.

These properties are not available with Antenna House Formatter V7.4 Lite.

axf:printer-marks / CSS (-ah-)marks no-LT XSL-FO Samples CollectionPrinter Markscrop-trim, cross-circle, cross-registration

Specifies the Printing marks, such as a crop mark. Specifies the action of external link. [CSS3-GCPM] Page marks and bleed area (“marks” has been removed from GCPM on and after May 13, 2014)

Value:[ [ crop | crop-trim ] || [ cross | cross-circle | cross-registration ] || <uri-specification>+ ] | none
Initial:none
Applies to:fo:simple-page-master / CSS @page
Inherited:no
Percentages:N/A

Values have the following meanings:

crop

Outputs corner marks. Outputs corner marks to the position of the trim size and the position of the bleed area if it exists. When corner marks are output to both the position of the trim size and the position of the bleed area, they are combinations of crop marks and bleed marks in Japanese style.

crop-trim

Outputs corner marks only to the position of the trim size (crop marks).

cross

Outputs cross-shaped marks.

cross-circle

Outputs cross-shaped marks with concentric circle.

cross-registration

Outputs registration marks.

<uri-specification>

Original printer marks, color bars, etc. can be outputted by specifying images, such as SVG. Two or more URIs can be specified. Images will be clipped at the bleed area. To avoid clipping, specify axf:printer-marks-over-content="true".

This property is not available with Antenna House Formatter V7.4 Lite.

axf:printer-marks-line-color / CSS -ah-printer-marks-line-color no-LT

Specifies the line color of printer marks.

Value:<color> | auto
Initial:auto
Applies to:fo:simple-page-master / CSS @page
Inherited:no
Percentages:N/A

When the value is auto, the color is considered the registration color.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:printer-marks-line-length / CSS -ah-printer-marks-line-length no-LT

Specifies the line length of printer marks.

Value:<length> <length>? | auto
Initial:auto
Applies to:fo:simple-page-master / CSS @page
Inherited:no
Percentages:N/A

By specifying the second value, you can make the printer marks extend beyond the bleed area. Values that exceed the width of the bleed area are truncated to that value. If omitted, it is considered 0. V7.4

When the value is auto, the length depends on the system setting. The default length of a printer mark is 10mm, it can be adjusted in the Option Setting File.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:printer-marks-line-width / CSS -ah-printer-marks-line-width no-LT

Specifies the line width of printer marks.

Value:<length> | auto
Initial:auto
Applies to:fo:simple-page-master / CSS @page
Inherited:no
Percentages:N/A

When the value is auto, the width depends on the system setting. The default width of a printer mark is 0.24pt, it can be adjusted in the Option Setting File.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:printer-marks-zero-margin / CSS -ah-printer-marks-zero-margin no-LT

Specifies the margin between the page and the printer marks when bleed is 0.

Value:<length> | auto
Initial:auto
Applies to:fo:simple-page-master / CSS @page
Inherited:no
Percentages:N/A

When the value is auto, the margin depends on the system setting. The default margin is 3mm, it can be adjusted in the Option Setting File.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:printer-marks-spine-width / CSS -ah-printer-marks-spine-width no-LT

Specifies the spine width of the facing page.

Value:<length>
Initial:0pt
Applies to:fo:simple-page-master / CSS @page
Inherited:no
Percentages:N/A

When a value greater than 0pt is specified, the printing image is considered to be constructed as facing pages, the center mark of the spine will be outputted as a spine-width printer mark.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:printer-marks-over-content / CSS -ah-printer-marks-over-content V7.4 no-LT XSL-FO Samples CollectionSpecifies whether printer marks are drawn over the page content

Specifies whether printer marks are drawn over the page content.

Value:false | true
Initial:false
Applies to:fo:simple-page-master / CSS @page
Inherited:no
Percentages:N/A

If true is specified, printer marks can be drawn over the page content.

This property is not available with Antenna House Formatter V7.4 Lite.


Printing Control

axf:printer-bin-selection / CSS -ah-printer-bin-selection no-LT

Selects the printer tray.

Value:<string> | <integer>
Initial:depends on the environment
Applies to:fo:page-sequence / CSS root element
Inherited:yes
Percentages:N/A

Effective only with Windows versions and functions when outputting to a printer. Whether it is effective also depends on a printer. What can be specified by the character string is the tray name which comes out in each printer setting dialog. This is the tray name acquired from a printer driver. The specified name which does not match to the tray name acquired from a printer driver is invalid. The specified integer needs to match to the tray number acquired from a printer driver.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:printer-duplex / CSS -ah-printer-duplex no-LT

Specifies to print in duplex mode.

Value:<integer>
Initial:depends on the environment
Applies to:fo:page-sequence / CSS root element
Inherited:no
Percentages:N/A

Effective only with Windows versions and functions when outputting to a printer. Whether it is effective also depends on a printer. Specify the value that is specified by the printer driver. Most printers support following integer values.

  1. Simplex Printing.
  2. Duplex Printing. Flip on Long(Vertical) Edge.
  3. Duplex Printing. Flip on Short(Horizontal) Edge.

See also SeparatePrinterDuplexJob in the Option Setting File. This property is not available with Antenna House Formatter V7.4 Lite.

axf:overprint / CSS -ah-overprint no-LT XSL-FO Samples CollectionOverprint

Specifies the overprint.

Value:auto | <overprint>#
Initial:auto
Applies to:all formatting objects
Inherited:yes
Percentages:N/A

<overprint> = <opcolor> [[stroke || paint || [full | nonzero]] | none]?
<opcolor> = <color> | k100 | separation | all

Values have the following meanings:

auto

The setting of the overprint in the Option Setting File is adopted. If you specify overprint="k100" in the Option Setting File, even if nothing is specified in FO, black overprinting will be done on all pages.

<color>

Specifies a color you want to apply the overprint. A color with alpha value cannot be specified.

k100

Applies the overprint to rgb-icc(#CMYK,0,0,0,1).

separation

Applies the overprint to the separation color shown rgb-icc(#Separation). The registration color is not included.

all

Applies the overprint to all colors except for a color with alpha value.

stroke

Applies the overprint for the line stroke.

paint

Applies the overprint for the paint.

full
nonzero

Specifies the operation in case the color ingredient is 0 when applying the overprint. When full is specified, the color ingredient is set to 0, when nonzero is specified, the color ingredient is not changed. (It is considered no color.) This setting is effective only with CMYK.

none

The overprint is not applied.

If you specify only the color as follows:

axf:overprint="<color>"

it is considered as follows:

axf:overprint="<color> stroke paint nonzero"

In addition, when neither stroke nor paint is specified, it is considered that stroke and paint are specified. Specify none to remove them from the overprint.

axf:overprint="k100, rgb-icc(#CMYK,0,0,0,1) stroke full, all paint"
As specified above, when a certain color can be interpreted as multiple settings, the settings will be investigated in the following order and the first matched setting will be adopted.
  1. <color>
  2. k100
  3. separation
  4. all

The effect of the overprint varies by the actual printing environment, in relation between the background color and the foreground color with overprint specified. The effect of the typical overprint by the color space is shown below. When color-conversion="all-cmyk" is specified in the Option Setting File, RGB serves as CMYK.

Foreground (overprint is specified)
CMYKSeparationRGBGrayscale
Background CMYKyesyesnono
Separationyesyesyesyes
RGByesyesnono
Grayscalenoyesnono

For more details, see also 4.5.6 Overprint Control in ISO 32000-1 or ISO 32000-2.

This property is not available with Antenna House Formatter V7.4 Lite.


Page Control Extensions

axf:repeat-page-sequence-master no-LT

Specifies the repetition of the page sequence.

Value:true | false
Initial:false
Applies to:fo:page-sequence-master
Inherited:no
Percentages:N/A

When the value is true, if the page output reaches in the end of <fo:page-sequence-master> and the page which should still be outputted remains, page output repeats from the start of <fo:page-sequence-master>.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:reverse-page / CSS -ah-reverse-page no-LT XSL-FO Samples CollectionPage numbers with mixed horizontal and vertical pages

Outputs pages in reverse order.

Value:true | false
Initial:false
Applies to:fo:page-sequence
Inherited:no
Percentages:N/A

Values have the following meanings:

true

Outputs pages in reverse order.

false

Outputs pages in order.

Specifies whether to output pages within fo:page-sequence in reverse order. This setting does not cover all the output destinations. Effective only with PDF output. Multi Separate Volume is not available. In case of CSS, this setting can be specified for the <html> element only.

This property is not available with Antenna House Formatter V7.4 Lite.

force-page-count / CSS -ah-force-page-countIntroduction to CSS for Paged Media-ah-force-page-count

The following bold values are extended.

Value:auto | even | odd | doubly-even | end-on-even | end-on-odd | end-on-doubly-even | even-document | odd-document | doubly-even-document | [ end-on | document ]? <number> <number>? | no-force

Values have the following meanings:

doubly-even

Force an doubly-even number of pages in this page-sequence.

end-on-doubly-even

Force the last page in this page-sequence to be an doubly-even-page.

even-document

Force the number of pages counted from the document head to be an even number.

odd-document

Force the number of pages counted from the document head to be an odd number.

doubly-even-document

Force the number of pages counted from the document head to be an doubly-even number.

[ end-on | document ]? <number> <number>? no-LT

Suppose that the first <number> is A, the next <number> is B, the number of pages of the current page-sequence is set as a multiple number of A + B. A must be an integer greater than or equal to 1, and B must be an integer greater than or equal to 0 and less than A. When B is omitted, it is considered 0. When end-on is specified, force-page-count determines the page count of the current page-sequence. When document is specified, it determines the page count counting from the beginning of the document. For example, for a page sequence with 5 pages of content:

  • force-page-count="even"
    equivalent to force-page-count="2"
  • force-page-count="odd"
    equivalent to force-page-count="2 1"
  • force-page-count="doubly-even"
    equivalent to force-page-count="4"
  • force-page-count="end-on-doubly-even"
    equivalent to force-page-count="end-on 4"
  • force-page-count="end-on 2"
    total number of pages is 6 with 1 blank page
  • force-page-count="end-on 4"
    total number of pages is 8 with 3 blank page
  • force-page-count="end-on 4 1"
    total number of pages is 5 with 0 blank pages
  • force-page-count="end-on 4 3"
    total number of pages is 7 with 2 blank pages
  • force-page-count="end-on 6 5"
    total number of pages is 5 with 0 blank pages
  • force-page-count="end-on 6 4"
    total number of pages is 10 with 5 blank pages

See also Empty <fo:page-sequence>.

In CSS, this property is evaluated when specified to @page.

This property is not available with Antenna House Formatter V7.4 Lite CSS.

odd-or-evenXSL-FO Samples CollectionPage masters for odd and even pages counting from the beginning of the document

The following bold values are extended.

Value: odd | even | odd-document | even-document | any

Values have the following meanings:

odd-document no-LT

This page master is eligible for selection if the number of pages from the beginning of the document is odd.

even-document no-LT

This page master is eligible for selection if the number of pages from the beginning of the document is even.

These extended values are not available with Antenna House Formatter V7.4 Lite.

page-positionXSL-FO Samples CollectionPage master for second pagePage masters for first, last, and only pages

The following bold values are extended. no-LT

Value: only | first | last | rest | any | second | <An+B>

Values have the following meanings:

second

Second page (the page after first).

<An+B>

You can specify values in the same format as :nth() in CSS.

size / CSS (-ah-)sizeIntroduction to CSS for Paged Mediasize

The following bold value is extended. [CSS3-Page] Page size: the ‘size’ property

Value: <length>{1,2} | auto | [ <paper-name> || [ portrait | landscape] ]

Values have the following meanings:

auto

It's the size of default-page-width×default-page-height in the Option Setting File.

<paper-name>

Specifies the paper name. The following can be specified. Case insensitive.

<paper-name>Width×Height
A3297×420mmISO 216
A4210×297mmISO 216
A5148×210mmISO 216
A6105×148mmISO 216
B4250×353mmISO 216
ISO-B4
JIS-B4257×364mmJIS P 0138
B5176×250mmISO 216
ISO-B5
JIS-B5182×257mmJIS P 0138
B6125×176mmISO 216
ISO-B6
JIS-B6128×182mmJIS P 0138
Letter8.5×11inNorth American Paper Sizes
Government-Letter8×10.5inNorth American Paper Sizes
Legal8.5×14inNorth American Paper Sizes
Ledger17×11inNorth American Paper Sizes
Tabloid11×17inNorth American Paper Sizes
Statement5.5×8.5in
Executive7.25×10.5in
Folio210×330mm
C 17×22inANSI Paper Sizes
D 22×34inANSI Paper Sizes
E 34×44inANSI Paper Sizes
ISO-DL 110×220mmISO 269
ISO-C3 324×458mmISO 269
ISO-C4 229×324mmISO 269
ISO-C5 162×229mmISO 269
ISO-C6 114×162mmISO 269
Hagaki 100×148mmJapan Post Co., Ltd.

CSS @page Introduction to CSS for Paged Media@page

In the CSS specifications, :blank :first :left :right :nth() are the only page selectors that can be specified for @page, but in Antenna House Formatter V7.4, the following can be specified including those that can be specified for <fo:conditional-page-master-reference> in XSL-FO. [CSS3-Page] Page selectors

  • :blank :not-blank
  • :first :last :only :rest
  • :left :right :odd :even :recto :verso
  • :nth()

The specificity of page selectors defined in [CSS3-Page] does not include :nth(), extended :only, etc. Therefore, Antenna House Formatter V7.4 implements the specificity as follows:

  1. <page-type-name>
  2. :blank
  3. :only
  4. :first :last
  5. :left :right :odd :even :recto :verso :nth()
  6. :rest
  7. :not-blank

The following adjustments will be made:

  • :first:last is considered :only.
  • When :only is specified, the settings of :first and :last are discarded.

Also, inconsistent settings, such as @page :left:right, will not result in an error, but such @page will not be adopted.

break-after / CSS (-ah-)break-after
break-before / CSS (-ah-)break-before XSL-FO Samples CollectionPage breaks at even or odd pages from the top of the documentReduce unnecessary forced breaksIntroduction to CSS for Paged Mediabreak-afterbreak-before

The following bold values are extended. [CSS3-Multicol] ‘break-before’, ‘break-after’, ‘break-inside’ no-LT

Value: auto | column | page | even-page | odd-page | even-document | odd-document (XSL)
auto | always | page | column | avoid | avoid-page | avoid-column | left | right | even-document | odd-document (CSS)

Values have the following meanings:

even-document

Page breaks at even-numbered pages counting from the beginning of the document. It is considered even-page in Antenna House Formatter V7.4 Lite.

odd-document

Page breaks at odd-numbered pages counting from the beginning of the document. It is considered odd-page in Antenna House Formatter V7.4 Lite.

See also axf:break-distance.

axf:break-distance / CSS -ah-break-distance no-LT XSL-FO Samples CollectionReduce unnecessary forced breaks

Specifies effective heights for break-after and break-before.

Value:always | <length> | <percentage>
Initial:always
Applies to:block-level formatting objects
Inherited:no
Percentages:refer to the height of containing block

Values have the following meanings:

always

break-after and break-before are always effective.

<length> | <percentage>

break-after and break-before are effective when the height of the remaining area is less than the specified height.

This property is not available with Antenna House Formatter V7.4 Lite.


Block Extensions

axf:suppress-if-first-on-page / CSS -ah-suppress-if-first-on-page no-LT

Specifies whether to suppress the block at the start of the page or the column.

Value:false | true | unless
Initial:false
Applies to:fo:block, fo:block-container
Inherited:no
Percentages:N/A

Values have the following meanings:

false

Does nothing.

true

Suppresses a block when it comes at the start of the page or the column. Actually, it is hidden but exists as a block of zero size without being deleted, it's effective to refer to id, etc.

unless

Suppresses a block when it comes to a place other than the start of the page or the column. Actually, it is hidden but exists as a block of zero size without being deleted, it's effective to refer to id, etc.

This property is not available with Antenna House Formatter V7.4 Lite.

Transformation

axf:transform / CSS (-ah-)transform no-LT XSL-FO Samples CollectionBlock transformation

Specifies the block transformation. [CSS3-Transforms] The ‘transform’ Property

Value: none | <transform-function>+
Initial:none
Applies to:transformable objects
Inherited:no
Percentages:N/A

Values have the following meanings:

none

Does not transform the block.

<transform-function>

Performs the specified transformation. The following transformations can be specified.

  • matrix(<number>, <number>, <number>, <number>, <number>, <number>)
  • translate(<translation-value>[, <translation-value>])
  • translateX(<translation-value>)
  • translateY(<translation-value>)
  • scale(<number>[, <number>])
  • scaleX(<number>)
  • scaleY(<number>)
  • rotate(<angle>)
  • skew(<angle>[, <angle>])
  • skewX(<angle>)
  • skewY(<angle>)

This property is not available with Antenna House Formatter V7.4 Lite.

axf:transform-origin / CSS (-ah-)transform-origin no-LT XSL-FO Samples CollectionBlock transformation

Specifies the origin of the block transformation. [CSS3-Transforms] The ‘transform-origin’ Property

Value: [ <percentage> | <length> | left | center | right | top | bottom] | [ [ <percentage> | <length> | left | center | right ] && [ <percentage> | <length> | top | center | bottom ] ]
Initial:center center
Applies to:transformable objects
Inherited:no
Percentages:refer to the size of the bounding box

This property is not available with Antenna House Formatter V7.4 Lite.

Baseline Grid

axf:baseline-grid / CSS -ah-baseline-grid no-LT XSL-FO Samples CollectionAlign title to top of text blockLine grid

Sets or clears the baseline grid.

Value:normal | none | root | new
Initial:normal
Applies to:block-level formatting objects, fo:page-sequence, fo:flow and fo:static-content / block containers
Inherited:yes
Percentages:N/A

Values have the following meanings:

normal

Neither sets nor clears the baseline grid.

none

Clears the baseline grid and the content will not align with a baseline grid.

new

Sets a new baseline grid. The new baseline grid is established by using the font and the line-height settings of this element.

root

Sets the baseline grid defined by the root element. The root baseline grid is defined by using the font and the line-height settings of the root element.

Inside the area line that a baseline grid is set, the lines are aligned with baselines on the baseline grid. Half-leading is not added before the first line and after the last line so that the em-box edges are aligned with the before and after edges of the content box.

The baseline grid is not available in the area with display-align other than auto.

An HTML+CSS example with baseline grids:

:root {
  font-size: 10pt;
  line-height: 18pt;
  font-family: "Yu Mincho", serif;
}

@page {
  size: 128mm 188mm;
  margin: auto;
  width: 28rem;
  height: calc(24rlh - (1rlh - 1rem));
}

body {
  -ah-baseline-grid: root;
}

h1 {
  -ah-baseline-grid: new;
  -ah-baseline-block-snap: center;
  font-size: 16pt;
  line-height: 20pt;
  margin-top: 16pt;
  margin-bottom: 16pt;
}

figure {
  -ah-baseline-grid: none;
  -ah-baseline-block-snap: auto;
}

An XSL-FO example with baseline grids:

<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format"
         xmlns:axf="http://www.antennahouse.com/names/XSL/Extensions"
         font-size="10pt" line-height="18pt" font-family="Yu Mincho, serif">
  ...
  <fo:page-sequence master-reference="master">
    <fo:flow flow-name="xsl-region-body" axf:baseline-grid="root">
      <fo:block axf:baseline-grid="new" axf:baseline-block-snap="center"
          font-size="16pt" line-height="20pt" space-before="16pt" space-after="16pt">
        Heading ...
      </fo:block>
      <fo:block>The quick brown fox jumps ...</fo:block>
      ...
      <fo:block axf:baseline-grid="none" axf:baseline-block-snap="auto">
         Figure ...
      </fo:block>
      ...
    </fo:flow>
  </fo:page-sequence>
</fo:root>

This property is not available with Antenna House Formatter V7.4 Lite.

axf:baseline-block-snap / CSS -ah-baseline-block-snap no-LT XSL-FO Samples CollectionAlign title to top of text blockLine grid

Specifies how to align blocks on the baseline grid.

Value:none | [auto | before | after | center] || [border-box | margin-box]
Initial:auto border-box
Applies to:block-level elements
Inherited:no
Percentages:N/A

Values have the following meanings:

none

The block is not aligned with the baseline grid.

auto

Same as before on top of column, same as after at bottom of column, otherwise center.

before

The before edge of the block is aligned with a text-before-edge baseline on the baseline grid.

after

The after edge of the block is aligned with a text-after-edge baseline on the baseline grid.

center

The block is centered between a text-before-edge and a text-after-edge baselines on the baseline grid.

border-box

The border edge is used to align the block on the baseline grid.

margin-box

The margin edge is used to align the block on the baseline grid.

This property specifies how to align blocks other than normal line boxes, such as headings, figures and tables, on the baseline grid.

baseline-block-snap

See axf:baseline-grid for usage.

This property is not available with Antenna House Formatter V7.4 Lite.


Line Breaking

Antenna House Formatter V7.4 provides extension properties to control the line-breaking. Usually, the line-breaking complies with UAX#14: Line Breaking Properties. See also Line Breaking in Technical Notes.

axf:line-break / CSS (-ah-)line-breakXSL-FO Samples CollectionBreaking Paragraphs into Lines (BPIL)Non-starter Japanese character

Specifies the method of line breaking. [CSS3-Text] Breaking Rules for Punctuation: the ‘line-break’ property

Value: auto | [[normal | strict | loose | anywhere] || [line | bpil]]
Initial: auto
Applies to:all block-level formatting objects
Inherited:yes
Percentages:N/A

Values have the following meanings:

auto

It is considered that normal is specified.

normal

CJK Nonstarter characters (prolonged sound mark, small hiragana letters, small katakana letters, and iteration marks) defined in JIS X 4051:2004 are not treated as Nonstarter characters. Characters marked with [NS] in the following list are processed.

strict

CJK Nonstarter character is treated. Characters marked with [NS] and [JIS] in the following list are processed.

line

Line breaking is performed one by one by a simple algorithm.

bpil

Line breaking is performed according to the line breaking algorithm by Knuth-Plass's Breaking Paragraphs into Lines. At this time, the bpil specification in the Option Setting File is ignored. Depending on the conditions, this algorithm may not be applicable. See Line Breaking in Technical Notes.

If neither normal nor strict is specified, it is considered that normal is specified. When neither line nor bpil is specified, the algorithm is selected according to the specification of bpil in the Option Setting File. For more details, see Line Breaking in Technical Notes.

The line breaking other than Nonstarter characters in CJK complies with UAX#14: Line Breaking Properties. At this time, characters specified to the properties of axf:append-non-starter-characters, axf:except-non-starter-characters, axf:append-non-end-of-line-characters and axf:except-non-end-of-line-characters are included.

The CJK Nonstarter character is as follows:

U+203CDOUBLE EXCLAMATION MARK [NS]
U+203DINTERROBANG [NS]
U+2047DOUBLE QUESTION MARK [NS]
U+2048QUESTION EXCLAMATION MARK [NS]
U+2049EXCLAMATION QUESTION MARK [NS]
U+3005IDEOGRAPHIC ITERATION MARK [NS] [JIS]
U+301CWAVE DASH [NS]
U+303BVERTICAL IDEOGRAPHIC ITERATION MARK [NS] [JIS]
U+303CMASU MARK [NS]
U+3041HIRAGANA LETTER SMALL A [JIS]
U+3043HIRAGANA LETTER SMALL I [JIS]
U+3045HIRAGANA LETTER SMALL U [JIS]
U+3047HIRAGANA LETTER SMALL E [JIS]
U+3049HIRAGANA LETTER SMALL O [JIS]
U+3063HIRAGANA LETTER SMALL TU [JIS]
U+3083HIRAGANA LETTER SMALL YA [JIS]
U+3085HIRAGANA LETTER SMALL YU [JIS]
U+3087HIRAGANA LETTER SMALL YO [JIS]
U+308EHIRAGANA LETTER SMALL WA [JIS]
U+3095HIRAGANA LETTER SMALL KA [JIS]
U+3096HIRAGANA LETTER SMALL KE [JIS]
U+309BKATAKANA-HIRAGANA VOICED SOUND MARK [NS]
U+309CKATAKANA-HIRAGANA SEMI-VOICED SOUND MARK [NS]
U+309DHIRAGANA ITERATION MARK [NS] [JIS]
U+309EHIRAGANA VOICED ITERATION MARK [NS] [JIS]
U+30A0KATAKANA-HIRAGANA DOUBLE HYPHEN [NS]
U+30A1KATAKANA LETTER SMALL A [JIS]
U+30A3KATAKANA LETTER SMALL I [JIS]
U+30A5KATAKANA LETTER SMALL U [JIS]
U+30A7KATAKANA LETTER SMALL E [JIS]
U+30A9KATAKANA LETTER SMALL O [JIS]
U+30C3KATAKANA LETTER SMALL TU [JIS]
U+30E3KATAKANA LETTER SMALL YA [JIS]
U+30E5KATAKANA LETTER SMALL YU [JIS]
U+30E7KATAKANA LETTER SMALL YO [JIS]
U+30EEKATAKANA LETTER SMALL WA [JIS]
U+30F5KATAKANA LETTER SMALL KA [JIS]
U+30F6KATAKANA LETTER SMALL KE [JIS]
U+30FBKATAKANA MIDDLE DOT [NS]
U+30FCKATAKANA-HIRAGANA PROLONGED SOUND MARK [JIS]
U+30FDKATAKANA ITERATION MARK [NS] [JIS]
U+30FEKATAKANA VOICED ITERATION MARK [NS] [JIS]
U+31F0KATAKANA LETTER SMALL KU [JIS]
U+31F1KATAKANA LETTER SMALL SI [JIS]
U+31F2KATAKANA LETTER SMALL SU [JIS]
U+31F3KATAKANA LETTER SMALL TO [JIS]
U+31F4KATAKANA LETTER SMALL NU [JIS]
U+31F5KATAKANA LETTER SMALL HA [JIS]
U+31F6KATAKANA LETTER SMALL HI [JIS]
U+31F7KATAKANA LETTER SMALL HU [JIS]
U+31F8KATAKANA LETTER SMALL HE [JIS]
U+31F9KATAKANA LETTER SMALL HO [JIS]
U+31FAKATAKANA LETTER SMALL MU [JIS]
U+31FBKATAKANA LETTER SMALL RA [JIS]
U+31FCKATAKANA LETTER SMALL RI [JIS]
U+31FDKATAKANA LETTER SMALL RU [JIS]
U+31FEKATAKANA LETTER SMALL RE [JIS]
U+31FFKATAKANA LETTER SMALL RO [JIS]
U+FE54SMALL SEMICOLON [NS]
U+FE55SMALL COLON [NS]
U+FF1AFULLWIDTH COLON [NS]
U+FF1BFULLWIDTH SEMICOLON [NS]
U+FF65HALFWIDTH KATAKANA MIDDLE DOT [NS]
U+FF67HALFWIDTH KATAKANA LETTER SMALL A [JIS]
U+FF68HALFWIDTH KATAKANA LETTER SMALL I [JIS]
U+FF69HALFWIDTH KATAKANA LETTER SMALL U [JIS]
U+FF6AHALFWIDTH KATAKANA LETTER SMALL E [JIS]
U+FF6BHALFWIDTH KATAKANA LETTER SMALL O [JIS]
U+FF6CHALFWIDTH KATAKANA LETTER SMALL YA [JIS]
U+FF6DHALFWIDTH KATAKANA LETTER SMALL YU [JIS]
U+FF6EHALFWIDTH KATAKANA LETTER SMALL YO [JIS]
U+FF6FHALFWIDTH KATAKANA LETTER SMALL TU [JIS]
U+FF70HALFWIDTH KATAKANA-HIRAGANA PROLONGED SOUND MARK [JIS]
U+FF9EHALFWIDTH KATAKANA VOICED SOUND MARK [NS]
U+FF9FHALFWIDTH KATAKANA SEMI-VOICED SOUND MARK [NS]

[NS] is classified into NS in Line Break Properties. [JIS] is classified into the Nonstarter character in JIS X 4051:2004.

axf:append-non-starter-characters / CSS -ah-append-non-starter-characters

Specifies the non-starter-characters to append.

Value:<string>
Initial:empty string
Applies to:fo:page-sequence / CSS root element
Inherited:no
Percentages:N/A

The characters included in <string> can be appended to the non-starter-characters. If the specified characters are also specified in axf:except-non-starter-characters as well in the same tag, the effect could be wrong. White space characters are disregarded even though they are specified. Closing parentheses and punctuation marks are automatically treated as except-non-starter characters without adding them. The initial value of non-starter-characters can be set by append-non-starter-characters in the Option Setting File.

axf:except-non-starter-characters / CSS -ah-except-non-starter-characters

Specifies the non-starter-characters to eliminate.

Value:<string>
Initial:empty string
Applies to:fo:page-sequence / CSS root element
Inherited:no
Percentages:N/A

The characters included in <string> can be eliminated from the non-starter-characters. If the specified characters are also specified to axf:append-non-starter-characters in the same tag as well, the effect is not guaranteed. White space characters are disregarded even though they are specified. The initial value of non-starter-characters can be set by append-non-starter-characters in the Option Setting File.

axf:append-non-end-of-line-characters / CSS -ah-append-non-end-of-line-characters

Specifies the non-end-of-line-characters to append.

Value:<string>
Initial:empty string
Applies to:fo:page-sequence / CSS root element
Inherited:no
Percentages:N/A

The characters included in <string> can be appended to the non-end-of-line-characters. If the specified characters are also specified to axf:except-non-end-of-line-characters as well in the same tag, the effect could be wrong. White space characters are disregarded even though they are specified. Opening parentheses etc. are automatically treated as except-non-end-of-line characters without adding them. The initial value of non-end-of-line-characters can be set by append-non-end-of-line-characters in the Option Setting File.

axf:except-non-end-of-line-characters / CSS -ah-except-non-end-of-line-characters

Specifies the non-end-of-line-characters to eliminate.

Value:<string>
Initial:empty string
Applies to:fo:page-sequence / CSS root element
Inherited:no
Percentages:N/A

The characters included in <string> can be eliminated from the non-end-of-line-characters. If the specified characters are also specified to axf:append-non-end-of-line-characters in the same tag as well, the effect is not guaranteed. White space characters are disregarded even though they are specified. The initial value of non-end-of-line-characters can be set by append-non-end-of-line-characters in the Option Setting File.

axf:word-break / CSS (-ah-)word-break

Specifies whether to enable line breaking even inside a word. [CSS3-Text] Breaking Rules for Letters: the ‘word-break’ property

Value:normal | keep-all | break-all | break-word | keep-non-spaces
Initial:normal
Applies to:all block-level and inline-level formatting objects
Inherited:yes
Percentages:N/A

Values have the following meanings:

normal

Follows a normal line breaking rule.

keep-all

Does not break inside words. A word here indicates a character string which consists of the following category (General Category) of Unicode.

  • Letter
  • Mark
  • Number

Whether to break lines on a boundary with characters other than these follows the rule of the standard line break. Moreover, hyphenate="true" is disregarded.

break-all

The line breaking is enabled between all the characters in the word. This is effective only with the following scripts.

  • Latn
  • Cyrl
  • Grek
  • Zyyy

axf:word-wrap="normal" is disregarded.

keep-non-spaces

Does not break between non-whitespace characters.

Within the word oriented upright by axf:text-orientation="upright", it is always considered axf:word-break="break-all".

axf:word-wrap / CSS (-ah-)word-wrap

Specifies whether to break word forcibly when line break cannot be performed. [CSS3-Text] Overflow Wrapping: the overflow-wrap/word-wrap property

Value:normal | break-word | break-spaces
Initial:break-word (XSL) / normal (CSS)
Applies to:all block-level and inline-level formatting objects
Inherited:yes
Percentages:N/A

Values have the following meanings:

normal

The line is not broken forcibly. The text will overflow across the region.

break-word

The line is broken forcibly at an appropriate position.

axf:url-break / CSS -ah-url-break V7.4 no-LT

Specifies how to perform the line breaking in a URL.

Value:normal | chicago
Initial:normal
Applies to:all block-level and inline-level formatting objects
Inherited:yes
Percentages:N/A

Values have the following meanings:

normal

Follows a normal line breaking rule.

chicago

Breaks lines for substrings such as URLs in text, as in The Chicago Manual of Style. That is, follows these rules:

  • Disallows breaking after /.
  • Allows breaking before a single / other than at the end of the URL. (Disallows breaking before //.)
  • Other than these, follows a normal line breaking rule.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:abbreviation-character-count / CSS -ah-abbreviation-character-countXSL-FO Samples CollectionControlling line breaking at abbreviations

Specifies the maximum number of characters considered an abbreviation.

Value:auto | <number>
Initial:auto
Applies to:fo:block
Inherited:yes
Percentages:N/A

Values have the following meanings:

auto

The setting of the abbreviation-character-count in the Option Setting File is adopted.

<number>

Specifies the number of characters considered an abbreviation.

axf:abbreviation-character-count controls the line break of the abbreviation delimited by U+002F or “/”. In general, the line break occurs with “km/h” or “w/o”, etc. because the position right after “/” is the target for the line break and it's not desirable. In UAX#14: Line Breaking Properties, it is written to avoid splitting in such cases. In Antenna House Formatter V7.4, when the number of characters of the word right after “/” is less than or equal to the specified number with axf:abbreviation-character-count, the word is considered the abbreviation and the line does not break. Also, the word right after “/” will not be hyphenated when the number of characters of the word is less than or equal to the specified number with axf:abbreviation-character-count. It is considered an abbreviation only when the string is one of the following scripts:

  • Latn
  • Cyrl
  • Grek
  • Zyyy

The axf:abbreviation-character-count must be an integer number of 0 or more. 0 does not control over the abbreviation. In addition, when the line overflows without finding the line break position, the line break may forcibly occur right after “/”. If the number of characters exceeds 10, it is considered 10.

axf:quotetype no-LT XSL-FO Samples CollectionSpecifying the direction of quotation marks

Specifies the direction of the quotes.

Value:QU | OP | CL
Initial:empty
Applies to:fo:character
Inherited:no
Percentages:N/A

Values have the following meanings (they are case insensitive):

QU

Considered to be an non-directional quotation mark.

OP

Considered to be an open quotation mark.

CL

Considered to be a close quotation mark.

For non-directional quotation marks such as U+0022, explicitly specify the direction as follows to encourage proper line breaks:

Lorem
<fo:character character="&#x22;" axf:quotetype="OP"/>ipsum<fo:character character="&#x22;" axf:quotetype="CL"/>
dolor sit amet,

Specifying the property to characters other than quotation marks is invalid. See Quotation Mark in Technical Notes for how to handle quotation marks. If not specified, the setting there will be used.

This property is not available with Antenna House Formatter V7.4 Lite.


Extension for Hyphenations

Antenna House Formatter V7.4 provides the extended features for hyphenations.

hyphenate XSL-FO Samples CollectionHyphenation processing and SOFT HYPHENHyphenation processing of words that consist of uppercase letters

The following bold value is extended.

Value:none | false | true

Values have the following meanings:

none

Neither hyphenation by dictionary nor hyphenation by SOFT HYPHEN (U+00AD) occurs. Corresponds to hyphens:none in CSS.

false

Hyphenation by dictionary does not occur, but hyphenation by SOFT HYPHEN (U+00AD) occurs. Corresponds to hyphens:manual in CSS.

true

Hyphenation by dictionary and hyphenation by SOFT HYPHEN (U+00AD) occur. Corresponds to hyphens:auto in CSS.

See Hyphenation.

hyphenation-push-character-count

The following bold value is extended.

Value:<number> | auto

Values have the following meanings:

auto

If after of <hyphen-min> is specified in the Hyphenation Exception Dictionary, it will be the value. If nothing is specified, the value is 2.

In CSS, (-ah-)hyphenate-after corresponds to it.

hyphenation-remain-character-count

The following bold value is extended.

Value:<number> | auto

Values have the following meanings:

auto

If before of <hyphen-min> is specified in the Hyphenation Exception Dictionary, it will be the value. If nothing is specified, the value is 2.

In CSS, (-ah-)hyphenate-before corresponds to it.

axf:hyphenation-minimum-character-count / CSS -ah-hyphenation-minimum-character-countXSL-FO Samples CollectionSpecifying the character count and zone of the word to be hyphenated

Specifies the minimum number of characters a word must have before it can be hyphenated.

Value:<number>
Initial:1
Applies to:fo:block, fo:character
Inherited:yes
Percentages:N/A

The axf:hyphenation-minimum-character-count must be an integer number of 1 or more.

axf:hyphenation-zone / CSS -ah-hyphenation-zoneXSL-FO Samples CollectionSpecifying the character count and zone of the word to be hyphenated

Limits the range where a hyphenation is available.

Value:none | <length> | <percentage>
Initial:none
Applies to:fo:block
Inherited:yes
Percentages:refer to the width of containing block

Values have the following meanings:

none

Nothing is limited in hyphenation.

<length>

If the length from the end of a word to the end of line is less or equal to the specified value, the following word is not hyphenated.
It is invalid when 0 or less value is specified.

axf:hyphenate-hyphenated-word / CSS -ah-hyphenate-hyphenated-wordXSL-FO Samples CollectionHyphenation of hyphenated words

Specifies whether to hyphenate the already hyphenated word or not.

Value:true | false
Initial:true
Applies to:fo:block
Inherited:yes
Percentages:N/A

Values have the following meanings:

true

Hyphenates a word.

false

Does not hyphenate a word. The line may break only at the hyphen position.

The following are recognized as hyphens.

U+002DHYPHEN-MINUS
U+2010HYPHEN
U+2011NON-BREAKING HYPHEN

This setting is effective when hyphenate="true" is specified.

axf:hyphenate-caps-word / CSS -ah-hyphenate-caps-wordXSL-FO Samples CollectionHyphenation processing of words that consist of uppercase letters

Specifies whether to hyphenate a word that consists of capital letters.

Value:true | false | false-all
Initial:true
Applies to:fo:block
Inherited:yes
Percentages:N/A

Values have the following meanings:

true

Hyphenates a word.

false

Does not hyphenate a word that consists of all capital letters. A word that does not consist of all capital letters, such as a word that has only the first letter capitalized, is hyphenated.

false-all

Does not hyphenate all words that start with a capital letter.

A phrase like ANTENNA-HOUSE with hyphens is considered multiple words. There is a possibility of a line break at the hyphen position. Even letters processed as small-caps are considered lowercase if the original letters are lowercase. This setting is effective when hyphenate="true" is specified.

axf:double-hyphen-translineation / CSS -ah-double-hyphen-translineation V7.4

Specifies whether to place a hyphen also at the start of the line when breaking lines at a hyphen.

Value:auto | true | false
Initial:auto
Applies to:fo:block
Inherited:yes
Percentages:N/A

Values have the following meanings:

auto

Works as true when the language is specified by double-hyphen-translineation in the Option Setting File.

true

Place a hyphen also at the start of the line when a line break occurs at a hyphen.

false

Does not place a hyphen at the start of the line when a line break occurs at a hyphen.

This setting is effective when hyphenate="true" is specified.

CSS (-ah-)hyphenate-afterIntroduction to CSS for Paged Mediahyphenate-after

[CSS3-GCPM] Hyphenate properties (“hyphenate-after” has been removed from GCPM on and after November 29, 2011)

Value:<integer> | auto
Initial:auto
Applies to:all elements
Inherited:yes
Percentages:N/A

 [XSL 1.1] hyphenation-push-character-count, hyphenation-push-character-count

CSS (-ah-)hyphenate-beforeIntroduction to CSS for Paged Mediahyphenate-before

[CSS3-GCPM] Hyphenate properties (“hyphenate-before” has been removed from GCPM on and after November 29, 2011)

Value:<integer> | auto
Initial:auto
Applies to:all elements
Inherited:yes
Percentages:N/A

 [XSL 1.1] hyphenation-remain-character-count, hyphenation-remain-character-count

CSS (-ah-)hyphenate-character

[CSS3-GCPM] Hyphenate properties (“hyphenate-character” has been removed from GCPM on and after November 29, 2011)

Value:auto | <string>
Initial:auto
Applies to:all elements
Inherited:yes
Percentages:N/A

 [XSL 1.1] hyphenation-character

CSS (-ah-)hyphenate-linesIntroduction to CSS for Paged Mediahyphenate-lines

[CSS3-GCPM] Hyphenate properties (“hyphenate-lines” has been removed from GCPM on and after November 29, 2011)

Value:no-limit | <integer>
Initial:no-limit
Applies to:all elements
Inherited:yes
Percentages:N/A

 [XSL 1.1] hyphenation-ladder-count

CSS (-ah-)hyphensIntroduction to CSS for Paged Mediahyphens

[CSS3-Text] Hyphenation Control: the ‘hyphens’ property

Value:none | manual | auto
Initial:manual
Applies to:all elements
Inherited:yes
Percentages:N/A

 [XSL 1.1] hyphenate

<axf:hyphenation-info> no-LT XSL-FO Samples CollectionAdding hyphenation information

Common Usage:

Specifies additional hyphenation information. This element does not generate an area. This feature is not available in CSS. This feature is not available with Antenna House Formatter V7.4 Lite.

Areas:

None.

Constraints:
<!ELEMENT axf:hyphenation-info (%axh-elements;)*>
<!ATTLIST axf:hyphenation-info language CDATA #REQUIRED>
<!ATTLIST axf:hyphenation-info src      CDATA #IMPLIED>

The <axf:hyphenation-info> extension element can be set as many as you want right under <fo:declarations>.

The language property is required to indicate which language this element is associated with. It is not available to do hyphenation if the specified language is originally not hyphenated. See Hyphenation for the languages you can specify.

The src property can optionally specify the exception dictionary. It's an additional setting to the original dictionary and effective only in this FO. There is no language dependency constraint for the file name unlike the original dictionary. It is a relative base-uri for the relative path. It's not a relative path to the environment valuable of the hyphenation dictionary. <exceptions> in the specified dictionary is evaluated. When multiple words of the same spelling are registered, the information on the last registered word becomes effective.

Contents:

%axh-elements; is an element which belongs to the name space http://www.antennahouse.com/names/XSL/Hyphenations. The elements in the Hyphenation Exception Dictionary are included in the name space, however currently only <exceptions> (and its child element, <hyphen>) can be described.

Examples:
<fo:declarations>
 <axf:hyphenation-info language="eng" src="en-add.xml"
  xmlns:axh="http://www.antennahouse.com/names/XSL/Hyphenations">
  <axh:exceptions>
  abc-defg
  </axh:exceptions>
 </axf:hyphenation-info>
</fo:declarations>

In this example, an additional exception dictionary, en-add.xml is specified for English language, and then the exception hyphenation is specified for the word spelled “abcdefg”.

SOFT HYPHEN Treatment

Generally SOFT HYPHEN (U+00AD) is displayed only when the line breaks and is not displayed when the line does not break. However in this processing, it is often the case that the glyph assigned to U+00AD may not be printed when the non-Unicode symbol font are used. In Antenna House Formatter V7.4, axf:soft-hyphen-treatment makes it possible to eliminate this problem.

<fo:block axf:soft-hyphen-treatment="preserve" font-family="Wingdings">abc&#xAD;xyz

axf:soft-hyphen-treatment / CSS -ah-soft-hyphen-treatment

Specifies how to treat SOFT HYPEN.

Value:auto | preserve
Initial:auto
Applies to:all formatting objects
Inherited:yes
Percentages:N/A

Values have the following meanings:

auto

SOFT HYPHEN is deleted except when needed for line breaking. (Same behavior as before.)

preserve

SOFT HYPHEN is not deleted and the target glyph is output. Hyphenation will no longer occur.

See SOFT HYPHEN.


Trimming and Hanging

Antenna House Formatter V7.4 provides extension properties to trim and to hang.

axf:punctuation-trim / CSS (-ah-)punctuation-trimXSL-FO Samples CollectionTrimming Japanese full-width punctuationIntroduction to CSS for Paged Mediapunctuation-trim

Specifies whether to treat full width punctuations in Japanese. [CSS3-Text] Fullwidth Punctuation Kerning: the ‘punctuation-trim’ property (“punctuation-trim” has been removed from CSS3-Text on and after January 19, 2012 after the transition of name)

Value: [ none | auto | all | [ [ start | start-except-first ] || [ end | allow-end | end-except-fullstop ] || adjacent ] ] || <string>
Initial:auto
Applies to:all block-level and inline-level formatting objects
Inherited:yes
Percentages:N/A

Values have the following meanings:

none

Punctuation characters are not trimmed.

start

Punctuation characters (open parenthesis etc.) at the start of the line are treated as half width.

start-except-first

Same as the start value except for a start line of a paragraph or a line right after the forced line break.

end

When text-align="right" or text-align="justify" (or text-align-last="justify") is specified and full width punctuation marks (closing parenthesis etc.) come to the end of the sentence, the character is treated as half width forcibly.

allow-end

When text-align="right" or text-align="justify" (or text-align-last="justify") is specified and full width punctuation marks (closing parenthesis etc.) come to the end of the sentence, characters are treated as full width if text fits into one line, characters are treated as half width if text does not fit into one line.

end-except-fullstop

Behaves as the same as the end value except for the following two characters.

U+3002IDEOGRAPHIC FULL STOP
U+FF0EFULLWIDTH FULL STOP

adjacent

The space between a full width punctuation and a full width character in Japanese is trimmed.

  • Between full width close parenthesis and full width open parenthesis.
  • Between full width close parenthesis and full width close parenthesis.
  • Between full width close parenthesis and full width middle dots.
  • Between full width close parenthesis and full width space.
  • Between full width close parenthesis and full width non punctuation characters.
  • Between full width open parenthesis and full width open parenthesis.
  • Between full width middle dots and full width open parenthesis.
  • Between full width space and full width open parenthesis.
  • Between full width non punctuation character and full width open parenthesis.

Full width punctuation characters are treated the same as full width close parenthesis. The adjacent value is equivalent to axf:kerning-mode="contextual" with XSL Formatter V4.

all

Trim all parentheses, middle dots, and punctuations of full width and treat them as half width.

<string>

<string> and other keywords can be written together. Specifying only <string> is equivalent to <string> none. The character string specified by <string> and the characters specified by other keywords are treated as half width characters.

auto

Dependent on the system setting. It is considered axf:punctuation-trim="none" or axf:punctuation-trim="start end adjacent" by punctuation-trim in the Option Setting File.

Full width punctuation open parenthesis processed by axf:punctuation-trim are:

U+2018LEFT SINGLE QUOTATION MARK
U+201CLEFT DOUBLE QUOTATION MARK
U+3008LEFT ANGLE BRACKET
U+300ALEFT DOUBLE ANGLE BRACKET
U+300CLEFT CORNER BRACKET
U+300ELEFT WHITE CORNER BRACKET
U+3010LEFT BLACK LENTICULAR BRACKET
U+3014LEFT TORTOISE SHELL BRACKET
U+3016LEFT WHITE LENTICULAR BRACKET
U+3018LEFT WHITE TORTOISE SHELL BRACKET
U+301ALEFT WHITE SQUARE BRACKET
U+301DREVERSED DOUBLE PRIME QUOTATION MARK
U+FF08FULLWIDTH LEFT PARENTHESIS
U+FF3BFULLWIDTH LEFT SQUARE BRACKET
U+FF5BFULLWIDTH LEFT CURLY BRACKET
U+FF5FFULLWIDTH LEFT WHITE PARENTHESIS  

Full width punctuation close parenthesis processed by axf:punctuation-trim are:

U+2019RIGHT SINGLE QUOTATION MARK
U+201DRIGHT DOUBLE QUOTATION MARK
U+3009RIGHT ANGLE BRACKET
U+300BRIGHT DOUBLE ANGLE BRACKET
U+300DRIGHT CORNER BRACKET
U+300FRIGHT WHITE CORNER BRACKET
U+3011RIGHT BLACK LENTICULAR BRACKET
U+3015RIGHT TORTOISE SHELL BRACKET
U+3017RIGHT WHITE LENTICULAR BRACKET
U+3019RIGHT WHITE TORTOISE SHELL BRACKET
U+301BRIGHT WHITE SQUARE BRACKET
U+301EDOUBLE PRIME QUOTATION MARK
U+301FLOW DOUBLE PRIME QUOTATION MARK
U+FF09FULLWIDTH RIGHT PARENTHESIS
U+FF3DFULLWIDTH RIGHT SQUARE BRACKET
U+FF5DFULLWIDTH RIGHT CURLY BRACKET
U+FF60FULLWIDTH RIGHT WHITE PARENTHESIS  

Full width punctuations processed by axf:punctuation-trim are:

U+3001IDEOGRAPHIC COMMA
U+3002IDEOGRAPHIC FULL STOP
U+FF0CFULLWIDTH COMMA
U+FF0EFULLWIDTH FULL STOP

Full width middle dots processed by axf:punctuation-trim are:

U+30FBKATAKANA MIDDLE DOT
U+FF1AFULLWIDTH COLON
U+FF1BFULLWIDTH SEMICOLON

axf:punctuation-trim doesn't affect the proportional font. Also, it is always considered none when anything other than auto is specified for glyph-orientation-*.

axf:text-justify-trim / CSS (-ah-)text-justify-trimXSL-FO Samples CollectionTrimming text at the end of line

Specifies the way to trim in text justification. [CSS3-Text] Additional compression: The 'text-justify-trim' property (“text-justify-trim” has been removed from CSS3-Text on and after June 27, 2005)

Value:none | [ punctuation || punctuation-except-fullstop || punctuation-except-middledot || [ kana | ideograph ] || inter-word ] | auto
Initial:auto
Applies to:all block-level and inline-level formatting objects
Inherited:yes
Percentages:N/A

Values have the following meanings:

none

Do not trim Japanese text.

punctuation

Trim text with parentheses, middle dots, and punctuations of full width in Japanese.

punctuation-except-fullstop

Behaves as the same as the punctuation value except for the following two characters.

U+3002IDEOGRAPHIC FULL STOP
U+FF0EFULLWIDTH FULL STOP

punctuation-except-middledot

Behaves as the same as the punctuation value except for the following middle dots.

U+30FBKATAKANA MIDDLE DOT
U+FF1AFULLWIDTH COLON
U+FF1BFULLWIDTH SEMICOLON

kana

Trim Hiragana and Katakana a bit.

ideograph

Trim spaces between Kanji or Kana.

inter-word

Trim spaces between Western words.

auto

Dependent on the system setting. This is the value specified by punctuation-trim and text-justify-mode in the Option Setting File. However, when axf:avoid-widow-words is enabled, it is considered that axf:text-justify-trim="ideograph inter-word" is specified.

Trim the spaces between characters as specified so that text fits into a line. When axf:punctuation-trim="all" is specified, there may be no more space to trim.

axf:text-justify / CSS (-ah-)text-justify

Specifies how to justify text. [CSS3-Text] Justification Method: the ‘text-justify’ property

Value:auto | inter-word | inter-character | distribute
Initial:auto
Applies to:all block-level and inline-level formatting objects
Inherited:yes
Percentages:N/A

Values have the following meanings:

auto

Uses the best text justification method for the script. For instance, in case of Japanese Kanji, Hiragana and Katakana, spaces between letters are expanded. In case of Arabic scripts, Kashida is used while spaces between words are expanded for the other scripts.

inter-word

Justifies text by expanding the space between words.

inter-character

Justifies text by expanding the space between letters.

distribute

Changed to inter-character with CSST-Text 2017-08-22. We also accept distribute for compatibility.

axf:kerning-mode / CSS -ah-kerning-modeXSL-FO Samples CollectionPair kerning in alphabets

Specifies whether to process the kerning.

Value:none | pair | auto
Initial:auto
Applies to:all block-level and inline-level formatting objects
Inherited:yes
Percentages:N/A

Values have the following meanings:

none

The kerning is not processed.

pair

The pair kerning is processed.

auto

Dependent on the system setting.

You can specify whether pair kerning is performed or not by pair-kerning in the Option Setting File. This can also be set in the Format Option Setting dialog in GUI.

axf:kerning-mode does not work when letter-spacing is specified.

axf:punctuation-spacing / CSS -ah-punctuation-spacingXSL-FO Samples CollectionTrimming the space between full-width punctuation and full-width character

Specifies the trimming spacing between a full width punctuation and a full width character in Japanese.

Value:<length> | <percentage> | auto
Initial:auto
Applies to:all block-level and inline-level formatting objects
Inherited:yes
Percentages:refer to the font size

The initial value of this space can be set by punctuation-spacing in the Option Setting File.

Values have the following meanings:

<length>

Specifies the amount of the trimming space with an absolute value.

<percentage>

It's a relative setting to the font size when actually applied.

auto

Dependent on the system setting. This is the value specified by punctuation-spacing in the Option Setting File.

This space is used for the following space amount specified by axf:punctuation-trim="adjacent".

  • Between full width close parenthesis and full width open parenthesis.
  • Between full width close parenthesis and full width non punctuation characters.
  • Between full width non punctuation character and full width open parenthesis.

axf:hanging-punctuation / CSS (-ah-)hanging-punctuationXSL-FO Samples CollectionHanging punctuation at the start / end of lineHanging punctuation in Latin textIntroduction to CSS for Paged Mediahanging-punctuation

Specifies whether to hang punctuation marks at the start of the line or end of the line. [CSS3-Text] Hanging Punctuation: the ‘hanging-punctuation’ property (“hanging-punctuation” has been removed from CSS3-Text on and after August 22, 2017)

Value:none | [ start || first || [ force-end | allow-end ] || last ]
Initial:none
Applies to:fo:block
Inherited:yes
Percentages:N/A

Values have the following meanings:

none

Do not hang punctuation marks at the start of the line or end of the line.

start

Hangs punctuation marks at the start of the line. If the target character for hanging appears at the start of the line, the character is forced to hang.

first

Behaves as the same as the start value only with the start line of a paragraph.

force-end

Hangs punctuation marks at the end of the line. When text-align="right" or text-align="justify" (or text-align-last="justify") is specified and a target character for hanging appears at the end of the line, the character is hanged forcibly. When anything else is specified to text-align, the character is hung naturally.

allow-end

Hangs punctuation marks at the end of the line. When text-align="right" or text-align="justify" (or text-align-last="justify") is specified and a target character for hanging comes to the end of the line, the character is not hung if text fits into one line, but the character is hung if text does not fit into one line. When anything else is specified to text-align, the character is hung naturally.

last

Behaves the same as the force-end value only with the end of the line of a paragraph.

The target punctuation marks is as follows:

  • force-end, allow-end
    Japanese or Simplified Chinese
    U+3001IDEOGRAPHIC COMMA
    U+3002IDEOGRAPHIC FULL STOP
    U+FF0CFULLWIDTH COMMA
    U+FF0EFULLWIDTH FULL STOP
    Traditional Chinese
    U+FE50SMALL COMMA
    U+FE51SMALL IDEOGRAPHIC
    U+FE52SMALL FULL STOP
    U+FF64HALFWIDTH IDEOGRAPHIC COMMA
    Other languages Same as the last value.
  • last
    quotation marks, closing parentheses, period, comma and hyphen
  • start, first
    quotation marks, closing parentheses and bullet

axf:avoid-widow-words / CSS -ah-avoid-widow-wordsXSL-FO Samples CollectionUncounting the last punctuation mark in one character at the end of the lineWidow Adjustment of Paragraphs

Specifies spacing behavior between words or characters so that the last line of the paragraph does not have only one word left (one character for CJK).

Value:false | true | [<length> || <percentage>]
Initial:false
Applies to:fo:block
Inherited:yes
Percentages:refer to the width of containing block

Values have the following meanings:

false

Does nothing.

true

Adjusts the spacing so that the last line of the paragraph does not have only one word left (one character for CJK). When axf:text-justify-trim="auto" is specified, it is considered that axf:text-justify-trim="ideograph inter-word" is specified.

<length>
<percentage>

Leaves the specified width of text on the last line of the paragraph. If both <length> and <percentage> are specified, the smaller one is adopted. When 0 or less is specified, it is considered false. If it is greater than 0 and axf:text-justify-trim="auto" is specified, it is considered that axf:text-justify-trim="ideograph inter-word" is specified. This setting is effective only when the Breaking Paragraphs into Lines line breaking algorithm is applied, such as when axf:line-break="bpil" is specified. Otherwise, the specified value of greater than 0 is considered true.

If the width of columns (length of the line) is short, when true is specified, it is not so effective because there is not enough space to run on. In addition, in case there is no room for a word to be placed at the end of the line, axf:avoid-widow-words has no effect. Note that there may be no more space to trim by setting axf:punctuation-trim or axf:text-justify-trim. See also avoid-widow-words-cjk-punctuation in the Option Setting File to learn more about the treatment of the punctuation at the end of the line in CJK.

axf:avoid-widow-words-cjk-punctuation / CSS -ah-avoid-widow-words-cjk-punctuation XSL-FO Samples CollectionUncounting the last punctuation mark in one character at the end of the line

Specifies whether to include the last punctuation mark and count them in one character when axf:avoid-widow-word="true" is specified in CJK.

Value:auto | true | false | <string>
Initial:auto
Applies to:fo:block
Inherited:yes
Percentages:N/A

Values have the following meanings:

auto

Follows the settings of avoid-widow-words-cjk-punctuation in the Option Setting File.

false

Because punctuation marks are also counted in one character, it may be a line like “す。”.

true

Because punctuation marks are not counted in one character, they do not become a line like “す。”, but a line like “です。”. The target punctuation marks here are the following characters:

<string>

If you specify a character string other than true/false, such as axf:avoid-widow-words-cjk-punctuation="&#xFF1F;&#xFF01;", those characters will also be treated as target punctuation marks in addition to the above.

axf:intrude-into-punctuation / CSS -ah-intrude-into-punctuation no-LT XSL-FO Samples CollectionIntruding the inline element into the punctuation

Intrudes the inline element into the punctuation.

Value:none | [start || end]
Initial:none
Applies to:inline elements
Inherited:yes
Percentages:N/A

Values have the following meanings:

none

Does nothing.

start

In Japanese, when the character immediately before the start side is any of the following, that character is treated as half-width.

  • full width close parenthesis
  • full width punctuation

See axf:punctuation-trim for these characters.

end

In Japanese, when the character immediately after the end side is any of the following, that character is treated as half-width.

  • full width open parenthesis

See axf:punctuation-trim for these characters.

Works when axf:punctuation-trim="adjacent" is specified.

This property is specified when you want to place the footnote symbol after the punctuation mark and treat the punctuation mark in half-width characters. You can do the same with axf:punctuation-trim="all", but you can't just apply it to a particular inline element.

This property is not available with Antenna House Formatter V7.4 Lite.


Spacing and Alignment

Adding Space

axf:text-autospace / CSS (-ah-)text-autospace

Specifies whether to add space surrounding ideographic glyphs or not. [CSS3-Text] Adding space: the ‘text-autospace’ property (“text-autospace” has been removed from CSS3-Text on and after April 4, 2011)

Value:none | [ ideograph-numeric || ideograph-alpha || ideograph-parenthesis ] | auto
Initial:auto
Applies to:all block-level and inline-level formatting objects
Inherited:yes
Percentages:N/A

Values have the following meanings:

none

Space is not added.

ideograph-numeric

Space is added between ideograph character and non-ideographic number character. Non-ideographic number character mentioned here indicates the character of Nd classified by Unicode and the non-full-width character.

ideograph-alpha

Space is added between ideograph character and non-ideographic alphabet character. Non-ideographic alphabet character mentioned here indicates the character of Lu, Ll, Lt and Lm classified by Unicode.

ideograph-parenthesis

Space is added between ideograph character and non-ideographic parenthesis character. However space is not added between ideograph character and non-ideographic closing parenthesis or between non-ideographic opening parenthesis and ideograph character.

auto

Dependent on the system setting. It's considered axf:text-autospace="none" or axf:text-autospace="ideograph-numeric ideograph-alpha" according to the setting.

The initial value of whether space is added or not can be set by text-autospace in the Option Setting File. It can also be set in the Format Option Setting Dialog in the GUI.

axf:text-autospace-width / CSS -ah-text-autospace-width

Specifies the width for axf:text-autospace.

Value:<length> | <percentage> | auto
Initial:auto
Applies to:all block-level and inline-level formatting objects
Inherited:yes
Percentages:refer to the font size

The initial value of this space can be set by text-autospace-width in the Option Setting File.

Values have the following meanings:

<length>

Specifies the amount of the space with an absolute value.

<percentage>

It's a relative setting to the font size when actually applied.

auto

Dependent on the system setting. This is the value specified by text-autospace-width in the Option Setting File.

This space is used in axf:text-autospace.

axf:text-treat-as / CSS -ah-text-treat-as no-LT

Specifies the character string treatable for trimming space between ideograph character and non-ideographic alphabet character and full width punctuation.

Value:<string> [both | start | end]?
Initial:empty string
Applies to:inline formatting objects
Inherited:no
Percentages:N/A

Values have the following meanings:

<string>

Specifies the treatable character string. If it is empty, the processing of the treatable character string is not performed.

both

Performs the processing of the treatable character string on both sides. If both/start/end are omitted, it is considered both.

start

Performs the processing of the treatable character string only on the start side.

end

Performs the processing of the treatable character string only on the end side.

The treatment of spaces between ideograph character and non-ideographic alphabet character by text-autospace and the trimming of full width punctuation by punctuation-trim only work between adjacent characters. That is, it does not affect <img>, <math>, etc. For example, if you specify like the following in HTML:

いろは<math>...</math>ほへと

there is no space between ideograph character and non-ideographic alphabet character before and after <math>. Then if you specify as follows:

math { -ah-text-treat-as: "A" }

it behaves as if the following character string was specified,

いろはAほへと

then, processes the space between ideograph character and non-ideographic alphabet character, creates the space between ideograph character and non-ideographic alphabet character before and after <math>. (html.css contains this setting.) Only the first and last characters of the text-treat-as string are effective. The first character is used between ideograph character and non-ideographic alphabet character with the character string on the start side, and the last character is used between ideograph character and non-ideographic alphabet character with the character string on the end side. If you want to change the treatment between ideograph character and non-ideographic alphabet character on the start side and the end side, you can specify like "A.". In addition, you may want to encourage it to apply to characters for which the spaces between ideograph character and non-ideographic alphabet character are normally not applied.

いろは#123ほへと

In the case above, there is no space before #, but there is a space after 3. So, if you specify as follows, you can also create a space before #.

いろは<span style="-ah-text-treat-as:'1'">#123</span>ほへと
いろは<fo:inline axf:text-treat-as="'1'">#123</fo:inline>ほへと

You can also apply the trimming of full-width punctuation to the match mark immediately after the closing parenthesis as follows:

ちりぬ)<sup style="-ah-text-treat-as:')' start">2)</sup>

alt can also be used for <img>.

img { -ah-text-treat-as: attr(alt) }

This property is not available with Antenna House Formatter V7.4 Lite.

axf:letter-spacing-side / CSS -ah-letter-spacing-side

Specifies on which side of the character the space by letter-spacing is distributed.

Value:both | start | end
Initial:both
Applies to:inline-level formatting objects
Inherited:yes
Percentages:N/A

Values have the following meanings:

both

Half the amount of space is distributed on both side of the character for each.

start

The space is distributed only on the start side of the character.

end

The space is distributed only on the end side of the character.

axf:auto-letter-spacing / CSS -ah-auto-letter-spacing no-LT

Changes letter-spacing depending on the number of characters.

Value:[ none | <length> | <percentage> ]*
Initial:none
Applies to:inline-level formatting objects
Inherited:no
Percentages:refer to the font size

Values have the following meanings:

none

Does not specify letter-spacing.

Values can be enumerated corresponding to the number of characters of 2 or more. For example, if specified as follows:

axf:auto-letter-spacing="2em 1em 0.5em 0.25em"

when the number of characters in this FO is 2, then letter-spacing="2em" is applied. When 3 characters, then letter-spacing="1em" is applied. When 4 characters, then letter-spacing="0.5em" is applied. When 5 characters, then letter-spacing="0.25em" is applied. Does nothing with any other number of characters. Only the characters included in the first inline element are counted.

This property is defined mainly for use in chapter titles in CJK text. In the following case,

第1章 はじめに

It is better to use this together with axf:letter-spacing-side as follows:

第1章 <fo:inline axf:auto-letter-spacing="2em 1em 0.5em 0.25em" axf:letter-spacing-side="end">はじめに</fo:inline>

It is not possible to apply this property to text (such as page numbers, etc.) for which the number of characters is not fixed.

This property is not available with Antenna House Formatter V7.4 Lite.

CSS -ah-margin-breakXSL-FO Samples CollectionCreating optional spaces around text inside a block

Specifies how to treat the margin when the page/column breaks.

Value:[ auto | discard | keep ] keep?
Initial:auto
Applies to:block elements
Inherited:no
Percentages:N/A

Values have the following meanings:

auto

Retains the margin on the before side of the block placed at the start of the document or right after the forced page/column break. Except for that, it is the same as discard.

discard

Discards the margin.

keep

Retains the margin on the before side. When the second keep is specified, the margin on the after side is also retained.

CSS -ah-ignore-leading-newline

Specifies whether the newline right after the start tag is disregarded or not.

Value:false | true | auto
Initial:false
Applies to:<pre> element
Inherited:no
Percentages:N/A

Values have the following meanings:

false

The newline right after the start tag is not disregarded.

true

The newline right after the start tag is disregarded.

auto

The newline right after the start tag is disregarded with HTML, not disregarded with XHTML.

This is effective with the element that does not disregard the newline like <pre>.

Text Alignment

axf:text-align-string / CSS -ah-text-align-stringXSL-FO Samples CollectionText alignment with text-align="<string>"

Specifies the text alignment when text-align="<string>".

Value:start | center | end | inside | outside | left | right
Initial:end
Applies to:fo:table-cell
Inherited:yes
Percentages:N/A

Values have the following meanings:

start
center
end
inside
outside
left
right

Same as text-align or text-align-last.

Although the specification of <string> to <fo:table-cell> aligns the character position of decimal point, etc., there is no definition for the alignment of the whole character string. At a default, Antenna House Formatter V7.4 displayed it right aligned according to the illustration of 17.5.4 Horizontal alignment in a column. Antenna House Formatter V7.4 extends the alignment and makes it possible to align left or align center.

axf:text-align-first / CSS -ah-text-align-firstIntroduction to CSS for Paged Mediatext-align-first

Specifies the text alignment of the first line.

Value:relative | start | center | end | justify | inside | outside | left | right
Initial:relative
Applies to:fo:block
Inherited:yes
Percentages:N/A

Values have the following meanings:

relative

Does nothing. axf:text-align-first is invalid.

start
center
end
justify
inside
outside
left
right

Same as text-align or text-align-last.

Specifies the alignment of the child of the first line area and the alignment of the line coming right after the line with U+000A at the end. Priority is given above text-align-last.

See axf:leader-expansion.

axf:flush-zone / CSS -ah-flush-zoneXSL-FO Samples CollectionAdjusting the space on the last lineAdjusts the space at the end of the last line

Adjusts the space at the end of the last line. no-LT

Value:none | <length> | <percentage>
Initial:none
Applies to:fo:block
Inherited:yes
Percentages:refer to the width of containing block

Values have the following meanings:

none

Does nothing.

<length>
<percentage>

If text-align="justify" is specified but text-align-last="justify" is not specified, and the space at the end of the last line is less than or equal to the specified value, the last line is processed as text-align-last="justify" is specified.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:balanced-text-align / CSS -ah-balanced-text-align no-LT

Specifies whether to balance the entire block including the last line.

Value:true | false | auto
Initial:auto
Applies to:fo:block
Inherited:yes
Percentages:N/A

Values have the following meanings:

true

The entire block is adjusted to be balanced including the last line.

false

Does not balance the last line.

auto

When applied to a block with any of the following conditions, the entire block including the last line is adjusted to be balanced.

  • text-align="justify" and text-align-last="justify"
  • text-align="center" and text-align-last="center"

This property is only valid when the line breaking algorithm of Breaking Paragraphs into Lines is applied, such as when axf:line-break="bpil" is specified. Otherwise it is considered false.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:adjust-last-line-spacing / CSS -ah-adjust-last-line-spacing no-LT XSL-FO Samples CollectionAdjusting the space on the last line

Adjusts the spacing on the last line.

Value:false | true
Initial:false
Applies to:block elements
Inherited:yes
Percentages:N/A

Values have the following meanings:

false

Does nothing.

true

Reduces the difference between the spacing on the last line and the spacing on the second-last line.

This processing applies under the following conditions:

  • text-align is “justify”
  • text-align-last is not “justify”
  • When the algorithm of Breaking Paragraphs into Lines is applied, such as when axf:line-break="bpil" is specified

If the result of adjusting the spacing satisfies the condition of axf:flush-zone, axf:flush-zone will be applied.

This property is not available with Antenna House Formatter V7.4 Lite.

leader-alignmentXSL-FO Samples CollectionLeader alignment

The following bold values are extended.

Value:none | reference-area | page | start | center | end
Initial:none
Applies to:fo:leader
Inherited:yes
Percentages:N/A

Values have the following meanings:

start

When leader-pattern="dots" or leader-pattern="use-content" is specified and the contents are only the text, leaders are aligned on the start side.

center

When leader-pattern="dots" or leader-pattern="use-content" is specified and the contents are only the text, leaders are center aligned.

end

When leader-pattern="dots" or leader-pattern="use-content" is specified and the contents are only the text, leaders are aligned on the end side.

axf:leader-expansion no-LT

Specifies whether to expand a leader forcibly.

Value:auto | force
Initial:auto
Applies to:fo:block
Inherited:yes
Percentages:N/A

Values have the following meanings:

auto

Operates as usual by specifying text-align.

force

Considers a line with leaders as text-align="justify". Consequently, leaders will expand.

Suppose you create a table of contents using leaders. Then you might want to format as follows with the length of a label, or the length of the number of pages.

  1. Short Label ................................. 10, 20, 30
    
  2. Short Label ... 10, 20, 30, 40, 50, 60, 70, 80, 90, 100,
                                     110, 120, 130, 140, 150
    
  3. Very Loooooooooooooooooooooooooooooooooooooong Label ...
    ............................................. 10, 20, 30
    
  4. Very Loooooooooooooooooooooooooooooooooooooong Label ...
    ..... 10, 20, 30, 40, 50, 60, 70, 80, 90, 100, 110, 120,
                                               130, 140, 150
    
  5. Very Very Very Loooooooooooooooooooooooooooooooooooooong
    Long Long Label ............................. 10, 20, 30
    
  6. Very Very Very Loooooooooooooooooooooooooooooooooooooong
    Long Long Label .... 10, 20, 30, 40, 50, 60, 70, 80, 90,
                                100, 110, 120, 130, 140, 150
    

When the following XSL Standard is specified,

<fo:block text-align="justify" text-align-last="justify">
 Label
 <fo:leader leader-pattern="dots"/>
 Pages
</fo:block>

only the simple 1. and 5. can get the expected results. And 3. can be performed by the following specification.

<fo:block text-align="justify" text-align-last="justify">
 Label
 <fo:leader leader-length.minimum="0pt" leader-pattern="dots"/><fo:leader leader-pattern="dots"/>
 Pages
</fo:block>

Next, by using axf:text-align-first as follows,

<fo:block text-align="justify" text-align-last="right" axf:text-align-first="justify">
 Label
 <fo:leader leader-length.minimum="0pt" leader-pattern="dots"/><fo:leader leader-pattern="dots"/>
 Pages
</fo:block>

all cases excluding 3. and 5. gets the result as expected. Furthermore, by using axf:leader-expansion as follows,

<fo:block text-align="justify" text-align-last="right" axf:text-align-first="justify"
          axf:leader-expansion="force">
 Label
 <fo:leader leader-length.minimum="0pt" leader-pattern="dots"/><fo:leader leader-pattern="dots"/>
 Pages
</fo:block>

all cases of 1. to 6. gets the result as expected.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:text-kashida-space / CSS -ah-text-kashida-space

Specifies the percentage of Kashida in Arabic justification.

Value:<percentage> | auto
Initial:auto
Applies to:all block-level and inline-level formatting objects
Inherited:yes
Percentages:yes

Values have the following meanings:

<percentage>

Indicates the percentage of white space and Kashida. If the value is 0%, Kashida is not inserted and only the white space expands as well as the normal justification. If the value is 100%, Kashida is inserted as much as possible. The value should be from 0% to 100%.

auto

Dependent on the system setting.

The initial value of the percentage can be set by text-kashida-space in the Option Setting File.

axf:justify-nbsp / CSS -ah-justify-nbsp

Specifies whether to justify NON-BREAKING SPACE or not.

Value:true | false
Initial:true
Applies to:all formatting objects
Inherited:yes
Percentages:N/A

Values have the following meanings:

true

NON-BREAKING SPACE is included for justification.

false

NON-BREAKING SPACE is not included for justification.

Generally, NON-BREAKING SPACE (U+00A0) is intended for justification. The axf:justify-nbsp property can be used when you want to check off U+00A0 from justification.

axf:indent-here / CSS -ah-indent-here no-LT

Aligns the indent position to the region position when a line break occurs.

Value:none | <length>
Initial:none
Applies to:fo:inline
Inherited:no
Percentages:N/A

Values have the following meanings:

none

Does nothing.

<length>

Aligns the indent position to the shifted position by <length> from the beginning of the specified line area.

In order to indent lines, specify <fo:inline> which contains this property as follows:

<fo:block>Indent-here: <fo:inline axf:indent-here="0pt"/>The quick brown fox jumps over the lazy dog ...</fo:block>

The start position of <fo:inline> becomes the standard of indentation.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:text-indent-if-first-on-page / CSS -ah-text-indent-if-first-on-page no-LT XSL-FO Samples Collectiontext-indent of a block at the top of the page

Specifies the text-indent of a block at the top of the page or the top of the column.

Value: <length> | <percentage> | auto
Initial: auto
Applies to:fo:block, fo:block-container
Inherited:yes
Percentages:refer to the logical width of the containing block

Values have the following meanings:

<length>
<percentage>

When the block comes to the top of the page or column, if the first line is on that page or column, the value of this property substitutes for the value of text-indent.

auto

Does nothing.

This property is not available with Antenna House Formatter V7.4 Lite.

Tab

In case of FO, the tab character (U+0009) will be normalized to the white space (U+0020); therefore, the character normally has a meaning of just a white space. However, there are a lot of document structures that the tab character aligns the text, such as JIS X 4051:2004. Antenna House Formatter V7.4 provides the extension that enables to express the tab structure.

<axf:tab> no-LT XSL-FO Samples CollectionRight-alignment of last line of a paragraphTabs

Common Usage:

Places a white space up to a tab stop position. Specify the tab stop position with axf:tab-stops.

Areas:

Generates and returns a single normal inline-area.

Contents:

EMPTY

This element is not equivalent to <fo:character character="&#9;"/>. For <fo:character>, all the properties related to a white space such as white-space-collapse and white-space-treatment are applied.

This element is not available with Antenna House Formatter V7.4 Lite.

axf:tab-align no-LT XSL-FO Samples CollectionTabs

Specifies the tab alignment at the tab stop position.

Value:auto | start | center | end | left | right | decimal | <string>
Initial:auto
Applies to:axf:tab
Inherited:no
Percentages:N/A

Values have the following meanings:

auto

The alignment of the tab stop position is considered what is specified in axf:tab-stops.

start

Aligns the start of the string to the tab stop position.

center

Aligns the center of the string to the tab stop position.

end

Aligns the end of the string to the tab stop position.

left

Aligns the left side of the string (the top of the string in case of vertical writing) to the tab stop position. Same as start above in case of writing-mode="lr-tb" and "tb-rl".

right

Aligns the right side of the string (the bottom of the string in case of vertical writing) to the tab stop position. Same as end above in case of writing-mode="lr-tb" and "tb-rl".

decimal

Considered that "." is specified.

<string>

Aligns the start of the string to the tab stop position as specified. For instance, when axf:tab-align="." is specified, alignment will be made as below:

1.2345
123.45
12345.
12345

This property is not available with Antenna House Formatter V7.4 Lite.

axf:tab-stops no-LT XSL-FO Samples CollectionTabs

Specifies the tab stop.

Value: [ [ <tab-align>? [ <length> | <number> ] ]* [ <tab-align>? eol ]? ]!
Initial:8
Applies to:all block-level formatting objects
Inherited:yes
Percentages:N/A
<tab-align> = start | center | end | left | right | decimal | <string>

Values have the following meanings:

<tab-align>

Specifies the alignment of the tab stop position. When omitted, it will be considered that this alignment is same as that of the previous tab stop position. When omitted at the start of the line, the value will be considered start. For more details, see axf:tab-align.

<length>

Specifies the tab length.

<number>

Regards the specified number of the white space characters (U+0020) as the tab length.

eol

Regards that the tab stop position is placed at the end of the line. However, when the previous tab specification already exceeded the end of the line, it will be considered that the tab stop position is always placed at the end of the line.

The tab length to be specified will be the distance added from the start of the reference area. You cannot specify a negative value. When eol is not specified, it will be considered that the tab length is repeatedly specified until the last value reaches the end of the line. However, when this value is 0, the tab will be ignored. For instance, specify as below:

axf:tab-stops="80pt decimal 40pt end 8 eol"

In case of CSS, tab-size:8 is equivalent to axf:tab-stops="8".

This property is not available with Antenna House Formatter V7.4 Lite.

axf:tab-treatment no-LT XSL-FO Samples CollectionTabs

Specifies the method to treat the tab character (U+0009).

Value:<number> | preserve
Initial:4
Applies to:fo:block, fo:character
Inherited:yes
Percentages:N/A

Values have the following meanings:

<number>

Treated as the specified number of the white space characters (U+0020). You cannot specify a negative value. This white space is subject to processing of white-space-treatment and white-space-collapse, etc.

preserve

Treated as <axf:tab/>.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:tab-overlap-treatment no-LT XSL-FO Samples CollectionTabs

Specifies a behavior when tab alignment makes letters overlapped.

Value:auto | ignore-tab | next-tab
Initial:auto
Applies to:fo:block, fo:character
Inherited:yes
Percentages:N/A

Values have the following meanings:

auto

Depends on the default value of the system. This is the value specified in tab-overlap-treatment in the Option Setting File.

ignore-tab

Ignores the tab. The string will be shown just after the previous string.

next-tab

Places the tab at the next tab stop position.

Letters will not be overlapped when axf:tab-align="start" is specified.

This property is not available with Antenna House Formatter V7.4 Lite.


Character and Text Decoration

axf:text-line-color / CSS -ah-text-line-color

Specifies the color of underline, strikethrough, and overline.

Value:<color>
Initial:the value of the ‘color’ property
Applies to:all elements with and generated content with textual content
Inherited:no
Percentages:N/A

axf:text-line-style / CSS -ah-text-line-style

Specifies the style of underline, strikethrough, and overline.

Value:<border-style>
Initial:solid
Applies to:all elements with and generated content with textual content
Inherited:no
Percentages:N/A

none cannot be specified to <border-style>.

axf:text-line-width / CSS -ah-text-line-width

Specifies the width of underline, strikethrough, and overline.

Value:auto | <border-width>
Initial:auto
Applies to:all elements with and generated content with textual content
Inherited:no
Percentages:N/A

axf:text-underline-position / CSS (-ah-)text-underline-position

Specifies the position of underline. [CSS3-Text] Other text decoration simple properties: 'text-underline-position'

Value: auto | [ [ before-edge | alphabetic | after-edge ] || [ <percentage> | <length> ] ]
Initial:auto
Applies to:all elements with and generated content with textual content
Inherited:yes
Percentages:refers to the line height of the parent area

Values have the following meanings:

auto

The underline is placed on the automatically adjusted position. The specification of axf:vertical-underline-side in vertical writing mode is effective.

before-edge

The underline is placed on the before-edge. When <percentage> or <length> is not specified, the upper end of the height of an underline is placed on the before-edge. When <percentage> or <length> is specified, the center of the height of an underline is placed on the before-edge.

alphabetic

The underline is placed on the position of the baseline. When <percentage> or <length> is not specified, the upper end of the height of an underline is placed on the baseline. When <percentage> or <length> is specified, the center of the height of an underline is placed on the baseline.

after-edge

The underline is placed on the after-edge. When <percentage> or <length> is not specified, the upper end of the height of an underline is placed on the after-edge. When <percentage> or <length> is specified, the center of the height of an underline is placed on the after-edge.

<percentage>
<length>

The underline position is shifted by the specified amount. When the underline is placed on the right side by axf:vertical-underline-side, it is moved to the opposite direction of the left side.

axf:vertical-underline-side / CSS -ah-vertical-underline-side

Specifies on which side of the text to put underline in vertical writing-mode.

Value:left | right | depend-on-language | auto
Initial:auto
Applies to:all block-level and inline-level formatting objects
Inherited:yes
Percentages:N/A

Values have the following meanings:

left

The underline is placed on the left side.

right

The underline is placed on the right side.

depend-on-language

The underline is placed on the right side when the language property is Japanese (jpn) or Korean (kor). The underline is placed on the left side when the language property is other than Japanese (jpn) or Korean (kor).

auto

Dependent on the system setting.

This property is effective only when axf:text-underline-position="auto" is specified. The overline is placed on the opposite position of the underline.

The initial value of the underline position can be set by vertical-underline-side in the Option Setting File. It can also be set in the Format Option Setting Dialog in the GUI.

When axf:vertical-underline-side="auto" is specified and the initial value of the system is also auto, the underline is placed on the right side when the language property is Japanese (jpn) or Korean (kor). The underline is placed on the left side when the language property is other than Japanese (jpn) or Korean (kor). If there is no language properties specified, it depends on the Default CJK language setting.

axf:text-stroke / CSS -ah-text-stroke no-LT XSL-FO Samples CollectionCharacter outline

Specifies the stroke of the character.

Value:<length> <color>? | <color>
Initial:0pt transparent
Applies to:all block-level and inline-level formatting objects
Inherited:yes
Percentages:N/A

This property is a shorthand for axf:text-stroke-width and axf:text-stroke-color.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:text-stroke-width / CSS -ah-text-stroke-width no-LT

Specifies the stroke width of the character.

Value:<length>
Initial:0pt
Applies to:all block-level and inline-level formatting objects
Inherited:yes
Percentages:N/A

Specifies the stroke width of the character. Strokes are not drawn when these are less than or equal to 0.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:text-stroke-color / CSS -ah-text-stroke-color no-LT

Specifies the stroke color of the character.

Value:<color>
Initial:transparent
Applies to:all block-level and inline-level formatting objects
Inherited:yes
Percentages:N/A

Specifies the stroke color of the character. Strokes are not drawn when these are transparent.

This property is not available with Antenna House Formatter V7.4 Lite.

CSS (-ah-)text-decorationXSL-FO Samples CollectionCharacter styleIntroduction to CSS for Paged Mediatext-decoration

[CSS 2.1] 16.3.1 Underlining, overlining, striking, and blinking
[CSS3-TextDecor] Text Decoration Shorthand: the ‘text-decoration’ property

Value:<text-decoration-line> || <text-decoration-color> || <text-decoration-style>
Initial:none
Applies to:all elements and generated content
Inherited:no
Percentages:N/A

CSS (-ah-)text-decoration-colorIntroduction to CSS for Paged Mediatext-decoration-color

[CSS3-TextDecor] Text Decoration Color: the ‘text-decoration-color’ property

Value:<color>
Initial:currentColor
Applies to:all elements and generated content
Inherited:no
Percentages:N/A

 axf:text-line-color

CSS (-ah-)text-decoration-lineIntroduction to CSS for Paged Mediatext-decoration-line

[CSS3-TextDecor] Text Decoration Lines: the ‘text-decoration-line’ property

Value:none | [ underline || overline || line-through || blink ]
Initial:none
Applies to:all elements and generated content
Inherited:no (but see prose)
Percentages:N/A

 [XSL 1.1] text-decoration

CSS (-ah-)text-decoration-styleIntroduction to CSS for Paged Mediatext-decoration-style

[CSS3-TextDecor] Text Decoration Style: the ‘text-decoration-style’ property

Value:<border-style>
Initial:solid
Applies to:all elements and generated content
Inherited:no
Percentages:N/A

 axf:text-line-style

axf:text-orientation / CSS (-ah-)text-orientation no-LT

mixed uprightSpecifies the orientation of text in vertical writing mode. [CSS3-WritingModes] Orienting Text: the ‘text-orientation’ property

Value:mixed | upright | sideways-rl | sideways | none | auto
Initial: auto
Applies to:all block-level and inline-level formatting objects
Inherited:yes
Percentages:N/A

Values have the following meanings:

mixed

Rotates alphanumeric characters, etc. 90-degree clockwise. (As shown on the right in the figure.)

upright

Renders all the characters upright except for punctuation marks, such as parentheses. (As shown on the left in the figure.)

sideways-rl
sideways

Rotates all the characters 90-degree clockwise. This has the same effect as setting some parts in horizontal layout in the vertical writing mode.

none

Dependent on the system. Although the operation is close to mixed, which character is rotated is decided by considering the compatibility with the old version.

auto

In XSL-FO, it is considered mixed when the value of text-orientation-mode is 7 in the Option Setting File, none when the value is less than or equal to 6. In CSS, it is considered mixed.

See also Upright Rendering of Text in Vertical Writing Mode to learn more about the behavior of mixed and upright. It is always considered axf:word-break="break-all", hyphenate="false" in upright character strings.

This property is not effective in horizontal writing mode. In addition, complicated scripts, such as Arabic or Thai, cannot be rendered upright.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:text-combine-horizontal / CSS (-ah-)text-combine-horizontal no-LT

Sets horizontal-in-vertical composition in vertical writing mode automatically. [CSS3-WritingModes] Horizontal-in-Vertical Composition: the ‘text-combine-horizontal’ property (“text-combine-horizontal” has been removed from CSS3-WritingMode on and after March 20, 2014)

Value: none | all | [ digits <integer> || alpha <integer> || alphanumeric <integer> || emoji ]
Initial:none
Applies to:all block-level and inline-level formatting objects
Inherited:yes
Percentages:N/A

Values have the following meanings:

none

Does not set horizontal-in-vertical composition.

all

The whole element which consists of only text (include emoji) is set to horizontal-in-vertical composition.

digits

A sequence of consecutive numbers (0-9) that are less than or equal to the digit number specified by <integer> is set to horizontal-in-vertical composition.

alpha

A sequence of consecutive alphabetic characters (A-Z, a-z) that are less than or equal to the digit number specified by <integer> is set to horizontal-in-vertical composition.

alphanumeric

A sequence of consecutive alphanumeric characters (0-9, A-Z, a-z) that are less than or equal to the digit number specified by <integer> is set to horizontal-in-vertical composition.

emoji

Makes the emoji horizontal-in-vertical composition.

Usually, horizontal-in-vertical composition will be marked up as follows:

<fo:inline-container writing-mode="lr-tb"
                     line-height="1"
                     text-align-last="center"
                     text-indent="0pt"
                     start-indent="0pt"
                     end-indent="0pt"
                     padding="0pt"
                     wrap-option="no-wrap">
 <fo:block>12</fo:block>
</fo:inline-container>

The automatic horizontal-in-vertical composition saves time and effort for this.

axf:text-combine-horizontal is applied before axf:text-orientation or text-transform, axf:number-transform, etc. The removable white space placed before and after the character string targeted for horizontal-in-vertical composition will be removed.

When digits is specified to axf:text-combine-horizontal and axf:text-orientation="upright" is also specified, the following behaviors are applied to the sequence of numbers targeted for horizontal-in-vertical composition that are shorter than <integer>, that has adjacent decimal point.

  • U+002E and U+FF65 are considered decimal points.
  • A sequence of numbers targeted for horizontal-in-vertical composition after the decimal point will not be set to horizontal-in-vertical composition. However, the decimal point will be transferred to U+FF65.
  • When the decimal point comes after a sequence of numbers targeted for horizontal-in-vertical composition, the sequence of numbers will be set to horizontal-in-vertical composition. The decimal point will be transferred to U+FF65.

The figure on the right shows the example of the horizontal-in-vertical composition set to “12.34” automatically.

<fo:block axf:text-combine-horizontal="digits 2"
          axf:text-orientation="upright"
>12.34</fo:block>

Furthermore, with the combination of text-transform, you can set two or more characters in non full-width, change others in full-width in horizontal-in-vertical composition.

<fo:block axf:text-combine-horizontal="digits 2"
          axf:text-orientation="upright"
          text-transform="full-width"
>平成25年4月16日</fo:block>

Automatic horizontal-in-vertical composition is invalid in the following cases. Emphasis marks in horizontal-in-vertical composition will be deleted.

  • In horizontal writing mode (includes the case where the value for axf:text-orientation is sideways in horizontal-in-vertical composition)
  • When languages other than CJK are specified
  • Within ruby
  • Character strings generated dynamically, such as <fo:page-number>

This property is not available with Antenna House Formatter V7.4 Lite.

Emphasis Marks

Antenna House Formatter V7.4 is capable of applying emphasis marks to the character string. However, emphasis marks cannot be applied to an arbitrary script. Only to the following scripts in addition to CJK are available.

  • Latn
  • Cyrl
  • Grek
  • Zyyy

It's not available to apply emphasis marks to the ruby characters, though it is available to apply to ruby's base characters.

As for the glyph of the emphasis mark in the general font, the size of glyph image is various, you will need to adjust the position and size according to the emphasis mark you use.

axf:text-emphasis-style="sesame"
axf:text-emphasis-offset="-0.25"
axf:text-emphasis-font-size="1"
axf:text-emphasis-position="before"
axf:text-emphasis-style="circle"
axf:text-emphasis-offset="0.25"
axf:text-emphasis-font-size="0.25"
axf:text-emphasis-position="before"

A free special font suitable for emphasis marks is available ( Kenten Generic OpenType Font). The font has the same size of emphasis marks, then the same settings for any emphasis marks will be OK.

axf:text-emphasis-style="sesame"
axf:text-emphasis-offset="0"
axf:text-emphasis-font-size="0.5"
axf:text-emphasis-font-family="KentenGeneric"
axf:text-emphasis-position="before"

axf:text-emphasis-style / CSS (-ah-)text-emphasis-styleXSL-FO Samples CollectionRuby and emphasis marks

Specifies the style of emphasis marks. [CSS3-TextDecor] Emphasis Mark Style: the ‘text-emphasis-style’ property

Value:none | [ [ filled | open ] || [ dot | circle | double-circle | triangle | sesame ] ] | <string>
Initial:none
Applies to:all elements
Inherited:yes
Percentages:N/A

Values have the following meanings:

none

No emphasis marks.

filled

Specifies a character with color-fill.

open

Specifies a character with an outline without color-fill.

dot

Specifies a filled dot. filled dot is U+2022 , open dot is U+25E6 .

circle

Specifies a circle. filled circle is U+25CF , open circle is U+25CB .

double-circle

Specifies a double-circle. filled double-circle is U+25C9 , open double-circle is U+25CE .

triangle

Specifies a triangle. filled triangle is U+25B2 , open triangle is U+25B3 .

sesame

Specifies a sesame dot. filled sesame is U+FE45 , open sesame is U+FE46 .

<string>

Specifies an arbitrary character string. When multiple characters are specified, overlapping of emphasis marks is not considered though everything is displayed.

when filled or open is not specified, it's considered filled. When filled or open is specified, it's considered circle in vertical writing mode.

axf:text-emphasis-position / CSS (-ah-)text-emphasis-position

Specifies on which side of base characters emphasis marks are put. [CSS3-TextDecor] Emphasis Mark Position: the ‘text-emphasis-position’ property

Value:before | after
Initial:before
Applies to:all elements
Inherited:yes
Percentages:N/A

Values have the following meanings:

before

Emphasis marks are put on the before side.

after

Emphasis marks are put on the after side.

axf:text-emphasis-offset / CSS -ah-text-emphasis-offsetXSL-FO Samples CollectionRuby and emphasis marks

Specifies the space between emphasis marks and the base characters.

Value:<number> | <length> | <percentage>
Initial:0pt
Applies to:all elements
Inherited:yes
Percentages:refer to the font size

When specified using <number>, the value is what is obtained by multiplying text-emphasis-font-size by the specified <number>. When ruby and emphasis marks are put on the same side, it is adjusted to the larger one of the specified value and the ruby height.

axf:text-emphasis-skip / CSS -ah-text-emphasis-skip

Specifies the character to which emphasis marks are not applied.

Value:none | [ spaces || punctuation || symbols || narrow ]
Initial:spaces
Applies to:all elements
Inherited:yes
Percentages:N/A

Values have the following meanings:

spaces

White space characters are excluded.

punctuation

Punctuation marks are excluded.

symbols

Symbols are excluded.

narrow

Non full width characters (half width characters, etc.) are excluded.

axf:text-emphasis-font-family / CSS -ah-text-emphasis-font-family

Specifies the font family of emphasis marks.

Value:[ <family-name> | <generic-family> ]#
Initial:empty string
Applies to:emphasis elements
Inherited:yes
Percentages:N/A

If nothing is specified, it's considered the same as font-family.

axf:text-emphasis-font-size / CSS -ah-text-emphasis-font-size

Specifies the font size of emphasis marks.

Value:<number> | <absolute-size> | <relative-size> | <length> | <percentage>
Initial:0.5
Applies to:emphasis elements
Inherited:yes
Percentages:refer to the font size

When specified using <number>, the value is what is obtained by multiplying font-size by the specified <number>.

axf:text-emphasis-font-style / CSS -ah-text-emphasis-font-style

Specifies whether emphasis marks are made Italic.

Value:normal | italic
Initial:empty
Applies to:emphasis elements
Inherited:yes
Percentages:N/A

If nothing is specified, it's considered the same as font-style.

axf:text-emphasis-font-weight / CSS -ah-text-emphasis-font-weight

Specifies the font weight of emphasis marks.

Value:normal | bold | bolder | lighter | 1...1000
Initial:empty
Applies to:emphasis elements
Inherited:yes
Percentages:N/A

If nothing is specified, it's considered the same as font-weight.

axf:text-emphasis-font-stretch / CSS -ah-text-emphasis-font-stretch

Specifies the font stretching of emphasis marks.

Value:normal | wider | narrower | ultra-condensed | extra-condensed | condensed | semi-condensed | semi-expanded | expanded | extra-expanded | ultra-expanded | <percentage> | <number>
Initial:empty
Applies to:emphasis elements
Inherited:yes
Percentages:refer to the text-emphasis-font-size

If nothing is specified, it's considered the same as font-stretch.

axf:text-emphasis-color / CSS (-ah-)text-emphasis-color

Specifies the color of emphasis marks. [CSS3-TextDecor] Emphasis Mark Color: the ‘text-emphasis-color’ property

Value:<color>
Initial:currentColor
Applies to:emphasis elements
Inherited:yes
Percentages:N/A

If nothing is specified, it's considered the same as color.

Text Shadow

text-shadow / CSS (-ah-)text-shadow no-LT XSL-FO Samples CollectionText shadow

Specifies the text shadow. [CSS3-TextDecor] Text Shadows: the ‘text-shadow’ property

Value: none | [ <length>{2,3} && <color>? ]#
Initial:none
Applies to:all elements which can have borders
Inherited:yes
Percentages:N/A

Values have the following meanings:

none

No shadow is displayed.

The meanings of <length>s and a <color> are as follows:

  • The first <length> is an offset of a horizontal shadow. It becomes a right-side shadow of a region when a positive value is specified. It becomes a left-side shadow of a region when a negative value is specified.
  • The second <length> is an offset of a vertical shadow. It becomes a bottom-side shadow of a region when a positive value is specified. It becomes a top-side shadow of a region when a negative value is specified.
  • The 3rd <length> has to be the non-negative value and specifies the blur radius. If 0 is specified, there is no shading. When the value greater than 0 is specified, the text shadow is described in raster-image format.
    The resolution of a described image can be set by textshadow-resolution-minimum-dpi, textshadow-resolution-pixel-per-em. In addition, when the blur radius is given by the length in px unit, the blur radius will not be decided by the resolution setting but by pxpi.
  • The color of the shadow can be specified by <color>.

This combination can be specified multiply and shadows can be added several times over. This property is not available with Antenna House Formatter V7.4 Lite.

Note the following when you set the blur:

  • Effective only with GUI and PDF output. The blur setting is ignored with the other outputs.
  • The blur setting is ignored with the device that cannot output in transparent mode like PDF/X.
  • The glyph of the font is processed and transformed into the raster image. Some fonts may not be allowed to be transformed into images, processed and distributed. Be sure the font you are using has no licensing problem.
  • When you set the blur without embedding the font, the font shape may differ between the text shadow and the text area in the environment where the font is not installed. We recommend to embed fonts when setting the blur. Also It's possible to specify whether to blur fonts that are not allowed to be embedded by textshadow-blur-cannot-embed-font.
  • It's not described to the decorated characters, such as decorated lines or emphasis marks.
  • Compression in PDF Output can also be applied to the image created by this feature.
  • The blur setting is ignored when transparency is specified as false.

Drop Capitals

axf:initial-letters / CSS (-ah-)initial-letters no-LT XSL-FO Samples CollectionDrop Caps

Creates drop initials. [CSS3-Inline] Initial Letters

Value:normal | [[<number> | <length>] <integer>? | [<number> | <length>] && [drop | raise]] [adjacent | <integer2>]?
Initial:normal
Applies to:fo:block (XSL) / ::first-letter (CSS)
Inherited:no
Percentages:N/A

Values have the following meanings:

normal

Does nothing.

<number>

Specifies the letter size of a dropped initial by number of lines. When the value is less than 1, it is invalid.

<length>

Specifies the letter size of a dropped initial by actual dimensions. The specified dimension is converted to how many lines it corresponds to. When it is less than 1 line, it is invalid.

<integer>

Specifies the number of lines a dropped initial should sink. When the value is omitted or equal to 0, it is considered a value obtained by rounding down the number of lines to an integer. When the value is less than 0, it is invalid.

drop

Equivalent to specifying a value of the number of lines rounded down to an integer to <integer>.

raise

Equivalent to specifying 1 to <integer>.

adjacent

Indents all lines in the block, not just the letter of a dropped initial.

<integer2>

Similar to adjacent, but indents the lines after the part of dropped initial by the specified number of lines. When the value is omitted, it is considered 0. When the value is negative, it is invalid.

This property can only be specified in <fo:block> in XSL-FO and in the ::first-letter pseudo element in CSS. A dropped initial is selected from the first text by tracing the children of the element for which axf:initial-letters is specified. In XSL-FO, axf:initial-letters is ignored if the following elements appear before text. In CSS, it follows the ::first-letter pseudo element (except for ruby).

  • fo:block with axf:initial-letters specified
  • fo:block within inline elements
  • Block elements other than fo:block
  • fo:inline-container
  • fo:bidi-override
  • fo:page-number
  • fo:page-number-citation
  • fo:page-number-citation-last
  • axf:footnote-number
  • axf:footnote-number-citation

When the strings of the block with axf:initial-letters specified are short and less than the number of lines to be sunk, the succeeding block without axf:initial-letters specified is also indented. However, in the following cases, it will not be indented and will be placed on the next line of the dropped initial.

  • Block with clear="start" or "both" specified
  • When a float is included on the end side of a block with clear="end" specified
  • When a space is included between blocks due to margin, etc.

A dropped initial is the first letter except for the following punctuations from the first text and accents that decorate them. At that time, all the following punctuations that are adjacent are also selected according to the ::first-letter specification.

  • Ps : open punctuation
  • Pe : close punctuation
  • Pi : initial punctuation
  • Pf : final punctuation
  • Po : other punctuation

For example, “H will be a dropped initial in case of “Hello.

The font size is automatically calculated from the cap-height etc. of the font, so the font-size specified in ::first-letter is ignored. When the letter following the dropped initial is in lowercase and small-caps is specified, the letter size is calculated taking into account not only cap-height but also x-height. For more details, see also axf:initial-letters-first-line-head-height. Some fonts do not have cap-height or x-height, or may not have appropriate values. In such a case, it can be adjusted by specifying in the Font Configuration File.

If the first letter is ruby, then the first ruby container of that ruby will be a dropped initial. When an image, such as <fo:external-graphic> comes first, the image is a dropped initial. At that time, all the settings related to the scaling of the image are ignored. If ::first-letter without initial-letters specified, ::first-letter does not apply to ruby or image.

::first-letter may be nested.

div::first-letter { ... }
p::first-letter { ... }
<div><p>Hello...

In this example, all ::first-letters are evaluated as follows:

<div><p><div::first-letter><p::first-letter>H</p::first-letter></div::first-letter>ello...

When initial-letters is specified to ::first-letter, the following restrictions apply.

  • For initial-letters, only the first ::first-letter is valid, and anything else specified is ignored.
  • If initial-letters is specified, subsequent ::first-letters are ignored.

A float with axf:float-x="start" within the number of lines of the dropped initial is placed on the start side of the dropped initial when its anchor is included at the start of the block. Otherwise, it will be pushed out and placed on the after side of the dropped initial.  axf:initial-letters-start-intrusion

This property is not available with Antenna House Formatter V7.4 Lite.

axf:initial-letters-first-line-head-height / CSS -ah-initial-letters-first-line-head-height no-LT

Specifies where the height of a dropped initial should be adjusted.

Value:cap-height | x-height | auto
Initial:auto
Applies to:fo:block (XSL) / ::first-letter (CSS)
Inherited:yes
Percentages:N/A

Values have the following meanings:

cap-height

Adjusts the height to cap-height on the first line. The figure shows an example when the number of lines is 2.

initial-letters-cap-height

x-height

Adjusts the height to x-height on the first line. The figure shows an example when the number of lines is 2 and small-caps is specified for the first line.

initial-letters-x-height

auto

Adjusts the height to x-height under the following conditions: Otherwise, adjusts to cap-height.

  • When the next character of a dropped initial character or image is lowercase small-caps (provided that the character or image to be a dropped initial and the next character belong to the same element)
  • When the number of lines of a dropped initial is equal to the number of lines a dropped initial should sink (provided that the number of lines is specified without units)

This property is not available with Antenna House Formatter V7.4 Lite.

axf:initial-letters-end-indent / CSS -ah-initial-letters-end-indent no-LT

Specifies the space on the end side of a dropped initial.

Value:<length>+
Initial:0pt
Applies to:fo:block (XSL) / ::first-letter (CSS)
Inherited:yes
Percentages:N/A

Multiple values can be specified. The first value applies to the first line and the second value applies to the next line. The last value applies after the corresponding line.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:initial-letters-leading-punctuation / CSS -ah-initial-letters-leading-punctuation no-LT

Specifies the size of the leading punctuation of a dropped initial, etc.

Value:normal | hide | [<length> || <color>]
Initial:normal
Applies to:fo:block (XSL) / ::first-letter (CSS)
Inherited:yes
Percentages:N/A

Values have the following meanings:

normal

Does nothing special.

hide

Does not display the leading punctuation.

<length>

Specifies the font size of the leading punctuation.

<color>

Specifies the color of the leading punctuation.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:initial-letters-leading-punctuation-position / CSS -ah-initial-letters-leading-punctuation-position no-LT

Specifies the position of the leading punctuation of a dropped initial in the inline progression direction.

Value:normal | [[hang | intrude] && <length>?]
Initial:normal
Applies to:fo:block (XSL) / ::first-letter (CSS)
Inherited:yes
Percentages:N/A

Values have the following meanings:

normal

Does nothing special.

hang

Protrudes the leading punctuation to the start side. axf:hanging-punctuation="start" protrudes one-character punctuation, but the hang setting protrudes all punctuations.

intrude

Penetrates and overlaps the leading punctuation with the dropped initial.

<length>

Adjusts the position of the leading punctuation. hang or intrude must be specified. Shifts the punctuation from that position by the specified length in the inline progression direction.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:initial-letters-leading-punctuation-shift / CSS -ah-initial-letters-leading-punctuation-shift no-LT

Specifies the position of the leading punctuation of a dropped initial in the block progression direction.

Value:normal | [[baseline | before | middle | after] || <length>]
Initial:normal
Applies to:fo:block (XSL) / ::first-letter (CSS)
Inherited:yes
Percentages:N/A

Values have the following meanings:

normal

Does nothing special. Aligns the leading punctuation with the baseline for horizontal writing and aligns it with the center for vertical writing.

baseline

Aligns the leading punctuation with the baseline of the last line.

before

Aligns the leading punctuation with the before side of the dropped initial.

middle

Aligns the leading punctuation with the center of the dropped initial.

after

Aligns the leading punctuation with the after side of the dropped initial.

<length>

Specifies the baseline-shift amount of the leading punctuation. If it is specified at the same time as baseline, before, middle, and after, it is the shift amount from that position.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:initial-letters-width no-LT

Specifies the width of a dropped initial.

Value:auto | <length> | <percentage>
Initial:auto
Applies to:fo:block
Inherited:yes
Percentages:refer to the width of containing reference area

Values have the following meanings:

auto

The width of a dropped initial is calculated from the included character string or image.

<length>
<percentage>

Forces the width of a dropped initial to the specified width.

Specify width in ::first-letter in CSS.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:initial-letters-text-align no-LT

Specifies the alignment of a dropped initial.

Value:start | center | end | left | right
Initial:end
Applies to:fo:block
Inherited:yes
Percentages:N/A

When the value of axf:initial-letters-width is auto, it has no effect because there is no room for right alignment.

Specify text-align in ::first-letter in CSS.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:initial-letters-color no-LT

Specifies the text color of a dropped initial.

Value:<color>
Initial:the value of the ‘color’ property
Applies to:fo:block
Inherited:yes
Percentages:N/A

Specify color in ::first-letter in CSS.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:initial-letters-start-intrusion / CSS -ah-initial-letters-start-intrusion V7.4 no-LT

Specifies the alignment of a float on the start side of the dropped initial.

Value:none | first-line
Initial:none
Applies to:fo:block (XSL) / ::first-letter (CSS)
Inherited:yes
Percentages:N/A

Values have the following meanings:

none

Aligns the float on the after side, avoiding the dropped initial.

first-line

If the anchor of the float is after the dropped initial and at the start line of the block, aligns the float on the start side of the dropped initial. If this is not the case, aligns it on the after side, avoiding the dropped initial. However, if the following conditions are not met, it is considered axf:initial-letters-start-intrusion="none" and aligned on the after side.

Specifies the alignment of a float when the anchor of the float, that has axf:float-x="start" and is included in the block with dropped initial specified, exists after the dropped initial. A float with an anchor before the dropped initial will be aligned on the start side regardless of this setting.

This property is not effective when intrusion-displace="block" is specified, because floats are always aligned outside the block.

This property is not available with Antenna House Formatter V7.4 Lite.


Text Transformation

axf:normalize / CSS -ah-normalize no-LT

Specifies the normalization of text.

Value: auto | none | nfc | nfkc | nfd | nfkd
Initial:auto
Applies to:all block-level and inline-level formatting objects
Inherited:yes
Percentages:N/A

Values have the following meanings:

auto
Depends on the value of normalize specified to the Option Setting File.
none
Does not normalize text.
nfc
Performs NFC.
nfkc
Performs NFKC.
nfd
Performs NFD.
nfkd
Performs NFKD.

Specifies whether the normalization defined in UAX#15: Unicode Normalization Forms is performed. The normalization is performed to the character strings described in the text area. If you use only the normalized code from the start, it is not necessary to specify the normalization. If not, the normalization by NFC will be a good choice for practical use.

In these conversions, all the Composition Exclusions are excluded from the normalization processing when axf:normalize-exclude="full-composition-exclusion" is specified.

This feature is not available with Antenna House Formatter V7.4 Lite.

axf:normalize-exclude / CSS -ah-normalize-exclude no-LT

Specifies whether Composition Exclusions are excluded or not when the normalization (axf:normalize) is specified.

Value: full-composition-exclusion | none
Initial:full-composition-exclusion
Applies to:all block-level and inline-level formatting objects
Inherited:yes
Percentages:N/A

Values have the following meanings:

full-composition-exclusion
Excludes all the characters specified in Composition Exclusions.
none
Does not exclude.

This feature is not available with Antenna House Formatter V7.4 Lite.

axf:text-replace / CSS (-ah-)text-replaceXSL-FO Samples CollectionCharacter string substitution

Replaces the character strings. [CSS3-GCPM] Character substitution (“text-replace” has been removed from GCPM on and after June 8, 2010)

Value:none | [ <string> <string> ]+
Initial:none
Applies to:all block-level and inline-level formatting objects
Inherited:yes
Percentages:N/A

Values have the following meanings:

none

Does nothing.

<string> <string>

The first pair of character strings is replaced by the latter character strings. You have to specify a character string by a pair. It is not replaced when character strings are odd pieces or the first character string is empty. White space characters will be replaced after being processed by white-space-treatment, etc.

When it is simultaneously specified with text-transform or axf:number-transform, axf:text-replace will be evaluated last.

text-transform / CSS (-ah-)text-transformXSL-FO Samples CollectionChanging the capitalization of text

The following bold values are extended. [CSS3-Text] Transforming Text: the ‘text-transform’ property

Value:none | [ [ capitalize | uppercase | lowercase | capitalize-lowercase ] || [ fullwidth | fullwidth-if-vertical ] || fullsize-kana ] ]

Values have the following meanings:

capitalize-lowercase

Makes an initial letter an upper case and makes the remainder lower cases. See also Changes from XSL Formatter V4.

fullwidth no-LT

Converts the character of U+0021 to U+007E into full width.

fullwidth-if-vertical no-LT

Only with the vertical writing (writing-mode="tb-rl"), text-transform="fullwidth" will be applied. Does no conversion when it's not the vertical writing.

fullsize-kana

Converts small kana into regular kana. Only fullwidth (not halfwidth) characters are converted.

axf:number-transform / CSS -ah-number-transform no-LT

Converts the number sequence in the character string.

Value:none | kansuji | kansuji-if-vertical | <list-style-type> | <string>
Initial:none
Applies to:all block-level and inline-level formatting objects
Inherited:yes
Percentages:N/A

Values have the following meanings:

none

Does nothing.

kansuji

Converts the contained number sequence into Japanese numerals. The details of the Japanese numeral format can be specified by axf:kansuji-style, axf:kansuji-letter and axf:kansuji-grouping-letter.

kansuji-if-vertical

Only with the vertical writing, such as writing-mode="tb-rl", axf:number-transform="kansuji" is applied. Does no conversion when it's not the vertical writing.

<list-style-type>

The same value as list-style-type can be specified. The range of the value that can be converted varies depending on the style.

<string>

When a character string is specified, the behavior is same as when the character string is specified by format.

A number sequence (number) here indicates character strings of the following forms.

number ::= '-'? digits
digits ::= [0-9]+

When it is simultaneously specified with text-transform or axf:text-replace, axf:number-transform is evaluated first. When a counter style which was specified with axf:counter-style or symbols() is used, prefix/suffix will not be added.

CSS (-ah-)list-style-typeIntroduction to CSS for Paged Medialist-style-type

Specifies the list style. [CSS3-Lists] 3 Default Marker Contents

Value: none | <name> | <string>
Initial:disc
Applies to:all elements with 'display:list-item'
Inherited:yes
Percentages:N/A

The following <list-style-type> are supported.  axf:number-transform, format, axf:counter-style, counter()

If the counter style indicated by <name> is not found, the style is considered decimal. <string> will display the string itself.

Japanese Numerals

Antenna House Formatter V7.4 can convert numbers into Japanese numerals using axf:number-transform. This function is not available with Antenna House Formatter V7.4 Lite.

axf:kansuji-style / CSS -ah-kansuji-style no-LT

Specifies the style used for Japanese numerals.

Value:simple | grouping | readable
Initial:simple
Applies to:all block-level and inline-level formatting objects
Inherited:yes
Percentages:N/A

Values have the following meanings:

simple

Converts a number sequence into Japanese numerals by one to one correspondence.

12340   ⇒ 一二三四〇
6700000 ⇒ 六七〇〇〇〇〇

grouping

In adds to the conversion of one to one correspondence, grouping for “万億兆京垓𥝱穣溝澗正載極” is inserted.

  • When all the parts below a certain grouping are zero, they are disregarded.

12340   ⇒ 一万二三四〇
6700000 ⇒ 六七〇万

readable

Inserts grouping of “万億兆...” and uses “十百千” additionally so that the character strings becomes readable.

  • Preceding zero is disregarded.
  • In the huge numerical value which needs the next grouping of “”, the digits more than “” are converted by one to one correspondence.

12340   ⇒ 一万二千三百四十
6700000 ⇒ 六百七十万
1000000 ⇒ 百万
000015  ⇒ 十五
0       ⇒ 〇

axf:kansuji-letter / CSS -ah-kansuji-letter no-LT

Specifies the character used for Japanese numerals.

Value:kanji | latin | <string>
Initial:kanji
Applies to:all block-level and inline-level formatting objects
Inherited:yes
Percentages:N/A

Values have the following meanings:

kanji

Use Japanese numerals for numbers. Equivalent to specifying axf:kansuji-letter="〇一二三四五六七八九".

: U+3007
: U+4E00
: U+4E8C
: U+4E09
: U+56DB
: U+4E94
: U+516D
: U+4E03
: U+516B
: U+4E5D

latin

Use full width western numerals for numbers. Equivalent to specifying axf:kansuji-letter="0123456789".

: U+FF10
: U+FF11
: U+FF12
: U+FF13
: U+FF14
: U+FF15
: U+FF16
: U+FF17
: U+FF18
: U+FF19

<string>

Specifies arbitrary characters as numbers you use. For example, if you want to use traditional Japanese numerals, specify axf:kansuji-letter="零壱弐参肆伍陸柒捌玖". If you want to specify traditional Japanese numerals only for “一二三”, specify axf:kansuji-letter="〇壱弐参四五六七八九". If you specify only the initial sequence like axf:kansuji-letter="〇壱弐参", it will be treated as axf:kansuji-letter="〇壱弐参四五六七八九".

: U+96F6
: U+58F1
: U+5F10
: U+53C2
: U+8086
: U+4F0D
: U+9678
: U+67D2
: U+634C
: U+7396

axf:kansuji-grouping-letter / CSS -ah-kansuji-grouping-letter no-LT

Specifies the grouping character used for Japanese numerals.

Value:<string>
Initial:empty string
Applies to:all block-level and inline-level formatting objects
Inherited:yes
Percentages:N/A

The null character sequence is considered “十百千万億兆京垓𥝱穣溝澗正載極”. Change and specify only a corresponding character if you want to change “” to “”, for example. When you specify only the head part like “拾佰阡萬”, it is compensated as “拾佰阡萬億兆京垓𥝱穣溝澗正載極”.

: U+5341 : 10
: U+767E : 100
: U+5343 : 1000
: U+4E07 : 104
: U+5104 : 108
: U+5146 : 1012
: U+4EAC : 1016
: U+5793 : 1020
𥝱 : U+25771 : 1024
: U+7A63 : 1028
: U+6E9D : 1032
: U+6F97 : 1036
: U+6B63 : 1040
: U+8F09 : 1044
: U+6975 : 1048

: U+62FE : 10
: U+4F70 : 100
: U+9621 : 1000
: U+842C : 104

<axf:counter-style> / CSS @counter-style no-LT XSL-FO Samples CollectionCounter stylesIntroduction to CSS for Paged Media@counter-style

With Antenna House Formatter V7.4, unique counter style can be defined. For details about the CSS specification, see CSS Counter Styles Level 3. This function is not available with Antenna House Formatter V7.4 Lite.

Common Usage:

Defining custom counter styles. This element does not generate area.

Areas:

None.

Constraints:
<!ELEMENT axf:counter-style EMPTY>
<!ATTLIST axf:counter-style name             CDATA #REQUIRED>
<!ATTLIST axf:counter-style system           CDATA "symbolic">
<!ATTLIST axf:counter-style negative         CDATA "-">
<!ATTLIST axf:counter-style prefix           CDATA "">
<!ATTLIST axf:counter-style suffix           CDATA ". ">
<!ATTLIST axf:counter-style range            CDATA "auto">
<!ATTLIST axf:counter-style pad              CDATA "0 ''">
<!ATTLIST axf:counter-style fallback         CDATA "decimal">
<!ATTLIST axf:counter-style symbols          CDATA #IMPLIED>
<!ATTLIST axf:counter-style additive-symbols CDATA #IMPLIED>

The <axf:counter-style> element can be placed directly under <fo:declarations>.

Contents:

EMPTY

Examples:
<fo:declarations>
  <axf:counter-style name="trinary"
                     system="numeric"
                     symbols="'0' '1' '2'"
                     suffix="') '"/>
</fo:declarations>

The following properties can be specified to <axf:counter-style> / @counter-style.

name

Specifies the name of the counter style.

Value:<name>
Initial:N/A
Inherited:no
Percentages:N/A

This name can be used with list-style-type and axf:number-transform etc. Note that default, decimal and none cannot be specified. The following counter styles are predefined. For more details, see Ready-made Counter Styles and 7. Complex Predefined Counter Styles.

A string generated with system="cyclic" is the one that is set with <list-style-type> in the Option Setting File. Items denoted with “*” mean that they were added for compatibility. kansuji denoted with “**” is converted in accordance with axf:kansuji-style. The counter style that is classified as complex cannot be defined with <axf:counter-style> / @counter-style. On the other hand, it can be extended with extends.

These predefined counter style names are case insensitive, while the counter style names that are defined with <axf:counter-style> / @counter-style are case sensitive.

CSS does not have this property. In case of CSS, specify the name with @counter-style directly.

systemIntroduction to CSS for Paged Mediasystem

Specifies the type of the counter system.

Value:cyclic | numeric | alphabetic | symbolic | additive | [fixed <integer>?] | [ extends <counter-style-name> ]
Initial:symbolic
Inherited:no
Percentages:N/A

negativeIntroduction to CSS for Paged Medianegative

Specifies the prefix and the suffix for the negative value.

Value:<symbol> <symbol>?
Initial:"-"
Inherited:no
Percentages:N/A

prefixIntroduction to CSS for Paged Mediaprefix

Specifies the prefix.

Value:<symbol>
Initial:""
Inherited:no
Percentages:N/A

suffixIntroduction to CSS for Paged Mediasuffix

Specifies the suffix.

Value:<symbol>
Initial:". "
Inherited:no
Percentages:N/A

rangeIntroduction to CSS for Paged Mediarange

Specifies the range to which the style is applied.

Value:[ [ <integer> | infinite ]{2} ]# | auto
Initial:auto
Inherited:no
Percentages:N/A

padIntroduction to CSS for Paged Mediapad

Specifies the padding for a small digit.

Value:<integer> && <symbol>
Initial:0 ""
Inherited:no
Percentages:N/A

fallbackIntroduction to CSS for Paged Mediafallback

Specifies the fallback style in case where the style could not be applied due to the style out of the range.

Value:<counter-style-name>
Initial:decimal
Inherited:no
Percentages:N/A

symbolsIntroduction to CSS for Paged Mediasymbols

Specifies the counter symbol.

Value:<symbol>+
Initial:N/A
Inherited:no
Percentages:N/A

additive-symbolsIntroduction to CSS for Paged Mediaadditive-symbols

Specifies the weighted counter symbol.

Value:[ <integer> && <symbol> ]#
Initial:N/A
Inherited:no
Percentages:N/A


Font Control

axf:ligature-mode / CSS -ah-ligature-modeXSL-FO Samples CollectionLigatures in alphabets

Specifies whether to perform the ligature processing.

Value:none | [latin || kana || jamo] | all | auto
Initial:auto
Applies to:all block-level and inline-level formatting objects
Inherited:yes
Percentages:N/A

Values have the following meanings:

none

The ligature processing is not performed.

latin

Processes the ligature in Western languages. It is processed when the scripts are the following.

  • Latn
  • Grek
  • Cyrl

kana

Processes the ligature of Kana + semivoiced sound symbol in JIS X 0213:2004 as follows:

  • U+304B + U+309A
  • U+304D + U+309A
  • U+304F + U+309A
  • U+3051 + U+309A
  • U+3053 + U+309A
  • U+30AB + U+309A
  • U+30AD + U+309A
  • U+30AF + U+309A
  • U+30B1 + U+309A
  • U+30B3 + U+309A
  • U+30BB + U+309A
  • U+30C4 + U+309A
  • U+30C8 + U+309A
  • U+31F7 + U+309A

Although the ligature of Western languages and the ligature of symbols are included in JIS X 0213:2004, these are processed by axf:ligature-mode="latin".

jamo no-LT

Processes the ligature of Hangul Jamo U+1100 to U+11FF.

all

latin kana jamo is considered to be specified.

auto

The ligature of kana is performed. latin-ligature in the Option Setting File will decide whether to perform the ligature of Western words. This setting can also be done with the Format Option Setting dialog in GUI. Whether to process the ligature of Hangul Jamo depends on jamo-ligature in the Option Setting File.

The ligature processed here is the ligature defined in the font itself. The ligature defined in Unicode are not processed. (It is called Canonical Composition.) In order to normalize ligatures defined in Unicode Standard, specify axf:normalize="nfc". Note that axf:normalize will not be effective with Antenna House Formatter V7.4 Lite.

If letter-spacing is specified, it will be inserted character by character. For example, in case of fi, a letter-spacing is inserted between f and i, regardless of whether it is ligatured or not. If it is an accented character, it is considered to be one character-cluster.

axf:font-feature-settings / CSS (-ah-)font-feature-settings no-LT

Controls the feature of OpenType fonts. [CSS3-Fonts] Low-level font feature settings control: the font-feature-settings property

Value:normal | <feature-tag-value>#
Initial:normal
Applies to:all elements
Inherited:yes
Percentages:N/A

Values have the following meanings:

normal

Does nothing.

<feature-tag-value>

Specifies the tag of OpenType GSUB/GPOS with the following format:

<feature-tag-value> = <string> [ <integer> | on | off ]?

<string> is the tag name of OpenType and is case sensitive. This string must be a 4-character ASCII string from U+0020 to U+007E. U+0020 is supplemented when it is less than 4 characters.

<integer> is an integer greater than or equal to 0 that indicates the validity and invalidity of the selection index or features of the glyph. on is 1 and off is the same as 0. 0 means to invalidate this tag. If omitted, it is considered 1. If exceeds the selectable number, the behavior depends on the font (usually considered 0 or 1).

The setting of axf:font-feature-settings overrides font-variant and axf:ligature-mode.

When axf:font-feature-settings="kern" or "vkrn" is specified, the setting of axf:kerning-mode is ignored.

This property is not available with Antenna House Formatter V7.4 Lite.

<axf:font-face> / CSS @font-face no-LT XSL-FO Samples CollectionAdditional fonts with axf:font-faceSpecify the Unicode range of the font added by axf:font-face, and adjust the font sizeIntroduction to CSS for Paged Media@font-face

In Antenna House Formatter V7.4, it is possible to add fonts you want to use in the document. See also @font-face in the CSS specifications.

Common Usage:

Specifies an additional font. This element does not generate area. This function is not available with Antenna House Formatter V7.4 Lite.

Areas:

None.

Constraints:
<!ELEMENT axf:font-face EMPTY>
<!ATTLIST axf:font-face src           CDATA #REQUIRED>
<!ATTLIST axf:font-face font-family   CDATA #REQUIRED>
<!ATTLIST axf:font-face font-style    CDATA "normal">
<!ATTLIST axf:font-face font-weight   CDATA "normal">
<!ATTLIST axf:font-face font-stretch  CDATA "normal">
<!ATTLIST axf:font-face unicode-range CDATA "all">
<!ATTLIST axf:font-face size-adjust   CDATA "normal">

The <axf:font-face> element can be placed directly under <fo:declarations>.

Contents:

EMPTY

Examples:
<fo:declarations>
  <axf:font-face src="url('https://www.hixie.ch/resources/fonts/AHEM____.TTF')"
                 font-family="AHEM"/>
</fo:declarations>

A font specified by <axf:font-face> / @font-face is always embedded. Fonts that are not allowed to be embedded cannot be specified.

The following properties can be specified to <axf:font-face> / @font-face.

src

Specifies the font resource.

Value:[ <uri-specification> [format(<font-type>)]? | <font-face-name> ]#
Initial:N/A
Inherited:no
Percentages:N/A

URI can be specified to <uri-specification> with the file name of the font, or the url() function. Also data scheme can be specified to url(). The type of fonts <font-type> can be specified by the format() function. When omitted, it will be recognized by the extension of the font resource or the media type (content-type) in the data scheme. Available types are as follows:

woff

WOFF File Format 1.0 font. content-type is “application/font-woff”.

woff2

WOFF File Format 2.0 font. content-type is “application/font-woff2”.

truetype

TrueType font. content-type is “application/x-font-ttf”.

opentype

OpenType font. content-type is “application/x-font-otf”.

<font-face-name> specifies a font that is already installed with the local() function.

<axf:font-face src="local(Arial)" ...

<axf:font-face> can be used as follows:

<fo:declarations>
<axf:font-face
  src="url('woff/MyPrivate.woff') format(woff)"
  font-family="MyWOFF"
/>
</fo:declarations>
...
<fo:block font-family="MyWOFF">
...

font-familyXSL-FO Samples CollectionWhite space and line breaks in program codeIntroduction to CSS for Paged Mediafont-family

Specifies the font family.

Value:<string>
Initial:N/A
Inherited:no
Percentages:N/A

font-styleXSL-FO Samples CollectionCharacter styleIntroduction to CSS for Paged Mediafont-style

Specifies the font style.

Value:normal | italic
Initial:normal
Inherited:no
Percentages:N/A

font-weightXSL-FO Samples CollectionCharacter styleIntroduction to CSS for Paged Mediafont-weight

Specifies the font weight.

Value:normal | bold | 1...1000
Initial:normal
Inherited:no
Percentages:N/A

font-stretchXSL-FO Samples CollectionFont-stretch

Specifies the font width.

Value:normal | ultra-condensed | extra-condensed | condensed | semi-condensed | semi-expanded | expanded | extra-expanded | ultra-expanded
Initial:normal
Inherited:no
Percentages:N/A

unicode-range

Specifies the Unicode Range to which this font applies.

Value:<urange># | all
Initial:all
Inherited:no
Percentages:N/A

size-adjust

Adjusts the size of this font.

Value:normal | <percentage> | <number>
Initial:normal
Inherited:no
Percentages:refer to the font size

Numeric values without units can be specified. 1 is equivalent to 100%. Negative values are not allowed.

<axf:script-font> no-LT

Common Usage:

Specifies the generic font according to the script. This element does not generate area.

Areas:

None.

Constraints:
<!ELEMENT axf:script-font EMPTY>
<!ATTLIST axf:script-font script     CDATA #REQUIRED>
<!ATTLIST axf:script-font serif      CDATA #IMPLIED>
<!ATTLIST axf:script-font sans-serif CDATA #IMPLIED>
<!ATTLIST axf:script-font monospace  CDATA #IMPLIED>
<!ATTLIST axf:script-font cursive    CDATA #IMPLIED>
<!ATTLIST axf:script-font fantasy    CDATA #IMPLIED>
<!ATTLIST axf:script-font fallback   CDATA #IMPLIED>

The <axf:script-font> element can be placed directly under <fo:declarations>. The same setting of script-font in the Option Setting File can be specified. The specifiation of <axf:script-font> will be adopted in preference to the setting in the Option Setting File.

Contents:

EMPTY


URI and Link

axf:base-uri / CSS -ah-base-uri

Specifies the location which becomes the base of relative URI.

Value:<uri-specification>
Initial:empty string
Applies to:all formatting objects
Inherited:yes
Percentages:N/A

The axf:base-uri is applied to all relative URI in a document. When making links using <fo:basic-link> and specify relative URI, the location that is specified using axf:base-uri is interpreted to be base URI. If this property is omitted or this has empty string, the base location is interpreted as current XML file.

 xml:base

In the case of the following example, it links to: “https://www.antenna.co.jp/AHF/ahf_samples/CSS-Print.pdf”.

<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format"
         xmlns:axf="http://www.antennahouse.com/names/XSL/Extensions"
         axf:base-uri="https://www.antenna.co.jp/AHF/">
                  :
                  :
<fo:basic-link external-destination="ahf_samples/CSS-Print.pdf">
    ...
</fo:basic-link>

Generates a hyper-link.

Value:<uri-specification> | none
Initial:N/A
Applies to:all inline elements
Inherited:no
Percentages:N/A

 [XSL 1.1] 7.23.6 external-destination, 7.23.8 internal-destination, xlink:href


Page Number

Antenna House Formatter V7.4 provides extension properties to control the page number.

initial-page-numberXSL-FO Samples CollectionPage number format and initial page number

The following bold value is extended. no-LT

Value: auto | auto-odd | auto-even | <number> | auto-odd-if-only

Values have the following meanings:

auto-odd-if-only no-LT

A page-sequence with only one page behaves like "auto-odd". Otherwise it is considered "auto".

axf:suppress-duplicate-page-number / CSS -ah-suppress-duplicate-page-number

Specifies to delete the duplicated page numbers.

Value:true | false
Initial:false
Applies to:all formatting objects
Inherited:yes
Percentages:N/A

When formatting an index, generally several <fo:page-number-citation> line up for one index item. In such case, when <fo:page-number-citation> refers to the same page number of the index, duplicate page numbers will be output using the standard property. If true is specified, when the same page number of the previous <fo:page-number-citation> is referred, that page number will be hidden along with the intervening elements (such as commas).

For example:

When axf:suppress-duplicate-page-number is not specified.

<fo:block text-align-last="justify">
 <fo:block>bcd
  <fo:leader leader-pattern="dots"/>
  <fo:basic-link internal-destination="ID1">
   <fo:page-number-citation ref-id="ID1"/>
  </fo:basic-link>
 </fo:block>
 <fo:block>index
  <fo:leader leader-pattern="dots"/>
  <fo:basic-link internal-destination="ID2">
   <fo:page-number-citation ref-id="ID2"/>,
  </fo:basic-link>
  <fo:basic-link internal-destination="ID3">
   <fo:page-number-citation ref-id="ID3"/>,
  </fo:basic-link>
  <fo:basic-link internal-destination="ID4">
   <fo:page-number-citation ref-id="ID4"/>,
  </fo:basic-link>
  <fo:basic-link internal-destination="ID5">
   <fo:page-number-citation ref-id="ID5"/>,
  </fo:basic-link>
  <fo:basic-link internal-destination="ID6">
   <fo:page-number-citation ref-id="ID6"/>,
  </fo:basic-link>
  <fo:basic-link internal-destination="ID7">
   <fo:page-number-citation ref-id="ID7"/>,
  </fo:basic-link>
 </fo:block>
</fo:block>

Format example of the above text is as follows:

Formatted result

When axf:suppress-duplicate-page-number is specified.

<fo:block text-align-last="justify" axf:suppress-duplicate-page-number="true">
 <fo:block>bcd
  <fo:leader leader-pattern="dots"/>
  <fo:basic-link internal-destination="ID1">
   <fo:page-number-citation ref-id="ID1"/>
  </fo:basic-link>
 </fo:block>
 <fo:block>index
  <fo:leader leader-pattern="dots"/>
  <fo:basic-link internal-destination="ID2">
   <fo:page-number-citation ref-id="ID2"/>,
  </fo:basic-link>
  <fo:basic-link internal-destination="ID3">
   <fo:page-number-citation ref-id="ID3"/>,
  </fo:basic-link>
  <fo:basic-link internal-destination="ID4">
   <fo:page-number-citation ref-id="ID4"/>,
  </fo:basic-link>
  <fo:basic-link internal-destination="ID5">
   <fo:page-number-citation ref-id="ID5"/>,
  </fo:basic-link>
  <fo:basic-link internal-destination="ID6">
   <fo:page-number-citation ref-id="ID6"/>,
  </fo:basic-link>
  <fo:basic-link internal-destination="ID7">
   <fo:page-number-citation ref-id="ID7"/>,
  </fo:basic-link>
 </fo:block>
</fo:block>

Format example of the above text is as follows.

Formatted result

axf:suppress-duplicate-page-number deletes the duplicated page numbers within the same line, but does not delete them when the line break occurs.

axf:page-number-prefix

Sets the prefix of page number.

Value:<string>
Initial:empty string
Applies to:fo:page-sequence
Inherited:no
Percentages:N/A

Specifies the prefix for page numbers. Specified string will be outputted before the page number by <fo:page-number> and <fo:page-number-citation>. Also this string will be used as the page label in the PDF.

<fo:page-sequence axf:page-number-prefix="A-" format="i" initial-page-number="10">
  <fo:static-content ...>
   ...<fo:page-number/>...
  </fo:static-content>
  ...
</fo:page-sequence>

Arabic and Hebrew cannot be specified for the value of axf:page-number-prefix.

axf:physical-page-number

Gets physical page number.

Value:true | false
Initial:false
Applies to:fo:page-number, fo:page-number-citation, fo:page-number-citation-last
Inherited:no
Percentages:N/A

The value of initial-page-number property is disregarded and the physical page number that is not affected by the page-sequence is obtained. In order to obtain the total number of pages, ID is given to the last page per the following example:

<fo:page-number-citation ref-id="lastpage" axf:physical-page-number="true"/>

In order to use this function with CSS, see counter(). However, this does not apply to Antenna House Formatter V7.4 Lite.

See also fo:page-number-citation-last in XSL 1.1.

axf:reverse-page-number no-LT XSL-FO Samples CollectionPage numbers with mixed horizontal and vertical pages

Places page numbers in reverse order.

Value:true | false
Initial:false
Applies to:fo:page-number, fo:page-number-citation, fo:page-number-citation-last
Inherited:no
Percentages:N/A

Values have the following meanings:

true

Places page numbers in reverse order.

false

Places page numbers in order.

By specifying axf:reverse-page-number="true", the page number reference in <fo:page-sequence> is counted from the last page of <fo:page-sequence> in descending order. When pages with different formatting directions are mixed, together with axf:reverse-page="true", it is available to align the page numbers in one order when outputting PDF. In order to use this function with CSS, see counter().

This property is not available with Antenna House Formatter V7.4 Lite.

axf:origin-idXSL-FO Samples CollectionRelative page numbers

Specifies the origin of the page number.

Value:<idref>
Initial:none
Applies to:fo:page-number, fo:page-number-citation, fo:page-number-citation-last
Inherited:no
Percentages:N/A

ID for the origin of the page number can be specified in <fo:page-number> or <fo:page-number-citation>. The output page number is as follows:

[ref-id page] - [origin-id page] + 1

If the specified Page is after the ref-id page, the value becomes 0. In <fo:page-number>, ref-id is considered the position of <fo:page-number> itself.

axf:assumed-page-number / CSS -ah-assumed-page-number

Specifies the assumed page number.

Value:<number>
Initial:N/A
Applies to:all formatting objects
Inherited:yes
Percentages:N/A

When <fo:page-number-citation> appears, the reference area is sometimes undecided. In evaluation of <fo:page-number-citation>, the temporary area is secured first, and when a page number is decided, it is adjusted to the right contents. Since the size of an area may change at this time, the formatted result is sometimes not desirable. For example, when an area becomes narrow, it seems that there is an unnecessary line break, and condition that a character will overflow if an area becomes large appears. axf:assumed-page-number gives the assumed page number at that time.

Antenna House Formatter V7.4 expects the area of at least three-digit page number and formats temporarily. What is necessary will be just to specify axf:assumed-page-number="99" etc., when the page number is clearly less than that.

axf:number-type

Specifies whether to output the page number or to output the column number.

Value:page | column | page-and-column
Initial:page
Applies to:fo:page-number, fo:page-number-citation, fo:page-number-citation-last
Inherited:no
Percentages:N/A

Values have the following meanings:

page

Outputs the page number.

column

Outputs the column number.

page-and-column

Outputs both of the page number and the column number.

It can be specified to <fo:page-number>, etc. and the column number can be outputted instead of the page number. While format property is applied to the format of the page number, axf:column-number-format property is applied to the format of the column number. The column number is not outputted if multiple column is not specified by specifying of column-count="1" or span="all".

axf:column-number-format

Specifies the format of column number.

Value:<string>
Initial:"A"
Applies to:fo:page-sequence
Inherited:no
Percentages:N/A

It applies to the format of column number specified by axf:number-type property. It can be specified with the same way as format property.

axf:suppress-folio-prefix

Invalidates the prefix of page numbers.

Value:true | false
Initial:false
Applies to:fo:page-number, fo:page-number-citation, fo:page-number-citation-last
Inherited:no
Percentages:N/A

Specifies whether to invalidate the prefix set by <fo:folio-prefix>.

Values have the following meanings:

true

Invalidates the prefix.

false

Validates the prefix.

axf:suppress-folio-suffix

Invalidates the suffix of page numbers.

Value:true | false
Initial:false
Applies to:fo:page-number, fo:page-number-citation, fo:page-number-citation-last
Inherited:no
Percentages:N/A

Specifies whether to invalidate the suffix set by <fo:folio-suffix>.

Values have the following meanings:

true

Invalidates the suffix.

false

Validates the suffix.

merge-sequential-page-numbers / CSS -ah-merge-sequential-page-numbers no-LT

Specifies the page number reference to be merged. In XSL-FO, the following bolded values are extended.

Value:merge | merge-f | merge-ff | leave-separate
Initial: merge (XSL) / leave-separate (CSS)
Applies to: fo:index-page-citation-list (XSL) / block level elements (CSS)
Inherited:yes
Percentages:N/A

Values have the following meanings:

merge

Merges page numbers when the consecutive page numbers are greater than or equal to 3. At this time, it is considered axf:suppress-duplicate-page-number="true". The separator can be changed by <fo:index-page-citation-range-separator> or -ah-index-page-citation-range-separator.

merge-f

Merges 2 consecutive page numbers and appends the suffix specified by <axf:index-page-citation-range-f-suffix> or -ah-index-page-citation-range-f-suffix. Applies merge to greater than or equal to 3 consecutive page numbers.

merge-ff

In addition to merge-f, merges 3 consecutive page numbers and appends the suffix specified by <axf:index-page-citation-range-ff-suffix> or -ah-index-page-citation-range-ff-suffix. Applies merge to greater than or equal to 4 consecutive page numbers.

leave-separate

Does nothing.

Suppose the following CSS is specified.

p.index-page-citation-list {
  -ah-merge-sequential-page-numbers: merge;
}
span.index-item {
  content: target-counter(attr(href), page);
}

Then, suppose the following HTML exists.

<p class="index-page-citation-list">
  <span class="index-item" href="#id1"/>,
  <span class="index-item" href="#id2"/>,
  <span class="index-item" href="#id3"/>,
  <span class="index-item" href="#id4"/>,
  <span class="index-item" href="#id5"/>,
  <span class="index-item" href="#id6"/>,
  <span class="index-item" href="#id7"/>,
  <span class="index-item" href="#id8"/>,
  <span class="index-item" href="#id9"/>
</p>

Suppose page numbers line up as follows:

1, 3, 4, 4, 5, 6, 8, 8, 9

The result will be as follows:

1, 3–6, 8, 9

If merge-f is specified, the result will be as follows:

1, 3–6, 8f.

This property is not available with Antenna House Formatter V7.4 Lite.

CSS -ah-index-page-citation-range-separator no-LT

Specifies the separator string when merging consecutive page numbers.

-ah-index-page-citation-range-separator corresponds to <fo:index-page-citation-range-separator> in XSL, but simple strings can only be specified in CSS.

Values that can be specified in CSS are as follows:

Value:<string>
Initial:"&#x2013;"
Applies to:block level elements
Inherited:yes
Percentages:N/A

The separator string is used when -ah-merge-sequential-page-numbers:merge is specified.

This property is not available with Antenna House Formatter V7.4 Lite.

<axf:index-page-citation-range-f-suffix> / CSS -ah-index-page-citation-range-f-suffix no-LT

Specifies the suffix when merging 2 consecutive page numbers.

In XSL, it is used in the same way as <fo:index-page-citation-range-separator>. The content is (#PCDATA|%inline;)*. If omitted, it is considered "f.".

Values that can be specified in CSS are as follows:

Value:<string>
Initial:"f."
Applies to:block level elements
Inherited:yes
Percentages:N/A

This suffix is used when axf:merge-sequential-page-numbers="merge-f" is specified.

This property is not available with Antenna House Formatter V7.4 Lite.

<axf:index-page-citation-range-ff-suffix> / CSS -ah-index-page-citation-range-ff-suffix no-LT

Specifies the suffix when merging 3 consecutive page numbers.

In XSL, it is used in the same way as <fo:index-page-citation-range-separator>. The content is (#PCDATA|%inline;)*. If omitted, it is considered "ff.".

Values that can be specified in CSS are as follows:

Value:<string>
Initial:"ff."
Applies to:block level elements
Inherited:yes
Percentages:N/A

This suffix is used when axf:merge-sequential-page-numbers="merge-ff" is specified.

This property is not available with Antenna House Formatter V7.4 Lite.

CSS -ah-fixed-width-pending-page-number V7.4 no-LT

Specifies whether to render without waiting for page number resolution in CSS.

Value:<boolean>
Initial:false
Applies to:all formatting objects
Inherited:false
Percentages:N/A

When true is specified, if page/pages is set in target-counter/counter and the target page number has not been determined yet, the page number will be assumed to be -ah -Assumed-page-number and makes it as resolved. After the temporary page number is resolved, replaces the page number and adjusts the space within the line where the page number is placed. By doing this, you can perform the rendering process without waiting for the page number to be resolved. You may be able to obtain an effect similar to the two-pass formatting described in Formatting Large Document.

If the tentatively determined page number is broken into multiple lines, the original number of characters will be assigned to fill the number of digits in the separated lines, and if there are no digits to allocate, the page will be blank. If it is exceeded, all remaining digits are allocated to the last line. Therefore, as shown below, the assumed page number will be line-broken.

999
99

If the resolved page number is 12, it will be as follows: At this time, the character 99 will disappear, but the line itself will remain, which may create unnecessary blank spaces in the layout.

12
(empty line)

If the resolved page number is 123456789, it will be as follows:

123
456789

Line Numbering

Place line numbers as part of the text. Line numbers can be placed against the line area. Even though the place looks empty, if there is a line area, line numbers can be placed. These are not placed in the space or in the margin. The axf:line-number is not effective inside <fo:float> or <fo:footnote>.

This function is not available with Antenna House Formatter V7.4 Lite.

axf:line-number / CSS -ah-line-number no-LT XSL-FO Samples CollectionAdding line numbers except for continued linesIndependent line numbering in table columnsLine numbersLine numbers to always show

Specifies whether to show line numbers.

Value:none | show | hide
Initial:none
Applies to:all block-level formatting objects that are descendants of fo:flow, fo:table-column
Inherited:yes (except for fo:table-column)
Percentages:N/A

Values have the following meanings:

none

Line numbers are not generated.

show

Line numbers are shown.

hide

Line numbers are not shown but the numbers of the line are counted.

Line numbers are counted against the lines inside the block where axf:line-number="show" or axf:line-number="hide" is specified.

If axf:line-number is specified to <fo:table-column>, independent line numbers are given to the column of the table. At this time, the same setting available for <fo:page-sequence> can be specified. The ID reference can be specified to <fo:table-column> as axf:line-number-initial="#xxx". The ID must be the same as the one specified to the existing <fo:table-column>. The value specified to that column is adopted as the default value of the line number information. A reference to a following column is invalid.
The following shows the example:

...
<fo:page-sequence ... axf:line-number="show"/>
...
<fo:table>
 <fo:table-column/>
 <fo:table-column axf:line-number="show" id="c2"/>
 <fo:table-body>
  ...
 </fo:table-body>
</fo:table>

In this table, line numbers specified to <fo:page-sequence> are given to the left column and line numbers specified to <fo:table-column id="c2"> are given to the right column independently. In the following table, if you specify as follows:

<fo:table>
 <fo:table-column/>
 <fo:table-column axf:line-number="show" axf:line-number-initial="#c2"/>
 <fo:table-body>
  ...
 </fo:table-body>
</fo:table>

then, line numbers of the right column will continue in sequence from the previous table.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:line-number-background-color / CSS -ah-line-number-background-color no-LT

Specifies the background color of line numbers.

Value:<color>
Initial:transparent
Applies to:all block-level formatting objects that are descendants of fo:flow, fo:table-column
Inherited:yes
Percentages:N/A

This property is not available with Antenna House Formatter V7.4 Lite.

axf:line-number-color / CSS -ah-line-number-color no-LT

Specifies the color of line numbers.

Value:<color>
Initial:the value of the ‘color’ property
Applies to:all block-level formatting objects that are descendants of fo:flow, fo:table-column
Inherited:yes
Percentages:N/A

This property is not available with Antenna House Formatter V7.4 Lite.

axf:line-number-display-align / CSS -ah-line-number-display-align no-LT

Specifies the alignment, in the block-progression-direction, of line numbers in the line area.

Value:auto | before | center | after
Initial:auto
Applies to:all block-level formatting objects that are descendants of fo:flow, fo:table-column
Inherited:yes
Percentages:N/A

Values have the following meanings:

before

Align the line numbers in the upper end of the line area.

center

Align the line numbers in the middle of the line area.

after

Align the line numbers in the lower end of the line area.

auto

It is considered after in horizontal writing, and center in vertical writing.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:line-number-font-family / CSS -ah-line-number-font-family no-LT

Specifies the font family of line numbers.

Value:[ <family-name> | <generic-family> ]#
Initial:depends on UA
Applies to:all block-level formatting objects that are descendants of fo:flow, fo:table-column
Inherited:yes
Percentages:N/A

This property is not available with Antenna House Formatter V7.4 Lite.

axf:line-number-font-size / CSS -ah-line-number-font-size no-LT

Specifies the font size of line numbers.

Value:<absolute-size> | <relative-size> | <length> | <percentage>
Initial:medium
Applies to:all block-level formatting objects that are descendants of fo:flow, fo:table-column
Inherited:yes
Percentages:refer to the font size

This property is not available with Antenna House Formatter V7.4 Lite.

axf:line-number-font-style / CSS -ah-line-number-font-style no-LT

Specifies whether to make the font style italic.

Value:normal | italic
Initial:normal
Applies to:all block-level formatting objects that are descendants of fo:flow, fo:table-column
Inherited:yes
Percentages:N/A

This property is not available with Antenna House Formatter V7.4 Lite.

axf:line-number-font-weight / CSS -ah-line-number-font-weight no-LT

Specifies the font weight of line numbers.

Value:normal | bold | bolder | lighter | 1...1000
Initial:normal
Applies to:all block-level formatting objects that are descendants of fo:flow, fo:table-column
Inherited:yes
Percentages:N/A

This property is not available with Antenna House Formatter V7.4 Lite.

axf:line-number-format / CSS -ah-line-number-format no-LT

Specifies the format of line numbers.

Value:<string>
Initial:1
Applies to:fo:page-sequence, fo:table-column / CSS root element
Inherited:no
Percentages:N/A

Line numbers are shown as the specified format. The way to specify is the same as that for the format property.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:line-number-initial / CSS -ah-line-number-initial no-LT

Specifies the line number of the first line.

Value:auto | <number> | #<id>
Initial:auto
Applies to:fo:page-sequence, fo:table-column / CSS root element
Inherited:no
Percentages:N/A

Values have the following meanings:

auto

Line numbers are not initialized, and it is succeeded from previous <fo:page-sequence>. When previous <fo:page-sequence> does not exist, it becomes 1.

<number>

Initializes the line number with the specified value. The value must be greater than or equal to 1. Actual initialization takes place at the time when axf:line-number-reset is specified.

#<id>

This extension can only be specified to <fo:table-column> to continue line numbers of <fo:table-column> in sequence. See also axf:line-number.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:line-number-interval / CSS -ah-line-number-interval no-LT

Specifies the interval of line numbers.

Value:<number> | auto
Initial:auto
Applies to:fo:page-sequence, fo:table-column / CSS root element
Inherited:no
Percentages:N/A

Values have the following meanings:

auto

The specification of previous <fo:page-sequence> is succeeded. When previous <fo:page-sequence> does not exist, it becomes 1.

<number>

Sets the interval of the line numbers to the value specified.

Specifies to show the line numbers like 5, 10, 15. In this case, axf:line-number-initial="1" axf:line-number-start="5" axf:line-number-interval="5" can be applied.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:line-number-offset / CSS -ah-line-number-offset no-LT

Specifies the offset of line numbers.

Value:<length>
Initial:0pt
Applies to:all block-level formatting objects that are descendants of fo:flow, fo:table-column
Inherited:yes
Percentages:N/A

This property is not available with Antenna House Formatter V7.4 Lite.

axf:line-number-orientation / CSS -ah-line-number-orientation no-LT XSL-FO Samples CollectionExample of line number orientation

Rotates line numbers.

Value:0 | 90 | 180 | 270 | -90 | -180 | -270
Initial:0
Applies to:fo:page-sequence, fo:table-column / CSS root element
Inherited:no
Percentages:N/A

Rotates line numbers with specified degrees. A numerical value can have a unit, such as "90deg".

This property is not available with Antenna House Formatter V7.4 Lite.

axf:line-number-position / CSS -ah-line-number-position no-LT

Specifies the position of line numbers.

Value:start | end | inside | outside | alternate
Initial:start
Applies to:all block-level formatting objects that are descendants of fo:flow, fo:table-column
Inherited:yes
Percentages:N/A

Values have the following meanings:

start

Places line numbers at start-edge.

end

Places line numbers at end-edge.

inside

Places line numbers at start-edge on odd pages, at end-edge on even pages.

outside

Places line number at end-edge on odd pages, at start-edge on even pages.

alternate

Places line number at end-edge in the last column of a column layout, except for the last column, places it at start-edge. If the layout is non-column, places it at start-edge.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:line-number-prefix / CSS -ah-line-number-prefix no-LT

Sets the prefix of line number.

Value:<string>
Initial:empty string
Applies to:fo:page-sequence, fo:table-column / CSS root element
Inherited:no
Percentages:N/A

Specifies the prefix for line numbers. Specified string will be output before each line number generated by axf:line-number.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:line-number-reset / CSS -ah-line-number-reset no-LT

Resets line numbering.

Value:auto | none | page | column | force
Initial:auto
Applies to:fo:page-sequence, fo:block, fo:table-column
Inherited:no
Percentages:N/A

Values have the following meanings:

auto

The specification of previous <fo:page-sequence> is succeeded. When the previous <fo:page-sequence> does not exist, it will become none.

none

Line numbers are not reset.

page

Line numbers are reset when pages break.

column

Line numbers are reset when columns break.

force

Line numbers are reset forcibly. It can be specified to <fo:block>.

Line numbers are reset to the value specified to axf:line-number-initial.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:line-number-start / CSS -ah-line-number-start no-LT

Specifies the starting line number.

Value:<number> | auto
Initial:auto
Applies to:fo:page-sequence, fo:table-column / CSS root element
Inherited:no
Percentages:N/A

Values have the following meanings:

auto

The specification of the previous <fo:page-sequence> is succeeded. When the previous <fo:page-sequence> does not exist, it will become 1.

<number>

Sets the line number that begins outputting to the value specified.

Line numbers are shown when the value is greater than or equal to the value specified here. When axf:line-number-initial="1" axf:line-number-start="5" are specified, the first 4 line numbers are not shown but the 5th line number will be outputted as the beginning number. When axf:line-number-initial="5" axf:line-number-start="6" are specified, the first line number is not shown but the next line number is outputted as 6.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:line-number-show / CSS -ah-line-number-show no-LT XSL-FO Samples CollectionLine numbers to always show

Specifies the line number to be always output.

Value:<number>*
Initial:empty
Applies to:fo:page-sequence, fo:table-column / CSS root element
Inherited:no
Percentages:N/A

Always outputs the numbers specified here even if numbers are not outputted by axf:line-number-interval, etc.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:line-number-text-align / CSS -ah-line-number-text-align no-LT

Specifies the alignment of line numbers in the line area.

Value:auto | start | center | end | inside | outside | left | right
Initial:auto
Applies to:all block-level formatting objects that are descendants of fo:flow, fo:table-column
Inherited:yes
Percentages:N/A

Values have the following meanings:

start
center
end
inside
outside
left
right

Same as text-align.

auto

When the position of the line numbers is in the start side, it is considered end. When the position of the line numbers is in the end side, it is considered start. The position of line numbers is specified by axf:line-number-position.

When axf:line-number-width is not specified, It is always considered auto.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:line-number-text-decoration / CSS -ah-line-number-text-decoration no-LT

Specifies the test decoration of line numbers.

Value:same as text-decoration
Initial:none
Applies to:all block-level formatting objects that are descendants of fo:flow, fo:table-column
Inherited:yes
Percentages:N/A

Values have the same meaning as text-decoration.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:line-number-width / CSS -ah-line-number-width no-LT

Specifies the width of line numbers.

Value:auto | <length>
Initial:auto
Applies to:all block-level formatting objects that are descendants of fo:flow, fo:table-column
Inherited:yes
Percentages:N/A

Values have the following meanings:

auto

The width of line numbers becomes the width of the text of the line.

When specifying the arrangement of line numbers by axf:line-number-text-align, the value other than auto should be specified for the width.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:line-number-except-continued-line / CSS -ah-line-number-except-continued-line no-LT XSL-FO Samples CollectionAdding line numbers except for continued lines

Specifies whether to add line numbers except for continued lines.

Value:true | false
Initial:false
Applies to:all block-level formatting objects that are descendants of fo:flow, fo:table-column
Inherited:yes
Percentages:N/A

Values have the following meanings:

true

When a long line wraps, only the first line is numbered. At this time, the continued lines is not counted in the number of lines.

false

Adds line numbers to all lines.

This property is not available with Antenna House Formatter V7.4 Lite.


Line Continued Mark

When the line with long text strings is broken and continues to the next line, line continued marks can be applied to the end of line. It is invalid inside fo:float or fo:footnote.

This function is not available with Antenna House Formatter V7.4 Lite.

axf:line-continued-mark / CSS -ah-line-continued-mark no-LT XSL-FO Samples CollectionLine continued mark

Specifies whether to show line continued marks.

Value:<string>
Initial:empty string
Applies to:all block-level formatting objects that are descendants of fo:flow
Inherited:yes
Percentages:N/A

Values have the following meanings:

<string>

Line continued marks with the specified character strings are shown. If the character strings are empty, line continued marks are not shown.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:line-continued-mark-background-color / CSS -ah-line-continued-mark-background-color no-LT

Specifies the background color of line continued marks.

Value:<color>
Initial:transparent
Applies to:all block-level formatting objects that are descendants of fo:flow
Inherited:yes
Percentages:N/A

This property is not available with Antenna House Formatter V7.4 Lite.

axf:line-continued-mark-color / CSS -ah-line-continued-mark-color no-LT

Specifies the color of line continued marks.

Value:<color>
Initial:depends on the current line area
Applies to:all block-level formatting objects that are descendants of fo:flow
Inherited:yes
Percentages:N/A

This property is not available with Antenna House Formatter V7.4 Lite.

axf:line-continued-mark-font-family / CSS -ah-line-continued-mark-font-family no-LT

Specifies the font family of line continued marks.

Value:[ <family-name> | <generic-family> ]#
Initial:depends on the current line area
Applies to:all block-level formatting objects that are descendants of fo:flow
Inherited:yes
Percentages:N/A

This property is not available with Antenna House Formatter V7.4 Lite.

axf:line-continued-mark-font-size / CSS -ah-line-continued-mark-font-size no-LT

Specifies the font size of line continued marks.

Value:<absolute-size> | <relative-size> | <length> | <percentage>
Initial:depends on the current line area
Applies to:all block-level formatting objects that are descendants of fo:flow
Inherited:yes
Percentages:refer to the font size

This property is not available with Antenna House Formatter V7.4 Lite.

axf:line-continued-mark-font-style / CSS -ah-line-continued-mark-font-style no-LT

Specifies whether to make the font style italic.

Value:normal | italic
Initial:depends on the current line area
Applies to:all block-level formatting objects that are descendants of fo:flow
Inherited:yes
Percentages:N/A

This property is not available with Antenna House Formatter V7.4 Lite.

axf:line-continued-mark-font-weight / CSS -ah-line-continued-mark-font-weight no-LT

Specifies the font weight of line numbers.

Value:normal | bold | bolder | lighter | 1...1000
Initial:depends on the current line area
Applies to:all block-level formatting objects that are descendants of fo:flow
Inherited:yes
Percentages:N/A

This property is not available with Antenna House Formatter V7.4 Lite.

axf:line-continued-mark-offset / CSS -ah-line-continued-mark-offset no-LT

Specifies the offset of line continued marks.

Value:<length>
Initial:0pt
Applies to:all block-level formatting objects that are descendants of fo:flow
Inherited:yes
Percentages:N/A

This property is not available with Antenna House Formatter V7.4 Lite.


Marker

axf:suppress-duplicate-marker-contents no-LT

Specifies the removal of duplicate marker references.

Value:true | false
Initial:false
Applies to:all formatting objects
Inherited:yes
Percentages:N/A

When inline consecutive <fo:retrieve-marker> refer to <fo:marker> with the same content, one <fo:retrieve-marker> is removed. For example, in the following case, text and elements between <fo:retrieve-marker> are also removed.

<fo:retrieve-marker/><fo:retrieve-marker/>

It does not work in the following cases:

  • When <fo:marker> is not an inline element
  • When <fo:retrieve-marker> is not a sibling element

The same applies to inline consecutive <fo:retrieve-table-marker>.

This property is not available with Antenna House Formatter V7.4 Lite.


Revision Bar

Antenna House Formatter V7.4 provides extension properties to layout the revision bars in the documents. The revision bar is shown above the border or the column rule. The revision bars and <fo:change-bar-*> are invalid in <fo:float>.

Revision Bar Model

axf:revision-bar-color / CSS -ah-revision-bar-color

Specifies the color of the revision bar.

Value:<color>
Initial:the value of the ‘color’ property
Applies to:all block-level and inline-level formatting objects that are descendants of fo:flow
Inherited:yes
Percentages:N/A

axf:revision-bar-offset / CSS -ah-revision-bar-offset

Specifies the offset of the revision bar.

Value:<length>
Initial:0pt
Applies to:all block-level and inline-level formatting objects that are descendants of fo:flow
Inherited:yes
Percentages:N/A

axf:revision-bar-position / CSS -ah-revision-bar-position

Specifies the position of the revision bar.

Value:start | end | inside | outside | alternate | both
Initial:start
Applies to:all block-level and inline-level formatting objects that are descendants of fo:flow
Inherited:yes
Percentages:N/A

Values have the following meanings:

start

Places revision bar at start-edge.

end

Places revision bar at end-edge.

inside

Places revision bar at start-edge on odd pages, at end-edge on even pages.

outside

Places revision bar at end-edge on odd pages, at start-edge on even pages.

alternate

Places revision bar at end-edge in the last column of multi-column layout, except for the last column, places it at start-edge.

both

Places revision bar at start-edge and end-edge.

axf:revision-bar-style / CSS -ah-revision-bar-style

Specifies the style of the revision bar.

Value:<border-style>
Initial:none
Applies to:all block-level and inline-level formatting objects that are descendants of fo:flow
Inherited:yes
Percentages:N/A

axf:revision-bar-width / CSS -ah-revision-bar-width

Specifies the width of the revision bar.

Value:<border-width>
Initial:medium
Applies to:all block-level and inline-level formatting objects that are descendants of fo:flow
Inherited:yes
Percentages:N/A

CSS (-ah-)change-bar-class

[CSS3-GCPM] Change bars (“change-bar-class” has been removed from GCPM on and after June 8, 2010)

Value:<name>
Initial:N/A
Applies to:all elements
Inherited:no
Percentages:N/A

 [XSL 1.1] change-bar-class

CSS (-ah-)change-bar-color

[CSS3-GCPM] Change bars (“change-bar-color” has been removed from GCPM on and after June 8, 2010)

Value:<color>
Initial:the value of the 'color' property
Applies to:all elements
Inherited:no
Percentages:N/A

 [XSL 1.1] change-bar-color

CSS (-ah-)change-bar-offset

[CSS3-GCPM] Change bars (“change-bar-offset” has been removed from GCPM on and after June 8, 2010)

Value:<length>
Initial:6pt
Applies to:all elements
Inherited:no
Percentages:N/A

 [XSL 1.1] change-bar-offset

CSS (-ah-)change-bar-side

[CSS3-GCPM] Change bars (“change-bar-side” has been removed from GCPM on and after June 8, 2010)

Value:start | end | left | right | inside | outside | alternate
Initial:start
Applies to:all elements
Inherited:no
Percentages:N/A

 [XSL 1.1] change-bar-placement

CSS (-ah-)change-bar-style

[CSS3-GCPM] Change bars (“change-bar-style” has been removed from GCPM on and after June 8, 2010)

Value:<border-style>
Initial:none
Applies to:all elements
Inherited:no
Percentages:N/A

 [XSL 1.1] change-bar-style

CSS (-ah-)change-bar-width

[CSS3-GCPM] Change bars (“change-bar-width” has been removed from GCPM on and after June 8, 2010)

Value:<border-width>
Initial:medium
Applies to:all elements
Inherited:no
Percentages:N/A

 [XSL 1.1] change-bar-width


Footnote

(-ah-)float is used to create footnotes and sidenotes in CSS. See also “Footnotes/Sidenotes by CSS”.

Footnote Positioning

With Antenna House Formatter V7.4, footnotes can be arranged per each column or footnotes duplicated in the same page can be deleted. Also, sidenotes can be generated.

axf:footnote-align

Specifies the alignment of the footnotes.

Value:auto | before | after
Initial:auto
Applies to:fo:region-body, fo:footnote
Inherited:no
Percentages:N/A

Values have the following meanings:

auto

Footnotes are placed automatically. Footnotes are the usual arrangement. When the text is one column, sidenotes are arranged with an anchor position, and in the case of two or more columns, sidenotes are arranged near by the before side.

before

Sidenotes are arranged near by the before side. In the case of usual footnotes that are not sidenotes, footnotes are arranged immediately after the text in a page.

after

Sidenotes are arranged near by the after side. In the case of usual footnotes that are not sidenotes, footnotes are arranged at the last of a page.

Specifies the method of arrangement of footnotes or sidenotes. When it is sidenotes (footnote arrangement into <fo:region-start> or <fo:region-end> is specified by axf:footnote-position), it's possible to specify whether it is arranged automatically, or it is arranged near by the before side, or it is arranged near by the after side.

axf:footnote-stacking / CSS -ah-footnote-stacking XSL-FO Samples CollectionFootnote arrangement

Specifies the method to layout the footnote.

Value:block | inline
Initial:block
Applies to:fo:region-body, fo:footnote
Inherited:no
Percentages:N/A

Values have the following meanings:

block

Arranges the footnotes in the block progression direction.

inline

Arranges the footnotes in the inline progression direction.

axf:footnote-positionXSL-FO Samples CollectionColumn-width footnotesSidenote

Specifies the location to place the footnote.

Value:page | odd-page | even-page | start | end | inside | outside | column | start-column | end-column | inside-column | outside-column
Initial:page
Applies to:fo:region-body, fo:footnote
Inherited:no
Percentages:N/A

Values have the following meanings:

page

Footnotes are placed on the after side of each page in <fo:region-body>. This is the standard layout of XSL specification.

odd-page

Footnotes are placed on the after side of each odd page in <fo:region-body>. This is the standard layout of sidenotes in vertical writing. (On the outside in odd page.)

even-page

Footnotes are placed on the after side of each even page in <fo:region-body>.

start

Footnotes are placed on each page in <fo:region-start>. Headnotes in vertical writing. Sidenotes on the left side in horizontal writing.

end

Footnotes are placed on each page in <fo:region-end>. Footnotes in vertical writing. Sidenotes on the right side in horizontal writing.

inside

Footnotes are placed at each even page in <fo:region-end> and each odd page in <fo:region-start>. Sidenotes on the inside in horizontal writing.

outside

Footnotes are placed on each even page in <fo:region-start> and each odd page in <fo:region-end>. This is a standard sidenotes in horizontal writing. (On the outside of both right and left pages.)

column

Footnotes are placed on the after side of each column. This is a standard footnote in horizontal writing. Same as page if the document is non multi-columns.

start-column

Footnotes are placed on the after side of the first column. Same as start if the document is non multi-columns.

end-column

Footnotes are placed on the after side of the end column. Same as end if the document is non multi-columns.

inside-column

Footnotes are placed in the same way as end-column at even page and in the same way as start-column at odd page. Footnotes are put together on the inside column in horizontal writing.

outside-column

Footnotes are placed in the same way as start-column at even page and in the same way as end-column at odd page. Footnotes are put together on the outside column in horizontal writing.

It is possible to arrange footnotes inside the <fo:region-start> or the <fo:region-end> (these notes are called sidenotes). Besides specifying them to <fo:region-body>, it is also effective to specify to individual <fo:footnote>. It is possible to make several types of notes intermingled by this extension.

There are following restrictions for sidenotes.

  • The sidenotes which run over from the specified area will overflow.
  • The xsl-footnote-separator is not effective.

start-column, end-column, inside-column and outside-column have the following restrictions.

  • It is not possible to specify these values to <fo:footnote>. It is only available to specify them to <fo:region-body>.
  • When you specify these values to <fo:region-body>, column cannot be specified to <fo:footnote>.
  • These values cannot be used with the forcible column break such as break-before="column", etc. These values cannot be used for a large volume of footnotes.

odd-page and even-page have the following restrictions.

  • It is not possible to specify these values to <fo:footnote>. It is only available to specify them to <fo:region-body>.

axf:footnote-keep / CSS -ah-footnote-keep

Specifies whether to arrange a footnote and an anchor in the same page

Value:auto | always | none
Initial:auto
Applies to:fo:region-body, fo:footnote
Inherited:no
Percentages:N/A

Values have the following meanings:

auto

When a footnote does not fit within the column, it is sent to the next page or the next column.

always

When a footnote does not fit within the column, the line of the anchor and the subsequent lines are sent to the following page, and a footnote and an anchor are arranged in the same page. When axf:footnote-position="column" is specified, a footnote and an anchor are arranged in the same column.

none

When a footnote does not fit within the column, the line of the anchor and the subsequent lines are sent to the next page, and attempts to fit the footnote itself within the page.

axf:footnote-max-height / CSS -ah-footnote-max-height no-LT XSL-FO Samples CollectionA footnote breaking across multiple pages

Specifies the maximum height of footnote.

Value:auto | <length> | <percentage>
Initial:auto
Applies to:fo:region-body
Inherited:no
Percentages:refer to the height of the page

Specifies the maximum height of footnote. The behavior when auto is specified depends on the value of auto-break-footnote in the Option Setting File.

  • When axf:footnote-max-height="auto" and auto-break-footnote="false" are specified

    Up to Antenna House Formatter V6.1, page (column) break did not occur within <fo:footnote-body>. This setting performs such previous operation. In case a footnote is big and exceeds the page height, an overflow occurs. However, only in case a footnote is small, is it possible to format without breaking a footnote.

  • When axf:footnote-max-height="auto" and auto-break-footnote="true" are specified

    It is considered that the page height is specified to axf:footnote-max-height and page break (column break) occurs within <fo:footnote-body>.

  • When axf:footnote-max-height="<length>" or "<percentage>" is specified

    The value must be a positive. auto-break-footnote is not referred to. At this time, page (column) break may occur within <fo:footnote-body>. The footnote will be put after an anchor position as much as possible and the remaining part will be split and sent to the next page (column). Note that axf:footnote-max-height is invalid for pages without text.

There are following restrictions in CSS.

  • A footnote can be split within @footnote only when @footnote is -ah-float-y:after and the width is not specified.
  • A footnote cannot be split when @footnote is -ah-float-reference:multicol.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:suppress-duplicate-footnote / CSS -ah-suppress-duplicate-footnoteXSL-FO Samples CollectionSuppressing duplicate footnotes within the same page

Specifies whether to delete footnotes duplicated in the same page.

Value:true | false
Initial:false
Applies to:fo:footnote
Inherited:yes
Percentages:N/A

Deters the display of duplicated footnotes on the same footnote region when the same footnote is assigned to two or more places in the same page. When axf:footnote-position="column" is specified, it is effective only with the footnote in the same column.

Footnote Numbering

These features are not available with Antenna House Formatter V7.4 Lite.

<axf:footnote-number> no-LT XSL-FO Samples CollectionCreating a footnote number and specifying a default value

Common Usage:

Generates a footnote number.

Areas:

Generates and returns a single normal inline-area.

Constraints:

<axf:footnote-number> can be specified only as an anchor area. That is, it can be specified only as a descendant of <fo:inline> that is a child of <fo:footnote>.

Contents:

EMPTY

This element is not available with Antenna House Formatter V7.4 Lite.

<axf:footnote-number-citation> no-LT

Common Usage:

Cites a footnote number.

Areas:

Generates and returns a single normal inline-area.

Constraints:

<axf:footnote-number-citation> can be specified only as a descendant of <fo:footnote-body>. The ref-id property is required, and the ID referenced by <axf:footnote-number-citation> must be the one specified in <axf:footnote-number> in the anchor area in the same <fo:footnote>.

Contents:

EMPTY

This element is not available with Antenna House Formatter V7.4 Lite.

axf:footnote-number-format no-LT

Specifies the format of footnote number.

Value:<string>
Initial:1
Applies to:fo:page-sequence
Inherited:no
Percentages:N/A

Adopted as a format of axf:footnote-number. It can be specified in the same way as the format property.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:footnote-number-initial no-LT

Specifies the initial footnote number.

Value:auto | <number>
Initial:auto
Applies to:fo:page-sequence
Inherited:no
Percentages:N/A

Values have the following meanings:

auto

Succeeded from the before existing <fo:page-sequence> without initializing a footnote number. When <fo:page-sequence> does not exist before, it is set to 1.

<number>

Initializes the footnote number with the specified value. The value must be greater than or equal to 1. Actual initialization takes place at the time when axf:footnote-number-reset is specified.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:footnote-number-reset no-LT

Resets the footnote numbering.

Value:auto | none | page | odd-page | even-page | column
Initial:auto
Applies to:fo:page-sequence
Inherited:no
Percentages:N/A

Values have the following meanings:

auto

Succeeded from the before existing <fo:page-sequence>. When <fo:page-sequence> does not exist before, it is set to none.

none

Does not reset the footnote number.

page

Resets the footnote number when a page breaks.

odd-page

Resets the footnote number when an odd page breaks.

even-page

Resets the footnote number when an even page breaks.

column

Resets the footnote number when a column breaks.

A footnote number is reset by the value specified by axf:footnote-number-initial.

This property is not available with Antenna House Formatter V7.4 Lite.


Columns

In FO, these properties are placed as <fo:region-body> and <fo:block-container>.

CSS (-ah-)columnsIntroduction to CSS for Paged Mediacolumns

[CSS3-Multicol] ‘columns’

Value:[ [ <integer> | auto] || [ <length> | auto] ]
Initial:see individual properties
Applies to:block-level elements
Inherited:no
Percentages:N/A

column-count / CSS (-ah-)column-countXSL-FO Samples CollectionMultiple columnsSpace before and after a spanning blockIntroduction to CSS for Paged Mediacolumn-count

[CSS3-Multicol] ‘column-count’

Value:<number> (XSL) / <number> | auto (CSS)
Initial:1 (XSL) / auto (CSS)
Applies to:fo:region-body, fo:block-container
Inherited:no
Percentages:N/A

column-gap / CSS (-ah-)column-gapIntroduction to CSS for Paged Mediacolumn-gap

[CSS3-Multicol] ‘column-gap’, [CSS3-Align] ‘column-gap’

Value:<length> | <percentage> (XSL) / <length> | normal (CSS)
Initial:12pt (XSL) / normal (CSS)
Applies to:fo:region-body, fo:block-container (XSL) / multi-column containers, grid containers (CSS)
Inherited:no
Percentages:refer to the width of the fo:block-container

CSS (-ah-)column-spanIntroduction to CSS for Paged Mediacolumn-span

[CSS3-Multicol] ‘column-span’

Value:none | all
Initial:none
Applies to:static, non-floating elements
Inherited:no
Percentages:N/A

CSS (-ah-)column-widthXSL-FO Samples CollectionColumn widthIntroduction to CSS for Paged Mediacolumn-width

[CSS3-Multicol] ‘column-width’

Value:<length> | auto
Initial:auto
Applies to:block-level elements
Inherited:no
Percentages:N/A

axf:column-fill / CSS (-ah-)column-fillXSL-FO Samples CollectionFilling columns

Specifies whether to balance the column height. [CSS3-Multicol] ‘column-fill’

Value:auto | balance | balance-all
Initial:balance
Applies to:multi-column elements
Inherited:no
Percentages:N/A

Values have the following meanings:

auto

Do not balance the height. However if span="all" is specified, it is balanced before the spanned column.

balance

Balance the height.

Column Rule

Antenna House Formatter V7.4 provides extension properties to layout the column rules in the column gaps. The column rule is placed above the border and below the revision bar.

Column Model

axf:column-rule / CSS (-ah-)column-rule XSL-FO Samples CollectionColumn rulefo:block-container with multiple columnsIntroduction to CSS for Paged Mediacolumn-rule

The shorthand is effective. column-rule-display can be included in both FO and CSS values. [CSS3-Multicol] ‘column-rule’

Value:<border-width> || <border-style> || <color> || <column-rule-display>
Initial:see individual properties
Applies to: fo:region-body, fo:block-container
Inherited:no
Percentages:N/A

axf:column-rule-align / CSS -ah-column-rule-align

Specifies the alignment of the column rule.

Value:before | center | after
Initial:center
Applies to:fo:region-body, fo:block-container
Inherited:no
Percentages:N/A

axf:column-rule-color / CSS (-ah-)column-rule-colorIntroduction to CSS for Paged Mediacolumn-rule-color

Specifies the color of the column rule. [CSS3-Multicol] ‘column-rule-color’

Value:<color>
Initial:the value of the ‘color’ property
Applies to:fo:region-body, fo:block-container
Inherited:no
Percentages:N/A

axf:column-rule-display / CSS -ah-column-rule-display

Formatted result

Specifies whether to also display a rule at the place where column gaps do not exist.

Value:gap | end | all
Initial:gap
Applies to:fo:region-body, fo:block-container
Inherited:no
Percentages:N/A

Values have the following meanings:

gap

Displays a rule only between existing columns.

end

Displays a rule at the end side of each existing column. However, the end side of the final column is not included.

all

Displays rules even between non-existent columns at the end of a page, etc.

Suppose contents are only in the left column of the three columns as shown in the figure on the right. When gap is specified, rules are not displayed at all. When end is specified, a rule (1) is displayed, when all is specified, rules (1) and (2) are displayed.

axf:column-rule-length / CSS -ah-column-rule-length

Specifies the length of the column rule.

Value:<length> | <percentage>
Initial:100%
Applies to:fo:region-body, fo:block-container
Inherited:no
Percentages:refer to the height of the column

In case where the column is short by specifying span="all" in FO, or in case of the block containing columns in CSS, that height of the column indicates 100%.

axf:column-rule-style / CSS (-ah-)column-rule-styleIntroduction to CSS for Paged Mediacolumn-rule-style

Specifies the style of the column rule. [CSS3-Multicol] ‘column-rule-style’

Value:<border-style>
Initial:none
Applies to:fo:region-body, fo:block-container
Inherited:no
Percentages:N/A

axf:column-rule-width / CSS (-ah-)column-rule-widthIntroduction to CSS for Paged Mediacolumn-rule-width

Specifies the width of the column rule. [CSS3-Multicol] ‘column-rule-width’

Value:<border-width>
Initial:medium
Applies to:fo:region-body, fo:block-container
Inherited:no
Percentages:N/A


Borders

axf:border-connection-form / CSS -ah-border-connection-form no-LT XSL-FO Samples CollectionShape of connections between bordersCreating optional spaces around text inside a blockPadding and border in a tableSpecify the border to the region

Specifies the shape of the connecting portion of borders.

Value: wedge | mixed | precedence
Initial:mixed
Applies to:all elements
Inherited:yes
Percentages:N/A

Values have the following meanings:

wedge

Connects borders in wedge shape. Forms the X shape at the cross-shaped intersecting portion, and forms the Y shape at the T-shaped intersecting portion.

mixed

Connects borders with the same thickness in rectangle shape at the T-shaped intersecting portion. Others will be in wedge shape.

precedence

Draws thick borders to the edge. For the same thickness, draws a stronger border to the edge by the border priority.

In the table of border-collapse="collapse", axf:border-connection-form specified in <fo:table-row>, <fo:table-cell>, etc. in that table is invalid. The one specified in <fo:table> is adopted.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:border-double-thickness / CSS -ah-border-double-thicknessXSL-FO Samples CollectionThickness of double-border linesCreating optional spaces around text inside a blockPadding and border in a tableSpecify the border to the region

Specifies the line thickness of border-style="double".

Value: <value>{1,3}
Initial:1
Applies to:all elements
Inherited:yes
Percentages:N/A

In <value>, either <number> or <length> can be specified. The values are outside line width, spacing and inside line width in order from left to right. If the value is omitted, it is considered to be equivalent to the preceding value. Negative values are not available. The line width can directly be specified in <length>. We do not guarantee the best result if the total of <length> exceeds the border-width. The values in <number> is summed and then the total of <length> is deducted from the actual border-width for proportional distribution. For example, if the border-width is 10pt and axf:border-double-thickness="4pt 2 1" is specified, it will be shown as follows:

  • Outside line width = 4pt
  • Spacing = (10pt-4pt)/(2+1)*2 = 4pt
  • Inside line width = (10pt-4pt)/(2+1)*1 = 2pt

axf:border-triple-thickness / CSS -ah-border-triple-thicknessXSL-FO Samples CollectionThickness of triple-border linesCreating optional spaces around text inside a blockPadding and border in a tableSpecify the border to the region

Specifies the line thickness of border-style="triple".

Value: <value>{1,5}
Initial:1
Applies to:all elements
Inherited:yes
Percentages:N/A

In <value>, either <number> or <length> can be specified. The values are outside line width, spacing, middle line width, spacing, and inside line width in order from left to right. If the value is omitted, it is considered to be equivalent to the preceding value. Negative values are not available. See axf:border-double-thickness for <value>.

axf:border-wave-form / CSS -ah-border-wave-formXSL-FO Samples CollectionDouble-wave border formGenerating wavy bordersCreating optional spaces around text inside a blockPadding and border in a tableSpecify the border to the region

Specifies the wave form of border-style="wave", border-style="double-wave".

Value: <value>{1,3}
Initial:auto
Applies to:all elements
Inherited:yes
Percentages:N/A

In <value>, either <number> or <length> or auto can be specified. The values are wave form and line width in order from left to right. If the value is auto or omitted, it is considered 6 and 0.125 each. Negative values are not available. The wave form or the line width can directly be specified in <length>. <number> is proportional to the border-width. The third value is effective with double-wave and indicates the wave width. If the value is omitted or auto, it is considered 0.5.

CSS -ah-border-afterXSL-FO Samples CollectionCreating optional spaces around text inside a blockPadding and border in a tableSpecify the border to the region

Specifies the border of the after side.

Value:<border-width> || <border-style> || <color>
Initial:see individual properties
Applies to:same as ‘border
Inherited:no
Percentages:see individual properties

This property is a shorthand for setting the width, style, and color of the after side.

CSS -ah-border-beforeXSL-FO Samples CollectionCreating optional spaces around text inside a blockPadding and border in a tableSpecify the border to the region

Specifies the border of the before side.

Value:<border-width> || <border-style> || <color>
Initial:see individual properties
Applies to:same as ‘border
Inherited:no
Percentages:see individual properties

This property is a shorthand for setting the width, style, and color of the before side.

CSS -ah-border-endXSL-FO Samples CollectionCreating optional spaces around text inside a blockPadding and border in a tableSpecify the border to the region

Specifies the border of the end side.

Value:<border-width> || <border-style> || <color>
Initial:see individual properties
Applies to:same as ‘border
Inherited:no
Percentages:see individual properties

This property is a shorthand for setting the width, style, and color of the end side.

CSS -ah-border-startXSL-FO Samples CollectionCreating optional spaces around text inside a blockPadding and border in a tableSpecify the border to the region

Specifies the border of the start side.

Value:<border-width> || <border-style> || <color>
Initial:see individual properties
Applies to:same as ‘border
Inherited:no
Percentages:see individual properties

This property is a shorthand for setting the width, style, and color of the start side.

CSS -ah-border-after-colorXSL-FO Samples CollectionCreating optional spaces around text inside a blockPadding and border in a tableSpecify the border to the region

Specifies the border color of the after side.

Value:<color>
Initial:currentColor
Applies to:same as ‘border-color
Inherited:no
Percentages:N/A

 [XSL 1.1] border-after-color

CSS -ah-border-before-colorXSL-FO Samples CollectionCreating optional spaces around text inside a blockPadding and border in a tableSpecify the border to the region

Specifies the border color of the before side.

Value:<color>
Initial:currentColor
Applies to:same as ‘border-color
Inherited:no
Percentages:N/A

 [XSL 1.1] border-before-color

CSS -ah-border-end-colorXSL-FO Samples CollectionCreating optional spaces around text inside a blockPadding and border in a tableSpecify the border to the region

Specifies the border color of the end side.

Value:<color>
Initial:currentColor
Applies to:same as ‘border-color
Inherited:no
Percentages:N/A

 [XSL 1.1] border-end-color

CSS -ah-border-start-colorXSL-FO Samples CollectionCreating optional spaces around text inside a blockPadding and border in a tableSpecify the border to the region

Specifies the border color of the start side.

Value:<color>
Initial:currentColor
Applies to:same as ‘border-color
Inherited:no
Percentages:N/A

 [XSL 1.1] border-start-color

CSS -ah-border-after-styleXSL-FO Samples CollectionCreating optional spaces around text inside a blockPadding and border in a tableSpecify the border to the region

Specifies the border style of the after side.

Value:<border-style>
Initial:none
Applies to:same as ‘border-style
Inherited:no
Percentages:N/A

 [XSL 1.1] border-after-style

CSS -ah-border-before-styleXSL-FO Samples CollectionCreating optional spaces around text inside a blockPadding and border in a tableSpecify the border to the region

Specifies the border style of the before side.

Value:<border-style>
Initial:none
Applies to:same as ‘border-style
Inherited:no
Percentages:N/A

 [XSL 1.1] border-before-style

CSS -ah-border-end-styleXSL-FO Samples CollectionCreating optional spaces around text inside a blockPadding and border in a tableSpecify the border to the region

Specifies the border style of the end side.

Value:<border-style>
Initial:none
Applies to:same as ‘border-style
Inherited:no
Percentages:N/A

 [XSL 1.1] border-end-style

CSS -ah-border-start-styleXSL-FO Samples CollectionCreating optional spaces around text inside a blockPadding and border in a tableSpecify the border to the region

Specifies the border style of the start side.

Value:<border-style>
Initial:none
Applies to:same as ‘border-style
Inherited:no
Percentages:N/A

 [XSL 1.1] border-start-style

CSS -ah-border-after-widthXSL-FO Samples CollectionCreating optional spaces around text inside a blockPadding and border in a tableSpecify the border to the region

Specifies the border width of the after side.

Value:<border-width>
Initial:none
Applies to:same as ‘border-width
Inherited:no
Percentages:refer to the logical width of the containing block

 [XSL 1.1] border-after-width

CSS -ah-border-before-widthXSL-FO Samples CollectionCreating optional spaces around text inside a blockPadding and border in a tableSpecify the border to the region

Specifies the border width of the before side.

Value:<border-width>
Initial:none
Applies to:same as ‘border-width
Inherited:no
Percentages:refer to the logical width of the containing block

 [XSL 1.1] border-before-width

CSS -ah-border-end-widthXSL-FO Samples CollectionCreating optional spaces around text inside a blockPadding and border in a tableSpecify the border to the region

Specifies the border width of the end side.

Value:<border-width>
Initial:none
Applies to:same as ‘border-width
Inherited:no
Percentages:refer to the logical width of the containing block

 [XSL 1.1] border-end-width

CSS -ah-border-start-widthXSL-FO Samples CollectionCreating optional spaces around text inside a blockPadding and border in a tableSpecify the border to the region

Specifies the border width of the start side.

Value:<border-width>
Initial:none
Applies to:same as ‘border-width
Inherited:no
Percentages:refer to the logical width of the containing block

 [XSL 1.1] border-start-width

CSS (-ah-)border-lengthXSL-FO Samples CollectionCreating optional spaces around text inside a blockPadding and border in a tableSpecify the border to the regionIntroduction to CSS for Paged Mediaborder-length

[CSS3-GCPM] The ‘border-length’ property (“border-length” has been removed from GCPM on and after June 8, 2010)

Value:<length> | auto
Initial:auto
Applies to:@footnote areas
Inherited:no
Percentages:refer to the width of element

CSS (-ah-)box-decoration-break

The following bold value is extended. [CSS3-Break] Fragmented Borders and Backgrounds: the box-decoration-break property

Value:slice | clone | padding
Initial:slice
Applies to:all elements
Inherited:no
Percentages:N/A

Extended values have the following meanings.

padding no-LT

slice eliminates the border and padding of the broken edges, while padding leaves padding.
This value cannot be specified by Antenna House Formatter V7.4 Lite.

Diagonal Border

Antenna House Formatter V7.4 provides extension properties to draw the diagonal border in the area such as the table cell where the border can be specified. The diagonal border by axf:diagonal-border-* is drawn from the edge of before-start to the edge of after-end. The diagonal border by axf:reverse-diagonal-border-* is drawn from the edge of before-end to the edge of after-start. When the writing-mode="lr-tb" is specified, the diagonal border is drawn as follows. When the writing-mode="rl-tb" or "tb-rl" is specified, it is drawn in a reverse way.

Diagonal Border

axf:diagonal-border-color / CSS -ah-diagonal-border-color

Specifies the color of the diagonal border.

Value:<color>
Initial:the value of the ‘color’ property
Applies to:all elements which can have borders
Inherited:yes
Percentages:N/A

axf:diagonal-border-style / CSS -ah-diagonal-border-style

Specifies the style of the diagonal border.

Value:<border-style>
Initial:none
Applies to:all elements which can have borders
Inherited:no
Percentages:N/A

axf:diagonal-border-width / CSS -ah-diagonal-border-width

Specifies the width of the diagonal border.

Value:<border-width>
Initial:medium
Applies to:all elements which can have borders
Inherited:yes
Percentages:N/A

axf:reverse-diagonal-border-color / CSS -ah-reverse-diagonal-border-color

Specifies the color of the reverse diagonal border.

Value:<color>
Initial:the value of the ‘color’ property
Applies to:all elements which can have borders
Inherited:yes
Percentages:N/A

axf:reverse-diagonal-border-style / CSS -ah-reverse-diagonal-border-style

Specifies the style of the reverse diagonal border.

Value:<border-style>
Initial:none
Applies to:all elements which can have borders
Inherited:no
Percentages:N/A

axf:reverse-diagonal-border-width / CSS -ah-reverse-diagonal-border-width

Specifies the width of the reverse diagonal border.

Value:<border-width>
Initial:medium
Applies to:all elements which can have borders
Inherited:yes
Percentages:N/A

Rounded Corners

axf:border-radius
axf:border-top-left-radius / CSS (-ah-)border-top-left-radius
axf:border-top-right-radius / CSS (-ah-)border-top-right-radius
axf:border-bottom-left-radius / CSS (-ah-)border-bottom-left-radius
axf:border-bottom-right-radius / CSS (-ah-)border-bottom-right-radius XSL-FO Samples CollectionBorder extensions for rounded cornersCreating optional spaces around text inside a blockPadding and border in a tableSpecify the border to the regionIntroduction to CSS for Paged Mediaborder-radiusborder-top-left-radiusborder-top-right-radiusborder-bottom-left-radiusborder-bottom-right-radius

Specifies the radii of the rounded corners. [CSS3-Background] Curve Radii: the ‘border-radius’ properties

Border Radius

Value: [<length>|<percentage>] [<length>|<percentage>]? diagonal?
Initial:0
Applies to:all elements which can have borders
Inherited:no
Percentages:border box

The first value is the horizontal radius (or vertical if vertical writing). The second value is the other radius. If the second length is omitted it is equal to the first. If either length is less or equal 0, the corner is square, not rounded. When specifying rounding corners for the table, if border-collapse="collapse" is specified, axf:border-radius is effective only when specified to fo:table.

If diagonal is specified, the diagonal border will be drawn in a straight line without being rounded. V7.4

Rounded corners do not apply to the following border-style.

  • wave

CSS (-ah-)border-radiusXSL-FO Samples CollectionCreating optional spaces around text inside a blockPadding and border in a tableSpecify the border to the regionIntroduction to CSS for Paged Mediaborder-radius

[CSS3-Background] Curve Radii: the ‘border-radius’ properties

The following bold value is extended.

Value: [<length>|<percentage>]{1,4} [ / [<length>|<percentage>]{1,4}]? diagonal?
Initial:0
Applies to:all elements which can have borders
Inherited:no
Percentages:border box

See axf:border-radius for restrictions on border-style.

Box Shadow

axf:box-shadow / CSS (-ah-)box-shadowXSL-FO Samples CollectionBox shadowIntroduction to CSS for Paged Mediabox-shadow

Specifies the box shadow. [CSS3-Background] Drop Shadows: the ‘box-shadow’ property

Value: none | [ inset? && [ <length>{2,4} && <color>? ] ]#
Initial:none
Applies to:all elements which can have borders
Inherited:no
Percentages:N/A

Values have the following meanings:

none

No shadow is displayed.

inset

An inner shadow is displayed.This setting is ignored with Antenna House Formatter V7.4 Lite. no-LT

The meanings of <length>s and a <color> are as follows:

  • The first <length> is an offset of a horizontal shadow. It becomes a right-side shadow of a region when a positive value is specified. It becomes a left-side shadow of a region when a negative value is specified.
  • The second <length> is an offset of a vertical shadow. It becomes a bottom-side shadow of a region when a positive value is specified. It becomes a top-side shadow of a region when a negative value is specified.
  • The 3rd <length> must be a non-negative value and specifies the blur radius. If the value is 0, there is no blur. This setting is ignored with Antenna House Formatter V7.4 Lite. no-LT
  • The 4th <length> extends a shadow. When a positive value is specified, the region will be expanded. When a negative value is specified, the region will be reduced. no-LT
  • The color of the shadow can be specified by <color>.

This combination can be specified multiply and shadows can be added several times over.


Table

<axf:table-cell-repeated-marker> / CSS running(table-cell-repeated-marker) no-LT XSL-FO Samples CollectionContent of a table cell split by a page break

Common Usage:

Specifies the contents to be displayed in the split cell.

Areas:

This element does not generate a region directly.

Constraints:

Available to specify only one as a first child (except for a marker) of fo:table-cell.

Contents:

(#PCDATA | %inline; | %block;)*

When axf:repeat-cell-content-at-break="true" is specified and <axf:table-cell-repeated-marker> is contained in the cell, the contents of <axf:table-cell-repeated-marker> is used instead of the contents of the cell.

In CSS, if you specify the following for an element in a cell, that element will be treated in the same way as <axf:table-cell-repeated-marker>. It does not have to be the first child, but only the first one specified will be adopted.

position: running(table-cell-repeated-marker);

This element is not available with Antenna House Formatter V7.4 Lite.

axf:repeat-cell-content-at-break / CSS -ah-repeat-cell-content-at-break

Specifies whether to copy the contents of a cell when a cell breaks.

Value:true | false
Initial:false
Applies to:fo:table-cell
Inherited:no
Percentages:N/A

Values have the following meanings:

true

When the content of table cell fits in table-cell-area without breaking and table-cell-area breaks according to the break of other table-cell in the same row, or according to the break among the multiple rows with number-rows-spanned, usually the content of table-cell-area becomes empty. When axf:repeat-cell-content-at-break is specified to table-cell, the content of the cell before break is copied and repeated.

false

The content of the cell is not copied.

Specifies whether to repeat the <fo:footnote> in the <fo:table-footer> that is repeated by table-omit-footer-at-break="false".

Value:true | false
Initial:true
Applies to:fo:table-footer
Inherited:yes
Percentages:N/A

Values have the following meanings:

true

Process <fo:footnote> repeatedly.

false

Do not process <fo:footnote> repeatedly.

axf:repeat-footnote-in-table-header

Specifies whether to repeat the <fo:footnote> in the <fo:table-header> that is repeated by table-omit-header-at-break="false".

Value:true | false
Initial:true
Applies to:fo:table-header
Inherited:yes
Percentages:N/A

Values have the following meanings:

true

Process <fo:footnote> repeatedly.

false

Do not process <fo:footnote> repeatedly.

The following bold value is extended.

Value:true | false | column

Values have the following meanings:

column no-LT

Omits footer on column breaks, but not on page breaks.

This property is not extended with Antenna House Formatter V7.4 Lite.

In HTML, <tfoot> can be placed after <tbody> but -ah-table-omit-footer-at-break:true will be forced at that time.

table-omit-header-at-break / CSS -ah-table-omit-header-at-breakXSL-FO Samples CollectionOmitting table header/footer at a column breakOutputting table header and footer repeatedlyIntroduction to CSS for Paged Media-ah-table-omit-header-at-break

The following bold value is extended.

Value:true | false | column

Values have the following meanings:

column no-LT

Omits header on column breaks, but not on page breaks.

This property is not extended with Antenna House Formatter V7.4 Lite.

axf:table-summary / CSS -ah-table-summary

Describes the table summary.

Value:<string>
Initial:empty
Applies to:fo:table
Inherited:no
Percentages:N/A

This is equivalent to <table summary="<string>"> in HTML. It doesn't affect the formatting result. It is outputted with Tagged PDF.

axf:table-row-orphans / CSS -ah-table-row-orphans no-LT XSL-FO Samples Collectiontable-row widows/orphans

Specifies the number of table-rows that must remain at the bottom of the page (column).

Value:<integer>
Initial:1
Applies to:fo:table-body
Inherited:yes
Percentages:N/A

This property is not available with Antenna House Formatter V7.4 Lite.

axf:table-row-widows / CSS -ah-table-row-widows no-LT XSL-FO Samples Collectiontable-row widows/orphans

Specifies the number of table-rows that must remain at the top of the page (column).

Value:<integer>
Initial:1
Applies to:fo:table-body
Inherited:yes
Percentages:N/A

This property is not available with Antenna House Formatter V7.4 Lite.

axf:scope no-LT XSL-FO Samples CollectionAssociating table body cells and table header cells

Specifies the range of cells with which this table header cell is associated.

Value: auto | row | col | rowgroup | colgroup | both
Initial:auto
Applies to:fo:table-cell
Inherited:no
Percentages:N/A

It is the same as the scope attribute in HTML.

axf:headers no-LT XSL-FO Samples CollectionAssociating table body cells and table header cells

Specifies the table header cells associated with this cell.

Value: <idrefs>
Initial:empty
Applies to:fo:table-cell
Inherited:no
Percentages:N/A

It is the same as the headers attribute in HTML.

CSS (-ah-)table-column-span

([CSS3-Tables] table-column-span and table-row-span properties)

Value:<number> | attr(...)
Initial:1
Applies to:table cells
Inherited:no
Percentages:N/A

 [XSL 1.1] number-columns-spanned

CSS (-ah-)table-row-span

([CSS3-Tables] table-column-span and table-row-span properties)

Value:<number> | attr(...)
Initial:1
Applies to:table cells
Inherited:no
Percentages:N/A

 [XSL 1.1] number-rows-spanned

axf:table-auto-layout-limit / CSS (-ah-)table-auto-layout-limit

Specifies the number of rows of fo:table to read ahead to determine the width of column when table-layout="auto" is specified.

Value:auto | <number>
Initial:auto
Applies to:fo:table
Inherited:yes
Percentages:N/A

Values have the following meanings:

auto

Follows the setting of table-auto-layout-limit in the Option Setting File.

<number>

Reads ahead the specified number of rows. When 0 is specified, all rows are read. When a negative value is specified, it is considered auto.

axf:retrieve-table-rows no-LT

Specifies the maximum number of fo:table-row in fo:marker referenced from fo:retrieve-table-marker.

Value:<integer>
Initial:10
Applies to:fo:retrieve-table-marker
Inherited:no
Percentages:N/A

When multiple rows are retrieved, the number of rows may be inconsistent and the rows may overlap or overflow. In such cases, specify the maximum number of lines to avoid it. Values less than 1 are considered 1.

This property is not available with Antenna House Formatter V7.4 Lite.


Images, Multimedia

axf:image-orientation / CSS -ah-image-orientation no-LT

Rotates the image.

Value:from-image | none | [ 0 | 90 | 180 | 270 ] flip?
Initial:from-image
Applies to:fo:external-graphic, fo:instream-foreign-object
Inherited:yes
Percentages:N/A

Values have the following meanings:

from-image

Follows the image information (such as the orientation specified in metadata).

none

Does not rotate the image.

[ 0 | 90 | 180 | 270 ] flip?

Rotates the image by the specified angle. If flip is specified, the rotated image will be flipped horizontally. A numerical value can have a unit, such as "90deg".

This property is not available with Antenna House Formatter V7.4 Lite. It is always considered none.

axf:image-resolution / CSS (-ah-)image-resolution

Specifies the resolution of an image. [CSS3-GCPM] Image resolution (“image-resolution” has been removed from GCPM on and after November 29, 2011)

Value:normal | [ from-image || <dpi> ]
Initial:from-image (XSL) / normal (CSS)
Applies to:fo:external-graphic, fo:instream-foreign-object
Inherited:no
Percentages:N/A

Values have the following meanings:

normal

Depends on the default value of the system. It's the value specified as pxpi in the Option Setting File. Ignores the actual resolution of an image.

from-image

Uses the actual resolution of an image. When an image does not have the resolution, it will follow the <dpi> specification. If nothing is specified, it is the same as normal.

<dpi>

Specifies the resolution (dpi). Ignores the actual resolution of an image.

The resolution of a background image is specified by axf:background-image-resolution. In case of vector images, such as SVG, it is applied to numerical values with no units. from-image is ignored.

You can also use dpcm as a unit to indicate the resolution.

axf:image-smoothing / CSS -ah-image-smoothing

Specifies whether to process anti-aliasing of an image on the screen.

Value:auto | true | false
Initial:auto
Applies to:fo:external-graphic, fo:instream-foreign-object
Inherited:no
Percentages:N/A

Values have the following meanings:

auto

Depends on smoothing settings in GUI.

true

Processes anti-aliasing of an image.

false

Does not process anti-aliasing of an image.

axf:image-preproc / CSS -ah-image-preproc V7.4 no-LT XSL-FO Samples CollectionEmbed Microsoft Office documents using OSDC

Preprocesses the image.

Value:<string>
Initial:empty string
Applies to:fo:external-graphic
Inherited:no
Percentages:N/A

The following can be specified for <string>.

  • OSDC [params]

    The data specified to src for fo:external-graphic is converted to PDF using Office Server Document Converter (hereinafter abbreviated as OSDC), and the PDF is embedded in the document.

    The OSDC to use is determined by searching the OSDC Environment Valuable SBCXX_HOME. Here, the XX part represents a number indicating the version, such as 90. The environment variable to be adopted will be the largest one with XX of 90 or more. The Windows version uses [SBCXX_HOME]\SBCCmd.exe, and the Linux version uses [SBCXX_HOME]/bin/SBCCmd.

    The following parameter can be specified for [params].

    • -pdfver version

      Specifies the PDF version output by OSDC. Values are limited to those that can be specified on the OSDC Command-line. Note that PDF/A cannot be specified. For example, specify -pdfver PDF1.6.

    Enter a space character between the parameter name and its value. If parameters with the same name are specified, the one specified later is effective.

    The default parameter can be specified with osdc-param="[params]" in the Option Setting File. The parameter specified in axf:image-preproc has priority.

    For example,specify as follows:

    <fo:external-graphic src="hello.docx" axf:image-preproc="OSDC -pdfver PDF1.6"/>
    

    Because it is embedded as PDF, you can specify the page like the following:

    <fo:external-graphic src="hello.docx#page=2" axf:image-preproc="OSDC -pdfver PDF1.6"/>
    

This property is not available with Antenna House Formatter V7.4 Lite.

axf:alttext / CSS -ah-alttext / HTML alt no-LT XSL-FO Samples CollectionDisplay the alternate text of an image

Specifies the alternate text of an image or link.

Value:<string>
Initial:empty string
Applies to:fo:external-graphic, fo:instream-foreign-object, fo:basic-link
Inherited:no
Percentages:N/A

Effective when outputting Tagged PDF. See Alternate descriptions are provided.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:display-alttext / CSS -ah-display-alttext no-LT XSL-FO Samples CollectionDisplay the alternate text of an image

Specifies whether to display the alternate text of an image.

Value: false | true | auto
Initial: auto
Applies to:fo:external-graphic, img
Inherited:yes
Percentages:N/A

Values have the following meanings:

false

The alternate text is not displayed.

true

The alternate text is displayed when the alternate text is specified and no image exists.

auto

The value specified by display-alttext in the Option Setting File is adopted.

The alternate text is specified by axf:alttext in XSL-FO and alt in HTML. When the alternate text is displayed, the image is not displayed.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:multimedia-treatment / CSS -ah-multimedia-treatment no-LT XSL-FO Samples CollectionEmbedded and External Multimedia DataRich Media Annotations

Specifies whether to embed Multimedia in PDF.

Value:auto | embed | absolute-link | relative-link | richmedia | richmedia-windowed
Initial:auto
Applies to:fo:external-graphic / multimedia objects
Inherited:yes
Percentages:N/A

Values have the following meanings:

auto

The value specified by multimedia-treatment in the Option Setting File is adopted.

embed

Embeds the multimedia objects in PDF. It is not recommended for PDF 2.0 or later.

absolute-link

Links the multimedia objects in PDF, instead of embedding them. The linked multimedia objects are referred to as the absolute link. It is not recommended for PDF 2.0 or later.

relative-link

Links the multimedia objects in PDF, instead of embedding them. The linked multimedia objects are referred to as the relative link from either XML or FO. It is not recommended for PDF 2.0 or later.

richmedia

Embeds the multimedia as Rich media annotation. Effective with PDF1.7 or later.

richmedia-windowed

Embeds the multimedia as Rich media annotation, but displayed in a separate window when playing. Effective with PDF1.7 or later.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:poster-image / CSS -ah-poster-image no-LT

Specifies the poster image for embedded multimedia.

Value:<uri-specification> | none | auto
Initial:auto
Applies to:fo:external-graphic / multimedia objects
Inherited:no
Percentages:N/A

Values have the following meanings:

<uri-specification>

Specifies the URL of the poster image. Multimedia, such as video or audio, cannot be specified.

none

Specifies no poster images.

auto

Uses the plain fallback image for the poster image.

This property is not available with Antenna House Formatter V7.4 Lite.

See also Multimedia.

axf:poster-content-type / CSS -ah-poster-content-type no-LT

Specifies the content type of the poster image for embedded multimedia.

Value:<string> | auto
Initial:auto
Applies to:fo:external-graphic / multimedia objects
Inherited:no
Percentages:N/A

Values have the following meanings:

<string>

Specifies the content type of the poster image.

auto

Recognizes the content type from the poster image.

This property is not available with Antenna House Formatter V7.4 Lite.

See also Multimedia.

axf:show-controls / CSS -ah-show-controls no-LT

Specifies whether to show the player control bar for multimedia.

Value:true | false
Initial:false
Applies to:fo:external-graphic / multimedia objects
Inherited:no
Percentages:N/A

Values have the following meanings:

true

Shows the player control bar.

false

Does not show the player control bar.

The control bar is shown under the playing multimedia object. To prevent overlapping the control bar with another object, it is necessary to make enough space below the multimedia object.

This property is not available with Antenna House Formatter V7.4 Lite.

See also Multimedia.

axf:media-volume / CSS -ah-media-volume no-LT

Specifies the volume of the sound when playing the multimedia.

Value: <percentage> | <number> | auto
Initial:auto
Applies to:fo:external-graphic / multimedia objects
Inherited:no
Percentages:N/A

This property is not available with Antenna House Formatter V7.4 Lite.

axf:media-play-mode / CSS -ah-media-play-mode no-LT

Specifies the number of times to play the multimedia.

Value: once | continuously | <number>
Initial:once
Applies to:fo:external-graphic / multimedia objects
Inherited:no
Percentages:N/A

Values have the following meanings:

once

Plays the multimedia only one time.

continuously

Plays the multimedia continuously.

<number>

Plays the multimedia only the specified number of times.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:media-duration / CSS -ah-media-duration no-LT

Specifies the duration of a time period of the multimedia.

Value: intrinsic | infinity | <number>
Initial:intrinsic
Applies to:fo:external-graphic / multimedia objects
Inherited:no
Percentages:N/A

Values have the following meanings:

intrinsic

Plays the multimedia only the period of time that the resource has.

infinity

Plays the multimedia indefinitely.

<number>

Plays the multimedia only the specified period of time. The value is the number of seconds.

This setting is invalid when axf:media-play-mode="once" is specified.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:media-extraction-policy / CSS -ah-media-extraction-policy no-LT

Specifies whether the creation of temporary files is allowed or not when playing the multimedia.

Value: tempnever | tempextract | tempaccess | tempalways
Initial:tempaccess
Applies to:fo:external-graphic / multimedia objects
Inherited:no
Percentages:N/A

Values have the following meanings:

tempnever

The creation of temporary files is not allowed.

tempextract

Only when the “copy of the contents” is given to the user right to access PDF, the creation of temporary files is allowed.

tempaccess

Only when the “content extraction for accessibility” is given to the user right to access PDF, the creation of temporary files is allowed.

tempalways

The creation of temporary files is always allowed.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:media-activation / CSS -ah-media-activation no-LT

Specifies when to activate / deactivate the rich media.

Value:[ ExplicitlyActivated | PageOpen | PageVisible ]? [ ExplicitlyDeactivated | PageClose | PageInvisible ]?
Initial:empty
Applies to:fo:external-graphic / multimedia objects
Inherited:no
Percentages:N/A

Values have the following meanings (values are case insensitive, values other than these are ignored):

ExplicitlyActivated

Activates when the content is clicked. It can be abbreviated as XA.

PageOpen

Activates when the page containing the content is opened. It can be abbreviated as PO.

PageVisible

Activates when the page containing the content is displayed. It can be abbreviated as PV.

ExplicitlyDeactivated

Deactivates when “Disable Content” is selected from the context menu. It can be abbreviated as XD.

PageClose

Dectivates when the page containing the content is closed. It can be abbreviated as PC.

PageInvisible

Deactivates when the page containing the content is not displayed. It can be abbreviated as PI.

If omitted, it is considered ExplicitlyActivated ExplicitlyDeactivated. This setting is effective when Rich media is activated.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:media-skin-control / CSS -ah-media-skin-control no-LT

Specifies the skin control of the rich media.

Value: none | all | [ play || stop || forward || rewind || seek || mute || volume ]
Initial:all
Applies to:fo:external-graphic / multimedia objects
Inherited:no
Percentages:N/A

Values have the following meanings:

none

No controls are displayed.

all

All controls are displayed.

play

The playback control is displayed.

stop

The stop control is displayed.

forward

The fast-forward control is displayed.

rewind

The rewind control is displayed.

seek

The seek control is displayed.

mute

The mute control is displayed.

volume

The volume control is displayed.

Other controls may be displayed automatically to display a certain control. This setting is effective when the Rich media is activated.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:media-skin-color / CSS -ah-media-skin-color no-LT

Specifies the skin color of the rich media.

Value: auto | <color>
Initial:auto
Applies to:fo:external-graphic / multimedia objects
Inherited:no
Percentages:N/A

When the color does not contain the α value, the default α value is adopted. When α value is specified, that value is adopted. This setting is effective when the Rich media is activated.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:media-skin-auto-hide / CSS -ah-media-skin-auto-hide no-LT

Specifies whether to automatically hide rich media skins or not.

Value: true | false
Initial:true
Applies to:fo:external-graphic / multimedia objects
Inherited:no
Percentages:N/A

This setting is effective when the Rich media is activated.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:media-window-width / CSS -ah-media-window-width no-LT

Specifies the width of the rich media window.

Value: auto | <length>
Initial:auto
Applies to:fo:external-graphic / multimedia objects
Inherited:no
Percentages:N/A

Specifies the width of the window when axf:multimedia-treatment="richmedia-windowed" is specified. This setting is effective when the Rich media is activated.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:media-window-height / CSS -ah-media-window-height no-LT

Specifies the height of the rich media window.

Value: auto | <length>
Initial:auto
Applies to:fo:external-graphic / multimedia objects
Inherited:no
Percentages:N/A

Specifies the height of the window when axf:multimedia-treatment="richmedia-windowed" is specified. This setting is effective when the Rich media is activated.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:media-flash-vars / CSS -ah-media-flash-vars no-LT

Specifies the variable when embedding Flash in the rich media.

Value:<string>
Initial:empty string
Applies to:fo:external-graphic / multimedia objects
Inherited:no
Percentages:N/A

This setting is effective when embedding Flash in the Rich media.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:media-flash-context-menu / CSS -ah-media-flash-context-menu no-LT

Specifies whether to display the context menu of Flash When embedding Flash in the rich media.

Value: true | false
Initial:false
Applies to:fo:external-graphic / multimedia objects
Inherited:no
Percentages:N/A

This setting is effective when embedding Flash in the Rich media

This property is not available with Antenna House Formatter V7.4 Lite.

axf:media-transparent-background / CSS -ah-media-transparent-background no-LT

Specifies whether to make the background transparent when embedding Flash in the rich media.

Value: true | false
Initial:true
Applies to:fo:external-graphic / multimedia objects
Inherited:no
Percentages:N/A

This setting is effective when embedding Flash in the Rich media.

This property is not available with Antenna House Formatter V7.4 Lite.


Background Extensions

Extended so that multiple background images can be specified.

In FO, Antenna House Formatter V7.4 provides extension properties to set the background of the page. These properties are placed as <fo:simple-page-master> or <fo:page-sequence>. If any one of background-* is specified for <fo:simple-page-master>, the setting of the background to <fo:simple-page-master> is effective, the setting of the background to <fo:page-sequence> is ignored.

background / CSS (-ah-)backgroundIntroduction to CSS for Paged Mediabackground

This property is a shorthand of background-*. [CSS3-Background] Backgrounds Shorthand: the ‘background’ property

Value: [ <bg-layer>, ]* <final-bg-layer>
Initial:see individual properties
Applies to:fo:simple-page-master, fo:page-sequence, all formatting objects
Inherited:no
Percentages:N/A

<bg-layer> = <background-image> || <background-position> [ / <background-size> ]? || <background-repeat> || <background-attachment> || <background-clip> || <background-origin>
<final-bg-layer> = <bg-layer> || <background-color>

background-color / CSS background-colorXSL-FO Samples CollectionCharacter styleSetting a background color to the entire pageTable backgroundsIntroduction to CSS for Paged Mediabackground-color

Value:<color>
Initial:transparent
Applies to:fo:simple-page-master, fo:page-sequence, all formatting objects
Inherited:no
Percentages:N/A

background-image / CSS (-ah-)background-imageXSL-FO Samples CollectionBackground clipBackground image originBackground image sizeExample of watermark using SVGGradientsMultiple background imagesPDF EmbeddingPositioning Background ImagePrinting by merging embedded PDFRepetitions of a background imageSetting an image as the page backgroundIntroduction to CSS for Paged Mediabackground-image

[CSS3-Background] Image Sources: the ‘background-image’ property

Value: [ <uri-specification> | none ]#
Initial:none
Applies to:fo:simple-page-master, fo:page-sequence, all formatting objects
Inherited:no
Percentages:N/A

background-repeat / CSS (-ah-)background-repeatXSL-FO Samples CollectionBackground clipBackground image originMultiple background imagesRepetitions of a background imageIntroduction to CSS for Paged Mediabackground-repeat

The following bold value is extended. [CSS3-Background] Tiling Images: the ‘background-repeat’ property

Value: [ repeat-x | repeat-y | paginate | [repeat | space | round | no-repeat]{1,2} ]#
Initial:repeat
Applies to:fo:simple-page-master, fo:page-sequence, all formatting objects
Inherited:no
Percentages:N/A

Extended values have the following meanings.

paginate no-LT

Effective when embedding PDF in the background image and indicates to embed multiple pages of PDF. For more details, see also PDF Embedding. For other than PDF, it's considered no-repeat. In case of CSS, it's effective when specified to @page.
This value cannot be specified by Antenna House Formatter V7.4 Lite.

background-attachment / CSS (-ah-)background-attachmentIntroduction to CSS for Paged Mediabackground-attachment

[CSS3-Background] Affixing Images: the ‘background-attachment’ property

Value: [ scroll | fixed | local ]#
Initial:scroll
Applies to:fo:simple-page-master, fo:page-sequence, all formatting objects
Inherited:no
Percentages:N/A

background-position / CSS (-ah-)background-positionXSL-FO Samples CollectionBackground image originMultiple background imagesPositioning Background ImageIntroduction to CSS for Paged Mediabackground-position

[CSS3-Background] Positioning Images: the ‘background-position’ property

Value: <bg-position>#
Initial:0%
Applies to:fo:simple-page-master, fo:page-sequence, all formatting objects
Inherited:no
Percentages:refer to the size of the padding-rectangle

<bg-position> = [ [ left | center | right | top | bottom | <percentage> | <length> ] | [ left | center | right | <percentage> | <length> ] [ top | center | bottom | <percentage> | <length> ] | [ center | [ left | right ] [ <percentage> | <length> ]? ] && [ center | [ top | bottom ] [ <percentage> | <length> ]? ] ]

background-position in FO is a shorthand. It is expanded to background-position-horizontal and background-position-vertical.

background-position-horizontal

Value: [ [ left | center | right | <percentage> | <length> ] | [ center | [ left | right ] [ <percentage> | <length> ]? ] ]#
Initial:0%
Applies to:fo:simple-page-master, fo:page-sequence, all formatting objects
Inherited:no
Percentages:refer to the size of the padding-rectangle

background-position-vertical

Value: [ [ top | center | bottom | <percentage> | <length> ] | [ center | [ top | bottom ] [ <percentage> | <length> ]? ] ]#
Initial:0%
Applies to:fo:simple-page-master, fo:page-sequence, all formatting objects
Inherited:no
Percentages:refer to the size of the padding-rectangle

axf:background-clip / CSS (-ah-)background-clipXSL-FO Samples CollectionBackground clipIntroduction to CSS for Paged Mediabackground-clip

[CSS3-Background] Painting Area: the ‘background-clip’ property

Value:[ border-box | padding-box | content-box ]#
Initial:padding-box (XSL) / border-box (CSS)
Applies to: fo:simple-page-master, fo:page-sequence, all formatting objects
Inherited:no
Percentages:N/A

axf:background-origin / CSS (-ah-)background-originXSL-FO Samples CollectionBackground clipBackground image originMultiple background imagesIntroduction to CSS for Paged Mediabackground-origin

[CSS3-Background] Positioning Area: the ‘background-origin’ property

Value:[ border-box | padding-box | content-box ]#
Initial:padding-box
Applies to: fo:simple-page-master, fo:page-sequence, all formatting objects
Inherited:no
Percentages:N/A

axf:background-size / CSS (-ah-)background-sizeXSL-FO Samples CollectionBackground image sizeIntroduction to CSS for Paged Mediabackground-size

[CSS3-Background] Sizing Images: the ‘background-size’ property

Value:[ [ <length> | <percentage> | auto ]{1,2} | cover | contain ]#
Initial:auto
Applies to: fo:simple-page-master, fo:page-sequence, all formatting objects
Inherited:no
Percentages:see text

axf:background-content-type / CSS -ah-background-content-type

Specifies the content type of a background image.

Value: [ <string> | auto ]#
Initial:auto
Applies to: fo:simple-page-master, fo:page-sequence, all formatting objects
Inherited:no
Percentages:N/A

axf:background-image-resolution / CSS -ah-background-image-resolution

Specifies the resolution of a background image.

Value: [ normal | [ from-image || <dpi> ] ]#
Initial:from-image (XSL) / normal (CSS)
Applies to:fo:simple-page-master, fo:page-sequence, all formatting objects
Inherited:no
Percentages:N/A

Values have the following meanings:

normal

Depends on the default value of the system. It's the value specified as pxpi in the Option Setting File. Ignores the actual resolution of an image.

from-image

Uses the actual resolution of an image. When an image does not have the resolution, it will follow the <dpi> specification. If nothing is specified, it is the same as normal.

<dpi>

Specifies the resolution (dpi). Ignores the actual resolution of an image.

The resolution of a non-background image is specified by axf:image-resolution. In case of vector images, such as SVG, it is applied to numerical values with no units. from-image is ignored.

You can also use dpcm as a unit to indicate the resolution.


Overflow Extensions

Antenna House Formatter V7.4 extends the value of the overflow property and provides the extension properties to regulate the behavior of the value. There are also properties that are extended/restricted in order to make the extended value of the overflow property correspond to the overflow-related property, which is not the proprietary extension of Antenna House Formatter V7.4.

overflowXSL-FO Samples CollectionAdjustment when block in fo:inline-container overflowsOverflow examplesOverflow extensionRendering where inline content overflowsSpecifying multiple condensing processes when text overflowsSpecifying whether to justify the last line after condensing the overflow

The following bold values are extended.

Value:visible | hidden | scroll | error-if-overflow | repeat | replace | condense | auto

Values have the following meanings:

replace

The string specified by axf:overflow-replace is repeated in a full area. When the specified string is empty, the string of the area is replaced with an empty string. The original string is discarded.

condense

Condenses the overflowed text within the region. How to condense the text can be specified by axf:overflow-condense.

These values are applied to <fo:block-container> or <fo:inline-container> only. When blocks with overflow="condense" are nested, the inner block is not affected by the outer block. For example, when the inner block is condensed with font-stretch, the inside font-size does not change even if the outer block is condensed with font-size.

axf:overflow-align / CSS -ah-overflow-align

Specifies the alignment of the overflowed block.

Value:normal | start | end | center
Initial:normal
Applies to:block-level formatting objects
Inherited:yes
Percentages:N/A

Values have the following meanings:

normal

Specifies the alignment of the block according to the text-align setting.

start

Specifies the alignment of the block to the start side.

end

Specifies the alignment of the block to the end side.

center

Specifies the block to center aligned.

This setting is invalid when overflow="condense" is specified.

axf:overflow-condense / CSS -ah-overflow-condenseXSL-FO Samples CollectionOverflow extensionSpecifying multiple condensing processes when text overflowsSpecifying whether to justify the last line after condensing the overflow

Specifies how to condense the overflowed text within the region.

Value:[ font-size | font-stretch | line-height | letter-spacing ]+ | auto | none
Initial:auto
Applies to:all block-level formatting objects
Inherited:yes
Percentages:N/A

Values have the following meanings:

font-size

Condenses the text by adjusting the font size.

font-stretch

Condenses the text by adjusting the font width.

line-height

Condenses the text by adjusting the line height. There is no condensing process that makes line-height negative.

letter-spacing

Condenses the text by adjusting the letter spacing.

auto

It is considered font-size for the condensing process in the block, font-stretch for the condensing process in inline.

none

Specifies not to condense the text. This can also be specified to the inline element and is not inherited.

When overflow="condense" is specified, the text within the region can be condensed by the way specified in the axf:overflow-condense property. The adjustment for condensing the text includes both the inline progression direction and the block progression direction. There is a difference in the condensing process between inline and block. Inline condensing process occurs by specifying <fo:inline-container>, and block condensing process occurs by specifying <fo:block-container>.

For example, if there is an absolute value setting such as font-size="20pt" internally, the size setting will not be changed by the condensing process with font-size. The same is true for other font-stretch and line-height.

text-align-last="justify" may be set when the condensing process by font-size or font-stretch in a block occurs. See axf:condensed-text-align-last.

You can specify multiple methods, such as axf:overflow="font-size font-stretch". (none cannot be specified.) In this example, if condensing process by font-size does not resolve the overflow, condensing process by font-stretch will continue to be attempted.

The overflow="condense" setting may be nested, such as when specifying overflow="condense" for horizontal-in-vertical composition in vertical writing mode.

<fo:block-container overflow="condense" axf:overflow-condense="font-stretch">
 <fo:inline-container overflow="condense" axf:overflow-condense="font-stretch">
  ...
 </fo:inline-container>
 ...
</fo:block-container>

In such a case, condensing process occurs in the outer <fo:block-container>, and from its font-stretch, the condensing process occurs in the inner <fo:inline-container>. To ensure that the inner condensing process is not affected by the outer condensing process, specify as follows:

<fo:block-container overflow="condense" axf:overflow-condense="font-stretch">
 <fo:inline axf:overflow-condense="none">
  <fo:inline-container overflow="condense" axf:overflow-condense="font-stretch">
   ...
  </fo:inline-container>
 </fo:inline>
 ...
</fo:block-container>

axf:overflow-condense-limit-font-size / CSS -ah-overflow-condense-limit-font-sizeXSL-FO Samples CollectionSpecifying multiple condensing processes when text overflows

Specifies the lower limit font size when axf:overflow-condense="font-size" is specified.

Value:none | [ <length> [ visible | hidden | error-if-overflow | repeat ]? ]
Initial:none
Applies to:all block-level formatting objects
Inherited:yes
Percentages:N/A

Values have the following meanings:

none

It is considered that 0 is specified.

<length>

Specifies the lower limit font size. A font is not made smaller than that value. If you specify less than 0, it is considered that 0 is specified.

When the content exceeds the limit shown by <length>, the region still overflows. Then a solution can be specified as follows:

axf:overflow-condense-limit-font-size="4pt hidden"

However, it is ignored when the following condensing method is specified in axf:overflow-condense.

axf:overflow-condense-limit-font-stretch / CSS -ah-overflow-condense-limit-font-stretchXSL-FO Samples CollectionSpecifying multiple condensing processes when text overflows

Specifies the lower limit value when axf:overflow-condense="font-stretch" is specified.

Value:none | [ [ <number> | <percentage> ] [ visible | hidden | error-if-overflow | repeat ]? ]
Initial:none
Applies to:all block-level formatting objects
Inherited:yes
Percentages:refer to the font size

Values have the following meanings:

none

It is considered that 0 is specified.

<percentage>

Specifies the percentage against the lower limit font width. A font size is not made smaller than that value. If you specify less than 0, it is considered that 0 is specified.

<number>

Equivalent to (<number> / 100)%.

When the content exceeds the limit shown by <percentage> or <number>, the region still overflows. Then a solution can be specified as follows:

axf:overflow-condense-limit-font-stretch="30% hidden"

However, it is ignored when the following condensing method is specified in axf:overflow-condense.

axf:overflow-condense-limit-line-height / CSS -ah-overflow-condense-limit-line-heightXSL-FO Samples CollectionSpecifying multiple condensing processes when text overflows

Specifies the lower limit value when axf:overflow-condense="line-height" is specified.

Value:none | [ <number> [ visible | hidden | error-if-overflow | repeat ]? ]
Initial:none
Applies to:all block-level formatting objects
Inherited:yes
Percentages:N/A

Values have the following meanings:

none

It is considered that 0 is specified.

<number>

Specifies the lower limit value of line-height. line-height is not made smaller than that value. The value is a percentage against the font size. If you specify less than 0, it is considered that 0 is specified.

When the content exceeds the limit shown by <number>, the region still overflows. Then a solution can be specified as follows:

axf:overflow-condense-limit-line-height="1 hidden"

However, it is ignored when the following condensing method is specified in axf:overflow-condense.

axf:overflow-condense-limit-letter-spacing / CSS -ah-overflow-condense-limit-letter-spacingXSL-FO Samples CollectionSpecifying multiple condensing processes when text overflows

Specifies the lower limit value when axf:overflow-condense="letter-spacing" is specified.

Value:none | [ <length> [ visible | hidden | error-if-overflow | repeat ]? ]
Initial:none
Applies to:all block-level formatting objects
Inherited:yes
Percentages:N/A

Values have the following meanings:

none

It is considered that -1em is specified.

<length>

Specifies the lower limit value of letter-spacing. letter-spacing is not made smaller than that value.

When the content exceeds the limit shown by <length>, the region still overflows. Then a solution can be specified as follows:

axf:overflow-condense-limit-letter-spacing="-0.2em hidden"

However, it is ignored when the following condensing method is specified in axf:overflow-condense.

axf:overflow-replace / CSS -ah-overflow-replaceXSL-FO Samples CollectionOverflow extension

Specifies an alternative character string for the overflowed text.

Value:<string>
Initial:empty string
Applies to:all block-level formatting objects
Inherited:yes
Percentages:N/A

When overflow="replace" is specified, the overflowed text is replaced by repeating the specified string. A complex character string cannot be specified.

axf:overflow-limit / CSS -ah-overflow-limit no-LT

Specifies the overflow limit value.

Value:<length>{1,2}
Initial:depends on system
Applies to:all formatting objects
Inherited:yes
Percentages:N/A

Specifies the overflow limit value with <length>. If a single <length> value is specified, it gives both the inline and block overflow limit values. If two <length> values are specified, the first gives the inline overflow limit value and the second gives the block overflow limit value. Negative values are invalid.

When overflow="error-if-overflow" is specified, overflows greater than the overflow limit value are reported as error level 2 (warning) and smaller overflows are reported as error level 1 (information).

The initial values of the overflow limit can be set by overflow-limit-inline and overflow-limit-block in the Option Setting File.

This property is a shorthand for axf:overflow-limit-inline and axf:overflow-limit-block.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:overflow-limit-inline / CSS -ah-overflow-limit-inline no-LT

Specifies the inline overflow limit value.

Value:<length>
Initial:depends on system
Applies to:all formatting objects
Inherited:yes
Percentages:N/A

Specifies the inline overflow limit value with <length>. Negative values are invalid.

For more details, see axf:overflow-limit.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:overflow-limit-block / CSS -ah-overflow-limit-block no-LT

Specifies the block overflow limit value.

Value:<length>
Initial:depends on system
Applies to:all formatting objects
Inherited:yes
Percentages:N/A

Specifies the block overflow limit value with <length>. Negative values are invalid.

For more details, see axf:overflow-limit.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:text-overflow / CSS (-ah-)text-overflow no-LT XSL-FO Samples CollectionRendering where inline content overflows

Specifies the display method at the end of the content when overflowing in the inline progression direction. [CSS3-UI] Overflow Ellipsis: the ‘text-overflow’ property

Value: clip | ellipsis | <string>
Initial:clip
Applies to:block level elements
Inherited:no
Percentages:N/A

This feature is effective only when overflow="hidden" is specified.

Values have the following meanings:

clip

When overflowing in the inline progression direction, no processing is performed.

ellipsis

When overflowing in the inline progression direction, narrow the display area by the extent of an ellipsis (U+2026), and then insert the ellipsis at the end.

<string>

When overflowing in the inline progression direction, narrow the display area by the extent of the specified string, and then insert the string at the end.

It has no effect on the overflow in the block progression direction.

When overflowing with only the first one character (or an object such as the first image), an ellipsis (abbreviated character string) is not added and it is treated as clip.

If the first one character (or an object such as the first image) does not overflow, but if it overflows when an ellipsis (abbreviated character string) is attached, the ellipsis (abbreviated character string) is also displayed.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:keep-together-within-dimension / CSS -ah-keep-together-within-dimension no-LT XSL-FO Samples CollectionLimiting the height to which keep-together applies

Specifies the upper limit height of the keep-together condition.

Value:all | <length>
Initial:all
Applies to:block level formatting object
Inherited:no
Percentages:N/A

If keep-together.within-page or .within-column or CSS break-inside is not auto, you can specify the height for keep-together to apply to that block. When it is all, the height is not restricted. If you specify a height with <length>, keep-together will be applied to that height, but after that it behaves as if auto was specified for keep-together. For example, if you want to specify keep-together.within-page="always" for a block, but want to break it if it is a block that exceeds the height of the page, specify as follows:

<fo:block keep-together.within-page="always" axf:keep-together-within-dimension="100vh">

This property is not available with Antenna House Formatter V7.4 Lite.

axf:keep-together-within-inline-dimension / CSS -ah-keep-together-within-inline-dimension no-LT

Specifies the upper limit width of the keep-together.within-line condition.

Value:all | <length>
Initial:all
Applies to:block level formatting object
Inherited:no
Percentages:N/A

When keep-together.within-line is not auto, you can specify the width to apply keep-together.within-line to the block. When all is specified, the width is not limited. If you specify a width with <length>, keep-together is applied up to that width, but for a width longer than that, keep-together behaves as if auto is specified.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:condensed-text-align-last / CSS -ah-condensed-text-align-last no-LT XSL-FO Samples CollectionSpecifying whether to justify the last line after condensing the overflow

Specifies whether to set text-align-last="justify" automatically after condensing the overflow.

Value:false | true | justify | auto
Initial:auto
Applies to:all block-level formatting objects
Inherited:yes
Percentages:N/A

Values have the following meanings:

false

Does nothing.

true

Sets text-align-last="justify".

justify

Sets text-align-last="justify" when text-align="justify" is specified. Whether or not text-align="justify" is determined by whether or not the element with the overflow="condense" specified is text-align="justify".

auto

Follows the setting of condensed-text-align-last in the Option Setting File.

This feature is only available when:

  • Condensing in the block progression dimension.
  • font-size or font-stretch condensing is occurring by axf:overflow-condense.
  • text-align-last is not explicitly specified.

This property is not available with Antenna House Formatter V7.4 Lite.

axf:inline-overflow-align / CSS -ah-inline-overflow-align no-LT XSL-FO Samples CollectionAdjustment when block in fo:inline-container overflows

Makes adjustments when the blocks in <fo:inline-container> overflow.

Value:normal | start | end | left | right
Initial:normal
Applies to:fo:inline-container
Inherited:yes
Percentages:N/A

Values have the following meanings:

normal

Does nothing. axf:inline-overflow-align is invalid.

start
end
left
right

Shifts the blocks on the specified side of the reference area that contains <fo:inline-container>.

This property is not available with Antenna House Formatter V7.4 Lite.


Extended Applies

Antenna House Formatter V7.4 has properties and elements whose applicable targets are extended.

<fo:page-sequence>XSL-FO Samples CollectionNested fo:page-sequenceTable across two pages

Nested <fo:page-sequence> no-LT

Extends so that <fo:page-sequence> can be nested and described as a child element of <fo:flow>.

For instance:

<fo:page-sequence><!--A-->
 <elements><!--B-->
 <fo:flow><!--F-->
  <elements><!--C-->
  <fo:page-sequence><!--P-->
  ...
  </fo:page-sequence>
  <elements><!--D-->
 </fo:flow>
</fo:page-sequence>

The structure above is processed as below:

<fo:page-sequence><!--A-->
 <elements><!--B-->
 <fo:flow><!--F-->
  <elements><!--C-->
 </fo:flow>
</fo:page-sequence>
<fo:page-sequence><!--P-->
 ...
</fo:page-sequence>
<fo:page-sequence><!--A-cloned-->
 <elements><!--B-cloned-->
 <fo:flow><!--F-cloned-->
  <elements><!--D-->
 </fo:flow>
</fo:page-sequence>

Note the following:

  • If <elements><!--D--> is not given, <fo:page-sequence><!--A-cloned--> will not be generated; however, <fo:page-sequence><!--A--> will be generated even if <elements><!--C--> is not given.
  • Markers in a different <fo:page-sequence> cannot be referenced. That is, the markers in <elements><!--C--> cannot be referenced in <fo:page-sequence><!--P--> or <fo:page-sequence><!--A-cloned-->. However, the marker immediately after <fo:flow> is duplicated together with <fo:flow>. In other words, the marker immediately after <fo:flow><!--F--> is duplicated immediately after <fo:flow><!--F-cloned-->. So it can be referenced in <fo:page-sequence><!--A-cloned-->.
  • Even if <fo:page-sequence><!--A--> has a setting of Multiple Separate Volume, no separate volumes will occur with <fo:page-sequence><!--A-cloned-->.
  • If an element which contains id is copied, the id will be discarded.
  • This structure cannot be applied to <fo:page-sequence-wrapper>.
  • The nested <fo:page-sequence> will try to read all the FO trees; therefore, note that the memory may reach the limit or similar things may happen if a large <fo:page-sequence> is nested.

Empty <fo:page-sequence> no-LT

<fo:flow> can be omitted. This means that <fo:page-sequence> can be empty.

Contents
(fo:title?,fo:folio-prefix?,fo:folio-suffix?,fo:static-content*,fo:flow*)

When force-page-count in <fo:page-sequence> is other than no-force, <fo:flow> can be omitted. This will allow adjustment of the page number on a certain page. For instance, when the last <fo:page-sequence> is indeterminate and you want to make the total page number even, a blank page can be used to insert <fo:page-sequence> like

<fo:page-sequence
  master-reference="blank"
  force-page-count="document 2"
/>

in the last page of the document.

<fo:change-bar-begin>XSL-FO Samples CollectionChange barText or graphic in change bar

Extends the child element so that <fo:float> can be described as the content of the element. As a result, arbitrary characters can be placed for side marks.  Float Extension no-LT

<fo:change-bar-begin change-bar-class="xxx">
<fo:float float="start">
<fo:block-container width="2.5em" absolute-position="absolute" left="-4em">
<fo:block font-size="12pt">This is a change log.</fo:block>
</fo:block-container>
</fo:float>
</fo:change-bar-begin>

The following properties specified in <fo:float> are adjusted to appropriate values:

  • axf:float-x
  • axf:float-y
  • axf:float-reference
  • axf:float-move

This extension is not available with Antenna House Formatter V7.4 Lite.


Extended Values

Antenna House Formatter V7.4 extends some values of the FO properties. In order to use these values, you have to specify exactly as follows:

axf:overflow="condense"

However, with Antenna House Formatter V7.4, even if axf: is not added, it is made so that it may function similarly. Moreover, the FO standard property and the extended property can be specified simultaneously as follows:

overflow="hidden" axf:overflow="condense"

At this time, the standard property will be overwritten by the extended property and only axf:overflow="condense" becomes effective. That is, it is the same as having overflow="condense" specified. However, in order to avoid the confusion, do not use such specification.

display-align / CSS -ah-display-alignXSL-FO Samples CollectionText aligment in a table cellText alignment in vertical direction

The following bold value is extended.

Value:auto | before | center | after | justify

Values have the following meanings:

justify

Justifies the text to block-progression dimension by adjusting the space between lines.

font-size-adjust / CSS (-ah-)font-size-adjust

The following bold value is extended. [CSS3-Fonts] Relative sizing: the font-size-adjust property

Value:none | <number> | <string>

Values have the following meanings:

<string>

Considers a character string as a font name and acquires the x-height value of the font. When a font does not exist or it does not have x-height information, it is considered none.

font-stretch / CSS (-ah-)font-stretchXSL-FO Samples CollectionFont-stretch

The following bold values are extended. [CSS3-Fonts] Font width: the font-stretch property

Value:normal | wider | narrower | ultra-condensed | extra-condensed | condensed | semi-condensed | semi-expanded | expanded | extra-expanded | ultra-expanded | <percentage> | <number>

Values have the following meanings:

<percentage>

Specifies the percentage against the font width.

<number>

Equivalent to (<number> / 100)%.

font-variant / CSS (-ah-)font-variantXSL-FO Samples CollectionSpecifying Japanese font face variantsIntroduction to CSS for Paged Mediafont-variant

The following bold values are extended. [CSS3-Fonts] Overall shorthand for font rendering: the font-variant property

Value:normal | none | [ <font-variant-caps> || <font-variant-numeric> || <font-variant-alternates> || <font-variant-ligatures> || <font-variant-position> || <font-variant-east-asian> ]

<font-variant-caps> = small-caps | all-small-caps | petite-caps | all-petite-caps | titling-caps | unicase
<font-variant-numeric> = <numeric-figure-values> || <numeric-spacing-values> || <numeric-fraction-values> || ordinal || slashed-zero
<numeric-figure-values> = lining-nums | oldstyle-nums
<numeric-spacing-values> = proportional-nums | tabular-nums
<numeric-fraction-values> = diagonal-fractions | stacked-fractions
<font-variant-alternates> = historical-forms | stylistic(<number>) | swash(<number>) | ornaments(<number>) | annotation(<number>) | styleset(<number>#) | character-variant(<number>#)
<font-variant-ligatures> = <common-lig-values> || <discretionary-lig-values> || <historical-lig-values> || <contextual-alt-values>
<common-lig-values> = common-ligatures | no-common-ligatures
<discretionary-lig-values> = discretionary-ligatures | no-discretionary-ligatures
<historical-lig-values> = historical-ligatures | no-historical-ligatures
<contextual-alt-values> = contextual | no-contextual
<font-variant-position> = sub | super
<font-variant-east-asian> = <east-asian-variant-values> || <east-asian-width-values> || ruby
<east-asian-variant-values> = jis78 | jis83 | jis90 | jis04 | hojo-kanji | nlckanji | simplified | traditional
<east-asian-width-values> = full-width | half-width | third-width | quarter-width | proportional-width

These are achieved by using the GSUB feature of OpenType fonts. small-caps and all-small-caps are emulated to the fonts which don't have the GSUB feature. The other is disregarded.

formatXSL-FO Samples CollectionPage number format and initial page number

The format tokens for the format property supports the format tokens defined in the XSLT 1.0 Recommendation and some extensions. axf:column-number-format is also the same.

  • The style that can be specified with list-style-type can be specified here. no-LT

  • Numerals

    Regular decimal representation of the numbers is generated. The minimum number of figures can be specified as 01, 001, etc. The following numbers can be specified as a format token.

    Format TokenDigitsDescription
    10
    U+0031U+0030 0 1 2 3 4 5 6 7 8 9DIGIT
    U+00B9U+2070 ⁰ ¹ ² ³ ⁴ ⁵ ⁶ ⁷ ⁸ ⁹SUPERSCRIPT DIGIT
    U+0661U+0660 ‭٠ ١ ٢ ٣ ٤ ٥ ٦ ٧ ٨ ٩ARABIC-INDIC DIGIT
    U+06F1U+06F0 ‭۰ ۱ ۲ ۳ ۴ ۵ ۶ ۷ ۸ ۹EXTENDED ARABIC-INDIC DIGIT
    U+0967U+0966 ० १ २ ३ ४ ५ ६ ७ ८ ९DEVANAGARI DIGIT
    U+09E7U+09E6 ০ ১ ২ ৩ ৪ ৫ ৬ ৭ ৮ ৯BENGALI DIGIT
    U+0A67U+0A66 ੦ ੧ ੨ ੩ ੪ ੫ ੬ ੭ ੮ ੯GURMUKHI DIGIT
    U+0AE7U+0AE6 ૦ ૧ ૨ ૩ ૪ ૫ ૬ ૭ ૮ ૯GUJARATI DIGIT
    U+0B67U+0B66 ୦ ୧ ୨ ୩ ୪ ୫ ୬ ୭ ୮ ୯ORIYA DIGIT
    U+0BE7U+0BE6 ௦ ௧ ௨ ௩ ௪ ௫ ௬ ௭ ௮ ௯TAMIL DIGIT
    U+0C67U+0C66 ౦ ౧ ౨ ౩ ౪ ౫ ౬ ౭ ౮ ౯TELUGU DIGIT
    U+0CE7U+0CE6 ೦ ೧ ೨ ೩ ೪ ೫ ೬ ೭ ೮ ೯KANNADA DIGIT
    U+0D67U+0D66 ൦ ൧ ൨ ൩ ൪ ൫ ൬ ൭ ൮ ൯MALAYALAM DIGIT
    U+0E51U+0E50 ๐ ๑ ๒ ๓ ๔ ๕ ๖ ๗ ๘ ๙THAI DIGIT
    U+0ED1U+0ED0 ໐ ໑ ໒ ໓ ໔ ໕ ໖ ໗ ໘ ໙LAO DIGIT
    U+1041U+1040 ၀ ၁ ၂ ၃ ၄ ၅ ၆ ၇ ၈ ၉MYANMAR DIGIT
    U+17E1U+17E0 ០ ១ ២ ៣ ៤ ៥ ៦ ៧ ៨ ៩KHMER DIGIT
    U+4E00U+3007 〇 一 二 三 四 五 六 七 八 九CJK IDEOGRAPH DIGIT
    U+C77CU+C601 영 일 이 삼 사 오 육 칠 팔 구HANGUL DIGIT
    U+FF11U+FF10 0 1 2 3 4 5 6 7 8 9FULLWIDTH DIGIT

  • Roman Numerals

    Regular expressions of Roman numeral, such as I II III IV V VI VII VIII IX X ..., is generated.

    Format TokenNumeralsDescription
    U+0049 (I) I V X L C D M ↁ ↂ LATIN CAPITAL LETTER I
    U+0069 (i) i v x l c d mLATIN SMALL LETTER I
    U+2160 () Ⅰ Ⅴ Ⅹ Ⅼ Ⅽ Ⅾ Ⅿ ↁ ↂ ROMAN NUMERAL ONE
    U+2170 () ⅰ ⅴ ⅹ ⅼ ⅽ ⅾ ⅿ SMALL ROMAN NUMERAL ONE
    U+FF29 () I V X L C D M ↁ ↂ FULLWIDTH LATIN CAPITAL LETTER I
    U+FF49 () i v x l c d m FULLWIDTH LATIN SMALL LETTER I

    Numerical values with upper case up to 39999 and numerical values with lower case up to 3999 can be expressed.

  • Hebrew Numerals

    Regular expressions of Hebrew numeral, such as ‭ א ב ג ד ה ... י אי בי גי די וט ..., is generated.

    Format TokenNumeralsDescription
    U+05D0 (א)‭ א ב ג ד ה ו ז ח ט י כ ל מ נ ס ע פ צ ק ר ש ת ך ם ן ף ץ HEBREW LETTER ALEF

    The specification of the grouping-separator and grouping-size properties are ignored and always considered grouping-separator=" " grouping-size="3". The way of the conversion is different from when format="hebrew" is specified.

  • Armenian Numerals

    Formats Armenian numerals. It's available to express up to 99999999.

    Format TokenNumeralsDescription
    U+0531 (Ա) Ա Բ Գ Դ Ե Զ Է Ը Թ Ժ Ի Լ Խ Ծ Կ Հ Ձ Ղ Ճ Մ Յ Ն Շ Ո Չ Պ Ջ Ռ Ս Վ Տ Ր Ց Ւ Փ Ք ARMENIAN CAPITAL LETTER AYB
    U+0561 (ա) ա բ գ դ ե զ է ը թ ժ ի լ խ ծ կ հ ձ ղ ճ մ յ ն շ ո չ պ ջ ռ ս վ տ ր ց ւ փ ք ARMENIAN SMALL LETTER AYB

  • Georgian Numerals

    Formats Georgian numerals. It's available to express up to 19999.

    Format TokenNumeralsDescription
    U+10D0 () ა ბ გ დ ე ვ ზ ჱ თ ი კ ლ მ ნ ჲ ო პ ჟ რ ს ტ უ ფ ქ ღ ყ შ ჩ ც ძ წ ჭ ხ ჴ ჯ ჰ ჵ GEORGIAN LETTER AN

  • Alphabets

    Regular expressions of alphabets sequence, such as A B C ... Z AA AB AC ..., is generated.

    Format TokenAlphabetsDescription
    U+0041 (A) A B C D E F G H I J K L M N O P Q R S T U V W X Y ZLATIN CAPITAL LETTER A
    U+0061 (a) a b c d e f g h i j k l m n o p q r s t u v w x y zLATIN SMALL LETTER A
    U+00C5 (Å) A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Æ Ø ÅLATIN CAPITAL LETTER A WITH RING ABOVE
    U+00E5 (å) a b c d e f g h i j k l m n o p q r s t u v w x y z æ ø åLATIN SMALL LETTER A WITH RING ABOVE
    U+0391 (Α) Α Β Γ Δ Ε Ζ Η Θ Ι Κ Λ Μ Ν Ξ Ο Π Ρ Σ Τ Υ Φ Χ Ψ Ω GREEK CAPITAL LETTER ALPHA
    U+03B1 (α) α β γ δ ε ζ η θ ι κ λ μ ν ξ ο π ρ σ τ υ φ χ ψ ω GREEK SMALL LETTER ALPHA
    U+0410 (А) А Б В Г Д Е Ж З И К Л М Н О П Р С Т У Ф Х Ц Ч Ш Щ Ы Э Ю Я CYRILLIC CAPITAL LETTER A
    U+0430 (а) а б в г д е ж з и к л м н о п р с т у ф х ц ч ш щ ы э ю я CYRILLIC SMALL LETTER A
    U+0623 (أ)‭ أ ب ت ث ج ح خ د ذ ر ز س ش ص ض ط ظ ع غ ف ق ك ل م ن ه و ي ARABIC LETTER ALEF WITH HAMZA ABOVE
    U+3042 () あ い う え お か き く け こ さ し す せ そ た ち つ て と な に ぬ ね の は ひ ふ へ ほ ま み む め も や ゆ よ ら り る れ ろ わ を ん HIRAGANA AIUEO
    U+3044 () い ろ は に ほ へ と ち り ぬ る を わ か よ た れ そ つ ね な ら む う ゐ の お く や ま け ふ こ え て あ さ き ゆ め み し ゑ ひ も せ す HIRAGANA IROHA
    U+30A2 () ア イ ウ エ オ カ キ ク ケ コ サ シ ス セ ソ タ チ ツ テ ト ナ ニ ヌ ネ ノ ハ ヒ フ ヘ ホ マ ミ ム メ モ ヤ ユ ヨ ラ リ ル レ ロ ワ ヲ ン KATAKANA AIUEO
    U+30A4 () イ ロ ハ ニ ホ ヘ ト チ リ ヌ ル ヲ ワ カ ヨ タ レ ソ ツ ネ ナ ラ ム ウ ヰ ノ オ ク ヤ マ ケ フ コ エ テ ア サ キ ユ メ ミ シ ヱ ヒ モ セ ス KATAKANA IROHA
    U+3131 () ㄱ ㄴ ㄷ ㄹ ㅁ ㅂ ㅅ ㅇ ㅈ ㅊ ㅋ ㅌ ㅍ ㅎ HANGUL CHOSUNG
    U+5B50 () 子 丑 寅 卯 辰 巳 午 未 申 酉 戌 亥 CHINESE ZODIAC 12
    U+7532 () 甲 乙 丙 丁 戊 己 庚 辛 壬 癸 CHINESE ZODIAC 10
    U+AC00 () 가 나 다 라 마 바 사 아 자 차 카 타 파 하 HANGUL GANADA
    U+FF21 () A B C D E F G H I J K L M N O P Q R S T U V W X Y Z FULLWIDTH LATIN CAPITAL LETTER A
    U+FF41 () a b c d e f g h i j k l m n o p q r s t u v w x y z FULLWIDTH LATIN SMALL LETTER A
    U+FF71 () ア イ ウ エ オ カ キ ク ケ コ サ シ ス セ ソ タ チ ツ テ ト ナ ニ ヌ ネ ノ ハ ヒ フ ヘ ホ マ ミ ム メ モ ヤ ユ ヨ ラ リ ル レ ロ ワ ヲ ン HALFWIDTH KATAKANA AIUEO
    U+FF72 () イ ロ ハ ニ ホ ヘ ト チ リ ヌ ル ヲ ワ カ ヨ タ レ ソ ツ ネ ナ ラ ム ウ ノ オ ク ヤ マ ケ フ コ エ テ ア サ キ ユ メ ミ シ ヒ モ セ ス HALFWIDTH KATAKANA IROHA

  • Non-repeating
    Format TokenCharactersDescription
    U+2460 () ⓪ ① ② ③ ④ ⑤ ⑥ ⑦ ⑧ ⑨ ⑩ ⑪ ⑫ ⑬ ⑭ ⑮ ⑯ ⑰ ⑱ ⑲ ⑳ CIRCLED DIGIT ONE
    0 to 20 can be expressed.
    U+2474 () ⑴ ⑵ ⑶ ⑷ ⑸ ⑹ ⑺ ⑻ ⑼ ⑽ ⑾ ⑿ ⒀ ⒁ ⒂ ⒃ ⒄ ⒅ ⒆ ⒇ PARENTHESIZED DIGIT ONE
    1 to 20 can be expressed.
    U+2488 () ⒈ ⒉ ⒊ ⒋ ⒌ ⒍ ⒎ ⒏ ⒐ ⒑ ⒒ ⒓ ⒔ ⒕ ⒖ ⒗ ⒘ ⒙ ⒚ ⒛ DIGIT ONE FULL STOP
    1 to 20 can be expressed.
    U+249C () ⒜ ⒝ ⒞ ⒟ ⒠ ⒡ ⒢ ⒣ ⒤ ⒥ ⒦ ⒧ ⒨ ⒩ ⒪ ⒫ ⒬ ⒭ ⒮ ⒯ ⒰ ⒱ ⒲ ⒳ ⒴ ⒵ PARENTHESIZED LATIN SMALL LETTER A
    1 to 26 can be expressed.
    U+24B6 () Ⓐ Ⓑ Ⓒ Ⓓ Ⓔ Ⓕ Ⓖ Ⓗ Ⓘ Ⓙ Ⓚ Ⓛ Ⓜ Ⓝ Ⓞ Ⓟ Ⓠ Ⓡ Ⓢ Ⓣ Ⓤ Ⓥ Ⓦ Ⓧ Ⓨ Ⓩ CIRCLED LATIN CAPITAL LETTER A
    1 to 26 can be expressed.
    U+24D0 () ⓐ ⓑ ⓒ ⓓ ⓔ ⓕ ⓖ ⓗ ⓘ ⓙ ⓚ ⓛ ⓜ ⓝ ⓞ ⓟ ⓠ ⓡ ⓢ ⓣ ⓤ ⓥ ⓦ ⓧ ⓨ ⓩ CIRCLED LATIN SMALL LETTER A
    1 to 26 can be expressed.
    U+24EB () ⓫ ⓬ ⓭ ⓮ ⓯ ⓰ ⓱ ⓲ ⓳ ⓴ NEGATIVE CIRCLED NUMBER ELEVEN
    11 to 20 can be expressed.
    U+24F5 () ⓵ ⓶ ⓷ ⓸ ⓹ ⓺ ⓻ ⓼ ⓽ ⓾ DOUBLE CIRCLED DIGIT ONE
    1 to 10 can be expressed.
    U+7532 U+5B50 (甲子) 甲子 乙丑 丙寅 丁卯 戊辰 己巳 庚午 辛未 壬申 癸酉 甲戍 乙亥 丙子 丁丑 戊寅 己卯 庚辰 辛巳 壬午 癸未 甲申 乙酉 丙戍 丁亥 戊子 己丑 庚寅 辛卯 壬辰 癸巳 甲午 乙未 丙申 丁酉 戊戍 己亥 庚子 辛丑 壬寅 癸卯 甲辰 乙巳 丙午 丁未 戊申 己酉 庚戍 辛亥 壬子 癸丑 甲寅 乙卯 丙辰 丁巳 戊午 己未 庚申 辛酉 壬戍 癸亥 CHINESE ZODIAC 60
    1 to 60 can be expressed.

  • The strings which consist of the same character with 2 or more altogether

    For example, when format="**" is specified, “*” is repeated by the number of numerical values. Up to 999 can be expressed.

  • The symbols of all different character with 2 or more altogether

    For example, if format="*†‡" is specified, the following regular expressions will be generated:

    1. *
    2. **
    3. ††
    4. ‡‡
    5. ***
    6. †††
    7. ‡‡‡
    8. ...

    Up to 999 can be expressed.

  • The character string which does not include symbols, with all different 2 or more characters altogether

    For example, character strings such as "上中下", which means the sequence of “first, second and third classes, etc.”, is considered a format token and generates the sequence of the following regular expressions.

    1. 上上
    2. 上中
    3. 上下
    4. 中上
    5. ...

internal-destination / CSS -ah-internal-destination

The following bold value is extended. no-LT

Value: <idref> | <number-with-fragment> | <named-action>

Values have the following meanings:

<number-with-fragment>

Effective with the internal link in PDF and indicates the page number of the link destination. This string is simple numeric characters (<number>) or the following string that combines numeric characters and a fragment with “#”. See Making Link for fragment.

123#zoom=50

The page number also can be specified in the fragment.

#page=123&zoom=50

When the page number is not specified, it is usually considered the 1st page. However, when the top position is specified, it is considered the head of the page of a block where internal-destination is contained. For example, it is specified as follows:

#view=fit
#view=fith
#zoom=,,0
<named-action>

Effective with the internal link in PDF and specifies the PDF Named Action. For example, the following settings are available. Since the specified value is not checked, you can specify arbitrary such as Print or GoBack, but whether it works or not depends on the PDF viewer.

#named=NextPage
#named=PrevPage
#named=FirstPage
#named=LastPage

Complex settings in CSS must be specified by character strings.

-ah-internal-destination: '#page=123&zoom=50';

This property is not extended with Antenna House Formatter V7.4 Lite.

CSS (-ah-)displayIntroduction to CSS for Paged Mediadisplay

The following bold values are extended. Values with strikethrough are not supported. [CSS3-Box] The ‘display’ property

Value: inline | block | inline-block | list-item | run-in | compact | table | inline-table | table-row-group | table-header-group | table-footer-group | table-row | table-column-group | table-column | table-cell | table-caption | ruby | ruby-base | ruby-text | ruby-base-group | ruby-text-group | <template> | flex V7.4 no-LT | inline-flex V7.4 no-LT | grid V7.4 no-LT | inline-grid V7.4 no-LT | (-ah-)bidi-override | (-ah-)meta | none

Values have the following meanings:

(-ah-)bidi-override

Equivalent to the <bdo> element in HTML.

(-ah-)meta

It is treated as an element representing the document information. Equivalent to the <meta> element in HTML. See also Document Information for PDF Output.
It can be specified for any XML that is not HTML, but it must be before the first page content. The content of the element is discarded.

It cannot be specified for the root element. The following HTML elements are fixed to display:none.

  • <head>
  • <title>
  • <base>
  • <link>
  • <style>
  • <script>

The following HTML elements are fixed to display:-ah-meta.

  • <meta>

In HTML, these display cannot be changed.


Extended Functions

Antenna House Formatter V7.4 extends some FO functions and CSS functions.

rgb-icc()XSL-FO Samples CollectionCMYK color with rgb-icc() and cmyk()Grayscale rendering with rgb-icc()PANTONE® spot colors with rgb-icc()Introduction to CSS for Paged Mediargb-icc()

The format of the argument which the rgb-icc function can accept is as follows:

  • rgb-icc(#Grayscale,<Scale>)

    Specifies Grayscale. The depth in color can be specified by <Scale>.

  • rgb-icc(<R>,<G>,<B>,#CMYK,<C>,<M>,<Y>,<K>)
  • rgb-icc(#CMYK,<C>,<M>,<Y>,<K>)

    Specifies CMYK. When RGB is omitted, it is calculated from CMYK.

  • rgb-icc(<R>,<G>,<B>,#Separation,<Name>,<Tint>,<C>,<M>,<Y>,<K>) no-LT
  • rgb-icc(<R>,<G>,<B>,#Separation,<Name>,<Tint>) no-LT
  • rgb-icc(<R>,<G>,<B>,#Separation,<Name>) no-LT
  • rgb-icc(#Separation,<Name>,<Tint>,<C>,<M>,<Y>,<K>) no-LT

    Specifies Separation color (Spot color). The name of the ink in use is specified as <Name>. For example, specify “PANTONE 131 PC”. The color tone is specified as <Tint>. When <Tint> is omitted, it is considered 1.0. It is also necessary to specify RGB or CMYK. When RGB is omitted, it is calculated from CMYK.

  • rgb-icc(#Separation,<Name>,<Tint>) no-LT
  • rgb-icc(#Separation,<Name>) no-LT

    If you purchase Antenna House Formatter PANTONE® OptionXSL-FO Samples CollectionPANTONE® spot colors with rgb-icc(), it includes the ability for more than 1,000 PANTONE® Colors to be converted into RGB or CMYK values automatically. This is specified in the FO as follows:

    rgb-icc(#Separation, 'PANTONE 131 PC')

  • rgb-icc(#Registration,<Tint>) no-LT
  • rgb-icc(#Registration) no-LT

    Specifies Registration color. The color tone is specified as <Tint>. When <Tint> is omitted, it is considered 1.0. Registration color is used for the registered trademark outputted to all the color versions. Registration color can also be expressed by specifying “All” as the <Name> of #Separation.

An identifier beginning with “#” is case insensitive. Formats using identifiers which begins with “#” are extended specifications in Antenna House Formatter V7.4. The specified RGB is an alternative color. It is used when the devices (display etc.) cannot display CMYK or the separation color directly. Arguments take the following values, respectively.

  • <R>,<G>,<B> = % value or 0 to 255 integer value
  • <C>,<M>,<Y>,<K> = % value or 0.0 to 1.0 float value
  • <Scale> = % value or 0.0 (black) to 1.0 (white) float value
  • <Tint> = % value or 0.0 (lightest) to 1.0 (darkest) float value

linear-gradient()

Expresses the linear gradient. It can be specified as a value of background-image. no-LT

linear-gradient( [ [ <angle> | to <side-or-corner> ], ]? <color-stop>#{2,} )
<side-or-corner> = [ left | right ] || [ top | bottom ]
<color-stop> = <color> [ <percentage> | <length> ]?

Arguments have the following meanings.

<angle>

Specifies the angle of the gradient. 0deg indicates top, 90deg indicates right.

<side-or-corner>

Specifies the angle of the gradient by keywords. to top, to right, to bottom and to left indicate 0deg, 90deg, 180deg and 270deg for each.

<color-stop>

Specifies the <color> that indicates the color assignment on the gradient, and optionally the stop position for that <color>. The stop position is specified at the <percentage> or <length> position along the gradient's axis. The first <color-stop> is called the start point, the last <color-stop> is called the end point, and the <color-stop> in between is called the transition. If the stop position is not specified, it will be the midpoint between the point immediately before and the point immediately after. The gradient is drawn from the start point to the end point towards the color assigned at each transition.

 [CSS3-Images] Linear Gradients: the ‘linear-gradient()’ notation

This function is not available with Antenna House Formatter V7.4 Lite.

radial-gradient()

Expresses the radial gradient. It can be specified as a value of background-image. no-LT

radial-gradient( [ [ <shape> || <size> ] [ at <position> ]? , | at <position>, ]? <color-stop>#{2,} )
<shape> = circle | ellipse
<size> = closest-side | farthest-side | closest-corner | farthest-corner | [ <length> | [ <length> | <percentage> ]{2} ]
<color-stop> = <color> [ <percentage> | <length> ]?

Arguments have the following meanings.

<shape>

Specifies the shape of the gradient.

<size>

Specifies the size of the gradient.

<position>

Specifies the center position of a circle or an oval. The value is the same as that of the background-position in CSS 2.1.

<color-stop>

Specifies the <color> that indicates the color assignment on the gradient, and optionally the stop position of that <color>. See linear-gradient () for more information on <color-stop>.

 [CSS3-Images] Radial Gradients: the ‘radial-gradient()’ notation

This function is not available with Antenna House Formatter V7.4 Lite.

repeating-linear-gradient()

Expresses the repeating linear gradient. It can be specified as a value of background-image. The syntax is the same as that of linear-gradient(). no-LT

 [CSS3-Images] Repeating Gradients: the ‘repeating-linear-gradient()’ and ‘repeating-radial-gradient()’ notations

This function is not available with Antenna House Formatter V7.4 Lite.

repeating-radial-gradient()

Expresses the repeating radial gradient. It can be specified as a value of background-image. The syntax is the same as that of radial-gradient(). no-LT

 [CSS3-Images] Repeating Gradients: the ‘repeating-linear-gradient()’ and ‘repeating-radial-gradient()’ notations

This function is not available with Antenna House Formatter V7.4 Lite.

CSS counter()Introduction to CSS for Paged Mediacounter()

The first argument of the counter function in CSS is extended as follows:

counter( <ident> [physical || reverse]?, <list-style-type>? )

Although any counter name can be specified to <ident>, there are some counter names defined already. Counters with these same names cannot be defined.

physical and reverse can be specified when <ident> is page. These extensions are not available with Antenna House Formatter V7.4 Lite.

See also list-style-type to learn more about <list-style-type>.

CSS attr()

[CSS3-Values] Attribute References: ‘attr()’

attr( <attr-name> <type-or-unit>? [ , <fallback> ]? )

The following can be specified for <type-or-unit>:

  • string
  • name
  • color
  • url
  • integer
  • number
  • length, angle, time, frequency
  • %
  • Units that can be specified with Antenna House Formatter V7.4

<fallback> is adopted when the property indicated by <attr-name> is not specified. When something is specified, <fallback> is not adopted even if it is an incorrect value.

For shorthands with complicated syntax such as font or border, shorthand expansion is not possible unless the type of each part is determined. For example, border has the syntax of <border-width> || <border-style> || <border-color> and the order is indefinite. For example, you can write as follows:

border: #FF0000 solid 10pt;

You can associate <border-width> with length and <border-color> with color. A type-specific function like rgb-icc() would be fine, but the type of att() cannot be identified. So, specify <type-or-unit> explicitly as follows:

border: attr(w length) attr(s name) attr(c color);

Then, it seems that you can judge which one corresponds to which one. However, the correspondence may be determined by the value as shown below:

border: red solid 10pt;

In such a case, it cannot be determined by the type alone. Also, most properties only accept specific names, so accurate correspondence is not possible with this alone. In such a case, you can associate it by specifying <fallback> as follows:

border: attr(w length) attr(s, solid) attr(c color);

The correspondence is done using the <fallback>, if it exists. If not, it is done using the representative value of <type-or-unit>. If the correspondence is not possible and the shorthand expansion is not possible, the property will result in an error.

CSS -ah-attr-img()

It is prepared for referencing the width/height of the image such as <img>. When the element is other than the image, when other than width/height is specified to <attr-name>, and when fix-css-img-percentage="false" is specified in the Option Setting File, it is the same as attr(). For details, see Changes from Antenna House Formatter V7.0 .

-ah-attr-img( <attr-name> <type-or-unit>? [ , <fallback> ]? )

CSS -ah-attr-from()

It is an extension of attr function. Specify the element of the ancestor which applies attr() to the first parameter.

-ah-attr-from( <from-name> , <attr-name> <type-or-unit>? [ , <fallback> ]? )


CSS Pseudo Element Extensions

Some CSS pseudo elements are extended.

CSS ::before(n) / ::after(n) V7.4 no-LT

[oXygen] Using the :before(n) and :after(n) CSS Pseudo-Elements

It is extended so that multiple ::before can be specified for one element, like ::before(2). ::before(2) and ::before(3) are considered different selectors. ::before without arguments is equivalent to ::before(1) and you can specify an integer greater than or equal to 1 for the argument. Smaller numbers are placed closest to the element and higher numbers are placed farther away. The same applies for ::after. Antenna House Formatter V7.4 Lite ignores all selectors that specify 2 or more parameters.


CSS3 Properties

This section enumerates the properties based on CSS3 specification supported with Antenna House Formatter V7.4 which have not been described until now.

CSS (-ah-)alignment-adjust

[CSS3-Line] Setting the alignment point: the 'alignment-adjust' property

Value:auto | baseline | before-edge | text-before-edge | middle | central | after-edge | text-after-edge | ideographic | alphabetic | hanging | mathematical | <percentage> | <length>
Initial:auto
Applies to:inline-level elements
Inherited:no
Percentages:refer to the line-height of element

 [XSL 1.1] alignment-adjust

CSS (-ah-)alignment-baseline

[CSS3-Line] Aligning the alignment point of an element: the 'alignment-baseline' property

Value:auto | baseline | before-edge | text-before-edge | middle | central | after-edge | text-after-edge | ideographic | alphabetic | hanging | mathematical
Initial:auto
Applies to:inline-level elements
Inherited:no
Percentages:N/A

 [XSL 1.1] alignment-baseline

CSS (-ah-)baseline-shiftXSL-FO Samples CollectionCharacter style

[CSS3-Line] Repositioning the dominant baseline: the 'baseline-shift' property

Value:baseline | sub | super | <percentage> | <length>
Initial:baseline
Applies to:inline-level elements
Inherited:no
Percentages:refer to the line-height of parent element

 [XSL 1.1] baseline-shift

CSS (-ah-)bookmark-labelIntroduction to CSS for Paged Mediabookmark-label

[CSS3-GCPM] bookmark-label

Value:content | <attr> | <string>
Initial:content
Applies to:all elements
Inherited:no
Percentages:N/A

 axf:outline-title

CSS (-ah-)bookmark-levelIntroduction to CSS for Paged Mediabookmark-level

[CSS3-GCPM] bookmark-level

Value:none | <integer>
Initial:none
Applies to:all elements
Inherited:no
Percentages:N/A

 axf:outline-level

CSS (-ah-)bookmark-stateIntroduction to CSS for Paged Mediabookmark-state

[CSS3-GCPM] bookmark-state

Value:open | closed
Initial:open
Applies to:block-level elements
Inherited:no
Percentages:N/A

 axf:outline-expand

CSS (-ah-)box-sizingIntroduction to CSS for Paged Mediabox-sizing

[CSS3-UI] 'box-sizing' property

Value:content-box | border-box
Initial:content-box
Applies to:all elements that accept width or height
Inherited:no
Percentages:N/A

CSS (-ah-)break-insideIntroduction to CSS for Paged Mediabreak-inside

[CSS3-Multicol] ‘break-before’, ‘break-after’, ‘break-inside’

Value:auto | avoid | avoid-page | avoid-column
Initial:auto
Applies to:block-level elements
Inherited:no
Percentages:N/A

 [XSL 1.1] keep-together

CSS (-ah-)counter-set

[CSS3-List] Manipulating Counters: the counter-increment, counter-set and counter-reset properties

Value:[ <custom-ident> <integer>? ]+ | none
Initial:none
Applies to:all elements
Inherited:no
Percentages:N/A

CSS (-ah-)dominant-baseline

[CSS3-Line] Dominant baseline: the 'dominant-baseline' property

Value:auto | use-script | no-change | reset-size | ideographic | alphabetic | hanging | mathematical | central | middle | text-after-edge | text-before-edge
Initial:auto
Applies to:inline-level elements
Inherited:no
Percentages:N/A

 [XSL 1.1] dominant-baseline

CSS (-ah-)object-fit no-LT

[CSS3-Images] 'object-fit' property

Value: fill | contain | cover | none | scale-down
Initial:fill
Applies to:replaced elements
Inherited:no
Percentages:N/A

This property is not available with Antenna House Formatter V7.4 Lite.

CSS (-ah-)object-position no-LT

[CSS3-Images] 'object-position' property

Value:[<percentage> | <length> | left | center | right | top | bottom]{1,2}
Initial:center center
Applies to:replaced elements
Inherited:no
Percentages:refer to the width and the height of box itself

This property is not available with Antenna House Formatter V7.4 Lite.

CSS (-ah-)pageIntroduction to CSS for Paged Mediapage

[CSS3-Page] Using named pages: ‘page’
[CSS3-GCPM] Named page lists (“Named page lists” has been removed from GCPM on and after June 8, 2010)

Value:auto | <identifier>+ auto?
Initial:auto
Applies to:block-level elements
Inherited:no
Percentages:N/A

CSS (-ah-)string-setIntroduction to CSS for Paged Mediastring-set

[CSS3-GCPM] Setting named strings: the ‘string-set’ property

Value:[ <identifier> <content-list> ]# | none
Initial:none
Applies to:all elements
Inherited:no
Percentages:N/A

env() is not supported yet.

The string-set sets the named strings for running headers.

 [CSS3-GCPM] Named strings

To make the element with structure, not only the text, into running headers, use the running elements.

 [CSS3-GCPM] Running elements

CSS (-ah-)text-alignXSL-FO Samples CollectionTable alignmentText alignment in the blockIntroduction to CSS for Paged Mediatext-align

[CSS 2.1] 16.2 Alignment
[CSS3-Text] Text Alignment: the ‘text-align’ shorthand

Value:start | end | left | right | inside | outside | center | justify | <string>
Initial:start
Applies to:all elements
Inherited:yes
Percentages:N/A

 [XSL 1.1] text-align

CSS (-ah-)text-align-lastIntroduction to CSS for Paged Mediatext-align-last

[CSS3-Text] Last Line Alignment: the ‘text-align-last’ property

Value:auto | start | end | left | right | inside | outside | center | justify
Initial:auto
Applies to:block elements
Inherited:yes
Percentages:N/A

 [XSL 1.1] text-align-last

CSS (-ah-)text-combine

[CSS3-WritingModes] Glyph Composition: the ‘text-combine’ property (“text-combine” has been removed from CSS3-WritingMode on and after September 1, 2011)

Value:none | horizontal
Initial:none
Applies to:non-replaced inline elements
Inherited:no
Percentages:N/A

CSS (-ah-)vertical-alignIntroduction to CSS for Paged Mediavertical-align

[CSS3-Line] Vertical alignment: the 'vertical-align' shorthand baseline alignment property

Value:baseline | sub | super | top | text-top | middle | central | bottom | text-bottom | <percentage> | <length>
Initial:baseline
Applies to:inline-level and table-cell elements
Inherited:no
Percentages:refer to the line-height

 [XSL 1.1] vertical-align

CSS (-ah-)writing-modeXSL-FO Samples CollectionWriting direction in the region-start/endWriting direction in vertical modeIntroduction to CSS for Paged Mediawriting-mode

[CSS3-WritingModes] Block Flow Direction: the ‘writing-mode’ property

Value:horizontal-tb | vertical-rl | lr-tb | rl-tb | tb-rl
Initial:horizontal-tb
Applies to:all elements except table row groups, table column groups, table rows, and table columns
Inherited:yes
Percentages:N/A

 [XSL 1.1] writing-mode


Other CSS Extensions

CSS -ah-logical-height

Specifies the block progression dimension.

Value:<length> | <percentage> | auto
Initial:auto
Applies to:same as ‘height
Inherited:no
Percentages:refer to the logical height of the containing block

 [XSL 1.1] block-progression-dimension

CSS -ah-logical-width

Specifies the inline progression dimension.

Value:<length> | <percentage> | auto
Initial:auto
Applies to:same as ‘width
Inherited:no
Percentages:refer to the logical width of the containing block

 [XSL 1.1] inline-progression-dimension

CSS -ah-margin-afterXSL-FO Samples CollectionCreating optional spaces around text inside a block

Specifies the margin of the after side.

Value:<length> | <percentage>
Initial:0
Applies to:same as ‘margin
Inherited:no
Percentages:refer to the logical width of the containing block

 [XSL 1.1] space-after

CSS -ah-margin-beforeXSL-FO Samples CollectionCreating optional spaces around text inside a block

Specifies the margin of the before side.

Value:<length> | <percentage>
Initial:0
Applies to:same as ‘margin
Inherited:no
Percentages:refer to the logical width of the containing block

 [XSL 1.1] space-before

CSS -ah-margin-endXSL-FO Samples CollectionCreating optional spaces around text inside a block

Specifies the margin of the end side.

Value:<length> | <percentage>
Initial:0
Applies to:same as ‘margin
Inherited:no
Percentages:refer to the logical width of the containing block

 [XSL 1.1] space-end, [XSL 1.1] end-indent

CSS -ah-margin-startXSL-FO Samples CollectionCreating optional spaces around text inside a block

Specifies the margin of the start side.

Value:<length> | <percentage>
Initial:0
Applies to:same as ‘margin
Inherited:no
Percentages:refer to the logical width of the containing block

 [XSL 1.1] space-start, [XSL 1.1] start-indent

CSS -ah-max-logical-height

Specifies the maximum block progression dimension.

Value:<length> | <percentage> | none
Initial:none
Applies to:same as ‘max-height
Inherited:no
Percentages:refer to the logical height of the containing block

 [XSL 1.1] block-progression-dimension

CSS -ah-max-logical-width

Specifies the maximum inline progression dimension.

Value:<length> | <percentage> | none
Initial:none
Applies to:same as ‘max-width
Inherited:no
Percentages:refer to the logical width of the containing block

 [XSL 1.1] inline-progression-dimension

CSS -ah-min-logical-height

Specifies the minimum block progression dimension.

Value:<length> | <percentage>
Initial:0
Applies to:same as ‘min-height
Inherited:no
Percentages:refer to the logical height of the containing block

 [XSL 1.1] block-progression-dimension

CSS -ah-min-logical-width

Specifies the minimum inline progression dimension.

Value:<length> | <percentage>
Initial:0
Applies to:same as ‘min-width
Inherited:no
Percentages:refer to the logical width of the containing block

 [XSL 1.1] inline-progression-dimension


CSS Extensions as is XSL

The following CSS extension properties apply the implementation of the XSL specification to CSS as is. See also each XSL specification. The implementation restrictions are the same as XSL. See also XSL-FO Conformance.

Functions in the XSL specifications can also be used in CSS with some exceptions. See 5.10 Core Function Library.

You can also use compound names in CSS, such as leader-length.minimum in XSL. In CSS, you have to add -ah-, like -ah-leader-length.minimum. You can specify the same compound name as XSL for the following properties: