<div dir="ltr">Hi Christian,<div>I like this idea very much.</div><div class="gmail_extra"><br></div><div class="gmail_extra">I'll ping David Cramer tomorrow to see if he can help. In the meantime, I've dug up this info:</div>
<div class="gmail_extra"><br></div><div class="gmail_extra"><a href="http://docbook.sourceforge.net/release/xsl/1.76.1/doc/html/generate.toc.html">http://docbook.sourceforge.net/release/xsl/1.76.1/doc/html/generate.toc.html</a></div>
<div class="gmail_extra">and</div><div class="gmail_extra"><a href="http://www.sagehill.net/docbookxsl/TOCcontrol.html">http://www.sagehill.net/docbookxsl/TOCcontrol.html</a></div><div class="gmail_extra"><br></div><div class="gmail_extra">
Also, our pom.xml file can control the output of TOC entries. </div><div class="gmail_extra"><br>Table of Contents, and Lists of Figures, Tables, Examples, and Equations<br>The generateToc tag in a configuration section contains a series of white-space separated word pairs, which define the generation or suppression of the table of contents and lists of figures, tables, examples, and equations.<br>
<br>The first word in each pair is the element name, such as appendix, article, book, chapter, section, and so on.<br><br>The second word is a comma-separated list that specifies which lists the element should display. Most elements just use toc, whic<span style="color:rgb(0,0,0);font-family:Verdana,Geneva,sans-serif;font-size:10pt">h generates a list of section titles.</span><br>
</div><div class="gmail_extra"><div class=""><p style="color:rgb(0,0,0);font-family:Verdana,Geneva,sans-serif;font-size:10pt">But the entry for the book element also generates tables of figures, tables, examples, and equations.</p>
<p style="color:rgb(0,0,0);font-family:Verdana,Geneva,sans-serif;font-size:10pt">The <code class="">title</code> tag generates a title for the list, such as <span class="">“<span class="">Table of Contents</span>”</span>.</p>
<p style="color:rgb(0,0,0);font-family:Verdana,Geneva,sans-serif;font-size:10pt">Use a value of <code class="">nop</code> to turn off the table of contents and all lists for an element. You can also turn off a table of contents by removing the element from the parameter.</p>
<p style="color:rgb(0,0,0);font-family:Verdana,Geneva,sans-serif;font-size:10pt">The following table describes the words that you use to generate or suppress the table of contents and lists:</p><p style="color:rgb(0,0,0);font-family:Verdana,Geneva,sans-serif;font-size:10pt">
</p><table rules="all" id="d6e196" style="color:rgb(0,0,0);font-family:Verdana,Geneva,sans-serif;font-size:12px;border:1px solid black;margin-bottom:20px"><colgroup><col width="25%"><col width="75%"></colgroup><thead style="color:white;font-weight:bold;background:gray"><tr>
<th style="padding:5px;background-image:initial;background-repeat:initial">Word</th><th style="padding:5px;background-image:initial;background-repeat:initial">Generates</th></tr></thead><tbody><tr><td style="border:1px solid black;padding:5px">
toc</td><td style="border:1px solid black;padding:5px">Table of contents</td></tr><tr><td style="border:1px solid black;padding:5px">title</td><td style="border:1px solid black;padding:5px">A title for the specified list, such as <span class="">“<span class="">Table of Contents</span>”</span>.</td>
</tr><tr><td style="border:1px solid black;padding:5px">figure</td><td style="border:1px solid black;padding:5px">List of figurees</td></tr><tr><td style="border:1px solid black;padding:5px">table</td><td style="border:1px solid black;padding:5px">
List of tables</td></tr><tr><td style="border:1px solid black;padding:5px">example</td><td style="border:1px solid black;padding:5px">List of examples</td></tr><tr><td style="border:1px solid black;padding:5px">equation</td>
<td style="border:1px solid black;padding:5px">List of equations</td></tr><tr><td style="border:1px solid black;padding:5px">nop</td><td style="border:1px solid black;padding:5px">No operation. Disables the table of contents and all lists for an element. You can also disable the table of contents or a list by removing the element from the parameter.</td>
</tr></tbody></table><p style="color:rgb(0,0,0);font-family:Verdana,Geneva,sans-serif;font-size:10pt"></p><p style="color:rgb(0,0,0);font-family:Verdana,Geneva,sans-serif;font-size:10pt">For example, you might add the following markup to your <code class="">pom.xml</code> file:</p>
<pre class="" style="color:rgb(35,48,45);font-family:Monaco,'Courier New','DejaVu Sans Mono','Bitstream Vera Sans Mono',monospace;font-size:12px!important;width:1052px;border-bottom-color:rgb(222,222,222)!important;border-bottom-style:solid!important;border-bottom-width:1px!important;border-top-color:rgb(222,222,222)!important;border-top-style:solid!important;border-top-width:1px!important;padding:0.5em!important">
<generateToc>
appendix toc,title
article/appendix nop
article toc,title
book title,figure,table,example,equation
chapter toc,title
part toc,title
preface nop
qandadiv toc
qandaset toc
reference toc,title
section toc
set toc,title
</generateToc></pre><p style="color:rgb(0,0,0);font-family:Verdana,Geneva,sans-serif;font-size:10pt">This markup generates the following items:</p><div class="" style="color:rgb(0,0,0);font-family:Verdana,Geneva,sans-serif;font-size:12px">
<ul class="" type="disc" style="font-size:10pt"><li class="" style="font-size:10pt"><p style="font-size:10pt">Appendix. Table of contents with a title.</p></li><li class="" style="font-size:10pt"><p style="font-size:10pt">
Appendix in an article. No table of contents or lists.</p></li><li class="" style="font-size:10pt"><p style="font-size:10pt">Article. Table of contents with a title.</p></li><li class="" style="font-size:10pt"><p style="font-size:10pt">
Book. List of figures, tables, examples, and equations with titles.</p></li><li class="" style="font-size:10pt"><p style="font-size:10pt">Chapter. Table of contents with a title.</p></li><li class="" style="font-size:10pt">
<p style="font-size:10pt">Part. Table of contents with a title.</p></li><li class="" style="font-size:10pt"><p style="font-size:10pt">Preface. No table of contents or lists.</p></li><li class="" style="font-size:10pt"><p style="font-size:10pt">
And so on.</p></li></ul></div></div></div><div class="gmail_extra"><br><div class="gmail_quote">On Tue, Jun 3, 2014 at 6:38 AM, Christian Berendt <span dir="ltr"><<a href="mailto:berendt@b1-systems.de" target="_blank">berendt@b1-systems.de</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">I tried extending the table of contents of the glossary to have an entry<br>
for each letter in the TOC. I think that's helpful.<br>
<br>
I think I have to increment the maximum depth of the generated TOC. But<br>
because I'm not familiar with XSL, can somebody give me a hint what I<br>
have to change?<br>
<br>
Christian.<br>
<br>
--<br>
Christian Berendt<br>
Cloud Computing Solution Architect<br>
Mail: <a href="mailto:berendt@b1-systems.de">berendt@b1-systems.de</a><br>
<br>
B1 Systems GmbH<br>
Osterfeldstraße 7 / 85088 Vohburg / <a href="http://www.b1-systems.de" target="_blank">http://www.b1-systems.de</a><br>
GF: Ralph Dehner / Unternehmenssitz: Vohburg / AG: Ingolstadt,HRB 3537<br>
<br>
_______________________________________________<br>
Openstack-docs mailing list<br>
<a href="mailto:Openstack-docs@lists.openstack.org">Openstack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
</blockquote></div><br></div></div>