Last updated: Apr 30, 2008

XSL FormatterXSL Formatter V4.3 Extensions

XSL Formatter V4.3 provides you with numerous XSL proprietary extension elements and properties. The following table shows a list of these elements.

When you use the extension properties, please be sure to specify the namespace URL http://www.antennahouse.com/names/XSL/Extensions

FYI: no-LT sign means that the item is not available with XSL Formatter V4.3 Lite.

XSL-FO
Sample Tutorial
XSL-FO 1.1 Conformance
XSL-FO 1.1 Test Suite
V4.3 Extensions
CGM Conformance
SVG Conformance
SVG 1.1 Test Suite
MathML Conformance
MathML 2.0 Test Suite
Element name Comments
<axf:document-info> 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: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:output-volume-info> Outputs PDF in Multi Separate Volume. no-LT
<axf:space-after-punctuation> Specifies the amount of space after the punctuation in European Typography. no-LT
<axf:space-before-punctuation> Specifies the amount of space before the punctuation in European Typography. no-LT
<axf:space-between-digit-and-punctuation> Specifies the amount of space between the digit and the punctuation in European Typography. no-LT
<axf:space-between-punctuation-and-digit> Specifies the amount of space between the punctuation and digit in European Typography. no-LT

Extended Properties

Property name Comments
axf:action-type Specifies the action of external link. no-LT
axf:alttext Specifies the alternate text of the image. no-LT
axf:annotation-contents Specifies the content of the annotation. no-LT
axf:annotation-color Specifies the color used for the background of the annotation. no-LT
axf:annotation-file-attachment Specifies the file with which file attachment annotation is related. no-LT
axf:annotation-flags Specifies the flag of the annotation. no-LT
axf:annotation-font-family Specifies the font family of the free text annotation. no-LT
axf:annotation-font-size Specifies the font size of the free text annotation. no-LT
axf:annotation-font-style Specifies whether to make the font of the free text annotation italic. no-LT
axf:annotation-font-weight Specifies the font weight of the free text annotation. no-LT
axf:annotation-height Specifies the height of the annotation. no-LT
axf:annotation-icon-name Specifies the name of the icon used for displaying the annotation. no-LT
axf:annotation-open Specifies the initial state of the annotation. no-LT
axf:annotation-position-horizontal Specifies the horizontal position of the annotation. no-LT
axf:annotation-position-vertical Specifies the vertical position of the annotation. no-LT
axf:annotation-text-color Specifies the color of the free text annotation. no-LT
axf:annotation-text-align Specifies the alignment of the free text annotation. no-LT
axf:annotation-title Specifies the title of the annotation. no-LT
axf:annotation-type Specifies the type of the annotation. no-LT
axf:annotation-width Specifies the width of the annotation. no-LT
axf:append-non-end-of-line-characters Specifies to append the non-end-of-line-characters. no-LT
axf:append-non-starter-characters Specifies to append the non-starter characters. no-LT
axf:assumed-page-number Specifies the assumed page number.
axf:assumed-page-number-prefix Specifies the assumed page number prefix.
axf:avoid-widow-words Specifies the spacing behavior so that the last line of the paragraph does not have only one word left. no-LT
axf:background-color Specifies the background color of a page.
axf:background-image Specifies the background image of a page.
axf:background-position-horizontal Specifies the the horizontal position of a background image of the page.
axf:background-position-vertical Specifies the vertical position of the background image of the page.
axf:background-repeat Specifies whether the background image of the page is repeated, and how.
axf:background-content-height Specifies the content height of a background image. no-LT
axf:background-content-type Specifies the content type of a background image. no-LT
axf:background-content-width Specifies the content width of a background image. no-LT
axf:background-scaling Specifies the scaling ratio of a background image. no-LT
axf:base-uri Specifies the location which becomes the base of relative URI.
axf:bleed Specifies the width of the bleed region for cutting off. no-LT
axf:bleed-bottom Specifies the width of the bleed region on the bottom for cutting off. no-LT
axf:bleed-left Specifies the width of the bleed region on the left for cutting off. no-LT
axf:bleed-right Specifies the width of the bleed region on the right for cutting off. no-LT
axf:bleed-top Specifies the width of the bleed region on the top for cutting off. no-LT
axf:bookmark-include Specifies how to include bookmarks of PDF in Multi Separate Volume. no-LT
axf:border-bottom-left-radius Specifies the bottom left border of the radius. no-LT
axf:border-bottom-right-radius Specifies the bottom right border of the radius. no-LT
axf:border-radius Specifies the border of the radius. no-LT
axf:border-top-left-radius Specifies the top left border of the radius. no-LT
axf:border-top-right-radius Specifies the top right border of the radius. no-LT
axf:box-shadow Specifies the box shadow. no-LT
axf:column-count Specifies the column count of the block. no-LT
axf:column-gap Specifies the column gap of the block. no-LT
axf:column-number-format Specifies the format of column number.
axf:column-rule-align Specifies the alignment of the column rule.
axf:column-rule-color Specifies the color of the column rule.
axf:column-rule-display Specifies whether to also display a rule at the place which does not have columns at the end of a page, etc.
axf:column-rule-length Specifies the length of the column rule.
axf:column-rule-style Specifies the style of the column rule.
axf:column-rule-width Specifies the width of the column rule.
axf:crop-offset Specifies the distance from the physical end to the trim size of the output medium. no-LT
axf:crop-offset-bottom Specifies the distance from the physical bottom edge to the trim size of the output medium. no-LT
axf:crop-offset-left Specifies the distance from the physical left edge to the trim size of the output medium. no-LT
axf:crop-offset-right Specifies the distance from the physical right edge to the trim size of the output medium. no-LT
axf:crop-offset-top Specifies the distance from the physical top edge to the trim size of the output medium. no-LT
axf:destination-type Specifies the type of destination for external links. no-LT
axf:diagonal-border-color Specifies the color of the diagonal border.
axf:diagonal-border-style Specifies the style of the diagonal border.
axf:diagonal-border-width Specifies the width of the diagonal border.
axf:except-non-end-of-line-characters Specifies to except the non-end-of-line-characters. no-LT
axf:except-non-starter-characters Specifies to except the non-starter characters. no-LT
axf:field-apply-signature Specifies whether to apply signature in the signature field. no-LT
axf:field-button-face Specifies the caption displayed in the push button field. no-LT
axf:field-button-face-down Specifies the caption displayed when pressing the push button. no-LT
axf:field-button-face-rollover Specifies the caption displayed when rolling over the push button. no-LT
axf:field-button-icon Specifies the icon displayed in the push button field. no-LT
axf:field-button-icon-down Specifies the icon displayed when pressing the push button. no-LT
axf:field-button-icon-rollover Specifies the icon displayed when rolling over the push button. no-LT
axf:field-button-layout Specifies the positioning between the caption and icon displayed in the push button field. no-LT
axf:field-checked Specifies the initial state of the check box and the radio button. no-LT
axf:field-checked-style Specifies the style of the check box and the radio button. no-LT
axf:field-default-text Specifies the text entered into the text field from the beginning. no-LT
axf:field-description Specifies the descriptive text of the filed. no-LT
axf:field-editable Specifies whether the value can be edited with the combo box. no-LT
axf:field-maxlen Specifies the maximum number of the characters which can be entered into the text field. no-LT
axf:field-multiline Specifies whether the text field is a single-line enterable field or a multi-line enterable field. no-LT
axf:field-multiple Specifies whether multiple items can be chosen in the list box. no-LT
axf:field-name Specifies the field name. no-LT
axf:field-password Specifies whether the text field requires the password or not. no-LT
axf:field-readonly Specifies whether the field is read-only or not. no-LT
axf:field-required Specifies whether the filed is enter-required or not. no-LT
axf:field-scroll Specifies whether the text field is scrollable or not. no-LT
axf:field-submit-coordinates Specified whether to send out the coordinates of the mouse when submitting a form field. no-LT
axf:field-submit-method Specifies the way to send the information when submitting a form field. no-LT
axf:field-top-index Specifies the first selected item in the list box, combo box. no-LT
axf:field-type Specifies the field type. no-LT
axf:field-value Specified the value used when submitting a form field, etc. no-LT
axf:footnote-align Specifies the alignment of the footnote. no-LT
axf:footnote-keep Specifies whether to arrange a footnote and an anchor in the same page. no-LT
axf:footnote-number-format Specifies the format of footnote number. no-LT
axf:footnote-number-initial Specifies the initial footnote number. no-LT
axf:footnote-number-reset Resets the footnote numbering. no-LT
axf:footnote-position Specifies whether to layout the footnotes in each column or not.
axf:footnote-stacking Specifies the method to layout the footnote. no-LT
axf:hanging-punctuation Specifies whether to wrap punctuation characters or not. no-LT
axf:hyphenation-minimum-character-count Specifies the minimum number of the character to hyphenate. no-LT
axf:hyphenation-zone Limits the range where a hyphenation is available. no-LT
axf:initial-volume-number Specifies the initial volume number of PDF in Multi Separate Volume. no-LT
axf:japanese-glyph Specifies the glyph of Japanese Kanji. no-LT
axf:justify-nbsp Specifies whether to include NON-BREAKING SPACE for justification or not.
axf:kerning-mode Specifies whether to process the kerning. no-LT
axf:line-break Specifies the method of line breaking. no-LT
axf:leader-expansion Specifies whether to expand leaders forcibly. no-LT
axf:ligature-mode Specifies whether to process the ligature. no-LT
axf:line-continued-mark Specifies whether to show line continued marks. no-LT
axf:line-continued-mark-background-color Specifies the background color of line continued marks. no-LT
axf:line-continued-mark-color Specifies the color of line continued marks. no-LT
axf:line-continued-mark-font-family Specifies the font family of line continued marks. no-LT
axf:line-continued-mark-font-size Specifies the font size of line continued marks. no-LT
axf:line-continued-mark-font-style Specifies whether to make the font style italic. no-LT
axf:line-continued-mark-font-weight Specifies the font weight of line continued marks. no-LT
axf:line-continued-mark-offset Specifies the offset of line continued marks. no-LT
axf:line-number Specifies whether to show line numbers. no-LT
axf:line-number-background-color Specifies the background color of line numbers. no-LT
axf:line-number-color Specifies the color of line numbers. no-LT
axf:line-number-display-align Specifies the alignment of line numbers in the block-progression-direction. no-LT
axf:line-number-font-family Specifies the font family of line numbers. no-LT
axf:line-number-font-size Specifies the font size of line numbers. no-LT
axf:line-number-font-style Specifies whether to make the font style italic. no-LT
axf:line-number-font-weight Specifies the font weight of line numbers. no-LT
axf:line-number-format Specifies the format of line numbers. no-LT
axf:line-number-initial Specifies the line number of the first line. no-LT
axf:line-number-interval Specifies the spacing between line numbers. no-LT
axf:line-number-offset Specifies the offset of line numbers. no-LT
axf:line-number-position Specifies the position of line numbers. no-LT
axf:line-number-reset Reset line numbering. no-LT
axf:line-number-start Specifies the starting line numbers. no-LT
axf:line-number-text-align Specifies the alignment of line numbers in the line area. no-LT
axf:line-number-text-decoration Specifies the text decoration of line numbers. no-LT
axf:line-number-width Specifies the width of line numbers. no-LT
axf:number-type Specifies whether to output the page number or to output the column number.
axf:origin-id Specifies the origin of the page number.
axf:outline-color Specifies the color of the title for the PDF bookmark. no-LT
axf:outline-expand Specifies whether to display the lower hierarchy or not.
axf:outline-external-destination Sets the external link in the PDF bookmark. no-LT
axf:outline-font-style Specifies the font style of the title for the PDF bookmark. no-LT
axf:outline-font-weight Specifies the font weight of the title for the PDF bookmark. no-LT
axf:outline-group Groups bookmark items of PDF, and outputs them collectively.
axf:outline-internal-destination Sets the internal link in the PDF bookmark. no-LT
axf:outline-level This indicates the hierarchy level of bookmark items.
axf:outline-title A string which appears as a title for bookmarks.
axf:output-volume-break Separates the PDF in multi volume. no-LT
axf:output-volume-filename Specifies the document file name in multi volume. no-LT
axf:overflow-condense Specifies how to condense the overflowed text within the region.
axf:overflow-condense-limit-font-size Specifies the minimum font size when axf:overflow-condense="font-size" is specified. no-LT
axf:overflow-condense-limit-font-stretch Specifies the minimum font size when axf:overflow-condense="font-stretch" is specified. V4.3 no-LT
axf:overflow-replace Specifies the alternative character string of the overflow text.
axf:page-number-prefix Sets the prefix of page number.
axf:physical-page-number Gets the physical page number.
axf:printer-duplex Specifies to print in duplex mode. no-LT
axf:printer-marks Specifies the printer marks, such as a crop mark. no-LT
axf:printer-marks-line-color Specifies the line color of the printer marks. no-LT
axf:printer-marks-line-length Specifies the line length of the printer marks. no-LT
axf:printer-marks-line-width Specifies the line width of the printer marks. no-LT
axf:printer-marks-zero-margin Specifies the margin between the page and the printer marks when bleed is 0. no-LT
axf:printer-bin-selection Selects the printer tray. no-LT
axf:punctuation-spacing Specifies the width of adjacent full width punctuations. no-LT
axf:punctuation-trim Specifies whether to treat full width punctuations as half width. no-LT
axf:repeat-cell-content-at-break Specifies whether to copy the contents of a cell when a cell breaks. no-LT
axf:repeat-page-sequence-master Specifies the repetition of the page sequence. no-LT
axf:reverse-diagonal-border-color Specifies the color of the reverse diagonal border.
axf:reverse-diagonal-border-style Specifies the style of the reverse diagonal border.
axf:reverse-diagonal-border-width Specifies the width of the reverse diagonal border.
axf:revision-bar-color Specifies the color of Revision Bar.
axf:revision-bar-offset Specifies the offset of Revision Bar.
axf:revision-bar-position Specifies the position of Revision Bar.
axf:revision-bar-style Specifies the style of Revision Bar.
axf:revision-bar-width Specifies the width of Revision Bar.
axf:soft-hyphen-treatment Specifies to output SOFT HYPHEN.
axf:suppress-duplicate-footnote Specifies to delete the duplicated footnotes.
axf:suppress-duplicate-page-number Specifies to delete the duplicated page numbers.
axf:suppress-if-first-on-page Specifies whether to suppress the block at the beginning of a page. no-LT
axf:text-align-first Specifies the text alignment of the first line.
axf:text-autospace Specifies whether to add space surrounding ideographic glyphs or not. no-LT
axf:text-autospace-width Specifies the width for axf:text-autospace. no-LT
axf:text-kashida-space Specifies the percentage of Kashida in Arabic. no-LT
axf:text-line-color Specifies the color of underline, strikethrough, and overline.
axf:text-line-style Specifies the style of underline, strikethrough, and overline.
axf:text-line-width Specifies the width of underline, strikethrough, and overline.
axf:text-underline-position Specifies the position of underline.
axf:vertical-underline-side Specifies the side for underline in vertical writing-mode. no-LT
axf:word-break Specifies whether to enable line breaking between word. no-LT

