Arbortext

Arbortext XSL FO PDF Bookmarks Extensions

This document provides further documentation for bookmark extensions to the XSL 1.0 Formatting Objects vocabulary that Arbortext supports. In fact, the definition of these capabilities are being developed the the W3C XSL Working Group for an expected XSL 1.1 specification, and Arbortext's 5.0 XSL FO support already includes support for this XSL 1.1 feature. Therefore, these capabilities are all specified via elements (formatting objects) and attributes (properties) in the “usual” W3C XSL FO namespace (not the ATIXslFoExt used for Arbortext developed extensions).

Introduction

A “bookmark-tree” can be included as a child of fo:root after fo:layout-master-set (and fo:declarations, if any) and before the first fo:page-sequence. The bookmark-tree contains bookmark FOs that specify the bookmarks to be generated.

The structure of the bookmark-tree is fairly simple and pretty much parallels a PDF bookmark set. This feature entails three FOs and no new properties (as existing properties are reused on these new FOs).

Added formatting objects

fo:bookmark-tree

Common usage: The fo:bookmark-tree formatting object is used to hold list of access points within the document such as a table of contents, a list of figures or tables, etc. Each access point is called a bookmark.

Content model: (bookmark+)+

Context (content models containing it):

  fo:root =
    (fo:layout-master-set,fo:declarations?,fo:bookmark-tree?,fo:page-sequence+)

This formatting object has no applicable properties.

fo:bookmark

Common usage: The fo:bookmark formatting object is used to identify an access point, by name, and to specify where that access point is within the current document or another external document. A given bookmark may be further subdivided into a sequence of (sub-)bookmarks to as many levels as the authors desire.

Note:

The fo:bookmark is a specialized form of the fo:basic-link with restrictions on the applicable properties and on its content model.

The property "starting-state" determines whether any sub-list of bookmarks is initially displayed or is hidden. The value "show" means include the sub-list of bookmarks in the presentation of this bookmark. The value "hide" means show only this bookmark in the presentation.

Content model: (fo:bookmark-title, fo:bookmark+)

Context (content models containing it):

  fo:bookmark-tree =
    (fo:bookmark+)+

The following properties apply to this formatting object:

  • Common Accessibility Properties
  • external-destination
  • internal-destination
  • starting-state
fo:bookmark-title

Common usage: The fo:bookmark-title formatting object is used to identify, in human readable form, an access point.

Note:

The fo:bookmark-title is a specialized form of fo:inline with restrictions on the applicable properties and on its content model.

This FO specifies that there is a conditional region on the given page master into which material can be floated. This region will only exist on any given page if some material has been floated into it.

Content model: (#PCDATA)

Context (content models containing it):

  fo:bookmark =
    (fo:bookmark-title, fo:bookmark+)

The following properties apply to this formatting object:

  • Common Accessibility Properties
  • font-style (with the value space limited to "normal" and "italic")
  • font-weight (with the value space limited to "normal" and "bold")

For technical questions on Arbortext products or this document, contact Arbortext Support.

Paul Grosso

This document was last modified: 2004 March 23