This is the mail archive of the
docbook-apps@lists.oasis-open.org
mailing list .
[docbook-apps] Eclipse Help toc generation: suppressing links?
- From: Denis Bradford <denis dot bradford at verizon dot net>
- To: docbook-apps at lists dot oasis-open dot org
- Date: Fri, 04 Feb 2005 11:00:43 -0500
- Subject: [docbook-apps] Eclipse Help toc generation: suppressing links?
- References: <OF84A5E853.0FD47D85-ONC1256F58.0037AFEA@sectra.se> <41A702AF.40905@kosek.cz>
In the eclipse.xsl stylesheet, the etoc template generates a nice toc.xml that can be used in an Eclipse Help plugin. I want to generate some toc groupings with just labels, no links. But eclipse.xsl
always generates an href for each toc and topic - I don't see a way to turn that off.
The Eclipse documentation says that toc and topic elements can be used with no href attributes.
In the following example from Eclipse Help, the "Tasks" toc and "funTasks" topics are rendered as
labels in the toc hierachy.
<toc label="Tasks">
<topic id="plainTasks" label="Plain Stuff">
<topic label="Task1" href="html/tasks/task1.html"/>
<topic label="Task2" href="html/tasks/task2.html"/>
</topic>
<topic id="funTasks" label="Fun Stuff" >
<topic label="Task3_1" href="html/tasks/task3_1.html"/>
<topic label="Task3_2" href="html/tasks/task3_2.html"/>
</topic>
</toc>
That's the sort of structure I'd like to generate. Before I start hacking away at eclipse.xsl:
- Am I right that there's no way to generate the result I want using the stylesheet as is?
- Any (experience with|advice for) a reasonable customization? Since all my help topics are in sections,
my thought is to suppress href links for anything above a section, and mark up anything else I want
to suppress in the same way with a role attribute like "noTOClink".
So my DocBook markup for the preceding example might look like this:
<chapter>
<title>Tasks</title>
<section id="plainTasks" role="noTOClink">
<title>Plain Stuff</title>
&Task1;
&Task2;
</section>
<section id="funTasks" role="noTOClink">
<title>Fun Stuff</title>
&Task3_1;
&Task3_2;
</section>
</chapter>