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

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

Unfortunately that only partially worked.

The WebHelp is set up as a DocBook set that includes the books.

When I set the directory for the individual books in the book files, the individual HTML files were generated in those subdirectories (under site/sqrrl-guides, the directory for the set as a whole).

While the TOC included all of the correct entries for all of the books, the actual TOC links were broken - the generated TOC links did not include the book subdirectories - they still assumed all of the files were directly in sqrrl-guides, as opposed to sqrrl-guides/InstallGuide, sqrrl-guides/AdminGuide, etc.

When I open the individual HTML files, links within and between books actually work. Images were broken, still assuming that the img directory was one level up instead of two.

Still digging to see if there's a DocBook or docbkx configuration that can help.

Janice

On Tue, Jan 5, 2016 at 4:06 PM, Katie Kearns <kkearns@trustedcs.com> wrote:

I don’t think it does what you think it does. If you look at the very bottom of the page, it says:

“Note that any instances of xref or link or olink that reference the original id value will not be altered. They will always point to the first instance in the output.”

I think the point of this little chunk of code is just to ensure that the TOC will work correctly...

What might work though is to use the dbhtml dir processing instruction:

http://www.sagehill.net/docbookxsl/Chunking.html#HtmlOutputDir

Just have each book generate into a different directory, and as long as you reuse chunks only across books (and not internal to a book) I think it would work? I’ve never tried it, though.

-Katie

From: Janice Manwiller [mailto:janice@sqrrl.com]
Sent: Tuesday, January 05, 2016 3:55 PM
To: Wood Nick
Cc: docbook-apps@lists.oasis-open.org
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.

Janice Manwiller

Principal Technical Writer

Sqrrl Data, Inc.

docbook-apps message