Extended Functions

Function name Comments
rgb-icc Extends the rgb-icc function.

Extended Values

Property name Comments
border-style
border-*-style
Extended the dot-dash, dot-dot-dash, and wave properties defined in 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.
font-stretch Extends the value of the font-stretch 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
overflow Extends the value of the overflow property.
text-align Extends the value of the page-position property.

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. XSL Formatter V4.3 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. XSL Formatter V4.3 assigns a script called Math to mathematical operators, such as U+2200 to U+22FF for the accommodation of MathML.


Document Information for PDF Output

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

A similar function is equipped in XSL1.1. Please make use of fo:bookmark.

<axf:document-info>

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

Common Usage:

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

Areas:

None.

Constraints:
<!ELEMENT axf:document-info EMPTY>
<!ATTLIST axf:document-info
  name   CDATA #REQUIRED
  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:

  • "title"

    Specifies the title of the document.

  • "subject"

    Specifies the subtitle of the document.

  • "author"

    Specifies the author of the document.

  • "keywords"

    Enumerates the comma-deliminated keyword.

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

  • "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="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 output, it is specified for the first separate volume.

With XSL Formatter V4.3 Lite, axf:document-info specified to fo:page-sequence is ignored.


PDF Output in Multi Separate Volume

XSL Formatter V4.3 makes it possible to out put PDF in Multi Separate Volume. These functions are not available with XSL Formatter V4.3 Lite.

