#7 Eclipse plug-in Help creates a huge TOC of chapters/sections and subsections

[David Jackson]

Sorry if this is a dumb question.

Most Eclipse Plugin Helps appear to create a simple TOC Bullet list of each 'chapter' title. then each chapter then create is own smaller bullet TOC of each Section title.
See View1 attachment of the Eclipse WorkBench Help as an example.
I have a "book" comprising of 8 chapters each chapter has <sect1> and some umber of <sect2> entries. When I run this through DEP4E I get a huge TOC generated - see View2 attachment.</sect2></sect1>

So my question is why is DEP4E creating such a huge Eclipse Plugin Help TOC when that doesn't appear to be the "standard" adopted by most other Eclipse Helps?.
Are there parameters in DEP4E that I need to embed in my XML Book to limit the creation of the TOC for an Eclipse Help so that it looks more like the "standard"?

Or is this working correctly and how Eclipse Plugin Helps are supposed to be displayed?
It doesn't seem right to me but I may be wrong..

[Nils Cordes]

A simpler ToC can be generated by using DocBook XSL Stylesheets Parameters.
http://docbook.sourceforge.net/release/xsl/current/doc/html/generate.section.toc.level.html
http://docbook.sourceforge.net/release/xsl/current/doc/html/toc.section.depth.html
http://docbook.sourceforge.net/release/xsl/current/doc/html/toc.max.depth.html

[David Jackson]

Nils,
I think it would be very useful if a step by step example could be
documented in DEP4E as to include a users customized XSL can be embedded
into DEP4E.
DEP4E hides all the complexity - which is good, so a simple explanation as
to how to embed it into DEP4E would be greatly beneficial to users.

David

On Mon, Jul 28, 2014 at 5:46 AM, Nils Cordes cordbhkj@users.sf.net wrote:

• status: open --> accepted
• assigned_to: Nils Cordes
• Comment:

A simpler ToC can be generated by using DocBook XSL Stylesheets Parameters.

http://docbook.sourceforge.net/release/xsl/current/doc/html/generate.section.toc.level.html

http://docbook.sourceforge.net/release/xsl/current/doc/html/toc.section.depth.html

http://docbook.sourceforge.net/release/xsl/current/doc/html/toc.max.depth.html

• [issues:#7] http://sourceforge.net/p/dep4e/issues/7 Eclipse plug-in
  Help creates a huge TOC of chapters/sections and subsections*

Status: accepted
Milestone: 2014.04.0
Labels: Eclipse plug-in Help TOC Chapter Titles
Created: Sat Jul 26, 2014 04:35 PM UTC by David Jackson
Last Updated: Sat Jul 26, 2014 04:35 PM UTC
Owner: Nils Cordes

Sorry if this is a dumb question.

Most Eclipse Plugin Helps appear to create a simple TOC Bullet list of
each 'chapter' title. then each chapter then create is own smaller bullet
TOC of each Section title.
See View1 attachment of the Eclipse WorkBench Help as an example.
I have a "book" comprising of 8 chapters each chapter has <sect1> and some
umber of <sect2> entries. When I run this through DEP4E I get a huge TOC
generated - see View2 attachment.</sect2></sect1>

So my question is why is DEP4E creating such a huge Eclipse Plugin Help
TOC when that doesn't appear to be the "standard" adopted by most other
Eclipse Helps?.
Are there parameters in DEP4E that I need to embed in my XML Book to limit
the creation of the TOC for an Eclipse Help so that it looks more like the
"standard"?

Or is this working correctly and how Eclipse Plugin Helps are supposed to
be displayed?
It doesn't seem right to me but I may be wrong..

---

Sent from sourceforge.net because you indicated interest in
https://sourceforge.net/p/dep4e/issues/7/

To unsubscribe from further messages, please visit
https://sourceforge.net/auth/subscriptions/

[Nils Cordes]

I agree: "A simple explanation as to how to customized XSL can be embedded into DEP4E would be greatly beneficial to users."

I'm working on easy to use way ...

[David Jackson]

:-)

On Mon, Jul 28, 2014 at 7:42 AM, Nils Cordes cordbhkj@users.sf.net wrote:

I agree: "A simple explanation as to how to customized XSL can be embedded
into DEP4E would be greatly beneficial to users."

I'm working on easy to use way ...

• [issues:#7] http://sourceforge.net/p/dep4e/issues/7 Eclipse plug-in
  Help creates a huge TOC of chapters/sections and subsections*

Status: accepted
Milestone: 2014.04.0
Labels: Eclipse plug-in Help TOC Chapter Titles
Created: Sat Jul 26, 2014 04:35 PM UTC by David Jackson
Last Updated: Mon Jul 28, 2014 12:46 PM UTC
Owner: Nils Cordes

Sorry if this is a dumb question.

Most Eclipse Plugin Helps appear to create a simple TOC Bullet list of
each 'chapter' title. then each chapter then create is own smaller bullet
TOC of each Section title.
See View1 attachment of the Eclipse WorkBench Help as an example.
I have a "book" comprising of 8 chapters each chapter has <sect1> and some
umber of <sect2> entries. When I run this through DEP4E I get a huge TOC
generated - see View2 attachment.</sect2></sect1>

So my question is why is DEP4E creating such a huge Eclipse Plugin Help
TOC when that doesn't appear to be the "standard" adopted by most other
Eclipse Helps?.
Are there parameters in DEP4E that I need to embed in my XML Book to limit
the creation of the TOC for an Eclipse Help so that it looks more like the
"standard"?

Or is this working correctly and how Eclipse Plugin Helps are supposed to
be displayed?
It doesn't seem right to me but I may be wrong..

---

Sent from sourceforge.net because you indicated interest in
https://sourceforge.net/p/dep4e/issues/7/

To unsubscribe from further messages, please visit
https://sourceforge.net/auth/subscriptions/

[Nils Cordes]

Ant Build File docbook_5-0.xml
<target name="Eclipse" ...
added: <param name="toc.max.depth" expression="1">
added: <param name="generate.toc" expression="appendix nop article nop chapter nop part nop section nop set nop">

[Nils Cordes]

fixed in Release 2014.7.0