RE: PDF bookmarks (was: Re: extensions to FO)

This sounds good to me. 

Also for this list's future reference, I'm a guy Sebastian. :-) We had that
conversation on fop-dev a while back.

-Kelly

-----Original Message-----
From: Nikolai Grigoriev [mailto:grig@renderx.com]
Sent: Sunday, February 04, 2001 10:56 AM
To: www-xsl-fo@w3.org
Subject: Re: PDF bookmarks (was: Re: extensions to FO)


Hi,

Here's yet another essay about representing bookmarks :-).

I see the following problems with various ways proposed to encode PDF
bookmarks:

1) The semantics of existing formatting objects should not
   be redefined nor extended. This is a drawback of my
   proposal (using fo:markers);

2) The bookmark hierarchy tree need not be isomorphic
   to the document structure. This is a limitation of Kelly's
   proposal (using pdf:outline-label attribute) and mine;

3) The contents of the bookmark label should not be
   restricted to plain text (even though it can only be
   plain text in PDF right now) - for extensibility's sake.
   This is a weak point of Kelly's proposal;

4) Using explicit, LISP-like data structures to
   encode tree hierarchy is unnatural in XML.
   This is a problem with Sebastian's current implementation
   of fotex:bookmark.

Thinking it over a while, I am inclined to support David Carlisle proposal:

> Actually I'd rather have specific bookmark constructors that
> are placed at the beginning of the file, not tied to section
> fo:blocks.

What if we create a separate bookmark tree as a top-level element outside
fo:page-sequences (e.g. immediately after fo:declarations), like a table of
content:

<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format"
         xmlns:fox="http://www.w3.org/2001/XSL/Format/Extensions">
  <fo:layout-master-set>...</fo:layout-master-set>

  <fox:bookmark internal-destination="whole-document">
     <fox:label>My Document</fox:label>
     <fox:bookmark internal-destination="intro">
        <fox:label>Introduction</fox:label>
     </fox:bookmark>
     <fox:bookmark internal-destination="sect-1">
        <fox:label>Section 1 Title</fox:label>
        <fox:bookmark internal-destination="subsect-1-1">
           <fox:label>Subsection 1.1 Title</fox:label>
        </fox:bookmark>
        .....
    </fox:bookmark>
    .....
  </fox:bookmark>

  <fo:page-sequence .....>
  ... ... ... ...

The "fox:" prefix stands for "FO eXtensions" :-).
The features are:

1) No standard elements are redefined - only extension
   elements are used.
2) The whole thing is atomic - dropping it as a whole
   makes no damage.
3) The tree ordering of bookmarks is imposed by the syntax.
4) The bookmark tree is arbitrary, and not constrained by
   the logical structure of divisions in the document.
5) (implementation-specific) The implementation is similar
   to fo:basic-link[@internal-destination] - activation
   behaviour is essentially the same.

What do you think of it?

Regards,
Nikolai

Received on Monday, 5 February 2001 11:34:36 UTC