<axf:output-volume-info>

Common Usage:

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

Areas:

None.

Constraints:
<!ELEMENT axf:output-volume-info EMPTY>
<!ATTLIST axf:output-volume-info
  initial-volume-number  NUMBER "1"
  format                 CDATA  "1"
  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.

The following conditions are required for the actual separate volume.

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 XSL Formatter V4.3 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 XSL Formatter V4.3 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 XSL Formatter V4.3 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 XSL Formatter V4.3 Lite.


Extension for European Rule

XSL Formatter V4.3 provides the extension for adjusting the amount of space before and after the punctuation in European Typography. These functions are not available with XSL Formatter V4.3 Lite. no-LT

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


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.

PDF bookmark

XSL Formatter V4.3 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

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.

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

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.

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

axf: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 XSL Formatter V4.3 Lite.

axf: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 XSL Formatter V4.3 Lite.

axf: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 XSL Formatter V4.3 Lite.

Remarks

  • These three object 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

PDF links can be created easily by using fo:basic-link.

PDF links are classified either as an internal link to a specified position in the PDF document, or as a 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 XSL Formatter V4.3 Lite.

The setting of external-destination for the external link in PDF conforms to the following specification of PDF parameters. Not all the parameters are effective with XSL Formatter V4.3. The invalid parameters are ignored.

This specification provides the following examples.

Only the following parameters are effective with XSL Formatter V4.3. The case sensitivity is ignored.

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, XSL Formatter V4.3 complies with the specification a little differently. show-destination property is invalid under the following conditions.

XSL Formatter V4.3 provides the following extension properties for the professional link.

axf:action-type

Specifies the action of external link or form action. no-LT

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.

submit no-LT

Submits a form filed as a form action and can be specified to axf:form-field.

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'. This property is not available with XSL Formatter V4.3 Lite.

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

Destination Type of PDFHow to specify axf:destination-type
[page /XYZ left top zoom] XSL Formatter V4.3 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] XSL Formatter V4.3 calculates the value of top. Effective only to specify in the internal link.
axf:destination-type="fith"
[page /FitV left] XSL Formatter V4.3 calculates the value of left.
axf:destination-type="fitv"
[page /FitR left bottom right top] XSL Formatter V4.3 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] XSL Formatter V4.3 calculates the value of top. Effective only to specify in the internal link.
axf:destination-type="fitbh"
[page /FitBV left] XSL Formatter V4.3 calculates the value of left.
axf:destination-type="fitbv"

This property is not available with XSL Formatter V4.3 Lite.

axf: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 XSL Formatter V4.3 Lite.

axf: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 simpe 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 XSL Formatter V4.3 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.

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

Annotation in PDF Output

Annotations can be added to PDF with XSL Formatter V4.3. 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 XSL Formatter V4.3 Lite.

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

Charcter strings are case insensitive.

This property is not available with XSL Formatter V4.3 Lite.

axf: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 not available with XSL Formatter V4.3 Lite.

axf: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 XSL Formatter V4.3 Lite.

axf: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 XSL Formatter V4.3 Lite.

axf: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 enumlating using the white space. They are case insensitive.

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

See also "PDF Reference" to learn more.

This property is not available with XSL Formatter V4.3 Lite.

axf: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 XSL Formatter V4.3 Lite.

axf: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) snows 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 XSL Formatter V4.3 Lite.

axf: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 XSL Formatter V4.3 Lite.

axf: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 XSL Formatter V4.3 Lite.

axf: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 XSL Formatter V4.3 Lite.

axf: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 XSL Formatter V4.3 Lite.

axf: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 XSL Formatter V4.3 Lite.

axf: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 XSL Formatter V4.3 Lite.

axf: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 XSL Formatter V4.3 Lite.

axf: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 XSL Formatter V4.3 Lite.

axf: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 XSL Formatter V4.3 Lite.

axf: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 XSL Formatter V4.3 Lite.

axf: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 XSL Formatter V4.3 Lite.


Acroform in PDF Output

It's possible to create PDF forms with XSL Formatter V4.3. Forms consist of the field to fill in the text and buttons, etc. Moreover, the action accompanied by push-button can be specified.

Forms can be specifided 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 does not function. <axf:form-field> other than these will work fine regardless of <axf:form>.

This function is not available with XSL Formatter V4.3 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

Specifies the digital signature field

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 filed. no-LT

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

axf:field-value

Specified 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 filed 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 filed is enter-required.

false

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

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 that 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-apply-signature

Specifies whether to apply a signature in the signature field. no-LT

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

Values have the following meanings.

true

Applies a signature in the signature field in PDF.

false

Does not apply a signature in the signature field in PDF.

The signature field can be specified automatically when generating PDF. See also Digital Signature in the PDF page for more details.

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

Specified 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. The user can selects only one of the radio buttons. Even if checked="true"are set multiply, only one button in a group is checked.

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

Listbox field

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

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

Digital Signature field

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

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

When performing the formatting process, the signature area is only reserved and the signature field is not generated. The signature field is generated and an actual signature is applied when generating PDF using PDF Digital Signature Module, When the PDF Digital Signature Module is not installed, neither generation of the signature field nor the actual signature can be performed. See also Digital Signature in the PDF Output page.

Form Actions

Form actions are realized by specifying the event to be triggerred and the action corresponding to the event to each field. In XSL Formatter V4.3, 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 can not 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" .../>

Printer Marks

XSL Formatter V4.3 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 XSL Formatter V4.3 Lite.

Printer Marks

axf:crop-offset
axf:crop-offset-top
axf:crop-offset-bottom
axf:crop-offset-left
axf: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
Inherited: no
Percentages: N/A

The trim size is specified by the page-width and page-height properties. 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 an individual value, 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, axf:crop-offset takes priority.

These properties are not available with XSL Formatter V4.3 Lite.

axf:bleed
axf:bleed-top
axf:bleed-bottom
axf:bleed-left
axf:bleed-right

Specifies the width of the bleed region for cutting off. no-LT

Value: <length>
Initial: 0pt
Applies to: fo:simple-page-master
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 an individual value, axf:bleed-top, axf:bleed-bottom, axf:bleed-left, and axf:bleed-right can be used. When axf:bleed and others are specified simultaneously, axf:bleed takes priority.

These properties are not available with XSL Formatter V4.3 Lite.

axf:printer-marks

Specifies the Printing marks, such as a crop mark. Specifies the action of external link. no-LT

Value: [ crop || cross || <uri-specification> [<uri-specification>]* ] | none
Initial: none
Applies to: fo:simple-page-master
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. Two 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 XSL Formatter V4.3 Lite.

axf:printer-marks-line-color

Specifies the line color of printer marks. no-LT

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

When the value is auto, the color is regarded as the registration color.

This property is not available with XSL Formatter V4.3 Lite.

axf:printer-marks-line-length

Specifies the line length of printer marks. no-LT

Value: <length> | auto
Initial: auto
Applies to: fo:simple-page-master
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 XSL Formatter V4.3 Lite.

axf:printer-marks-line-width

Specifies the line width of printer marks. no-LT

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

When the value is auto, the width depends on the system setting. The default width is 0.2pt.

This property is not available with XSL Formatter V4.3 Lite.

axf: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
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 XSL Formatter V4.3 Lite.


Printing

axf:printer-bin-selection

