Last updated: August 11, 2014

XSL FormatterAH Formatter XSL/CSS Extension

AH Formatter V6.2 provides you with numerous XSL proprietary extension elements and properties. When you use the extension elements or properties, please 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">

AH Formatter V6.2 also provides a lot of CSS extension. In this document, CSS2.1 or CSS3 properties with restrictions are written together with XSL properties. See also " XSL/CSS Properties List". 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 AH Formatter V6.2, 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 CSS2.1.

XSL-FO
Sample Tutorial
XSL-FO 1.1 Conformance
XSL-FO 1.1 Test Suite
Extension
Float Extension
Ruby Extension
Property List
CGM Conformance
SVG Conformance
SVG 1.1 Test Suite
MathML Conformance
MathML 2.0 Test Suite

Extended Elements

Extended elements are provided only for XSL.

Element name Description
<fo:change-bar-begin> Extends the child element so that <fo:float> can be described as the content of the element. no-LT
<axf:document-info> / HTML <meta> Specifies the document information. This information is embedded into the PDF.
<axf:footnote-number> Generates a footnote number. no-LT
<axf:footnote-number-citation> Cites a footnote number. no-LT
<axf:font-face> / CSS @font-face Appends a font. 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-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:output-volume-info> Outputs PDF in Multi Separate Volume. no-LT
<axf:ruby> Generates the ruby structure.
<axf:ruby-base> Specifies the base character of ruby.
<axf:ruby-text> Specifies ruby.
<axf:space-after-punctuation> Specifies the amount of space after the punctuation in European Typography.
<axf:space-before-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:table-cell-repeated-marker> Specifies the contents to be displayed in the split cell. V6.2 no-LT

Extended Values

Extended values are provided both for XSL and CSS, but values may differ.

Property name Description
border-style
border-*-style
rule-style
Extended the dot-dash, dot-dot-dash, and wave properties defined in old CSS3. These styles are preferred in the following order:
  1. double
  2. solid
  3. dashed
  4. dot-dash
  5. dot-dot-dash
  6. dotted
  7. ridge
  8. outset
  9. groove
  10. inset
  11. wave
This order is not described in CSS3.
display-align Extends the value of the display-align property.
font-size-adjust Extends the value of the font-size-adjust property.
font-stretch Extends the value of the font-stretch property.
font-variant Extends the value of the font-variant property.
force-page-count Extends the value of the force-page-count property.
format Extends the value of the format property.
internal-destination Extends the value of the internal-destination property. no-LT
leader-alignment Extends the value of the leader-alignment property.
overflow Extends the value of the overflow property.
size Extends the value of the size property.
table-omit-footer-at-break Extends the value of the table-omit-footer-at-break property. no-LT
table-omit-header-at-break Extends the value of the table-omit-header-at-break property. no-LT
text-transform Extends 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 name Description
rgb-icc() Extends the rgb-icc function.
rgba() Available to use rgba() function in CSS3 RGBA color values both with CSS and FO. V6.2
linear-gradient() It is a function expressing the gradation. no-LT
radial-gradient()
repeating-linear-gradient()
repeating-radial-gradient()
CSS counter() Extents the counter function of CSS.
CSS attr() Corresponds to the specification of CSS3 Values and Units.
CSS -ah-attr-from() Extends the attr function.

Extended Units

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

Unit name Description
ex Unit of the value based on x-height of the font defined by CSS 2.1 4.3.2 Length. When the font does not have x-height, a value of 0.5em should be used.
jpt Unit of the absolute value defined by JIS Z 8305. 1jpt = 0.3514mm.
q Unit of the absolute value expressing Q (quarter). 1q = 0.25mm. (JIS X 4052, JIS Z 8125)
dpi Used when expressing the resolution with axf:image-resolution .
dd Unit of the absolute value expressing didot. 1dd = 0.01483in.
cc Unit of the absolute value expressing cicero. 1cc = 12dd.
rem Unit of em in the root element. It cannot be used for the value of the font-size property in the root element.
ch Unit of the length expressing the width of character 0(U+0030) to be 1. When the glyph is not in the font, it becomes 0.5em.
wch Unit of the length expressing the width of character U+3000 to be 1. When the glyph is not in the font, it becomes 1em.
lh Unit 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.
rlh Unit of lh in the root element. It cannot be used for the value of the line-height property in the root element.
vw Unit of the width expressing the viewport width as 100.
vh Unit of the height expressing the viewport height as 100.
vmin Equal to the smaller length of vw or vh.
vmax Equal to the larger length of vw or vh.
pvw Unit of the width expressing the page width as 100.
pvh Unit of the height expressing the page height as 100.
pvmin Equal to the smaller length of pvw or pvh.
pvmax Equal to the larger length of pvw or pvh.
gr Unit to specify spanning columns.

Other Extensions

  1. 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. AH Formatter V6.2 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" />

  2. In the XSL Specification, the value of the <script> specified in the script property is supposed to be regulated in ISO 15924. AH Formatter V6.2 assigns a script called Math to mathematical operators, such as U+2200 to U+22FF for the accommodation of MathML.

  3. Although only xml:lang of the XML specification is explicitly stated in the XSL specification, AH Formatter V6.2 accepts the following XML input. The same is applied to XHTML and XML+CSS.


Document Information for PDF Output

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

<axf:document-info> / HTML <meta>

Document information such as an author and title can be embedded in the PDF. AH Formatter V6.2 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.

In HTML, the setting equivalent to axf:document-info can be specified with the <meta> tag. The setting of <meta name="document-title"> will take precedence over the setting of <title>.

  <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" />
  ...
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>

The axf:document-info extension property can be placed in any position right under the fo:root and before fo:page-sequence. Its properties are "name" and "value", which are required. The value of 'name' must be one of the followings: 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 subtitle 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

  • copyright-notice no-LT

    Specifies the information of the copyright.

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

  • xmp no-LT

    Specifies the URL of XMP. This URL follows <uri-specification> in the XSL specification. See also URI. The following settings become invalid when XMP is specified.

    • author-title
    • description-writer
    • copyright-status
    • copyright-notice
    • copyright-info-url

    The validity of a XMP file is checked simply whether it is well-formed or not. The contents are not detected. When contradictory or incorrect contents are included, the effect is not guaranteed.

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

  • pagelayout *

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

    • 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. The default value is SinglePage.

  • 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 PDF 1.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. Refer to 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

Contents:

EMPTY

Examples:
<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format"
         xmlns:axf="http://www.antennahouse.com/names/XSL/Extensions">
  <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"/>
...

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:root 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.

"openaction" and "pagemode" cannot be specified for the multi separate volume. Only the specification of the right under of fo:root is effective. When the separate volume is outputted, it is specified for the first separate volume.

With AH Formatter V6.2 Lite, axf:document-info specified to fo:page-sequence is ignored.

axf:pdftag / CSS -ah-pdftag

Specifies the tag name of Tagged PDF files. no-LT

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">

PDF Output in Multi Separate Volume

AH Formatter V6.2 makes it possible to output PDF in Multi Separate Volume. These features are not available in CSS. These features are not available with AH Formatter V6.2 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  NUMBER "1">
<!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:root. If it comes before fo:page-sequence appears, it is possible to put it in an arbitrary position under a child of fo:root.

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.

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

axf:bookmark-include

Specifies how to include bookmarks in multi separate volume. no-LT

Value: first | all | separate
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.

This property is not available with AH Formatter V6.2 Lite.

axf:document-info-include

Specifies how to include document information in multi separate volume. no-LT

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.

Please refer to <axf:document-info>. This property is not available with AH Formatter V6.2 Lite.

axf:initial-volume-number

Specifies the initial volume number in multi separate volume. no-LT

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

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

This property is not available with AH Formatter V6.2 Lite.

axf:output-volume-break

Separates the file in multi volume. no-LT

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 regarded as 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 AH Formatter V6.2 Lite.

axf:output-volume-filename

Specifies the document file name in multi separate volume. no-LT

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

<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 AH Formatter V6.2 Lite.


Bookmark and Link in PDF Output

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.

CAUTION: A similar function is equipped in XSL1.1. Please make use of fo:bookmark. However, please use axf:outline-* instead of fo:bookmark when you output PDF in Multi Separate Volume.

PDF bookmark

AH Formatter V6.2 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

The axf: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

The axf: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

The axf: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 zero 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

The axf: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

The axf:outline-color specifies the color which appears as a title of bookmarks. no-LT

Value: <color>
Initial: the value of the 'color' property
Applies to: block-level formatting objects
Inherited: no
Percentages: N/A

This property is effective with PDF 1.4 or later. This property is not available with AH Formatter V6.2 Lite.

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

The axf:outline-font-style specifies the font style which appears as a title of bookmarks. no-LT

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 PDF 1.4 or later. This property is not available with AH Formatter V6.2 Lite.

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

The axf:outline-font-weight specifies the font weight which appears as a title of bookmarks. no-LT

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 PDF 1.4 or later. This property is not available with AH Formatter V6.2 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.

Making Link

In 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 relative address is transformed into either 'Open the file' or 'World Wide Web link' by the use-launch-for-relative-uri property in PDF Output Setting. The external link specified by the absolute address is always transformed into 'World Wide Web link'.

Furthermore, it's possible to specify professional links as follows. For further understanding see also "PDF Reference" by Adobe Systems Incorporated. The professional links are not available with AH Formatter V6.2 Lite.

  • 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 for the external link in PDF as well as the 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 external link in the bookmark.
  • Possible to specify the internal link in the bookmark.

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 AH Formatter V6.2. The invalid parameters are ignored.

This specification provides the following examples.

  • 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#pagemode=none
  • http://mydocs/doc.pdf#pagemode=bookmarks&page=2
  • http://mydocs/doc.pdf#page=3&pagemode=thumbs

Only the following parameters are effective with AH Formatter V6.2. The case sensitivity is ignored.

  • nameddest
  • page
  • zoom
  • view
  • viewrect

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

With the external link for PDF, it's possible to specify whether to open a new window by the show-destination property. A link destination except PDF is invalid. If show-destination="new" is specified, a new window will be opened and PDF will be displayed on the window. If show-destination="replace" is specified, a new window will not be opened but PDF will be displayed in the current window. When nothing specified, it depends on the operation of the PDF viewer application. Although it is defined as "replace" in the XSL-FO specification when the property is omitted, AH Formatter V6.2 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.

AH Formatter V6.2 provides the following extension properties for the professional link.

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

Specifies the action of external link or form action. In CSS, form actions are invalid.

Value: gotor | launch | uri | reset | submit | auto
Initial: auto
Applies to: fo:basic-link, axf:form-field
Inherited: no
Percentages: N/A

Values have the following meanings.

gotor

Opens the link destination by the "GoToR" action as PDF. The URI of the destination is regarded as 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).

reset no-LT

Resets a form filed as a form action and can be specified to axf:form-field. It's invalid in CSS.

submit no-LT

Submits a form filed as a form action and can be specified to axf:form-field. It's invalid in CSS.

auto

Dependent on the system setting.

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 relative address is transformed into either 'Open the file' or 'World Wide Web link' by the use-launch-for-relative-uri property in PDF Output Setting. The external link specified by the absolute address is always transformed into 'World Wide Web link'.

axf:destination-type / CSS -ah-destination-type

Specifies the type of destination for the external link. These are the types of destination for PDF as the external link. no-LT

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.

CAUTION: Although the link functions in GUI, destination-type is invalid and it is always considered as xyz-left-top.
Destination Type of PDFHow to specify axf:destination-type
[page /XYZ left top zoom] AH Formatter V6.2 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 t 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] AH Formatter V6.2 calculates the value of top. Effective only to specify in the internal link.
axf:destination-type="fith"
[page /FitV left] AH Formatter V6.2 calculates the value of left.
axf:destination-type="fitv"
[page /FitR left bottom right top] AH Formatter V6.2 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] AH Formatter V6.2 calculates the value of top. Effective only to specify in the internal link.
axf:destination-type="fitbh"
[page /FitBV left] AH Formatter V6.2 calculates the value of left.
axf:destination-type="fitbv"

This property is not available with AH Formatter V6.2 Lite.

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

Sets the external link in the PDF bookmark. no-LT

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 AH Formatter V6.2 Lite.

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

Sets the internal link in the PDF bookmark. no-LT

Value: empty string | <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 #. Refer to 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 regarded as the 1st page. However, when the top position is specified, it is regarded as 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 AH Formatter V6.2 Lite.

ID in the External Link

When specifying the ID in the external link, the type of the destination should be given to the ID of the link destination. Nameddest is only effective as the parameter in the URI. The type of the destination can be specified to the link destination. Values indicated in axf:destination-type can be specified for "xxxx".

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

ID in the Internal Link

When specifying the ID in the internal link, the type of the destination should be given to the ID of the link destination as well as the external link.

  • Link origin:
    <fo:basic-link internal-destination="Chapter6">
    
  • Link destination:
    <fo:block id="Chapter6" axf:destination-type="xxxx">
    

