forrest-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Ross Gardler <rgard...@apache.org>
Subject Re: docbook documentation splittet in several chunk
Date Sun, 27 Nov 2005 21:28:55 GMT
Fabian Müller wrote:

> There are three things I do not like:
> 
> 1) I would like to have numbers for each chapter. These numbers should
> be added to the table of contents. Additional numbers for the sections
> would be great as well.

Patches to docbook2xdoc in the simplified-dovbook plugin are welcome.

> 2) I have a problem with the structure of the table of contents. For
> example I have
> 
> Developer Information
> |
> |---> Libraries
>       |
>       |---> SIP/RTP
>             |
>             |---> libosip
>             |
>             |---> ortp
> 
> The problem is that libosip and ortp are not shown in the toc but I
> would like to show these sections. libosip and ortp are at <sect3>
> level in my docbook source. Is is possible to specify to which level
> the sections should be shown in the toc?

http://forrest.apache.org/docs_0_70/linking.html#toc-generation

> 3) The last but very important issue is this one: I included the GPL
> as an appendix to the documentation but the appendix is not mentioned
> in the table of contents. Furthermore there is no heading for the
> appendix like "Appendix A" or something like that. The appendix is
> just attached to the end of the documentation. On
> http://openpbx-docs.org/tutorial.html you can see that a link to
> appendix A (the GPL) is available in the table of contents and that
> there is the heading "Anhang A. GNU GENERAL PUBLIC LICENSE" above
> appendix A.

Sounds like the tag use to identify the appendix is not processed by the 
docbook2xdoc.xsl. Patches welcome.

Ross


Mime
View raw message