Selects the printer tray. no-LT

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

Effective only with the Windows version. 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 XSL Formatter V4.3 Lite.

axf:printer-duplex

Specifies to print in duplex mode. no-LT

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

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

  1. Simplex Printing.
  2. Duplex Printing. Flip on Long Edge. (The before edge of the first side of a page and the second side of a page are in the same way. )
  3. Duplex Printing. Flip on Short Edge. (The before edge of the first side of a page and the second side of a page are in the reverse way.)

This property is not available with XSL Formatter V4.3 Lite.


Base URI

The axf:base-uri specifies the location which becomes the base of relative URI. The value of axf:base-uri is applied to all relative URIs 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.

axf:base-uri

Value: <uri-specification>
Initial: empty string
Applies to: all formatting objects
Inherited: yes
Percentages: N/A

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>

Repeat Page Sequence

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.


Block Extensions

axf: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 | inherit
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 begining 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 XSL Formatter V4.3 Lite.

Block Column

Columns can be set inside of a block. Each extended property can be specified to fo:block-container.

axf:column-count

The axf:column-count specifies the number of columns of fo:block-container. no-LT

Value: <number> | inherit
Initial: 1
Applies to: fo:block-container
Inherited: no
Percentages: N/A

This property is not available with XSL Formatter V4.3 Lite.

axf:column-gap

The axf:column-count specifies the width of the separation between adjacent columns of fo:block-container. no-LT

Value: <length> | <percentage> | inherit
Initial: 12.0pt
Applies to: fo:block-container
Inherited: refer to width of the fo:block-container
Percentages: N/A

This property is not available with XSL Formatter V4.3 Lite.


Line Breaking

XSL Formatter V4.3 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

The axf:line-break specifies the method of line breaking. no-LT

Value: normal | strict | inherit
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.

17D6;NS # KHMER SIGN CAMNUC PII KUUH                         
203C;NS # DOUBLE EXCLAMATION MARK                           
203D;NS # INTERROBANG                                       
2047;NS # DOUBLE QUESTION MARK                               
2048;NS # QUESTION EXCLAMATION MARK                          
2049;NS # EXCLAMATION QUESTION MARK                          
3005;NS # IDEOGRAPHIC ITERATION MARK                            [JIS]
301C;NS # WAVE DASH                                         
303B;NS # VERTICAL IDEOGRAPHIC ITERATION MARK                    [JIS]
303C;NS # MASU MARK                                          
3041;NS # HIRAGANA LETTER SMALL A                               [JIS]
3043;NS # HIRAGANA LETTER SMALL I                               [JIS]
3045;NS # HIRAGANA LETTER SMALL U                               [JIS]
3047;NS # HIRAGANA LETTER SMALL E                               [JIS]
3049;NS # HIRAGANA LETTER SMALL O                               [JIS]
3063;NS # HIRAGANA LETTER SMALL TU                              [JIS]
3083;NS # HIRAGANA LETTER SMALL YA                              [JIS]
3085;NS # HIRAGANA LETTER SMALL YU                              [JIS]
3087;NS # HIRAGANA LETTER SMALL YO                              [JIS]
308E;NS # HIRAGANA LETTER SMALL WA                              [JIS]
3095;NS # HIRAGANA LETTER SMALL KA                               [JIS]
3096;NS # HIRAGANA LETTER SMALL KE                               [JIS]
309B;NS # KATAKANA-HIRAGANA VOICED SOUND MARK               
309C;NS # KATAKANA-HIRAGANA SEMI-VOICED SOUND MARK          
309D;NS # HIRAGANA ITERATION MARK                               [JIS]
309E;NS # HIRAGANA VOICED ITERATION MARK                        [JIS]
30A0;NS # KATAKANA-HIRAGANA DOUBLE HYPHEN                    
30A1;NS # KATAKANA LETTER SMALL A                               [JIS]
30A3;NS # KATAKANA LETTER SMALL I                               [JIS]
30A5;NS # KATAKANA LETTER SMALL U                               [JIS]
30A7;NS # KATAKANA LETTER SMALL E                               [JIS]
30A9;NS # KATAKANA LETTER SMALL O                               [JIS]
30C3;NS # KATAKANA LETTER SMALL TU                              [JIS]
30E3;NS # KATAKANA LETTER SMALL YA                              [JIS]
30E5;NS # KATAKANA LETTER SMALL YU                              [JIS]
30E7;NS # KATAKANA LETTER SMALL YO                              [JIS]
30EE;NS # KATAKANA LETTER SMALL WA                              [JIS]
30F5;NS # KATAKANA LETTER SMALL KA                              [JIS]
30F6;NS # KATAKANA LETTER SMALL KE                              [JIS]
30FB;NS # KATAKANA MIDDLE DOT                               
30FC;NS # KATAKANA-HIRAGANA PROLONGED SOUND MARK                [JIS]
30FD;NS # KATAKANA ITERATION MARK                               [JIS]
30FE;NS # KATAKANA VOICED ITERATION MARK                        [JIS]
31F0;NS # KATAKANA LETTER SMALL KU                               [JIS]
31F1;NS # KATAKANA LETTER SMALL SI                               [JIS]
31F2;NS # KATAKANA LETTER SMALL SU                               [JIS]
31F3;NS # KATAKANA LETTER SMALL TO                               [JIS]
31F4;NS # KATAKANA LETTER SMALL NU                               [JIS]
31F5;NS # KATAKANA LETTER SMALL HA                               [JIS]
31F6;NS # KATAKANA LETTER SMALL HI                               [JIS]
31F7;NS # KATAKANA LETTER SMALL HU                               [JIS]
31F8;NS # KATAKANA LETTER SMALL HE                               [JIS]
31F9;NS # KATAKANA LETTER SMALL HO                               [JIS]
31FA;NS # KATAKANA LETTER SMALL MU                               [JIS]
31FB;NS # KATAKANA LETTER SMALL RA                               [JIS]
31FC;NS # KATAKANA LETTER SMALL RI                               [JIS]
31FD;NS # KATAKANA LETTER SMALL RU                               [JIS]
31FE;NS # KATAKANA LETTER SMALL RE                               [JIS]
31FF;NS # KATAKANA LETTER SMALL RO                               [JIS]
A015;NS # YI SYLLABLE WU                                     
FE54;NS # SMALL SEMICOLON                                    
FE55;NS # SMALL COLON                                        
FF1A;NS # FULLWIDTH COLON                                   
FF1B;NS # FULLWIDTH SEMICOLON                               
FF65;NS # HALFWIDTH KATAKANA MIDDLE DOT                     
FF67;NS # HALFWIDTH KATAKANA LETTER SMALL A                     [JIS]
FF68;NS # HALFWIDTH KATAKANA LETTER SMALL I                     [JIS]
FF69;NS # HALFWIDTH KATAKANA LETTER SMALL U                     [JIS]
FF6A;NS # HALFWIDTH KATAKANA LETTER SMALL E                     [JIS]
FF6B;NS # HALFWIDTH KATAKANA LETTER SMALL O                     [JIS]
FF6C;NS # HALFWIDTH KATAKANA LETTER SMALL YA                    [JIS]
FF6D;NS # HALFWIDTH KATAKANA LETTER SMALL YU                    [JIS]
FF6E;NS # HALFWIDTH KATAKANA LETTER SMALL YO                    [JIS]
FF6F;NS # HALFWIDTH KATAKANA LETTER SMALL TU                    [JIS]
FF70;NS # HALFWIDTH KATAKANA-HIRAGANA PROLONGED SOUND MARK      [JIS]
FF9E;NS # HALFWIDTH KATAKANA VOICED SOUND MARK              
FF9F;NS # HALFWIDTH KATAKANA SEMI-VOICED SOUND MARK         

This property is not available with XSL Formatter V4.3 Lite.

axf:append-non-starter-characters

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

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

This property is not available with XSL Formatter V4.3 Lite.

axf:except-non-starter-characters

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

Value: <string>
Initial: empty string
Applies to: fo:page-sequence
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 chararters 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.