Page Number in the External Link

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.

Page Number in the Internal Link

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.

Bookmark with the External Link

Specify the axf:outline-external-destination property as follows in order to specify the external link to the bookmark.

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

Bookmark with the Internal Link

Specify the axf:outline-internal-destination property as follows in order to specify the internal link to the bookmark.

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

Remarks

  • 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 volume. At that time, the action type of the link is accounted as axf:action-type="gotor".
  • When an unintended link is created, please 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 in PDF Output

Annotations can be added to PDF with AH Formatter V6.2. See also "PDF Reference" for more details. Annotations which can be specified here are a part of those defined in "PDF Reference". This function is not available with AH Formatter V6.2 Lite.

axf:annotation-type / CSS -ah-annotation-type

Specifies the type of the annotation. no-LT

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.

This property is not available with AH Formatter V6.2 Lite.

axf:annotation-author / CSS -ah-annotation-author

Specifies the author of the annotation. V6.2MR2 no-LT

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 AH Formatter V6.2 Lite.

axf:annotation-title / CSS -ah-annotation-title

Specifies the title of the annotation. no-LT

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 PDF 1.5 or later. This property is not available with AH Formatter V6.2 Lite.

axf:annotation-contents / CSS -ah-annotation-contents

Specifies the content of the annotation. no-LT

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

Specifies the character strings to be displayed when any of the following types of the annotations (axf:annotation-type) is specified.

  • "Text"
  • "FreeText"
  • "Stamp"
  • "FileAttachment"

This property is not available with AH Formatter V6.2 Lite.

axf:annotation-color / CSS -ah-annotation-color

Specifies the color used for the background of the annotation. no-LT

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 AH Formatter V6.2 Lite.

axf:annotation-flags / CSS -ah-annotation-flags

Specifies the flag of the annotation. no-LT

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
  • LockedContentsV6.2MR3

See also "PDF Reference" to learn more.

This property is not available with AH Formatter V6.2 Lite.

axf:annotation-open / CSS -ah-annotation-open

Specifies the initial state of the annotation. no-LT

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 AH Formatter V6.2 Lite.

axf:annotation-icon-name / CSS -ah-annotation-icon-name

Specifies the name of the icon used for displaying the annotation. no-LT

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 regarded as "None".

  • "Stamp"

    Standard names are as follows:

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

    Empty string is regarded as "Draft".

  • "FileAttachment"

    Standard names are as follows:

    • "Graph"
    • "Paperclip"
    • "PushPin"
    • "Tag"

    Empty string is regarded as "PushPin".

This property is not available with AH Formatter V6.2 Lite.

axf:annotation-position-horizontal / CSS -ah-annotation-position-horizontal

Specifies the horizontal position of the annotation. no-LT

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 AH Formatter V6.2 Lite.

axf:annotation-position-vertical / CSS -ah-annotation-position-vertical

Specifies the vertical position of the annotation. no-LT

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 AH Formatter V6.2 Lite.

axf:annotation-width / CSS -ah-annotation-width

Specifies the width of the annotation. no-LT

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 AH Formatter V6.2 Lite.

axf:annotation-height / CSS -ah-annotation-height

Specifies the height of the annotation. no-LT

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 AH Formatter V6.2 Lite.

axf:annotation-font-family / CSS -ah-annotation-font-family

Specifies the font family of the free text annotation. no-LT

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 AH Formatter V6.2 Lite.

axf:annotation-font-size / CSS -ah-annotation-font-size

Specifies the font size of the free text annotation. no-LT

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 AH Formatter V6.2 Lite.

axf:annotation-font-weight / CSS -ah-annotation-font-weight

Specifies the font weight of the free text annotation. no-LT

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 AH Formatter V6.2 Lite.

axf:annotation-font-style / CSS -ah-annotation-font-style

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

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 AH Formatter V6.2 Lite.

axf:annotation-text-color / CSS -ah-annotation-text-color

Specifies the color of the free text annotation. no-LT

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 AH Formatter V6.2 Lite.

axf:annotation-text-align / CSS -ah-annotation-text-align

Specifies the alignment of the free text annotation. no-LT

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 AH Formatter V6.2 Lite.

axf:annotation-file-attachment / CSS -ah-annotation-file-attachment

Specifies the file with which file attachment annotation is related. no-LT

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

This property is not available with AH Formatter V6.2 Lite.


Acroform in PDF Output

It's possible to create PDF forms with AH Formatter V6.2. Forms consist of the field to fill in the text and buttons, etc. Moreover, the action accompanied by push-button can be specified. These features are not available in CSS.

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>. This function is not available with AH Formatter V6.2 Lite.

<axf:form>

Common Usage:

Encloses the unit of the form action. no-LT

Areas:

Generates and returns a block-area.

Contents:

(%block;)*

<axf:form-field>

Common Usage:

Generates a form field. no-LT

Areas:

Generates and returns a single normal inline-area.

Contents:

(axf:form-field-option)*

<axf:form-field-option>

Common Usage:

Specifies the component elements of the list box, combo box. no-LT

Areas:

No areas generated.

Contents:

#PCDATA

axf:field-type

Specifies the field type. no-LT

Value: text | button | checkbox | radio | listbox | combobox | signature
Initial: N/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

axf:field-name

Specifies the field name. no-LT

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

axf:field-description

Specifies the descriptive text of the field. no-LT

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

axf:field-value

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

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

axf:field-readonly

Specifies whether the field is read-only or not. no-LT

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

Specifies whether the field is enter-required or not. no-LT

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

Specifies the text entered into the text field from the beginning. no-LT

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

axf:field-multiline

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

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

Specifies whether the text field is scrollable or not. no-LT

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

Specifies whether the text field requires the password or not. no-LT

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

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

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.

CAUTION: When the maximum number of characters is specified and the number of characters set as initial value of the text field in axf:field-default-text exceeds the specified maximum number, the initial value will be discarded.

axf:field-format-category

Specifies the format type of the text field. no-LT

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.

CAUTION: As for the character string set as initial values of the text field in axf:field-default-text , its validity is inspected when a format is specified. Nonconforming initial values will be discarded.

axf:field-format

Specifies the format of the text field. no-LT

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 numbers like "$ ". When putting it after the numbers, put the white space before numbers.

  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. Please refer to 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. Please refer to the specifications of JavaScript, etc. to learn the meaning of the character in the format.

CAUTION: The specified format might be invalid depending on the version of Acrobat.

axf:field-button-layout

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

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

Specifies the caption displayed in the push button field. no-LT

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

axf:field-button-icon

Specifies the icon displayed in the push button field. no-LT

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

axf:field-button-face-down

Specifies the caption displayed in the push button field. no-LT

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

axf:field-button-icon-down

Specifies the icon displayed when pressing the push button. no-LT

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

axf:field-button-face-rollover

Specifies the caption displayed when rolling over the push button. no-LT

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

axf:field-button-icon-rollover

Specifies the icon displayed when rolling over the push button. no-LT

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

axf:field-checked

Specifies the initial state of the check box and the radio button. no-LT

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

Specifies the style of the check box and the radio button. no-LT

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

axf:field-top-index

Specifies the first selected item in the list box, combo box. no-LT

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 regarded as 1.

axf:field-multiple

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

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

Specifies whether the value can be edited with the combo box. no-LT

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-submit-method

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

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

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

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.

Form Fields

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

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

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.

Checkbox field

Checkbox 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

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 checked="true" is set multiply, only one button in a group is checked.

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

Listbox field

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

Combobox field

Combobox 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-edittable="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.

Form Actions

Form actions are realized by specifying the event to be triggered and the action corresponding to the event to each field. In AH Formatter V6.2, the action can be specified to the field which 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 action is generated only by pushing the bottom. The action has the following three types.

axf:action-type is extended for Form actions.

Reset

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.

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

Submit

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.

<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" default-text="YYY" .../>
 ...
</axf:form>

Link

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. Nothing is specified to action-type.

<axf:form-field field-type="button" internal-destination="URI" .../>

The internal link can be specified as follows. You can specify any one of gotor, launch or uri to action-type.

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

Layer in PDF Output

Layers can be specified to PDF with AH Formatter V6.2. Layer settings are effective only with PDF 1.5 or later. These features are not available with AH Formatter V6.2 Lite.

axf:layer-settings / CSS (-ah-)layer-settings

Defines layers. V6.2 no-LT

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

Values have the following meanings.

none

No definition.

<layer-setting>

<layer-setting> has the following syntax:

<layer-setting> = <layer-name> [on | off]? [ view [on | off] || print [on | off] || export [on | off] || locked || lang <string> prefered? ]?
<layer-name> = <string>

Multiple layers can be defined by comma-separated items. <layer-name>, the name which identifies a layer is indispensable with the definition of the layer. Others are omissible. on|off specify the default state of a layer. When omitted, it is considered as on. It is also possible to specify the default state of on/off for every feature of view, print, and export. When locked is specified the layer will be locked. lang specifies the language.

This property is not available with AH Formatter V6.2 Lite.

axf:layer / CSS (-ah-)layer

Specifies to which layer the area is arranged. V6.2 no-LT

Value: none | <layer-name>
Initial: none
Applies to: all elements
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 <layer-settings>.

This property is not available with AH Formatter V6.2 Lite.


Extension for European Rule

AH Formatter V6.2 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-after-punctuation> etc. in Option Setting File is effective.

<axf:space-after-punctuation>

Specifies the amount of space after the punctuation.

<axf:space-before-punctuation>

Specifies the amount of space before the punctuation.

<axf:space-between-digit-and-punctuation>

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

<axf:space-between-punctuation-and-digit>

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 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 0 or less.

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-before-punctuation code="?" space="1 div 3" language="fr"/>
<axf:space-before-punctuation code="!" space="1 div 3" language="fr"/>
<axf:space-before-punctuation code=";" space="1 div 3" language="fr"/>
<axf:space-before-punctuation code=":" space="1 div 4" language="fr"/>
<axf:space-before-punctuation code="&#xBB;" space="1 div 4" language="fr"/>
<axf:space-after-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 a Font

This element is not available with AH Formatter V6.2.

<axf:font-face> / CSS @font-face

Common Usage:

Specifies an additional font. This element does not generate area. These functions are not available with AH Formatter V6.2 Lite. no-LT

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  (%font-style;) "normal">
<!ATTLIST axf:font-face font-weight (%font-weight;) "normal">

The <axf:font-face> element can be placed directly under <fo:declarations>.

Contents:

EMPTY

Examples:
<fo:declarations>
  <axf:font-face src="url(http://www.hixie.ch/resources/fonts/AHEM____.TTF)"
                 font-family="AHEM"/>
</fo:declarations>

A font specified by <axf:font-face> / @font-face is always embedded. A font with embedding prohibition information cannot be specified.

The following properties can be specified to <axf:font-face> / @font-face.

src

Specifies the font resource.

Value: [ <uri> [format(<string>)]? | <font-face-name> ]#
Initial: N/A
Inherited: no
Percentages: N/A

URI can be specified to <uri> with the file name of the font, or the url() function. The type of fonts can be specified by the format() function. When omitted, it will be recognized by the extension of the font resource. Available types are as follows:

woff

WOFF (Web Open Font Format)

truetype

TrueType

opentype

OpenType

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

When using the already installed font, specify the installed font name with the local() function.

<fo:declarations>
<axf:font-face
  src="local(Arial)"
  ...

font-family

Specifies the font family.

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

font-style

Specifies the font style.

Value: normal | italic
Initial: normal
Inherited: no
Percentages: N/A

font-weight

Specifies the font weight.

Value: normal | bold | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900
Initial: normal
Inherited: no
Percentages: N/A


Appending Option Setting Information

AH Formatter V6.2 can specify the additional option setting information used inside the document. These features are not available in CSS.

<axf:formatter-config>

Common Usage:

Specifies additional option setting information. This element doesn't generate the area tree. These features are not available with AH Formatter V6.2 Lite. no-LT

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 FO. It becomes base-uri for the relative path. A part of the element which 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 can be described. The other elements will be disregarded.

  • <pdf-settings>
  • <text-settings>
  • <svg-settings>
  • <inx-settings>
  • <mif-settings>
  • <ps-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 area tree.


Printer Marks

AH Formatter V6.2 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 AH Formatter V6.2 Lite.

Printer Marks

axf:crop-offset / CSS -ah-crop-offset
axf:crop-offset-top / CSS -ah-crop-offset-top
axf:crop-offset-bottom / CSS -ah-crop-offset-bottom
axf:crop-offset-left / CSS -ah-crop-offset-left
axf:crop-offset-right / CSS -ah-crop-offset-right

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

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). 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 AH Formatter V6.2 Lite.

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

Specifies whether to display the area that is extended beyond the finished page size. no-LT

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 finished page size or the extended area is displayed.

These properties are not available with AH Formatter V6.2 Lite.

