Generating context-sensitive help from Confluence content

[Robert Lauriston]

Is anyone doing this successfully?

I have Scroll DocBook Exporter > DocBook+WebHelp working. DocBook+WebHelp doesn't have a CSH call handler or map file, so I figured we'd code our own, but there's a problem. Scroll's DocBook names section IDs scroll-bookmark-## with ascending numbers, and that's how the output is chunked into HTML files, so the file names change any time you add or remove a topic or other bookmarked element earlier in the book.

Maybe Scroll can give me a fix, but in the meantime, I'm looking for other possible solutions.

[Matthias Krohn]

Hi Robert,

I experiment last year with Scroll Versions and Scroll DocBook Exporter. I got a prototype wörking. In the next months I will develop a regular solution. Regarding context sensitive help my approach is to use the Scroll Versions PageKey (also called Permalink) as per default unique and under normal circumstances not changing context id. Using the current DocBook Exporter the PageKey is provided via the xml:id parameter (see also https://k15t.jira.com/browse/EXP-504). Of course, this requires Scroll Versions installed and limits to one context id per page, but for us this is acceptable.

Regards,
Matthias

[Robert Lauriston]

I installed Scroll Versions and defined some page keys, but the page key strings do not appear in my DocBook export.

[Matthias Krohn]

Hi Robert, I made a mistake, sorry. The PageKey is not exported via the xml:id parameter, but as an own scroll:page-key parameter. Be aware you need at least version 3.1 of the Exporter. Below you find the first tag of an export example. The last parameter is the wanted one. <?xml version="1.0" encoding="UTF-8"?> <article xmlns="http://docbook.org/ns/docbook"; xmlns:xlink="http://www.w3.org/1999/xlink"; xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"; xmlns:scroll="http://www.k15t.com/scroll-docbook/extensions"; xsi:schemaLocation="http://docbook.org/ns/docbook http://docbook.org/xml/5.0/xsd/docbook.xsd"; version="5.0" xml:id="scroll-bookmark-1" scroll:page-key="MyPageKey"> Regards, Matthias

[Matthias Krohn]

For clarification an extract for a single page of an export: ... <?confluence type="page" ?> <section xml:id="scroll-bookmark-33" scroll:page-key="OrganizationPageKey"> <title>Organization</title> ...