This property is not available with XSL Formatter V4.3 Lite.

axf:append-non-end-of-line-characters

Specifies the append-non-end-of-characters in CJK. no-LT

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

This property is not available with XSL Formatter V4.3 Lite.

axf:except-non-end-of-line-characters

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

Value: <string>
Initial: empty string
Applies to: fo:page-sequence
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 chararters 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.

This property is not available with XSL Formatter V4.3 Lite.

axf:word-break

The axf:word-break specifies whether to enable line breaking even between word. no-LT

Value: normal | break-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 for only the following scripts.

  • Latn
  • Cyrl
  • Grek
  • Zyyy

This property is not available with XSL Formatter V4.3 Lite.

axf:hyphenation-minimum-character-count

The axf:hyphenation-minimum-character-count specifies the minimum nunber of the character to hyphenate. no-LT

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

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

This property is not available with XSL Formatter V4.3 Lite.

axf:hyphenation-zone

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

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 zero or less value is specified.

This property is not available with XSL Formatter V4.3 Lite.


Trimming and Hanging

XSL Formatter V4.3 provides extension properties to trim and to hang.

axf:punctuation-trim

The axf:punctuation-trim specifies whether to treat full width punctuations as half width. no-LT

Value: none | start | end | both | auto | inherit
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.

end

Punctuation characters (close parenthesis etc.) at end of line are trimmed.

both

Punctuation characters at start and end of line are trimmed.

auto

Dependent on the system setting.

The initial value of whether punctuation characters are trimmed or not can be set by punctuation-trim in the Option Setting File. It can also be set in the Format Option Setting Dialog in the GUI.

This property is not available with XSL Formatter V4.3 Lite.

axf:kerning-mode

The axf:kerning-mode specifies whether to process the kerning. no-LT

Value: none | [ pair || contextual ] | auto | inherit
Initial: auto
Applies to: all block-level and inline-level formatting objects
Inherited: yes
Percentages: N/A

Values have the following meanings.

none

Adjacent full width punctuation characters are not trimmed.

pair

The pair kerning is processed.

contextual

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 non punctuation characters.
  • Between full width open parenthesis and full width open parenthesis.
  • Between full width middle dots and full width open parenthesis.
  • Between non punctuation character and full width open parenthesis.

Full width punctuation characters are treated the same as full width close parenthesis. By specifying axf:kerning-mode="contextual" the space between full width close parenthesis and non punctuation characters is not condensed. The space can be condensed by setting the value of axf:punctuation-spacing less than the default.

auto

Dependent on the system setting.

Full width punctuation open parenthesis processed by axf:kerning-mode="contextual" are:

2018;QU # LEFT SINGLE QUOTATION MARK                        
201C;QU # LEFT DOUBLE QUOTATION MARK                        
3008;OP # LEFT ANGLE BRACKET                                
300A;OP # LEFT DOUBLE ANGLE BRACKET                         
300C;OP # LEFT CORNER BRACKET                               
300E;OP # LEFT WHITE CORNER BRACKET                         
3010;OP # LEFT BLACK LENTICULAR BRACKET                     
3014;OP # LEFT TORTOISE SHELL BRACKET                       
3016;OP # LEFT WHITE LENTICULAR BRACKET                     
3018;OP # LEFT WHITE TORTOISE SHELL BRACKET                 
301A;OP # LEFT WHITE SQUARE BRACKET                         
301D;OP # REVERSED DOUBLE PRIME QUOTATION MARK              
FF08;OP # FULLWIDTH LEFT PARENTHESIS                        
FF3B;OP # FULLWIDTH LEFT SQUARE BRACKET                     
FF5B;OP # FULLWIDTH LEFT CURLY BRACKET                      
FF5F;OP # FULLWIDTH LEFT WHITE PARENTHESIS                   

Full width punctuation close parenthesis processed by axf:kerning-mode="contextual" are:

2019;QU # RIGHT SINGLE QUOTATION MARK                       
201D;QU # RIGHT DOUBLE QUOTATION MARK                       
3009;CL # RIGHT ANGLE BRACKET                               
300B;CL # RIGHT DOUBLE ANGLE BRACKET                        
300D;CL # RIGHT CORNER BRACKET                              
300F;CL # RIGHT WHITE CORNER BRACKET                        
3011;CL # RIGHT BLACK LENTICULAR BRACKET                    
3015;CL # RIGHT TORTOISE SHELL BRACKET                      
3017;CL # RIGHT WHITE LENTICULAR BRACKET                    
3019;CL # RIGHT WHITE TORTOISE SHELL BRACKET                
301B;CL # RIGHT WHITE SQUARE BRACKET                        
301E;CL # DOUBLE PRIME QUOTATION MARK                       
301F;CL # LOW DOUBLE PRIME QUOTATION MARK                   
FF09;CL # FULLWIDTH RIGHT PARENTHESIS                       
FF3D;CL # FULLWIDTH RIGHT SQUARE BRACKET                    
FF5D;CL # FULLWIDTH RIGHT CURLY BRACKET                     
FF60;CL # FULLWIDTH RIGHT WHITE PARENTHESIS                  

Full width punctuations processed by axf:kerning-mode="contextual" are:

3001;CL # IDEOGRAPHIC COMMA                                 
3002;CL # IDEOGRAPHIC FULL STOP                             
FF0C;CL # FULLWIDTH COMMA                                   
FF0E;CL # FULLWIDTH FULL STOP                               

Full width middle dots processed by axf:kerning-mode="contextual" are:

30FB;NS # KATAKANA MIDDLE DOT                               
FF1A;NS # FULLWIDTH COLON                                   
FF1B;NS # FULLWIDTH SEMICOLON                               

You can specify whether pair kernings for European languages is performed or not by pair-kerning in the Option Setting File. You can specify whether to trim the letter spacing or keep the same letter of full-width punctuations by punctuation-trim in the Option Setting Dialog. These can also be set in the Option Setting dialog In GUI.

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

This property is not available with XSL Formatter V4.3 Lite.

axf:punctuation-spacing

The axf:punctuation-spacing specifies the spacing between a full width punctuation and a full width character in Japanese. no-LT

Value: <length> | <percentage> | inherit
Initial: 50%
Applies to: all block-level and inline-level formatting objects
Inherited: yes
Percentages: refer to the font size

This space is used in axf:kerning-mode="contextual". The initial value of this space can be set by punctuation-spacing in the Option Setting File.

This property is not available with XSL Formatter V4.3 Lite.

axf:hanging-punctuation

The axf:hanging-punctuation specifies whether to hang Japanese punctuation characters or not. no-LT

Value: none | end | inherit
Initial: none
Applies to: fo:block
Inherited: yes
Percentages: N/A

Values have the following meanings.

none

Punctuation characters are not subject to hang.

end

Punctuation characters at end of line can hang.

Punctuation characters to be hanged are four Japanese punctuations (U+3001, U+3002, U+FF0C, U+FF0E).

This property is not available with XSL Formatter V4.3 Lite.

axf: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). no-LT

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 interval between Japanese characters or Western words.

false

Spacing behavior is not processed.

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.

This property is not available with XSL Formatter V4.3 Lite.


Spacing and Alignment

Adding Space

axf:text-autospace

The axf:text-autospace specifies whether to add space surrounding ideographic glyphs or not. no-LT

Value: none | [ ideograph-numeric || ideograph-alpha || ideograph-parenthesis || ideograph-punctuation ] | auto | inherit
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, Nl, and No classified by Unicode.

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.

This property is not available with XSL Formatter V4.3 Lite.

axf:text-autospace-width

The axf:text-autospace-width specifies the width for axf:text-autospace. no-LT

Value: <length> | <percentage> | inherit
Initial: 25%
Applies to: all block-level and inline-level formatting objects
Inherited: yes
Percentages: refer to the font size

This space is used in axf:text-autospace. In addition, the initial value of the space can be set by text-autospace-width in the Option Setting File.

This property is not available with XSL Formatter V4.3 Lite.

Text Alignment

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

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

