[Accessibility conventions are described at the bottom of the page]
*** This is a free preview excerpt of a commercial publication. ***

9. Bookmarks and indexes
[> 10.][< 8.1.1][^^^]
9.0 Additional navigation aids
[> 10.][< 9.][^^][^^^]
Additional navigation aids can help the reader find information easily
[[1] - provides hyperlinks into contents
]
[F1.1]Bookmarks
[[1] - similar to a table of contents, but not presented on the canvas of the publication
[[2] - it is a design pattern to use the same logic to build both the rendered table of contents and the publications bookmark information
][1] - document rendering formats such as Adobe Portable Document Format (PDF) have a bookmark tree
[[2] - viewers render the bookmark tree in a separate window pane
 [2] - interactions in the bookmark pane change the focus of the publication in the main pane
][1] - XSL-FO doesn't apply any presentation constraints or many features on bookmark entries
[[2] - entries are comprised of text and a very small subset of annotations and styles
]]
[F1.1]Indexes
[[1] - far more granular than a table of contents
 [1] - a hierarchical alphabetized summary of key concepts and words found in the publication
 [1] - using page number citations is insufficient to the task
[[2] - page number citations cannot have page ranges and duplicate page number citations resolved into a minimum list of unique page references
][1] - XSL-FO only addresses page number resolution for indexes, not the index structure or rendering
[[2] - up to the stylesheet to accomplish the selection, grouping and ordering of the index entries
]]
[F1.0]A two-pass methodology for PDF files can be used with XSLT 1.0
[[1] - public resource freely available from Crane Softwrights Ltd.
[[2] - [http://www.CraneSoftwrights.com/links/res-pfux.htm]
][1] - the method first renders XML markup on PDF pages using page number citations to resolve all index entries
 [1] - the markup is scraped out of the PDF file by off-the-shelf PDF software
 [1] - the markup is massaged by XSLT to interpret page ranges and eliminate duplication
 [1] - the massaged markup is input to the second pass to render the index hyperlinked into the content
]
[F1.0]Many vendors provide custom extensions for this functionality
[[1] - but extensions are not portable across different tools, thus requiring duplication of the information in an instance enabled for different processors
]
The XSL-FO objects for bookmarks covered in this chapter are:
[[1] - [F1.1]<[bookmark-tree]> ([6.11.1])
[[2] - defines a set of bookmarks for the completed document
][1] - [F1.1]<[bookmark]> ([6.11.2])
[[2] - defines a single bookmark
][1] - [F1.1]<[bookmark-title]> ([6.11.3])
[[2] - specifies the title for a single bookmark
]]
The XSL-FO objects for indexes covered in this chapter are:
[[1] - [F1.1]<[index-page-citation-list]> ([6.10.7])
[[2] - render a formatted list of page numbers and page ranges for a set of index keys
][1] - [F1.1]<[index-page-citation-list-separator]> ([6.10.8])
[[2] - specifies the separation between formatted index entry members
][1] - [F1.1]<[index-page-citation-range-separator]> ([6.10.9])
[[2] - specifies the separation between two page numbers in a page range in a formatted index entry member
][1] - [F1.1]<[index-key-reference]> ([6.10.6])
[[2] - render a formatted list of page numbers and page ranges for a single index key
][1] - [F1.1]<[index-page-number-prefix]> ([6.10.2])
[[2] - specifies the start of pages in the flow for an index page range
][1] - [F1.1]<[index-page-number-suffix]> ([6.10.3])
[[2] - specifies the end of pages in the flow for an index page range
][1] - [F1.1]<[index-range-begin]> ([6.10.4])
[[2] - specifies the suffix for cited pages for a single index key
][1] - [F1.1]<[index-range-end]> ([6.10.5])
[[2] - specifies the suffix for cited pages for a single index key
]]

*** This is a free preview excerpt of a commercial publication. ***

This is an accessible version of Crane's commercial training material. The content has been specifically designed to assist screen reader software in viewing the entire textual content. Figures are replaced with text narratives.

Navigation hints are in square brackets:
[Tx.x] and [Fx.x] are textual representations of the applicability icons;
[digit] indicates list depth for nested lists;
[link [URL]] indicates the URL of a hyperlink if different than link;
[EXAMPLE] indicates an example listing of code;
[FIGURE] indicates the presence of a figure replaced by its description;
[>] jumps forward;
[<] jumps backward;
[^] jumps to start of the section;
[^^] jumps to the start of the chapter;
[^^^] jumps to the table of contents.
Suggestions for improvement are welcome: [info@CraneSoftwrights.com]
Book sales: [http://www.CraneSoftwrights.com/links/trn-acc.htm]
Information: [http://www.CraneSoftwrights.com/links/info-acc.htm]
This content is protected by copyright and, as there are no means to protect this accessible version from plagiarism, please do not make any commercial edition available to others.

+//ISBN 978-1-894049::CSL::Courses::PFUX//DOCUMENT Practical Formatting Using XSL-FO 2008-01-27 17:30UTC//EN
Practical Formatting Using XSL-FO
Seventh Edition - 2008-01-27
ISBN 978-1-894049-19-1
Copyright © Crane Softwrights Ltd.