Re: FW: [docbook-apps] Question on adjusting IDs for reused content

Subject: Re: FW: [docbook-apps] Question on adjusting IDs for reused content

I tried adding the customization to common.xsl, but it's still not doing what I expect. I'm not sure if my expectations are off or it's just not working correctly.

It isn't generating separate HTML topic files with distinct names for duplicated sections. However, the section and bridgehead IDs in the HTML files all have "1" appended.

For example, I Xinclude the same chapter file (chapter ID adm-modify-cluster) into two different books. The chapter contains two sections (IDs modify-cluster-prep-new-nodes and modify-cluster-using-script). The WebHelp is configured to generate a new topic file for each section.

With the customization in place, I would expect six topic files to be generated.

For the first book that uses the chapter:

- adm-modify-cluster.html

- modify-cluster-prep-new-nodes.html

- modify-cluster-using-script.html

For the second book that uses the chapter:

- adm-modify-cluster1.html

- modify-cluster-prep-new-nodes1.html

- modify-cluster-using-script1.html

Within the second set of files, the IDs would also have the appended 1.

This would prevent the "bouncing" in the WebHelp TOC.

However, with the customization, I'm still getting just one set of files:

- adm-modify-cluster.html

- modify-cluster-prep-new-nodes.html

- modify-cluster-using-script.html

Within the single set of files, all of the IDs have 1 appended.

Any ideas?

Thanks,

Janice

On Tue, Jan 5, 2016 at 10:24 AM, Wood Nick <Nick.Wood@ncia.nato.int> wrote:

Sorry, forgot to include the list in my reply to Janice.

Nick

From: Wood Nick
Sent: 05 January 2016 15:13
To: 'Janice Manwiller' <janice@sqrrl.com>
Subject: RE: [docbook-apps] Question on adjusting IDs for reused content

Janice,

Is custom-docbook.xsl your fo customisation layer, if so, you probably have a customised common.xsl stylesheet above this, and that is where the object.id customisation should go.

Regards

Nick

From: Janice Manwiller [mailto:janice@sqrrl.com]
Sent: 28 December 2015 21:05
To: docbook-apps@lists.oasis-open.org
Subject: [docbook-apps] Question on adjusting IDs for reused content

I've been working on reusing content in the doc set I work on. The guides are in a single WebHelp.

- Using DocBook 5

- Output generated using the Maven docbkx plugin

As pointed out in the DocBook XSL guide, if you reuse content that has an identifier, then in the WebHelp output, the TOC generates the correct links. However, because those links all point to the same file, when you click any of those TOC links, the TOC selection bounces to the "first" instance. For example, you click a link in the Install Guide, and the TOC bounces to the entry in the Admin Guide.

To avoid the TOC "bouncing", the DocBook XSL reference included a suggested customization to have the generation process append numbers to subsequent instances:

http://www.sagehill.net/docbookxsl/DuplicateIDs.html#ModifyIdValues

I tried adding the template from this section to both custom-docbook.xsl (the main DocBook customization) and docbook-webhelp.xsl (the WebHelp customization), but it didn't have any affect in either place.

Am I putting the customization in the wrong place? Is there something else I'm missing?

Thanks,

Janice

Janice Manwiller

Principal Technical Writer

Sqrrl Data, Inc.

docbook-apps message