Value: auto | force | inherit
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 Looooooooooooooooooooooooooooong Label ...
    ...................................... 10,20,30
    
  4. Very Looooooooooooooooooooooooooooong Label ...
    ... 10,20,30,40,50,60,70,80,90,100,110,120,130,
                                            140,150
    
  5. Very Very Very Looooooooooooooooooooooooooooong
    Long Long Label ...................... 10,20,30
    
  6. Very Very Very Looooooooooooooooooooooooooooong
    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 gets the result as expected.

This property is not available with XSL Formatter V4.3 Lite.

axf:text-kashida-space

Specifies the percentage of Kashida in Arabic justification. no-LT

Value: <percentage> | auto | inherit
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 the percentage can be set by text-kashida-space in the Option Setting File.

This property is not available with XSL Formatter V4.3 Lite.

axf:justify-nbsp

The axf;justify-nbsp specifies whether to justify NON-BREAKING SPACE or not. Generally, NON-BREAKING SPACE (U+00A0) is intended for justification. The axf:justify-nbsp property can be used when you do not want to include U+00A0 in justification. In V2.5, U+00A0 is not intended for justification. This property can also be specified for compatibility with V2.5.

Value: true | false | inherit
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.


Character and Text Decoration

axf:text-line-color

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

Value: auto | <color> | inherit
Initial: auto
Applies to: all elements with and generated content with textual content
Inherited: no
Percentages: N/A

axf:text-line-style

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

Value: <border-style> | inherit
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

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

Value: auto | <border-width> | inherit
Initial: auto
Applies to: all elements with and generated content with textual content
Inherited: no
Percentages: N/A

axf:text-underline-position

axf:text-underline-position specifies the position of underline.

Value: auto | before-edge | alphabetic | after-edge | <percentage> | <length> | inherit
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

axf:text-underline-position="alphabetic" places the baseline in the upper end of the height of an underline. axf:text-underline-position="0pt places the baseline at the center of the height of an underline.

axf:vertical-underline-side

The axf:vertical-underline-side specifies on which side of the text to put underline in vertical writing-mode. no-LT

Value: left | right | depend-on-language | auto | inherit
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 V4.2MR2

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.

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. This property is not available with XSL Formatter V4.3 Lite.

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.

XSL Formatter V4.3 implements the extension property axf:soft-hyphen-treatment whith makes it possible to eliminate this problem.

<fo:block axf:soft-hyphen-treatment="preserve" font-family="Wingdings">abc&#xAD;xyz

axf:soft-hyphen-treatment

Value: auto | preserve | inherit
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.


Ligature

axf:ligature-mode

Specifies whether to perform the ligature processing. no-LT

Value: none | [ latin || kana ] | all | auto | inherit
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 followngs.

  • 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, U+FB01 etc. defined in Unicode are not processed. That is, a sequence of U+0066 U+0069 are not substituted with U+FB0. If the ligature corresponding to U+0066 U+0069 is defined inside the font, its glyph will be outputted.

CAUTION: Type1 font is not supported.

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.

This property is not available with XSL Formatter V4.3 Lite.

axf:japanese-glyph

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

Value: none | jp78 | jp83 | jp90 | jp04 | inherit
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.

This property is not available with XSL Formatter V4.3 Lite.


Page Number

XSL Formatter V4.3 provides extension properties to control the page number.

axf:suppress-duplicate-page-number

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

Value: true | false
Initial: false
Applies to: all formatting objects
Inherited: yes
Percentages: N/A

When formatting 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

A similar function is equipped in XSL1.1. Please make use of marge-*-index-key-reference.

axf:page-number-prefix

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

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

Specifies the prefix for page numbers. Specified string will be outputted before the page number by fo:page-number and fo:page-number-citation. Also this string will be used as the page label in the PDF.

<fo:page-sequence axf:page-number-prefix="A-" format="i" initial-page-number="10">
  <fo:static-content ...>
   ...<fo:page-number/>...
  </fo:static-content>
  ...
</fo:page-sequence>

Arabic and Hebrew cannot be specified for the value of axf:page-number-prefix.

A similar function is equipped in XSL1.1. Please make use of fo:folio-prefix.

axf:physical-page-number

The axf:physical-page-number gets physical page number.

Value: true | false | inherit
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

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.

XSL Formatter V4.3 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:assumed-page-number-prefix

Specifies the assumed page number prefix.

Value: <string>
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. It is unknown at this time whether the reference area is inside of the same <fo:page-sequence>. When the reference area is in the different <fo:page-sequence>, the values of axf:page-number-prefix may differ. Then the temporary area is secured first, and when a reference place appears, it is adjusted to the right contents. If axf:page-number-prefix is specified to the current <fo:page-sequence>, it will be assumed as a temporary area. Otherwise, a suitable short character string will be assumed. 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 prefix at that time.

Even when axf:page-number-prefix is empty, it's not known whether it is empty at the time of the temporary formatting. Then a certain amount of the area will be secured. In order to deter this, please specify axf:assumed-page-number-prefix="''" to an suitable element. Since an area is not secured at this time, the setting of axf:page-number-prefix is ignored.

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.


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 XSL Formatter V4.3 Lite.

axf: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
Inherited: yes
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.

This property is not available with XSL Formatter V4.3 Lite.

axf: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
Inherited: yes
Percentages: N/A

This property is not available with XSL Formatter V4.3 Lite.

axf:line-number-color

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

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

This property is not available with XSL Formatter V4.3 Lite.

axf: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 | inherit
Initial: auto
Applies to: all block-level formatting objects which are descendants of fo:flow
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 XSL Formatter V4.3 Lite.

axf:line-number-font-family

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

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

This property is not available with XSL Formatter V4.3 Lite.

axf: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> | inherit
Initial: medium
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 XSL Formatter V4.3 Lite.

axf:line-number-font-style

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

Value: normal | italic | inherit
Initial: normal
Applies to: all block-level formatting objects which are descendants of fo:flow
Inherited: yes
Percentages: N/A

This property is not available with XSL Formatter V4.3 Lite.

axf: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 | inherit
Initial: normal
Applies to: all block-level formatting objects which are descendants of fo:flow
Inherited: yes
Percentages: N/A

This property is not available with XSL Formatter V4.3 Lite.

axf: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 XSL Formatter V4.3 Lite.

axf: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 equal to or more than 1. Actual initialization takes place at the time when axf:line-number-reset is specified.

This property is not available with XSL Formatter V4.3 Lite.

axf: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 XSL Formatter V4.3 Lite.

axf:line-number-offset

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

Value: <length> | inherit
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 XSL Formatter V4.3 Lite.

axf:line-number-position

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

Value: start | end | inside | outside | alternate | inherit
Initial: start
Applies to: all block-level formatting objects which are descendants of fo:flow
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 XSL Formatter V4.3 Lite.

axf:line-number-reset

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

Value: auto | none | page | column
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 none.

none

Line numbers are not reset.

page

Line numbers are reset when pages break.

column

Line numbers are reset when column break.

Line numbers are reset to the value specified to axf:line-number-initial.

This property is not available with XSL Formatter V4.3 Lite.

axf: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 previous fo:page-sequence is succeeded. When previous fo:page-sequence does not exist, it becomes 1.

<number>

Sets the line number that begins outputting to the value specified.

Line numbers are shown when the value is equal to or more than the value specified here. When axf:line-number-initial="1" axf:line-number-start="5" are specified, the first 4 lines are not shown but the 5th line starts being outputted. When axf:line-number-initial="5" axf:line-number-start="6" are specified, the first line is not shown but the next line is outputted as 6.

This property is not available with XSL Formatter V4.3 Lite.

axf: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 | inherit
Initial: auto
Applies to: all block-level formatting objects which are descendants of fo:flow
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 XSL Formatter V4.3 Lite.

axf: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
Inherited: yes
Percentages: N/A

Values have the same meaning as text-decoration.

This property is not available with XSL Formatter V4.3 Lite.

axf:line-number-width

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

