Add scroll-bookmark macro (named destinations in pdf, bookmarks in word, ...)

Description

Named Destinations act as anchors within a PDF documents where external references can point to. Moreover, Named Destinations can trigger a certain behaviour (e.g. opening menus). More information:
http://www.mindtheflex.com/?p=86

Environment

Confluence all versions

Activity

Show:
Jens Rutschmann (K15t)
January 24, 2013, 12:54 PM

With Adobe Reader X one can call the following command from the Adobe Reader directory:

LDP
February 11, 2013, 4:55 PM

It would be great if the generated bookmarks from Scroll PDF Exporter are also named destinations, so that you could open the pdf in a specific chapter and use the pdf as an onlinehelp document this way.

Currently the only solution for this is to use this tool after creating the pdf with Scroll PDF Exporter, to convert the bookmarks to named destinations: http://destinator.grifir.com
But this is one manual step to much

Jens Rutschmann (K15t)
June 10, 2014, 8:51 AM

Removed default assignee for unscheduled issues

Jens Rutschmann (K15t)
June 20, 2014, 4:32 PM

The new scroll-bookmark macro will allow you to add bookmarks with your custom IDs to the exported document.

Those are mapped to the export target format as follows:

Output Type

Bookmark Target Type

PDF

Named Destinations

Word

Bookmarks

Docbook

<anchor> tags

HTML, EPUB, EclipseHelp

empty <span> tags with IDs

The macro can be inserted anywhere in your content. If inserted into headings the bookmarks will be placed at the document section for that heading.

Please note

When placing a bookmark macro on a heading that is merged with the page title then the bookmark is not exported, for the following reasons:

  • The page title is typically not placed directly in front of the content. Depending on your template there might be multiple pages for toc, legals, etc. between the document title and the start of the exported content).

  • The $scroll.title placeholder is typically considered as "text-only" and depending on the output format there is no consistent way of properly adding the bookmarks at that location.

  • Placing such bookmarks on the text following the heading in Confluence would separate the bookmark from its original source. To achieve this simply put the macro manually into the first paragraph after the heading.

Since this only happens for the very top page and top heading of the exported content, instead link simply to the document as a whole.

Assignee

Unassigned

Reporter

Former user

Participants

None

QA Status

None

Deployment

None

Documentation Status

None

UI Concept

None

External Votes

None

Time tracking

0m

Time remaining

0m

Sprint

None

Fix versions

Priority

Major
Configure