axf:bleed / CSS (-ah-)bleed
axf:bleed-top / CSS -ah-bleed-top
axf:bleed-bottom / CSS -ah-bleed-bottom
axf:bleed-left / CSS -ah-bleed-left
axf:bleed-right / CSS -ah-bleed-right

Specifies the width of the bleed region for cutting off. [CSS3-GCPM] Page marks and bleed area no-LT

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

The region 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 AH Formatter V6.2 Lite.

axf:printer-marks / CSS (-ah-)marks

Specifies the Printing marks, such as a crop mark. Specifies the action of external link. [CSS3-GCPM] Page marks and bleed area no-LT

Value: [ crop || cross || <uri-specification> [<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 crop marks.

cross

Outputs cross marks, registration marks.

<uri-specification>

Original printer marks, color bars, etc. can be outputted by specifying images, such as SVG. 2 or more URIs can be specified.

Crop marks becomes what unites the inner printer marks (crop marks) and the outside printer marks (bleed marks) when there is specification of axf:bleed.

This property is not available with AH Formatter V6.2 Lite.

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

Specifies the line color of printer marks. no-LT

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 regarded as the registration color.

This property is not available with AH Formatter V6.2 Lite.

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

Specifies the line length of printer marks. no-LT

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

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 AH Formatter V6.2 Lite.

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

Specifies the line width of printer marks. no-LT

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 AH Formatter V6.2 Lite.

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

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

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 AH Formatter V6.2 Lite.

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

Specifies the spine width of the facing page. V6.2 no-LT

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 assumed 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 AH Formatter V6.2 Lite.


Printing Control

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

Selects the printer tray. no-LT

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

Effective only with the Windows version 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 AH Formatter V6.2 Lite.

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

Specifies to print in duplex mode. no-LT

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

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

  1. Simplex Printing.
  2. Duplex Printing. Flip on Long Edge.
  3. Duplex Printing. Flip on Short Edge.

See also SeparatePrinterDuplexJob in the Option Setting File. This property is not available with AH Formatter V6.2 Lite.

axf:overprint / CSS -ah-overprint

Specifies the overprint. V6.2MR2 no-LT

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 as 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. Please 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 rgb-conversion="cmyk" is specified in the Option Setting File, RGB serves as CMYK.

Foreground (overprint is specified)
CMYKSeparationRGBGrayscale
Background CMYK Yes Yes No No
Separation Yes Yes Yes Yes
RGB Yes Yes No No
Grayscale No Yes No No

See also 4.5.6 Overprint Control in "PDF Reference" for more details.

CAUTION: The overprint is effective only with the PDF output. It is invalid when printing to paper directly. Also it is not applied to shading and the form field.
CAUTION: The setting does not affect on the embedded PDF. Please create PDF by specifying the overprint before embedding it.

This property is not available with AH Formatter V6.2 Lite.


Page Control Extensions

axf:repeat-page-sequence-master

The axf:repeat-page-sequence-master specifies the repetition of the page sequence. no-LT

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 AH Formatter V6.2 Lite.

axf:reverse-page

Outputs pages in reverse order. no-LT

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. PDF output in multi separate volume is not available.

This property is not available with AH Formatter V6.2 Lite.


Block Extensions

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

axf:suppress-if-first-on-page specifies whether to suppress the block at the beginning of a page. no-LT

Value: false | true
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 beginning of a page. Since it is actually not deleted but exists without display as a block of size zero, it's effective to refer to ID, etc.

This property is not available with AH Formatter V6.2 Lite.

Transformation

axf:transform / CSS (-ah-)transform

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

Value: none | <transform-function> [ <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 AH Formatter V6.2 Lite.

axf:transform-origin / CSS (-ah-)transform-origin

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

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 AH Formatter V6.2 Lite.

Baseline Grid

axf:baseline-grid / CSS -ah-baseline-grid

Sets or clears the baseline grid. V6.2 no-LT

Value: normal | none | root | new
Initial: normal
Applies to: block-level formatting objects, fo:flow and fo:static-content / block containers
Inherited: no
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 AH Formatter V6.2 Lite.

axf:baseline-block-snap / CSS -ah-baseline-block-snap

Specifies how to align blocks on the baseline grid. V6.2 no-LT

Value: none | [auto | before | after | center] || [border-box | margin-box]
Initial: auto border-box
Applies to: block-level elements with 'baseline-grid: new' or 'baseline-grid: none'
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.

See baseline-grid for usage.

This property is not available with AH Formatter V6.2 Lite.


Line Breaking

AH Formatter V6.2 provides extension properties to control the line-breaking. Usually, the line-breaking complies with UAX#14: Line Breaking Properties. Also refer to Line Breaking in Technical Notes.

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

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

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

Values have the following meanings.

normal

Nonstarter Japanese 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. Also, the properties of axf:append-non-starter-characters, axf:except-non-starter-characters, axf:append-non-end-of-line-characters, axf:except-non-end-of-line-characters are disregarded.

strict

Nonstarter character is treated for Japanese. Also, the characters specified to the properties of axf:append-non-starter-characters, axf:except-non-starter-characters, axf:append-non-end-of-line-characters, axf:except-non-end-of-line-characters are included.

The Nonstarter character in LineBreak-5.0.0.txt is as follows. [JIS] is classified into the Nonstarter character in JIS X 4051:2004.

U+17D6KHMER SIGN CAMNUC PII KUUH  
U+203CDOUBLE EXCLAMATION MARK
U+203DINTERROBANG
U+2047DOUBLE QUESTION MARK  
U+2048QUESTION EXCLAMATION MARK  
U+2049EXCLAMATION QUESTION MARK  
U+3005IDEOGRAPHIC ITERATION MARK [JIS]
U+301CWAVE DASH
U+303BVERTICAL IDEOGRAPHIC ITERATION MARK   [JIS]
U+303CMASU MARK  
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
U+309CKATAKANA-HIRAGANA SEMI-VOICED SOUND MARK
U+309DHIRAGANA ITERATION MARK [JIS]
U+309EHIRAGANA VOICED ITERATION MARK [JIS]
U+30A0KATAKANA-HIRAGANA DOUBLE HYPHEN  
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
U+30FCKATAKANA-HIRAGANA PROLONGED SOUND MARK [JIS]
U+30FDKATAKANA ITERATION MARK [JIS]
U+30FEKATAKANA VOICED ITERATION MARK [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+A015YI SYLLABLE WU  
U+FE54SMALL SEMICOLON  
U+FE55SMALL COLON  
U+FF1AFULLWIDTH COLON
U+FF1BFULLWIDTH SEMICOLON
U+FF65HALFWIDTH KATAKANA MIDDLE DOT
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
U+FF9FHALFWIDTH KATAKANA SEMI-VOICED SOUND MARK

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

Specifies the append-non-starter-characters in CJK.

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

When axf:line-break="strict" is specified, 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, closing parenthesis and punctuations, that are originally non-starter, 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:except-non-starter-characters / CSS -ah-except-non-starter-characters

Specifies the except-non-starter-characters in CJK.

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

When axf:line-break="strict" is specified, 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, closing parenthesis and punctuations, that are originally non-starter, 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 append-non-end-of-characters in CJK.

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

When axf:line-break="strict" is specified, 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, opening parenthesis and punctuations, that are originally non-end-of-line, 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:except-non-end-of-line-characters / CSS -ah-except-non-end-of-line-characters

Specifies the except-non-end-of-characters in CJK.

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

When axf:line-break="strict" is specified, 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, opening parenthesis and punctuations, that are originally non-end-of-line, 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

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

Value: normal | break-all | keep-all
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.

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

Within the word oriented upright by axf:text-orientation="upright", it is always regarded as 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] Force Wrapping: the 'word-wrap' property

Value: normal | break-word
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:abbreviation-character-count / CSS -ah-abbreviation-character-count

Specifies the minimum number of characters considered to be an abbreviation.

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

Values have the following meanings.

auto

The value specified by abbreviation-character-count in the Option Setting File is adopted.

<number>

Specifies the number of characters considered to be 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 AH Formatter V6.2, when the number of characters of the word right after / is less than or equal the specified number with axf:abbreviation-character-count, the word is considered as the abbreviation and the line does not break. The same behavior is also applied to the hyphenation. Only when the string is one of the following scripts, it is considered as an abbreviation.

  • 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 /.


Extension for Hyphenations

AH Formatter V6.2 provides the extended features for hyphenations.

axf:hyphenation-minimum-character-count / CSS -ah-hyphenation-minimum-character-count

The axf:hyphenation-minimum-character-count specifies the minimum number of the character to hyphenate.

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-zone

axf:hyphenation-zone limits the range where a hyphenation is available.

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

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-word

Specifies whether to hyphenate the already hyphenated word or not.

Value: true | false
Initial: true
Applies to: fo:block, fo:character
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 followings are recognized as hyphens.

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

This setting is invalid when hyphenate="false" is specified.

CSS (-ah-)hyphenate-after

[CSS3-GCPM] Hyphenate properties

Value: <integer> | auto
Initial: auto
Applies to: all elements
Inherited: yes
Percentages: N/A

[XSL1.1] hyphenation-push-character-count

CSS (-ah-)hyphenate-before

[CSS3-GCPM] Hyphenate properties

Value: <integer> | auto
Initial: auto
Applies to: all elements
Inherited: yes
Percentages: N/A

[XSL1.1] hyphenation-remain-character-count

CSS (-ah-)hyphenate-character

[CSS3-GCPM] Hyphenate properties

Value: auto | <string>
Initial: auto
Applies to: all elements
Inherited: yes
Percentages: N/A

[XSL1.1] hyphenation-character

CSS (-ah-)hyphenate-lines

[CSS3-GCPM] Hyphenate properties

Value: no-limit | <integer>
Initial: no-limit
Applies to: all elements
Inherited: yes
Percentages: N/A

[XSL1.1] hyphenation-ladder-count

CSS (-ah-)hyphens

[CSS3-Text] Hyphenation Control: the ‘hyphens’ property

Value: none | manual | auto
Initial: manual
Applies to: all elements
Inherited: yes
Percentages: N/A

[XSL1.1] hyphenate

<axf:hyphenation-info>

Common Usage:

Specifies additional hyphenation information. This element doesn't generate the area tree. This feature is not available in CSS. This feature is not available with AH Formatter V6.2 Lite. no-LT

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 indispensable to indicate which language this element is associated with. It is not available to do hyphenation if the specified language is originally not hyphenated. This setting is invalid for Thai.

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:

%axs-settings; 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.

CAUTION: In the example above, do not use the following setting. (<hyphen/> is disregarded.)
abc<hyphen/>defg
Instead, please make sure to specify
abc<axh:hyphen/>defg

Output Glyph by SOFT HYPHEN

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 fonts such as pictographic characters are used.

AH Formatter V6.2 implements the extension property axf:soft-hyphen-treatment which 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

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

preserve

SOFT HYPHEN is not deleted and the target glyph is output.


Trimming and Hanging

AH Formatter V6.2 provides extension properties to trim and to hang.

axf:punctuation-trim / CSS (-ah-)punctuation-trim

Specifies whether to treat full width punctuations in Japanese. [CSS3-Text] Fullwidth Punctuation Kerning: the ‘punctuation-trim’ property

Value: none | [ [ start | start-except-first ] || [ end | allow-end | end-except-fullstop ] || adjacent ] | all | <string> | auto
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 start of line are trimmed.

start-except-first

Same as start 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>

Behave the same as "all", but only the character included in the character strings specified here is treated as a half width. Other than parentheses, middle dots, and punctuations of full width are disregarded.

auto

Dependent on the system setting. It is regarded as "none" or "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

CAUTION: To make the behavior of axf:punctuation-trim="both" in XSL Formatter V4 the same, please specify axf:punctuation-trim="start end" or axf:punctuation-trim="start allow-end" in AH Formatter V6.2. In addition, if you use this extension together with axf:kerning-mode="contextual", please specify axf:punctuation-trim="start end adjacent" etc. with AH Formatter V6.2.

axf:text-justify-trim / CSS (-ah-)text-justify-trim

Specifies the way to trim in text justification. [CSS3-Text] Additional compression: The 'text-justify-trim' property

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 "true", it is considered as "Ideograph inter-word" 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:kerning-mode / CSS -ah-kerning-mode

The axf:kerning-mode 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 for Western characters is processed.

auto

Dependent on the system setting.

You can specify whether pair kerning for European languages is performed or not by pair-kerning in the Option Setting File. This can also be set in the Option Setting dialog in GUI.

CAUTION: axf:kerning-mode="contextual" with XSL Formatter V4 was abolished with AH Formatter V6.2. Please use axf:punctuation-trim="adjacent" instead.

axf:kerning-mode does not work when letter-spacing is specified.

axf:punctuation-spacing / CSS -ah-punctuation-spacing

The axf:punctuation-spacing 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-punctuation

Specifies whether to hang punctuations at the start of the line or end of the line. [CSS3-Text] Hanging Punctuation: the ‘hanging-punctuation’ property

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 punctuations at the start of the line or end of the line.

start

Hangs punctuations at the start of the line. If the target character for hanging comes to the start of the line, the character is hanged forcibly.

first

Behaves as the same as the start value only with the start line of a paragraph.

force-end

Hangs punctuations 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 sentence, the character is hanged forcibly. When anything else is specified to text-align, the character is hanged naturally. the end value before V5 is taken as the allow-end value.

allow-end

Hangs punctuations 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 sentence, the character is not hanged if text fits into one line, the character is hanged if text does not fit into one line. When anything else is specified to text-align, the character is hanged 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-words

The axf:avoid-widow-words 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: true | false
Initial: false
Applies to: fo:block
Inherited: yes
Percentages: N/A

Values have the following meanings.

true

Adjusts the spacing so that the last line of the paragraph does not have only one word left (one character for CJK) when the spacing behavior is available by trimming the space between Japanese characters or Western words.

false

Does nothing.

If the width of columns (length of the line) is short, 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. Please note that there may have no more space to trim by setting axf:punctuation-trim or axf:text-justify-trim. With non-CJK languages, adjusting by sending a character to the next will not be done.


Spacing and Alignment

Adding Space

axf:text-autospace / CSS (-ah-)text-autospace

The axf:text-autospace specifies whether to add space surrounding ideographic glyphs or not. [CSS3-Text] Adding space: the ‘text-autospace’ property

Value: none | [ ideograph-numeric || ideograph-alpha || ideograph-parenthesis || ideograph-punctuation ] | 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, Lm and Lo 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.

ideograph-punctuation

Space is added between ideograph character and non-ideographic punctuation character. Non-ideographic punctuation character mentioned here indicates the character of Ps, Pe, Po, Pi, and Pf classified by Unicode excluding parenthesis character and quotation mark. Space is added between period and ideograph character. However space is not added between ideograph character and period. The same rule is applied to comma.

auto

Dependent on the system setting. It's regarded as "none" or "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

The axf:text-autospace-width specifies the width for axf:text-autospace 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 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: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

Changes letter-spacing depending on the number of characters. no-LT

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. Nothing is done with the other numbers of characters. Only the characters included in the first in-line element is counted.

This property is defined mainly assuming the chapter in CJK. In the following case,

第1章 はじめに

it's better to use axf:letter-spacing-side toghther as follows.

第1章 <fo:inline axf:auto-letter-spacing="2em 1em 0.5em 0.25em" axf:letter-spacing-side="end">はじめに</fo:inline>

It's not possible to apply this property to the text to which the number of characters (like page numbers, etc.) is not decided.

This property is not available with AH Formatter V6.2 Lite.

CSS -ah-margin-break

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-string

axf:text-align-string specifies the text alignment when text-align="<string>".

Value: start | center | end | inside | outside | left | right
Initial: end
Applies to: fo:block
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, AH Formatter V6.2 displayed it right aligned according to the illustration of 17.5.4 Horizontal alignment in a column. AH Formatter V6.2 extends the alignment and makes it possible to align left or align center

axf:text-align-first / CSS -ah-text-align-first

axf:text-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.

Refer to axf:leader-expansion.

axf:leader-expansion / CSS -ah-leader-expansion

axf:leader-expansion specifies whether to expand a leader forcibly. no-LT

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 AH Formatter V6.2 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 form justification.

axf:indent-here / CSS -ah-indent-here

Aligns the indent position to the region position when a line break occurs. no-LT

Value: none | <length>
Initial: none
Applies to: fo:inline
Inherited: no
Percentages: N/A

Values have the following meanings.

none

Nothing is done.

<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. The start position of <fo:inline> becomes the standard of indentation.

<fo:block>Indent-here: <fo:inline axf:indent-here="0pt"/>The quick brown fox jumps over the lazy dog....</fo:block>

This property is not available with AH Formatter V6.2 Lite.


Character and Text Decoration

axf:text-line-color / CSS -ah-text-line-color

axf:text-line-color specifies the color of underline, strikethrough, and overline.

Value: auto | <color>
Initial: auto
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

axf: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

axf: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

axf: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: no
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

The axf: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.

CSS (-ah-)text-decoration

[CSS2.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-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-line

[CSS3-TextDecor] Text Decoration Lines: the ‘text-decoration-line’ property

Value: none | [ underline || overline || line-through ]
Initial: none
Applies to: all elements and generated content
Inherited: no (but see prose)
Percentages: N/A

[XSL1.1] text-decoration

CSS (-ah-)text-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

mixed uprightSpecifies the orientation of text in vertical writing mode. [CSS3-WritingModes] Orienting Text: the ‘text-orientation’ property no-LT

Value: mixed | upright | sideways-right | sideways | none
Initial: none (XSL) / mixed (CSS)
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 in the figure on the right)

upright

Renders all the characters upright except for punctuations, such as parentheses. (As shown in the figure on the left)

sideways-right
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.

See also Upright rendering of text in vertical writing mode to learn more about the behavior of "mixed" and "upright".

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 AH Formatter V6.2 Lite.

axf:text-combine-horizontal / CSS (-ah-)text-combine-horizontal

Sets horizontal-in-vertical composition in vertical writing mode automatically. [CSS3-WritingModes] Horizontal-in-Vertical Composition: the ‘text-combine-horizontal’ property no-LT

Value: none | all | [ digits <integer> || alpha <integer> || alphanumeric <integer> ]
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 inline element which consists of only text 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.

Usually, horizontal-in-vertical composition will be marked up as follows: The automatic horizontal-in-vertical composition saves time and effort for this.

<fo:inline-container writing-mode="lr-tb"
                     line-height="1"
                     text-align="center"
                     text-indent="0pt"
                     start-indent="0pt"
                     end-indent="0pt"
                     padding="0pt"
                     wrap-option="no-wrap">
 <fo:block>12</fo:block>
</fo:inline-container>

axf:text-combine-horizontal is applied before axf:text-orientation or text-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 regarded as 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>

CAUTION: Automatic horizontal-in-vertical composition is not recommended to use in any other way than axf:text-orientation="upright".

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 lt;fo:page-number>

This property is not available with AH Formatter V6.2 Lite.

Emphasis Marks

AH Formatter V6.2 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-style

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 as filled. When filled or open is specified, it's considered as 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-offset

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

Punctuations 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 | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900
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

Specifies the text shadow. [CSS3-TextDecor] Text Shadows: the ‘text-shadow’ property V6.2 no-LT

Value: none | [ <length>{2,3} && <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.

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.
  • 3rd <length> starts blurring from the position where the region is extended. This setting is ignored with AH Formatter V6.2.
  • 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 AH Formatter V6.2 Lite.

CAUTION: With text-shadow, characters are reproduced and drawn several times over. The problem of accessibility may occur with Tagged PDF.

[XSL1.1] text-shadow


Text Transformation

axf:normalize / CSS -ah-normalize

Specifies the normalization of text. no-LT

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.

CAUTION: Please keep in mind that U+00A0, which is a meaningful code as FO, will be transformed to U+0020, etc. by performing the normalization with NFKC, for example.

This feature is not available with AH Formatter V6.2 Lite.

axf:normalize-exclude / CSS -ah-normalize-exclude

Specifies whether Composition Exclusions are excluded or not when the normalization (axf:normalize) is specified. no-LT

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 AH Formatter V6.2 Lite.

axf:text-replace / CSS (-ah-)text-replace

Replaces the character strings. [CSS3-GCPM] Character substitution

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

Values have the following meanings.

none

Do 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 at the end.

axf:number-transform / CSS -ah-number-transform

Converts the number sequence in the character string. no-LT

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

Do 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. Nothing is changed when it's not the vertical writing.

<list-style-type>

Among the list-style-type defined by CSS, the number related types which can be specified are <algorithmic>, <numeric>, <alphabetic>, <symbolic>, <non-repeating>. Convertible digit numbers may differ depending on list-style-type. Too long number sequence cannot be converted.

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

CSS (-ah-)list-style-type

Specifies the list style. [CSS3-Lists] List Content: The 'list-style-type' property

Value: <glyph> | <algorithmic> | <numeric> | <alphabetic> | <symbolic> | <non-repeating> | normal | none
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

  • none
  • normal
  • <glyph>
  • <algorithmic>
    • upper-roman
      It is the same as format="I". Use LATIN CAPITAL LETTER, such as U+0049, U+0058 etc. Numerical values up to 39999 can be expressed.
    • lower-roman
      It is the same as format="i." Use LATIN SMALL LETTER, such as U+0069, U+0078 etc. Numerical values up to 3999 can be expressed.
    • armenian, lower-armenian
      Same as format="&#x0561;".
    • upper-armenian
      Same as format="&#x0531;".
    • georgian
      Same as format="&#x10D0;".
    • ethiopic-numeric
      Same as format="&#x1369;".
    • tamil
      Same as format="&#x0BE7;".
    • hebrew
      Same as format="&#x05D0;".
    • cjk-ideographic, japanese-informal
      Same conversion as:
      axf:number-transform="kansuji"
      axf:kansuji-style="readable"
      axf:kansuji-letter="kanji"
      
    • japanese-formal
      Same conversion as:
      axf:number-transform="kansuji"
      axf:kansuji-style="readable"
      axf:kansuji-letter="〇壱弐参"
      axf:kansuji-grouping-letter="拾"
      
    • japanese-formal-obsolete
      Same conversion as:
      axf:number-transform="kansuji"
      axf:kansuji-style="readable"
      axf:kansuji-letter="〇壹貳參肆伍陸柒捌玖"
      axf:kansuji-grouping-letter="拾佰阡萬"
      
  • <numeric>
    • decimal
      Same as format="1".
    • decimal-leading-zero
      Same as format="01".
    • super-decimal
      Same asformat="&#x00B9;".
    • arabic-indic
      Same as format="&#x0661;".
    • bengali
      Same as format="&#x09E7;".
    • cambodian, khmer
      Same as format="&#x17E1;".
    • devanagari
      Same as format="&#x0967;".
    • gujarati
      Same as format="&#x0AE7;".
    • gurmukhi
      Same as format="&#x0A67;".
    • kannada
      Same asformat="&#x0CE7;".
    • lao
      Same as format="&#x0ED1;".
    • malayalam
      Same as format="&#x0D67;".
    • mongolian
      Same as format="&#x1811;".
    • myanmar
      Same as format="&#x1041;".
    • oriya
      Same as format="&#x0B67;".
    • persian, urdo
      Same as format="&#x06F1;".
    • telugu
      Same as format="&#x0C67;".
    • tibetan
      Same as format="&#x0F21;".
    • thai
      Same as format="&#x0E51;".
    • cjk-decimal
      Same as format="&#x4E00;".
    • fullwidth-decimal
      Same as format="&#xFF11;".
    • binary
      Generates binary numbers. It cannot be specified by format.
    • octal
      Generates octal numbers. It cannot be specified by format.
    • upper-hexadecimal
      Generates upper-case hexadecimal numbers. It cannot be specified by format.
    • lower-hexadecimal
      Generates lower-case hexadecimal numbers. It cannot be specified by format.
  • <alphabetic>
    • lower-alpha, lower-latin
      Same as format="a".
    • upper-alpha, upper-latin
      Same as format="A".
    • lower-greek
      Same as format="&#x03B1".
    • upper-greek
      Same as format="&#x0391".
    • lower-norwegian
      Same as format="&#x00C5;".
    • upper-norwegian
      Same as format="&#x00E5;".
    • cjk-earthly-branch
      Same as format="&#x5B50;".
    • cjk-heavenly-stem
      Same as format="&#x7532;".
    • hiragana
      Same as format="&#x3042;".
    • hiragana-iroha
      Same as format="&#x3044;".
    • katakana
      Same as format="&#x30A2;".
    • katakana-iroha
      Same as format="&#x30A4;".
    • hangul
      Same as format="&#xAC00;".
    • hangul-consonant
      Same as format="&#x3131;".
    • fullwidth-lower-roman
      Same as format="&#xFF49;".
    • fullwidth-upper-roman
      Same as format="&#xFF29;".
    • fullwidth-lower-alpha, fullwidth-lower-latin
      Same as format="&#xFF41;".
    • fullwidth-upper-alpha, fullwidth-upper-latin
      Same as format="&#xFF21;".
    • halfwidth-katakana
      Same as format="&#xFF71;"
    • halfwidth-katakana-iroha
      Same as format="&#xFF72;".
  • <symbolic>
    • asterisks
      Same as format="**". Numerical values up to 999 can be expressed.
    • footnotes
      Same as format="&#x002A;&#x2051;&#x2020;&#x2021;". Numerical values up to 999 can be expressed.
  • <non-repeating>
    • circled-decimal
      Same as format="&#x2460;". Numerical values of 0 to 20 can be expressed.
    • dotted-decimal
      Same as format="&#x2488;". Numerical values of 1 to 20 can be expressed.
    • double-circled-decimal
      Same as format="&#x24F5;". Numerical values of 1 to 10 can be expressed.
    • filled-circled-decimal
      Same as format="&#x24EB;". Numerical values of 11 to 20 can be expressed.
    • parenthesised-decimal
      Same as format="&#x2474;". Numerical values of 1 to 20 can be expressed.
    • circled-lower-latin
      Same as format="&#x24D0;". Numerical values of 1 to 26 can be expressed.
    • circled-upper-latin
      Same as format="&#x24B6;". Numerical values of 1 to 26 can be expressed.
    • parenthesised-lower-latin
      Same as format="&#x249C;". Numerical values of 1 to 26 can be expressed.

Japanese Numerals

AH Formatter V6.2 can convert numbers into Japanese numerals using axf:number-transform. This function is not available with AH Formatter V6.2 Lite.

axf:kansuji-style / CSS -ah-kansuji-style

Specifies the style used for Japanese numerals. no-LT

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

Specifies the character used for Japanese numerals. no-LT

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 specify 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 specify axf:kansuji-letter="0123456789".

0 : U+FF10
1 : U+FF11
2 : U+FF12
3 : U+FF13
4 : U+FF14
5 : U+FF15
6 : U+FF16
7 : U+FF17
8 : U+FF18
9 : 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 to "一二三", specify axf:kansuji-letter="〇壱弐参四五六七八九". If you specify only the head part like axf:kansuji-letter="〇壱弐参", it is compensated 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

Specifies the grouping character used for Japanese numerals. no-LT

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 regarded as "十百千万億兆京垓𥝱穣溝澗正載極". Please 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
百 : U+767E
千 : U+5343
万 : U+4E07
億 : U+5104
兆 : U+5146
京 : U+4EAC
垓 : U+5793
𥝱 : U+25771
穣 : U+7A63
溝 : U+6E9D
澗 : U+6F97
正 : U+6B63
載 : U+8F09
極 : U+6975

拾 : U+62FE
佰 : U+4F70
阡 : U+9621
萬 : U+842C


Ligature

axf:ligature-mode / CSS -ah-ligature-mode

Specifies whether to perform the ligature processing.

Value: none | [ latin || kana ] | 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 European languages. It is processed when the scripts are the followings.

  • 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 European languages and the ligature of symbols are included in JIS X 0213:2004, these are processed by ligature-mode="latin".

all

latin and kana are considered to be specified.

auto

Dependent on the system setting.

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 AH Formatter V6.2 Lite.

You can specify whether ligatures for European languages are performed or not by latin-ligature in the Option Setting File. These can also be set in the Option Setting dialog in GUI.

axf:japanese-glyph / CSS -ah-japanese-glyph

Specifies the glyph of Japanese Kanji. Applied only to the Japanese Kanji that has the substitution function for the specific Open type.

Value: none | jp78 | jp83 | jp90 | jp04
Initial: none
Applies to: all block-level and inline-level formatting objects
Inherited: yes
Percentages: N/A

Values have the following meanings.

none

Nothing is done.

jp78

jp78 is applied. Nothing is done when the font does not have jp78.

jp83

Jp83 is applied. Nothing is done when the font does not have jp83.

jp90

Jp90 is applied. Nothing is done when the font does not have jp90.

jp04

Jp04 is applied. Nothing is done when the font does not have jp04.

The glyph of Japanese Kanji is changed more than a little by JIS in which it is being defined. Some of the Open Type font have glyphs that correspond to JIS respectively. The glyphs of such fonts can be specified by the japanese-glyph property.

CAUTION: AH Formatter V6.2 supports Unicode Variation Sequence. We recommend to use the feature of Variation Sequence as much as possible for Japanese Kanji.
CAUTION: In AH Formatter V6.2, the specification of <string> is not recommended. Please use font-variant.

axf:alt-glyph / CSS -ah-alt-glyph

Specifies the alternative glyph of a character.

Value: <number> | <string> <number>?
Initial: 0
Applies to: all block-level and inline-level formatting objects
Inherited: yes
Percentages: N/A

Values have the following meanings.

<number>

Specifies the order of the alternative glyph. 0 is a standard glyph. When the specified order is beyond the number of the glyph which is contained in the font, it is regarded as 0.

<string>

Specifies the tag of OpenType GSUB feature. If omitted, it is regarded as aalt. <number> is required or not required depending on the tag. When <number> is omitted even if it's necessary, it is regarded as 1. The following tags can be specified.

  • aalt
  • nalt

CAUTION: In AH Formatter V6.2, the specification of <string> is not recommended. Please use font-variant="annotation(<number>)" for nalt.

Some of the OpenType fonts have some alternative glyphs against a certain glyph. In such a font, a glyph can be chosen with the alt-glyph property. AH Formatter V6.2 doesn't offer the method to investigate what type and how many glyphs are contained. It is applied only to the script associated with Kanji, Hiragana, Katakana, Latin, Greek, Cyrillic and Number.


URI and Link

axf:base-uri / CSS -ah-base-uri

The axf: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: "http://www.antennahouse.co.jp/xsl-info/Thai/THAI-BangKokNationalMuseum.pdf".

<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format"
         xmlns:axf="http://www.antennahouse.com/names/XSL/Extensions"
         axf:base-uri="http://www.antennahouse.co.jp/xsl-info/">
                  :
                  :
<fo:basic-link external-destination="Thai/THAI-BangKokNationalMuseum.pdf">
    ...
</fo:basic-link>

CSS -ah-link

Generates a hyper-link.

Value: <uri-specification> | none
Initial: N/A
Applies to: all inline elements
Inherited: no
Percentages: N/A

☞ [XSL1.1] 7.23.6 external-destination, 7.23.8 internal-destination, xlink:href


Page Number

AH Formatter V6.2 provides extension properties to control the page number.

axf:suppress-duplicate-page-number / CSS -ah-suppress-duplicate-page-number

The axf:suppress-duplicate-page-number specifies to delete the duplicated page numbers.

CAUTION: A similar function is equipped in XSL1.1. Please make use of marge-*-index-key-reference.
Value: true | false
Initial: false
Applies to: all formatting objects
Inherited: yes
Percentages: N/A

When formatting a 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, page numbers are output repeatedly using the standard property.

For example:

When axf:suppress-duplicate-page-number is not specified.

<fo:block text-align-last="justify">
 <fo:block>bcd
  <fo:leader lender-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 lender-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 lender-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 lender-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:page-number-prefix

The axf:page-number-prefix sets the prefix of page number.

CAUTION: A similar function is equipped in XSL1.1. Please make use of fo:folio-prefix.
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

The 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"/>

See also fo:page-number-citation-last in XSL1.1.

axf:origin-id

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 to be 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.

AH Formatter V6.2 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

The 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

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


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.

CAUTION: Placing the line numbering for the page formatted complexly with fo:block-container or fo:table, etc. might get unintended consequences. Please apply the line numbering to a simple structural document as much as possible.

This function is not available with AH Formatter V6.2 Lite.

axf:line-number / CSS -ah-line-number

The axf:line-number specifies whether to show line numbers. no-LT

Value: none | show | hide
Initial: none
Applies to: all block-level formatting objects which are descendants of fo:flow, fo:table-column V6.2
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 added 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. The backward reference is invalid. V6.2

This property is not available with AH Formatter V6.2 Lite.

axf:line-number-background-color / CSS -ah-line-number-background-color

The axf:line-number-background-color specifies the background color of line numbers. no-LT

Value: <color> | transparent
Initial: transparent
Applies to: all block-level formatting objects which are descendants of fo:flow, fo:table-column V6.2
Inherited: yes
Percentages: N/A

This property is not available with AH Formatter V6.2 Lite.

axf:line-number-color / CSS -ah-line-number-color

The axf:line-number-color specifies the color of line numbers. no-LT

Value: <color>
Initial: the value of the 'color' property
Applies to: all block-level formatting objects which are descendants of fo:flow, fo:table-column V6.2
Inherited: yes
Percentages: N/A

This property is not available with AH Formatter V6.2 Lite.

axf:line-number-display-align / CSS -ah-line-number-display-align

The axf:line-number-display-align specifies the alignment, in the block-progression-direction, of line numbers in the line area. no-LT

Value: auto | before | center | after
Initial: auto
Applies to: all block-level formatting objects which are descendants of fo:flow, fo:table-column V6.2
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 AH Formatter V6.2 Lite.

axf:line-number-font-family / CSS -ah-line-number-font-family

The axf:line-number-font-family specifies the font family of line numbers. no-LT

Value: [ <family-name> | <generic-family> ]#
Initial: depends on UA
Applies to: all block-level formatting objects which are descendants of fo:flow, fo:table-column V6.2
Inherited: yes
Percentages: N/A

This property is not available with AH Formatter V6.2 Lite.

axf:line-number-font-size / CSS -ah-line-number-font-size

The axf:line-number-font-size specifies the font size of line numbers. no-LT

Value: <absolute-size> | <relative-size> | <length> | <percentage>
Initial: medium
Applies to: all block-level formatting objects which are descendants of fo:flow, fo:table-column V6.2
Inherited: yes
Percentages: refer to the font size

This property is not available with AH Formatter V6.2 Lite.

axf:line-number-font-style / CSS -ah-line-number-font-style

The axf:line-number-font-style specifies whether to make the font style italic. no-LT

Value: normal | italic
Initial: normal
Applies to: all block-level formatting objects which are descendants of fo:flow, fo:table-column V6.2
Inherited: yes
Percentages: N/A

This property is not available with AH Formatter V6.2 Lite.

axf:line-number-font-weight / CSS -ah-line-number-font-weight

The axf:line-number-font-weight specifies the font weight of line numbers. no-LT

Value: normal | bold | bolder | lighter | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900
Initial: normal
Applies to: all block-level formatting objects which are descendants of fo:flow, fo:table-column V6.2
Inherited: yes
Percentages: N/A

This property is not available with AH Formatter V6.2 Lite.

axf:line-number-format / CSS -ah-line-number-format

The axf:line-number-format specifies the format of line numbers. no-LT

Value: <string>
Initial: 1
Applies to: fo:page-sequence
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 AH Formatter V6.2 Lite.

axf:line-number-initial / CSS -ah-line-number-initial

The axf:line-number-initial specifies the line number of the first line. no-LT

Value: auto | <number>
Initial: auto
Applies to: fo:page-sequence
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.

This property is not available with AH Formatter V6.2 Lite.

axf:line-number-interval / CSS -ah-line-number-interval

The axf:line-number-interval specifies the interval of line numbers. no-LT

Value: <number> | auto
Initial: auto
Applies to: fo:page-sequence
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 AH Formatter V6.2 Lite.

axf:line-number-offset / CSS -ah-line-number-offset

The axf:line-number-offset specifies the offset of line numbers. no-LT

Value: <length>
Initial: 0pt
Applies to: all block-level formatting objects which are descendants of fo:flow, fo:table-column V6.2
Inherited: yes
Percentages: N/A

This property is not available with AH Formatter V6.2 Lite.

axf:line-number-orientation / CSS -ah-line-number-orientation

Rotates line numbers. no-LT

Value: 0 | 90 | 180 | 270 | -90 | -180 | -270
Initial: 0
Applies to: fo:page-sequence
Inherited: no
Percentages: N/A

Rotates line numbers with specified degrees.

This property is not available with AH Formatter V6.2 Lite.

axf:line-number-position / CSS -ah-line-number-position

The axf:line-number-position specifies the position of line numbers. no-LT

Value: start | end | inside | outside | alternate
Initial: start
Applies to: all block-level formatting objects which are descendants of fo:flow, fo:table-column V6.2
Inherited: yes
Percentages: N/A

Values have the following meanings.

start

Places line number at start-edge.

end

Places line number at end-edge.

inside

Places line number 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 multi-column layout, except for the last column, places it at start-edge.

This property is not available with AH Formatter V6.2 Lite.

axf:line-number-prefix / CSS -ah-line-number-prefix

The axf:line-number-prefix sets the prefix of line number. no-LT

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

Specifies the prefix for line numbers. Specified string will be outputted before the page number by axf:line-number.

This property is not available with AH Formatter V6.2 Lite.

axf:line-number-reset / CSS -ah-line-number-reset

The axf:line-number-reset resets line numbering. no-LT

Value: auto | none | page | column | force
Initial: auto
Applies to: fo:page-sequence, fo:block
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.

CAUTION: force can be specified only to fo:block. On the contrary, other values cannot be specified to fo:block.

This property is not available with AH Formatter V6.2 Lite.

axf:line-number-start / CSS -ah-line-number-start

The axf:line-number-start specifies the starting line number. no-LT

Value: <number> | auto
Initial: auto
Applies to: fo:page-sequence
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 AH Formatter V6.2 Lite.

axf:line-number-text-align / CSS -ah-line-number-text-align

The axf:line-number-text-align specifies the alignment of line numbers in the line area. no-LT

Value: auto | start | center | end | inside | outside | left | right
Initial: auto
Applies to: all block-level formatting objects which are descendants of fo:flow, fo:table-column V6.2
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 regarded as end. When the position of the line numbers is in the end side, it is regarded as start. The position of line numbers is specified by axf:line-number-position.

When axf:line-number-width is not specified, It is always regarded as auto.

This property is not available with AH Formatter V6.2 Lite.

axf:line-number-text-decoration / CSS -ah-line-number-text-decoration

The axf:line-number-text-decoration specifies the test decoration of line numbers. no-LT

Value: same as text-decoration
Initial: none
Applies to: all block-level formatting objects which are descendants of fo:flow, fo:table-column V6.2
Inherited: yes
Percentages: N/A

Values have the same meaning as text-decoration.

This property is not available with AH Formatter V6.2 Lite.

axf:line-number-width / CSS -ah-line-number-width

The axf:line-number-text-align specifies the width of line numbers. no-LT

Value: auto | <length>
Initial: auto
Applies to: all block-level formatting objects which are descendants of fo:flow, fo:table-column V6.2
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 AH Formatter V6.2 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 AH Formatter V6.2 Lite.

axf:line-continued-mark / CSS -ah-line-continued-mark

The axf:line-continued-mark specifies whether to show line continued marks. no-LT

Value: <string>
Initial: empty string
Applies to: all block-level formatting objects which 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.

CAUTION: Complicated character strings which consist of multiple scripts or complicated scripts, such as Arabic, Thai, etc., are not supported.

This property is not available with AH Formatter V6.2 Lite.

axf:line-continued-mark-background-color / CSS -ah-line-continued-mark-background-color

The axf:line-continued-mark-background-color specifies the background color of line continued marks. no-LT

Value: <color> | transparent
Initial: transparent
Applies to: all block-level formatting objects which are descendants of fo:flow
Inherited: yes
Percentages: N/A

This property is not available with AH Formatter V6.2 Lite.

axf:line-continued-mark-color / CSS -ah-line-continued-mark-color

The axf:line-continued-mark-color specifies the color of line continued marks. no-LT

Value: <color>
Initial: depends on the current line area
Applies to: all block-level formatting objects which are descendants of fo:flow
Inherited: yes
Percentages: N/A

This property is not available with AH Formatter V6.2 Lite.

axf:line-continued-mark-font-family / CSS -ah-line-continued-mark-font-family

The axf:line-continued-mark-font-family specifies the font family of line continued marks. no-LT

Value: [ <family-name> | <generic-family> ]#
Initial: depends on the current line area
Applies to: all block-level formatting objects which are descendants of fo:flow
Inherited: yes
Percentages: N/A

This property is not available with AH Formatter V6.2 Lite.

axf:line-continued-mark-font-size / CSS -ah-line-continued-mark-font-size

The axf:line-continued-mark-font-size specifies the font size of line continued marks. no-LT

Value: <absolute-size> | <relative-size> | <length> | <percentage>
Initial: depends on the current line area
Applies to: all block-level formatting objects which are descendants of fo:flow
Inherited: yes
Percentages: refer to the font size

This property is not available with AH Formatter V6.2 Lite.

axf:line-continued-mark-font-style / CSS -ah-line-continued-mark-font-style

The axf:line-continued-mark-font-style specifies whether to make the font style italic. no-LT

Value: normal | italic
Initial: depends on the current line area
Applies to: all block-level formatting objects which are descendants of fo:flow
Inherited: yes
Percentages: N/A

This property is not available with AH Formatter V6.2 Lite.

axf:line-continued-mark-font-weight / CSS -ah-line-continued-mark-font-weight

The axf:line-continued-mark-font-weight specifies the font weight of line numbers. no-LT

Value: normal | bold | bolder | lighter | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900
Initial: depends on the current line area
Applies to: all block-level formatting objects which are descendants of fo:flow
Inherited: yes
Percentages: N/A

This property is not available with AH Formatter V6.2 Lite.

axf:line-continued-mark-offset / CSS -ah-line-continued-mark-offset

The axf:line-continued-mark-offset specifies the offset of line continued marks. no-LT

Value: <length>
Initial: 0pt
Applies to: all block-level formatting objects which are descendants of fo:flow
Inherited: yes
Percentages: N/A

This property is not available with AH Formatter V6.2 Lite.


Revision Bar

AH Formatter V6.2 provides extension properties to layout the revision bars in the documents. The revision bar is shown above the border or the column rule.

CAUTION: A similar function is equipped in XSL1.1. Please make use of fo:change-bar-begin and fo:change-bar-end.

Revision Bar Model

axf:revision-bar-color / CSS -ah-revision-bar-color

The axf: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 which are descendants of fo:flow
Inherited: yes
Percentages: N/A

axf:revision-bar-offset / CSS -ah-revision-bar-offset

The axf:revision-bar-offset specifies the offset of the revision bar.

Value: <length>
Initial: 0pt
Applies to: all block-level and inline-level formatting objects which are descendants of fo:flow
Inherited: yes
Percentages: N/A

axf:revision-bar-position / CSS -ah-revision-bar-position

The axf: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 which 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

The axf: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 which are descendants of fo:flow
Inherited: yes
Percentages: N/A

axf:revision-bar-width / CSS -ah-revision-bar-width

The axf: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 which are descendants of fo:flow
Inherited: yes
Percentages: N/A

CSS (-ah-)change-bar-class

[CSS3-GCPM] Change bars

Value: <name>
Initial: N/A
Applies to: all elements
Inherited: no
Percentages: N/A

[XSL1.1] change-bar-class

CSS (-ah-)change-bar-color

[CSS3-GCPM] Change bars

Value: <color>
Initial: the value of the 'color' property
Applies to: all elements
Inherited: no
Percentages: N/A

[XSL1.1] change-bar-color

CSS (-ah-)change-bar-offset

[CSS3-GCPM] Change bars

Value: <length>
Initial: 6pt
Applies to: all elements
Inherited: no
Percentages: N/A

[XSL1.1] change-bar-offset

CSS (-ah-)change-bar-side

[CSS3-GCPM] Change bars

Value: start | end | left | right | inside | outside | alternate
Initial: start
Applies to: all elements
Inherited: no
Percentages: N/A

[XSL1.1] change-bar-placement

CSS (-ah-)change-bar-style

[CSS3-GCPM] Change bars

Value: <border-style>
Initial: none
Applies to: all elements
Inherited: no
Percentages: N/A

[XSL1.1] change-bar-style

CSS (-ah-)change-bar-width

[CSS3-GCPM] Change bars

Value: <border-width>
Initial: medium
Applies to: all elements
Inherited: no
Percentages: N/A

[XSL1.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 AH Formatter V6.2, 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 2 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 which 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 which 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 region-start or 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

The axf:footnote-stacking 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-position

The axf:footnote-position specifies the location to layout the footnote.

Value: 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 at the bottom of each page in region-body. This is the standard layout of XSL specification.

start

Footnotes are placed at each page in region-start.

end

Footnotes are placed at each page in region-end.

inside

Footnotes are placed at each even-page in region-end and each odd-page in region-start.

outside

Footnotes are placed at each even-page in region-start and each odd-page in region-end.

column

Footnotes are placed at the bottom of each column.

start-column

Footnotes are placed at the bottom of the first column.

end-column

Footnotes are placed at the bottom of the last column.

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.

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.

It is possible to arrange footnotes inside the region-start or the 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 limitations.

  • It is not possible to specify these values to fo:footnote. It is only available to specify them to region-body.
  • When you specify these values to 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.

axf:footnote-keep

Specifies whether to arrange a footnote and an anchor in the same page

Value: auto | always
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 following 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.

axf:footnote-max-height

Specifies the maximum height of footnote. V6.2

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 AH Formatter V6.1, page break (column break) did not occur within 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 auto-break-footnote="page height" is specified and page break (column break) occurs within footnote-body.

  • When axf:footnote-max-height="value" is specified

    The value must be a positive. auto-break-footnote is not referred to. At this time, page (column) break may occur within 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).

These property are not available with AH Formatter V6.2 Lite.

axf:suppress-duplicate-footnote

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 2 or more places in the same page. When axf:footnote-position="column" is specified, it is effective only for the footnote in the same column.

Footnote Numbering

These features are not available with AH Formatter V6.2 Lite.

<axf:footnote-number>

Common Usage:

Generates a footnote number. no-LT

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> which is a child of <fo:footnote>.

Contents:

EMPTY

This element is not available with AH Formatter V6.2 Lite.

<axf:footnote-number-citation>

Common Usage:

Cites a footnote number. no-LT

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 should be referenced by <axf:footnote-number> in the same anchor area.

Contents:

EMPTY

This element is not available with AH Formatter V6.2 Lite.

axf:footnote-number-format

Specifies the format of footnote number. no-LT

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 AH Formatter V6.2 Lite.

axf:footnote-number-initial

Specifies the initial footnote number. no-LT

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 AH Formatter V6.2 Lite.

axf:footnote-number-reset

Resets the footnote numbering. no-LT

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 AH Formatter V6.2 Lite.


Columns

In FO, these properties are placed as fo:region-body and fo:block-container.

CSS (-ah-)columns

[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-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-gap

[CSS3-Multicol] ‘column-gap’

Value: <length> | <percentage> (XSL) / <length> | normal (CSS)
Initial: 12pt (XSL) / normal (CSS)
Applies to: fo:region-body, fo:block-container
Inherited: refer to width of the fo:block-container
Percentages: N/A

CSS (-ah-)column-span

[CSS3-Multicol] ‘column-span’

Value: none | all
Initial: none
Applies to: static, non-floating elements
Inherited: no
Percentages: N/A

CSS (-ah-)column-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-fill

Specifies whether to balance the column height. [CSS3-Multicol] ‘column-fill’

Value: auto | balance
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

AH Formatter V6.2 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.

CAUTION: The following figure shows the associated width in FO. In CSS, the width of column-rule in column-gap is not taken into consideration.

Column Model

CSS (-ah-)column-rule

[CSS3-Multicol] ‘column-rule’

Value: <border-width> || <border-style> || [ <color> | transparent ]
Initial: see individual properties
Applies to: multi-column elements
Inherited: no
Percentages: N/A

axf:column-rule-align / CSS -ah-column-rule-align

The axf: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-color

The axf:column-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

axf:column-rule-display 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 the existing columns.

end

Displays a rule at the end side of the existing column. However, the most end side of the column is not included.

all

Displays all rules between the non-existing 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

The axf: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-style

The axf:column-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-width

The axf:column-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

CSS -ah-border-after

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 is a shorthand property for setting the width, style, and color of the after side.

CSS -ah-border-before

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 is a shorthand property for setting the width, style, and color of the before side.

CSS -ah-border-end

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 is a shorthand property for setting the width, style, and color of the end side.

CSS -ah-border-start

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 is a shorthand property for setting the width, style, and color of the start side.

CSS -ah-border-after-color

Specifies the border color of the after side.

Value: <color>
Initial: currentColor
Applies to: same as ‘border-color’
Inherited: no
Percentages: N/A

[XSL1.1] border-after-color

CSS -ah-border-before-color

Specifies the border color of the before side.

Value: <color>
Initial: currentColor
Applies to: same as ‘border-color’
Inherited: no
Percentages: N/A

[XSL1.1] border-before-color

CSS -ah-border-end-color

Specifies the border color of the end side.

Value: <color>
Initial: currentColor
Applies to: same as ‘border-color’
Inherited: no
Percentages: N/A

[XSL1.1] border-end-color

CSS -ah-border-start-color

Specifies the border color of the start side.

Value: <color>
Initial: currentColor
Applies to: same as ‘border-color’
Inherited: no
Percentages: N/A

[XSL1.1] border-start-color

CSS -ah-border-after-style

Specifies the border style of the after side.

Value: <border-style>
Initial: none
Applies to: same as ‘border-style’
Inherited: no
Percentages: N/A

[XSL1.1] border-after-style

CSS -ah-border-before-style

Specifies the border style of the before side.

Value: <border-style>
Initial: none
Applies to: same as ‘border-style’
Inherited: no
Percentages: N/A

[XSL1.1] border-before-style

CSS -ah-border-end-style

Specifies the border style of the end side.

Value: <border-style>
Initial: none
Applies to: same as ‘border-style’
Inherited: no
Percentages: N/A

[XSL1.1] border-end-style

CSS -ah-border-start-style

Specifies the border style of the start side.

Value: <border-style>
Initial: none
Applies to: same as ‘border-style’
Inherited: no
Percentages: N/A

[XSL1.1] border-start-style

CSS -ah-border-after-width

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

[XSL1.1] border-after-width

CSS -ah-border-before-width

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

[XSL1.1] border-before-width

CSS -ah-border-end-width

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

[XSL1.1] border-end-width

CSS -ah-border-start-width

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

[XSL1.1] border-start-width

CSS (-ah-)border-length

[CSS3-GCPM] The ‘border-length’ property

Value: <length> | auto
Initial: auto
Applies to: all elements
Inherited: no
Percentages: refer to width of element

Diagonal Border

AH Formatter V6.2 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

The axf: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

The axf: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

The axf: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

The axf: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

The axf: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

The axf: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

Rounding Border

axf:border-radius / CSS (-ah-)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

Specifies the radii of the rounded corners. [CSS3-Background] Curve Radii: the ‘border-radius’ properties

Border Radius

Value: [<length>|<percentage>] [<length>|<percentage>]?
Initial: 0
Applies to: all elements which can have borders
Inherited: no
Percentages: border box V6.2MR3

The first value is the horizontal radius (or vertical if the 'writing-mode' is vertical). 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. For rounded table borders, when border-collapse="collapse" is specified, border-radius is effective only when specified to fo:table.

Box Shadow

axf:box-shadow / CSS (-ah-)box-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 AH Formatter V6.2 Lite. V6.2 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 AH Formatter V6.2 Lite. V6.2 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. V6.2 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. V6.2

CAUTION:

The minimum unit of <length> which can be specified is 1/96in=0.265mm. The value is rounded to its multiple number.

CAUTION:

The blur is invalid with the device which cannot output transparency like PDF/X.


Table

<axf:table-cell-repeated-marker>

Common Usage:

Specifies the contents to be displayed in the split cell. V6.2 no-LT

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. This element is not available with AH Formatter V6.2 Lite.

axf:repeat-cell-content-at-break / CSS -ah-repeat-cell-content-at-break

axf: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 plural 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.

axf:repeat-footnote-in-table-footer / CSS -ah-repeat-footnote-in-table-footer

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 / CSS -ah-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.

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> in HTML. It doesn't affect the formatting result. It is outputted with Tagged PDF.

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

[XSL1.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

[XSL1.1] number-rows-spanned


Images, Multimedia

axf:alttext / CSS -ah-alttext / HTML alt

Specifies the alternate text of the image.

Value: <string>
Initial: empty string
Applies to: fo:external-graphic, fo:instream-foreign-object
Inherited: no
Percentages: N/A

Effective when outputting Tagged PDF. When there is no specification of axf:alttext, the value of the role property is used as an alternate text. But, since it's not an original use of the role property, it's not recommended.

axf:image-resolution / CSS (-ah-)image-resolution

Specifies the resolution of an image. [CSS3-GCPM] Image resolution

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.

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:background-content-width / CSS -ah-background-content-width
axf:background-content-height / CSS -ah-background-content-height
axf:background-content-type / CSS -ah-background-content-type
axf:background-scaling / CSS -ah-background-scaling

content-width, content-height, content-type, and scaling can be applied to background-image, which are the same properties applied to fo:external-graphic.

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

CSS (-ah-)background-clip

[CSS3-Background] The ‘background-clip’ property

Value: [border-box | padding-box | content-box | no-clip] [ , [border-box | padding-box | content-box | no-clip] ]*
Initial: border-box
Applies to: all elements
Inherited: no
Percentages: N/A

CSS (-ah-)background-origin

[CSS3-Background] The ‘background-origin’ property

Value: [border-box | padding-box | content-box] [, [border-box | padding-box | content-box]]*
Initial: padding-box
Applies to: all elements
Inherited: no
Percentages: N/A

CSS (-ah-)background-size

[CSS3-Background] The ‘background-size’ property

Value: [ [ <length> | <percentage> | auto ]{1,2} | cover | contain ] [ , [ <length> | <percentage> | auto ]{1,2} | cover | contain ]*
Initial: auto
Applies to: all elements
Inherited: no
Percentages: see text

axf:poster-image / CSS -ah-poster-image

Specifies the poster image for embedded multimedia. no-LT

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 AH Formatter V6.2 Lite.

See also Multimedia.

axf:poster-content-type / CSS -ah-poster-content-type

Specifies the content type of the poster image for embedded multimedia. no-LT

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 AH Formatter V6.2 Lite.

See also Multimedia.

axf:show-controls / CSS -ah-show-controls

Specifies whether to show the player control bar for multimedia. no-LT

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.

CAUTION: Whether the control bar is shown or not depends on the multimedia data, the viewer or the player.

This property is not available with AH Formatter V6.2 Lite.

See also Multimedia.

axf:media-volume / CSS (-ah-)media-volume

Specifies the volume of the sound when playing the multimedia. V6.2 no-LT

Value: <percentage>
Initial: 100%
Applies to: fo:external-graphic / multimedia objects
Inherited: no

CAUTION: Whether the setting is effective or not depends on the multimedia data, the viewer or the player.

This property is not available with AH Formatter V6.2 Lite.

axf:media-play-mode / CSS (-ah-)media-play-mode

Specifies the number of times to play the multimedia. V6.2 no-LT

Value: once | continuously | <number>
Initial: once
Applies to: fo:external-graphic / multimedia objects
Inherited: no

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.

CAUTION: Whether the setting is effective or not depends on the multimedia data, the viewer or the player.

This property is not available with AH Formatter V6.2 Lite.

axf:media-duration / CSS (-ah-)media-duration

Specifies the duration of a time period of the multimedia. V6.2 no-LT

Value: intrinsic | infinity | <number>
Initial: intrinsic
Applies to: fo:external-graphic / multimedia objects
Inherited: no

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.

CAUTION: Whether the setting is effective or not depends on the multimedia data, the viewer or the player.

This property is not available with AH Formatter V6.2 Lite.

axf:media-extraction-policy / CSS (-ah-)media-extraction-policy

Specifies whether the creation of temporary files is allowed or not when playing the multimedia. V6.2 no-LT

Value: tempnever | tempextract | tempaccess | tempalways
Initial: tempaccess
Applies to: fo:external-graphic / multimedia objects
Inherited: no

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.

CAUTION: Whether the setting is effective or not depends on the multimedia data, the viewer or the player.

This property is not available with AH Formatter V6.2 Lite.


Overflow Extensions

AH Formatter V6.2 extends the value of the overflow property and provides the extension property to regulate the behavior of the value.

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.

axf:overflow-condense / CSS -ah-overflow-condense

The axf:overflow-condense specifies how to condense the overflowed text within the region.

Value: letter-spacing | font-stretch | font-size | line-height | auto | none
Initial: auto
Applies to: all block-level formatting objects
Inherited: yes
Percentages: N/A

Values have the following meanings.

letter-spacing

Condenses the text by adjusting the letter spacing.

font-stretch

Condenses the text by adjusting the font width.

font-size

Condenses the text by adjusting the font size.

line-height

Condenses the text by adjusting the line height.

auto

Dependent on the system setting.

none

Specifies not to condense the text. This can also be specified to the in-line element and is not inherited.

Condensing the text within the region can be specified with the properties of overflow="condense". The adjustment for condensing the text includes both the inline progression direction and the block progression direction. The system will process the specified method by combining the methods considered as suitable.

There is a difference in the condensation process between inline and block. The condensation process occurs in the inline when there is only one line with <fo:inline-container> or <fo:block-container keep-together.within-line="always"> etc. In other cases, the condensation process occurs in the block.

The length of the absolute value specified inside the block will not be adjusted. For example, in the following case, the length will not be adjusted.

<fo:block-container width="4in" overflow="condense" axf:overflow-condense="font-size">
this text will be condenced
<fo:block font-size="24pt">no condenced text</fo:block>
</fo:block-container>

Moreover, when the adjustment by font-size or font-stretch in the block takes place, text-align-last="justify" is set implicitly. Please specify text-align-last="left" etc., explicitly when justify is unnecessary.

axf:overflow-condense-limit-font-size / CSS -ah-overflow-condense-limit-font-size

axf:overflow-condense-limit-font-size specifies the minimum font size when axf:overflow-condense="font-size" is specified.

Value: <length> [ visible | hidden | scroll | error-if-overflow | repeat ]
Initial: 0pt
Applies to: all block-level formatting objects
Inherited: yes
Percentages: N/A

Values have the following meanings.

<length>

Specifies the minimum font size. A font is not made smaller than that value. It is invalid when 0 or less are 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"

axf:overflow-condense-limit-font-stretch / CSS -ah-overflow-condense-limit-font-stretch

axf:overflow-condense-limit-font-stretch specifies the minimum value when axf:overflow-condense="font-stretch" is specified.

Value: [ <number> | <percentage> ] [ visible | hidden | scroll | error-if-overflow | repeat ]
Initial: 0
Applies to: all block-level formatting objects
Inherited: yes
Percentages: refer to the font size

Values have the following meanings.

<percentage>

Specifies the percentage against the minimum font width. Font size becomes above this percentage. The 0 or less percentage value is invalid.

<number>

Equivalent to <percentage> / 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"

axf:overflow-replace / CSS -ah-overflow-replace

An alternative character string for the specified overflow text.

Value: <string>
Initial: depends on system
Applies to: all block-level formatting objects
Inherited: yes
Percentages: N/A

When overflow="replace" is specified, the overflow text is replaced by repeating the specified string. The font shown by an alternative character string is decided to one font by the value of the script property or the typical script of its own. A complex character string cannot be specified.

axf:overflow-limit / CSS -ah-overflow-limit

Specifies the overflow limit value. V6.2MR3 no-LT

Value: <length>{1,2}
Initial: depends on system
Applies to: all formatting objects
Inherited: yes
Percentages: N/A

The lengths specify the overflow limit values. If one length is specified, it gives both the inline and block overflow limit values. If two are specified, the first gives the inline overflow limit value and the second the block overflow limit value. Lengths may not be negative.

When overflow="error-if-overflow" is specified, overflows greater than the overflow limit value are reported as error level 2 (warning) "Area Overflow" and smaller overflows are reported as error level 1 (information) "Area Overflow, minor".

The initial values of the overflow limit can be set by overflow-limit-inline and overflow-limit-block in the Option Setting File.

This is a shorthand property for setting axf:overflow-limit-inline and axf:overflow-limit-block.

This property is not available with AH Formatter V6.2 Lite.

axf:overflow-limit-inline / CSS -ah-overflow-limit-inline

Specifies the inline overflow limit value. V6.2MR3 no-LT

Value: <length>
Initial: depends on system
Applies to: all formatting objects
Inherited: yes
Percentages: N/A

The length specifies the inline overflow limit value. The length may not be negative.

See axf:overflow-limit for details.

This property is not available with AH Formatter V6.2 Lite.

axf:overflow-limit-block / CSS -ah-overflow-limit-block

Specifies the block overflow limit value. V6.2MR3 no-LT

Value: <length>
Initial: depends on system
Applies to: all formatting objects
Inherited: yes
Percentages: N/A

The length specifies the block overflow limit value. The length may not be negative.

See axf:overflow-limit for details.

This property is not available with AH Formatter V6.2 Lite.


Extended Applies

AH Formatter V6.2 has properties and elements whose applicable targets are extended.

<fo:change-bar-begin>

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

This extension is not available with AH Formatter V6.2 Lite.

Page Background

AH Formatter V6.2 provides extension properties to set the background of the page. These properties are placed as fo:simple-page-master or fo:page-sequence.

background-color

Value: <color> | transparent
Initial: transparent
Applies to: fo:simple-page-master, fo:page-sequence, all formatting objects
Inherited: no
Percentages: N/A

background-image

Value: <uri-specification> | none
Initial: none
Applies to: fo:simple-page-master, fo:page-sequence, all formatting objects
Inherited: no
Percentages: N/A

background-position-horizontal

Value: <percentage> | <length> | left | center | right
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: <percentage> | <length> | top | center | bottom
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-repeat

Following bold value is extended.

Value: repeat | repeat-x | repeat-y | no-repeat | paginate
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

Effective when embedding PDF in the background image and indicates to embed plural pages of PDF. For details, please refer to PDF Embedding. This value cannot be specified by AH Formatter V6.2 Lite.


Extended Values

AH Formatter V6.2 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 AH Formatter V6.2, 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, please do not use such specification.

display-align / CSS -ah-display-align

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

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 regarded as none.

font-stretch / CSS (-ah-)font-stretch

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 <percentage> / 100.

font-variant / CSS (-ah-)font-variant

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>) | ornament(<number>) | annotation(<number>) | styleset(<number>#) | character-variant(<number>#) V6.2
<font-variant-ligatures> = <common-lig-values> || <discretionary-lig-values> || <historical-lig-values> || <contextual-alt-values> V6.2
<common-lig-values> = common-ligatures | no-common-ligatures V6.2
<discretionary-lig-values> = discretionary-ligatures | no-discretionary-ligatures V6.2
<historical-lig-values> = historical-ligatures | no-historical-ligatures V6.2
<contextual-alt-values> = contextual | no-contextual V6.2
<font-variant-position> = sub | super V6.2
<font-variant-east-asian> = <east-asian-variant-values> || <east-asian-width-values> || ruby V6.2
<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.

force-page-count

Following bold values are extended.

Value: auto | even | doubly-even | odd | end-on-even | end-on-doubly-even | end-on-odd | 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.

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 specified page-sequence is set as a multiple number of A + B. A must be an integer greater than or equal to 1, B must be an integer greater than or equal to 0 and less than A. When B is omitted, it is regarded as 0. when end-on was specified, the page number of the last page of the specified page-sequence is applied. When document is specified, The number of the page counted from the beginning of the document is applied. For example (assuming 5 pages of content in a page sequence):

  • 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

format

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.

  • 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 Token Digits Description
    10
    U+0031U+0030 0 1 2 3 4 5 6 7 8 9 DIGIT
    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+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+0F21U+0F20 ༠ ༡ ༢ ༣ ༤ ༥ ༦ ༧ ༨ ༩ TIBETAN DIGIT
    U+1041U+1040 ၀ ၁ ၂ ၃ ၄ ၅ ၆ ၇ ၈ ၉ MYANMAR DIGIT
    U+17E1U+17E0 ០ ១ ២ ៣ ៤ ៥ ៦ ៧ ៨ ៩ KHMER DIGIT
    U+1811U+1810 ᠐ ᠑ ᠒ ᠓ ᠔ ᠕ ᠖ ᠗ ᠘ ᠙ MONGOLIAN DIGIT
    U+4E00U+3007 〇 一 二 三 四 五 六 七 八 九 CJK IDEOGRAPH DIGIT
    U+C77CU+C601 영 일 이 삼 사 오 육 칠 팔 구 HANGUL DIGIT
    U+FF11U+FF10 0 1 2 3 4 5 6 7 8 9 FULLWIDTH DIGIT

  • Roman Numerals

    Roman Numeral, such as I II III IV V VI VII VIII IX X ..., is generated.

    Format Token Numerals Description
    U+0049 (I) I V X L C D M ↁ ↂ LATIN CAPITAL LETTER I
    U+0069 (i) i v x l c d m LATIN 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

    Hebrew Numeral, such as ‭ א ב ג ד ה ... י אי בי גי די וט ..., is generated.

    Format Token Numerals Description
    U+05D0 (א) ‭ א ב ג ד ה ו ז ח ט י כ ל מ נ ס ע פ צ ק ר ש ת ך ם ן ף ץ HEBREW LETTER ALEF

    The specification of the grouping-separator and grouping-size properties are ignored and always regarded as grouping-separator=" " grouping-size="3".

  • Armenian Numerals

    Formats Armenian numerals. It's available to express up to 99999999.

    Format Token Numerals Description
    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 Token Numerals Description
    U+10D0 () ა ბ გ დ ე ვ ზ ჱ თ ი კ ლ მ ნ ჲ ო პ ჟ რ ს ტ უ ფ ქ ღ ყ შ ჩ ც ძ წ ჭ ხ ჴ ჯ ჰ ჵ GEORGIAN LETTER AN

  • Ethiopic Numerals

    Formats Ethiopic numerals.

    Format Token Numerals Description
    U+1369 () ፩ ፪ ፫ ፬ ፭ ፮ ፯ ፰ ፱ ፲ ፳ ፴ ፵ ፶ ፷ ፸ ፹ ፺ ETHIOPIC DIGIT ONE

  • Tamil Numerals

    Formats Tamil numerals.

    Format Token Numerals Description
    U+0BE7 () ௧ ௨ ௩ ௪ ௫ ௬ ௭ ௮ ௯ TAMIL DIGIT ONE

  • Alphabets

    Alphabets sequence, such as A B C ... Z AA AB AC ..., is generated.

    Format Token Alphabets Description
    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 Z LATIN 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 z LATIN 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 Token Characters Description
    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 regular expression of "*"" †""‡"" **""††"" ‡‡""***"" †††" "‡‡‡"... will be generated. 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 as a format token and generates the sequence of "上" "中" "下" "上上" "上中" "上下"... order.

internal-destination

Following bold value is extended. no-LT

Value: empty string | <idref> | <number-with-fragment>

Values have the following meanings.

<number-with-fragment>

Effective for the internal link in PDF. indicates 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 #. Refer to 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 regarded as the 1st page. However, when the top position is specified, it is regarded as 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

This property is not extended with AH Formatter V6.2 Lite.

leader-alignment

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.

overflow

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.

size / CSS (-ah-)size

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

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

Values have the following meanings.

<page-size>

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

<page-size> Short×Long
A3297×420mm
A4210×297mm
A5148×210mm
A6105×148mm
B4250×353mm
ISO-B4250×353mm
JIS-B4257×364mm
B5176×250mm
ISO-B5176×250mm
JIS-B5182×257mm
B6125×176mm
ISO-B6125×176mm
JIS-B6128×182mm
Letter8.5×11in
Legal8.5×14in
Ledger11×17in
Statement5.5×8.5in
Executive7.25×10.5in
Folio210×330mm
Quarto 8.5×10.83in
C 17×22in
D 22×34in
E 34×44in
ISO-Designated 110×220mm
ISO-C3 324×458mm
ISO-C4 229×324mm
ISO-C5 162×229mm
ISO-C6 114×162mm
Hagaki 100×148mm

table-omit-footer-at-break / CSS -ah-table-omit-footer-at-break

Following bold value is extended. no-LT

Value: true | false | column

Values have the following meanings.

column

Omits footer on column breaks, but not on page breaks.

This property is not extended with AH Formatter V6.2 Lite.

table-omit-header-at-break / CSS -ah-table-omit-header-at-break

Following bold value is extended. no-LT

Value: true | false | column

Values have the following meanings.

column

Omits header on column breaks, but not on page breaks.

This property is not extended with AH Formatter V6.2 Lite.

text-transform / CSS (-ah-)text-transform

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 Difference in Formatting with XSL Formatter V4.

fullwidth

Converts the character of U+0021 - U+007E into full width. no-LT

fullwidth-if-vertical

Only with the vertical writing (writing-mode="tb-rl"), text-transform="fullwidth" will be applied. Nothing is changed when it's not the vertical writing. no-LT

fullsize-kana

Converts small kana into regular kana. Only fullwidth (not halfwidth) characters are converted.


Extended Functions

AH Formatter V6.2 extends some FO functions and CSS functions.

rgb-icc()

The format of the argument which the rgb-icc function can accept is as follows. An identifier beginning with # is case insensitive. Formats using identifiers which begins with # are extended specifications in AH Formatter V6.2. The specified RGB is an alternative color. It is used when the devices (display etc.) cannot display CMYK or the separation color directly.

  • 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 as 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 AH Formatter PANTONE® Option, 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 as 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.

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() no-LT

Expresses the linear gradient. It can be specified as a value of background-image.

linear-gradient( [ [ <angle> | to <side-or-corner> ], ]? <color-stop>[, <color-stop> ]+ )
<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, percent and length for the gradient.

[CSS3-Images] Linear Gradients: the ‘linear-gradient()’ notation

This function is not available with AH Formatter V6.2 Lite.

radial-gradient() no-LT

Expresses the radial gradient. It can be specified as a value of background-image.

radial-gradient( [ [ <shape> || <size> ] [ at <position> ]? , | at <position>, ]? <color-stop> [ , <color-stop> ]+ )
<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 CSS2.1.

<color-stop>

Specifies the color, percent and length for the gradient.

[CSS3-Images] Radial Gradients: the ‘radial-gradient()’ notation

This function is not available with AH Formatter V6.2 Lite.

repeating-linear-gradient() no-LT

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

[CSS3-Images] Repeating Gradients: the ‘repeating-linear-gradient()’ and ‘repeating-radial-gradient()’ notations

This function is not available with AH Formatter V6.2 Lite.

repeating-radial-gradient() no-LT

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

[CSS3-Images] Repeating Gradients: the ‘repeating-linear-gradient()’ and ‘repeating-radial-gradient()’ notations

This function is not available with AH Formatter V6.2 Lite.

CSS counter()

Although any counter name can be specified to the ident argument in counter (ident, list-style-type) of CSS, there are some counter names defined already. Counters with these same names cannot be defined.

CSS attr()

[CSS3-Values] Attribute References: ‘attr()’

attr( <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> ]? )


CSS3 Properties

This section enumerates the properties based on CSS3 specification supported with AH Formatter V6.2 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 line-height of element

[XSL1.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

[XSL1.1] alignment-baseline

CSS (-ah-)baseline-shift

[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 line-height of parent element

[XSL1.1] baseline-shift

CSS (-ah-)bookmark-label

[CSS3-GCPM] Bookmarks

Value: content | <attr> | <string>
Initial: content
Applies to: all elements
Inherited: no
Percentages: N/A

axf:outline-title

CSS (-ah-)bookmark-level

[CSS3-GCPM] Bookmarks

Value: none | <integer>
Initial: none
Applies to: all elements
Inherited: no
Percentages: N/A

axf:outline-level

CSS (-ah-)bookmark-state

[CSS3-GCPM] Bookmarks

Value: open | closed
Initial: open
Applies to: block-level elements
Inherited: no
Percentages: N/A

axf:outline-expand

CSS (-ah-)box-decoration-break

[CSS3-Background] The ‘box-decoration-break’ property

Value: slice | clone
Initial: slice
Applies to: all elements
Inherited: no
Percentages: N/A

CSS (-ah-)box-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-after

[CSS3-Multicol] ‘break-before’, ‘break-after’, ‘break-inside’

Value: auto | always | page | column | avoid | avoid-page | avoid-column | left | right
Initial: auto
Applies to: block-level elements
Inherited: no
Percentages: N/A

[XSL1.1] break-after

CSS (-ah-)break-before

[CSS3-Multicol] ‘break-before’, ‘break-after’, ‘break-inside’

Value: auto | always | page | column | avoid | avoid-page | avoid-column | left | right
Initial: auto
Applies to: block-level elements
Inherited: no
Percentages: N/A

[XSL1.1] break-before

CSS (-ah-)break-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

[XSL1.1] keep-together

CSS (-ah-)crop

[CSS3-Content] The 'crop' property

Value: <shape> | auto
Initial: auto
Applies to: replaced elements
Inherited: no
Percentages: relative to intrinsic size

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

[XSL1.1] dominant-baseline

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

[XSL1.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

[XSL1.1] inline-progression-dimension

CSS -ah-margin-after

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

[XSL1.1] space-after

CSS -ah-margin-before

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

[XSL1.1] space-before

CSS -ah-margin-end

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

[XSL1.1] space-end, [XSL1.1] end-indent

CSS -ah-margin-start

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

[XSL1.1] space-start, [XSL1.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

[XSL1.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

[XSL1.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

[XSL1.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

[XSL1.1] inline-progression-dimension

CSS -ah-padding-after

Specifies the padding of the after side.

Value: <length> | <percentage>
Initial: 0
Applies to: same as ‘padding’
Inherited: no
Percentages: refer to the logical width of the containing block

[XSL1.1] padding-after

CSS -ah-padding-before

Specifies the padding of the before side.

Value: <length> | <percentage>
Initial: 0
Applies to: same as ‘padding’
Inherited: no
Percentages: refer to the logical width of the containing block

[XSL1.1] padding-before

CSS -ah-padding-end

Specifies the padding of the end side.

Value: <length> | <percentage>
Initial: 0
Applies to: same as ‘padding’
Inherited: no
Percentages: refer to the logical width of the containing block

[XSL1.1] padding-end

CSS -ah-padding-start

Specifies the padding of the start side.

Value: <length> | <percentage>
Initial: 0
Applies to: same as ‘padding’
Inherited: no
Percentages: refer to the logical width of the containing block

[XSL1.1] padding-start

CSS (-ah-)page

[CSS3-Page] Using named pages: ‘page’
[CSS3-GCPM] Named page lists

Value: auto | [ <identifier> ]+ auto?
Initial: auto
Applies to: block-level elements
Inherited: no
Percentages: N/A

CSS (-ah-)string-set

[CSS3-GCPM] Setting named strings: the ‘string-set’ property

Value: [[ <identifier> <content-list>] [, <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-align

[CSS2.1] 16.2 Alignment
[CSS3-Text] Text Alignment: the ‘text-align’ property

Value: start | end | left | right | inside | outside | center | justify | <string>
Initial: start
Applies to: all elements
Inherited: yes
Percentages: N/A

[XSL1.1] text-align

CSS (-ah-)text-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

[XSL1.1] text-align-last

CSS (-ah-)text-combine

[CSS3-WritingModes] Glyph Composition: the ‘text-combine’ property

Value: none | horizontal
Initial: none
Applies to: non-replaced inline elements
Inherited: no
Percentages: N/A

CSS (-ah-)vertical-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

[XSL1.1] vertical-align

CSS (-ah-)writing-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

[XSL1.1] writing-mode


Copyright © 1996-2014 Antenna House, Inc. All rights reserved.
Antenna House is a trademark of Antenna House, Inc.