Value: auto | <length> | inherit
Initial: auto
Applies to: all block-level formatting objects which are descendants of fo:flow
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 XSL Formatter V4.3 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 XSL Formatter V4.3 Lite.

axf: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 XSL Formatter V4.3 Lite.

axf: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 XSL Formatter V4.3 Lite.

axf:line-continued-mark-color

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

Value: <color> | inherit
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 XSL Formatter V4.3 Lite.

axf: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>],]* [<family-name> | <generic-family>] | inherit
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 XSL Formatter V4.3 Lite.

axf: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> | inherit
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 XSL Formatter V4.3 Lite.

axf: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 | inherit
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 XSL Formatter V4.3 Lite.

axf: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 | inherit
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 XSL Formatter V4.3 Lite.

axf:line-continued-mark-offset

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

Value: <length> | inherit
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 XSL Formatter V4.3 Lite.


Revision Bar

XSL Formatter V4.3 provides extension properties to layout the revision bars in the documents. The revision bar is shown above the border or the column rule.

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

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

Value: <color> | inherit
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

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

Value: <length> | inherit
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

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

Value: start | end | inside | outside | alternate | both | inherit
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

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

Value: <border-style> | inherit
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

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

Value: <border-width> | inherit
Initial: medium
Applies to: all block-level and inline-level formatting objects which are descendants of fo:flow
Inherited: yes
Percentages: N/A


Footnote

Footnote Positioning

With XSL Formatter V4.3, 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. no-LT

Value: auto | before | after
Initial: auto
Applies to: fo:region-body, fo:footnote
Inherited: no
Percentages: N/A

Values have the following meanings.

auto

Footnotes are placed automatically. Footnotes are the usual arrangement. When the text is one column, sidenotes are arranged with an anchor position, and in the case of two or more columns, sidenotes are arranged near by the before side.

before

Sidenotes are arranged near by the before side. In the case of usual footnotes 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. This property is not available with XSL Formatter V4.3 Lite.

axf:footnote-stacking

The axf:footnote-stacking specifies the method to layout the footnote. no-LT

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.

This property is not available with XSL Formatter V4.3 Lite.

axf:footnote-position

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

Value: page | start | end | inside | 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 no-LT

Footnotes are placed at each page in region-start. This value is not available with XSL Formatter V4.3 Lite.

end no-LT

Footnotes are placed at each page in region-end. This value is not available with XSL Formatter V4.3 Lite.

inside no-LT

Footnotes are placed at each even-page in region-end and each odd-page in region-start. This value is not available with XSL Formatter V4.3 Lite.

outside no-LT

Footnotes are placed at each even-page in region-start and each odd-page in region-end. This value is not available with XSL Formatter V4.3 Lite.

column

Footnotes are placed at the bottom of each column.

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.

axf:footnote-keep

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

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:suppress-duplicate-footnote

Specifies wether to delete footnotes duplicated in the same page.

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

Deters the display of duplicaited footnotes on the same footnote region when the same footnote is assigned to two or more places in the same page. When axf:footnote-position="column" is specified, it is effective only for the footnote in the same column.

Footnote Numbering

These functions are not available with XSL Formatter V4.3 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 XSL Formatter V4.3 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 XSL Formatter V4.3 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 XSL Formatter V4.3 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 more 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 XSL Formatter V4.3 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 XSL Formatter V4.3 Lite.


Borders

Column Rule

XSL Formatter V4.3 provides extension properties to layout the column rules in the column gaps. These properties are placed as fo:region-body and fo:block-container. The column rule is placed above the border and below the revision bar.

Column Model

axf:column-rule-align

The axf:column-rule-align specifies the alignment of the column rule.

Value: before | center | after | inherit
Initial: center
Applies to: fo:region-body, fo:block-container
Inherited: no
Percentages: N/A

axf:column-rule-color

The axf:column-rule-color specifies the color of the column rule.

Value: <color> | inherit
Initial: the value of the 'color' property
Applies to: fo:region-body, fo:block-container
Inherited: no
Percentages: N/A

axf:column-rule-display

axf:column-rule-display specifies whether to also display a rule at the place which does not have columns at the end of a page, etc.

Value: gap | end | all | inherit
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 a rule all between the non-existing columns at the end of a page, etc.

axf:column-rule-length

The axf:column-rule-length specifies the length of the column rule.

Value: <length> | <percentage>| inherit
Initial: 100%
Applies to: fo:region-body, fo:block-container
Inherited: no
Percentages: refer to the size of the column

axf:column-rule-style

The axf:column-rule-style specifies the style of the column rule.

Value: <border-style> | inherit
Initial: none
Applies to: fo:region-body, fo:block-container
Inherited: no
Percentages: N/A

axf:column-rule-width

The axf:column-rule-width specifies the width of the column rule.

Value: <border-width> | inherit
Initial: medium
Applies to: fo:region-body, fo:block-container
Inherited: no
Percentages: N/A

Diagonal Border

XSL Formatter V4.3 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

The axf:diagonal-border-color specifies the color of the diagonal border.

Value: <color> | inherit
Initial: the value of the 'color' property
Applies to: all FOs which can have borders
Inherited: yes
Percentages: N/A

axf:diagonal-border-style

The axf:diagonal-border-style specifies the style of the diagonal border.

Value: <border-style> | inherit
Initial: none
Applies to: all FOs which can have borders
Inherited: no
Percentages: N/A

axf:diagonal-border-width

The axf:diagonal-border-width specifies the width of the diagonal border.

Value: <border-width> | inherit
Initial: medium
Applies to: all FOs which can have borders
Inherited: yes
Percentages: N/A

axf:reverse-diagonal-border-color

The axf:reverse-diagonal-border-color specifies the color of the reverse diagonal border.

Value: <color> | inherit
Initial: the value of the 'color' property
Applies to: all FOs which can have borders
Inherited: yes
Percentages: N/A

axf:reverse-diagonal-border-style

The axf:reverse-diagonal-border-style specifies the style of the reverse diagonal border.

Value: <border-style> | inherit
Initial: none
Applies to: all FOs which can have borders
Inherited: no
Percentages: N/A

axf:reverse-diagonal-border-width

The axf:reverse-diagonal-border-width specifies the width of the reverse diagonal border.

Value: <border-width> | inherit
Initial: medium
Applies to: all FOs which can have borders
Inherited: yes
Percentages: N/A

Rounding Border

axf:border-radius
axf:border-top-left-radius
axf:border-top-right-radius
axf:border-bottom-left-radius
axf:border-bottom-right-radius

The radii of quater ellipse (rounding border) are specified. no-LT

Border Radius

Value: <length> <length>?
Initial: 0
Applies to: all FOs which can have borders
Inherited: no
Percentages: N/A

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 zero, the corner is square, not rounded. These properties are not available with XSL Formatter V4.3 Lite.

Box Shadow

axf:box-shadow

The box shadow is specified. no-LT

Value: none | [ <length> <length> <length>? || <color> ]
Initial: none
Applies to: all FOs which can have borders
Inherited: no
Percentages: N/A

The meanings of the three <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 quantity of gradation. If the value is 0, there is no gradation. With XSL Formatter V4.3, this value is disregarded and it is always considered as 0.
  • Gradation of color can be specified by <color>.

This property is not available with XSL Formatter V4.3 Lite.


Table

axf:repeat-cell-content-at-break

axf:repeat-cell-content-at-break specifies whether to copy the contents of a cell when a cell breaks. no-LT

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.


Images

Page Background

XSL Formatter V4.3 provides extension properties to set the background of the page. These properties are placed as fo:simple-page-master or fo:page-sequence.

axf:background-color

The axf:background-color specifies the background color of fo:simple-page-master.

Value: <color> | transparent
Initial: transparent
Applies to: fo:simple-page-master, fo:page-sequence
Inherited: no
Percentages: N/A

axf:background-image

The axf:background-image specifies the background image of fo:simple-page-master.

Value: <uri-specification> | none
Initial: none
Applies to: fo:simple-page-master, fo:page-sequence
Inherited: no
Percentages: N/A

axf:background-position-horizontal

The axf:background-position-horizontal specifies the horizontal position of the background image of fo:simple-page-master.

Value: <percentage> | <length> | left | center | right | inherit
Initial: 0%
Applies to: fo:simple-page-master, fo:page-sequence
Inherited: no
Percentages: refer to the size of the padding-rectangle

axf:background-position-vertical

The axf:background-position-vertical specifies the vertical position of the background image of fo:simple-page-master.

Value: <percentage> | <length> | top | center | bottom | inherit
Initial: 0%
Applies to: fo:simple-page-master, fo:page-sequence
Inherited: no
Percentages: refer to the size of the padding-rectangle

axf:background-repeat

The axf:background-repeat specifies whether the background image of fo:simple-page-master or fo:page-sequence is repeated, and how.

Value: repeat | repeat-x | repeat-y | no-repeat | paginate | inherit
Initial: repeat
Applies to: fo:simple-page-master, fo:page-sequence
Inherited: no
Percentages: N/A

Extended values have the following meanings.

paginate no-LT

Effective when embedding PDF in the background image and indicates to embed plural pages of PDF. For details, please refer to PDF Embedding. This value cannot be specified by XSL Formatter V4.3 Lite.

axf:background-content-width
axf:background-content-height
axf:background-content-type
axf: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.

Thess properties are not available with XSL Formatter V4.3 Lite.

Alternate Text

axf:alttext

Specifies the alternate text of the image. no-LT

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.

This property is not available with XSL Formatter V4.3 Lite.


Overflow Extensions

XSL Formatter V4.3 extends the value of the overflow property and provides the extension property to regulate the behavior of the value.

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

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.

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>

axf:overflow-condense-limit-font-size

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

Value: <length> [ visible | hidden | scroll | error-if-overflow | repeat ] | inherit
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 zero 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"

This property is not available with XSL Formatter V4.3 Lite.

axf:overflow-condense-limit-font-stretch

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

Value: [ <number> | <percentage> ] [ visible | hidden | scroll | error-if-overflow | repeat ] | inherit
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 zero 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"

This property is not available with XSL Formatter V4.3 Lite.

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


Extended Functions

XSL Formatter V4.3 extends some FO 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 XSL Formatter V4.3.

  • 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 XSL Formatter PANTONE® Option, it includes the ability for more than 1000 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(<R>,<G>,<B>,#Registration,<Tint>) no-LT
  • rgb-icc(<R>,<G>,<B>,#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

Extended Values

XSL Formatter V4.3 extends some values of the FO properties. In order to use these values, you have to specify exactly as follows:

axf:text-align="'.' center"

However, with XSL Formatter V4.3, 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:

text-align="." axf:text-align="center"

At this time, the standard property will be overwritten by the extended property and only axf:text-align="center" becomes effective. That is, it is the same as having text-align="center" specified. However, in order to avoid the confusion, please do not use such specification.

font-stretch

Following bold values are extended.

Value: normal | wider | narrower | ultra-condensed | extra-condensed | condensed | semi-condensed | semi-expanded | expanded | extra-expanded | ultra-expanded | <percentage> | <number> | inherit

Values have the following meanings.

<percentage>

Specifies the percentage against the font width.

<number>

Equivalent to <percentage> / 100.

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

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

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 equal to or more than 1, B must be an integer equal to or more than 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, force-page-count="even" is equivalent to force-page-count="2", force-page-count="odd" is equivalent to force-page-count="2 1" , force-page-count="doubly-even" is equivalent to force-page-count="4" and force-page-count="end-on-doubly-even" is equivalent to force-page-count="end-on 4" respectively.

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+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) I V X L C D M FULLWIDTH LATIN CAPITAL LETTER I
    U+FF49 (i) i v x l c d m FULLWIDTH LATIN SMALL LETTER I

    The numerical value to 3999 can be expressed with U+0049, U+0069, U+FF29, and U+FF49. The numerical value to 39999 can be expressed with U+2160 and U+2170. When the numerical value exceeds the restriction, it is evaluated as format="1" with U+0049, U+0069, U+2160, and U+2170, It is evaluated as format="&#xFF11;" with U+FF29 and U+FF49.

  • Hebrew Numerals

    Hebrew Numeral, such as ‭ א ב ג ד ה ... י אי בי גי די וט ..., is generated.

    Format Token Numerals Description
    U+05D0 (א) ‭ א ב ג ד ה ו ז ח ט י כ ל מ נ ס ע פ צ ק ר ש ת ך ם ן ף ץ HEBREW LETTER ALEF

    Although the specification of the grouping-separator property is effective, when 1 or more is specified as the value of grouping-size, it is always regarded as 3. When specifying these in Hebrew number, usually it is specified like grouping-separator="&#x5F3;" grouping-size="3".

  • Alphabets

    Alphabets sequence, such as A B C ... Z AA AB AC ..., is generated.

    Format Token Aplphabets 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+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+7532 U+5B50 (甲子) 甲子 乙丑 丙寅 丁卯 戊辰 己巳 庚午 辛未 壬申 癸酉 甲戍 乙亥 丙子 丁丑 戊寅 己卯 庚辰 辛巳 壬午 癸未 甲申 乙酉 丙戍 丁亥 戊子 己丑 庚寅 辛卯 壬辰 癸巳 甲午 乙未 丙申 丁酉 戊戍 己亥 庚子 辛丑 壬寅 癸卯 甲辰 乙巳 丙午 丁未 戊申 己酉 庚戍 辛亥 壬子 癸丑 甲寅 乙卯 丙辰 丁巳 戊午 己未 庚申 辛酉 壬戍 癸亥 CHINESE ZODIAC 60
    U+AC00 (가) 가 나 다 라 마 바 사 아 자 차 카 타 파 하 HANGUL GANADA
    U+FF21 (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 FULLWIDTH LATIN CAPITAL LETTER A
    U+FF41 (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 FULLWIDTH LATIN SMALL LETTER A
    U+FF71 (ア) ア イ ウ エ オ カ キ ク ケ コ サ シ ス セ ソ タ チ ツ テ ト ナ ニ ヌ ネ ノ ハ ヒ フ ヘ ホ マ ミ ム メ モ ヤ ユ ヨ ラ リ ル レ ロ ワ ヲ ン HALFWIDTH KATAKANA AIUEO
    U+FF72 (イ) イ ロ ハ ニ ホ ヘ ト チ リ ヌ ル ヲ ワ カ ヨ タ レ ソ ツ ネ ナ ラ ム ウ ノ オ ク ヤ マ ケ フ コ エ テ ア サ キ ユ メ ミ シ ヒ モ セ ス HALFWIDTH KATAKANA IROHA

  • The strings which consist of the same character with two or more altogether

    For example, if format="*****" is specified, the character string * ** *** **** ***** will be generated against 1 to 5. As for the numerical value more than the number of characters, it will be generated as one character with numeric value after that. For example, *6.

  • Plural full-width CJK ideographic characters

    Plural full-width CJK ideographic characters that does not belong to any rule in the above indicates the generation rule by itself. 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 simpe 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 XSL Formatter V4.3 Lite.

overflow

Following bold values are extended.

Value: visible | hidden | scroll | error-if-overflow | repeat | replace | condense | auto | inherit

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.

text-align

Extended the property so that <string> and other values can be written together.

Value: relative | justify | [[ start | center | end | inside | outside | left | right ] || <string> ] | inherit
Initial: relative
Applies to: fo:block, fo:external-graphic,fo:instream-foreign-object, fo:table-and-caption
Inherited: yes
Percentages: N/A

Although the specification of <string> to fo:table-cell alignes the character position of decimal point, etc., there is no definition for the alignment of the whole character string. At a default, XSL Formatter V4.3 displayed it right aligned according to the illustration of 17.5.4 Horizontal alignment in a column . XSL Formatter V4.3 extends the alignment and makes it possible to align left or align center

by specifying like:

text-align="'.' center"

Copyright © 1996-2010 Antenna House, Inc. All rights reserved.
Antenna House is a trademark of Antenna House, Inc.