[docbook-apps] RE: [docbook] can I move the table of contents?
Good morning Lorenzo. I'm taking this to the right mailing list (see recipient). You'll be using some sort of docbook stylesheets to transform the docbook document into your output format (.html, .pdf, .fo, ..). A common implementation is located at http://docbook.sf.net/release/xsl/current/. Taking that implementation as reference, if you for example would use the HTML xsl-stylesheets to generate your output, you would find a file at html/index.xsl with the comment: !-- some implementations use completely empty index tags to indicate -- !-- where an automatically generated index should be inserted. so -- !-- if the index is completely empty, skip it. Unless generate.index -- !-- is non-zero, in which case, this is where the automatically -- !-- generated index should go. -- Interpreting this would take me to assume that I could place an empty index tag (index /) somewhere in my docbook document and by setting the parameter $generate.index to 1 would then generate it in that place and only there. But I haven't tried this. Good luck! :-) Cheers, Dominik -Original Message- From: Lorenzo Caminiti [mailto:lorcamin...@gmail.com] Sent: Thursday, April 19, 2012 1:29 AM To: docb...@lists.oasis-open.org Subject: [docbook] can I move the table of contents? Hello all, This is my very first post on this ML. My question: Is there a way I can specify to generate the Table of Contents within a specific section instead that at very beginning of the document? (For example, some DocBook XSL option...) I'm using Boost.QuickBook as a front-end to generate DocBook documents in HTML. The Table of Contents automatically shows up at the very top of the very first HTML document. I'd like to move it to later in the document. Thanks a lot. --Lorenzo - To unsubscribe, e-mail: docbook-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-h...@lists.oasis-open.org - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
Re: [docbook-apps] can I move the table of contents?
Morning, some implementations use completely empty index tags to indicate where an automatically generated index should be inserted. so [...] Dominik, if I understood it correctly, Lorenzo talks about the table of contents, not the index. :) Back to Lorenzos original question: My question: Is there a way I can specify to generate the Table of Contents within a specific section instead that at very beginning of the document? (For example, some DocBook XSL option...) I guess you mean to move the TOC to the end of, lets say, a book? Yes, the DocBook stylesheets has lots of ways how to do this. The easiest method is to set a parameter, but in this case, I fear, there is none. However, if there is no parameter, you have to customize the respective template(s). First you have to create a customization layer (see [1] or [2]). Then you have to overwrite the standard implementation. For example, if you want to move the TOC of a book to the end, look at html/division.xsl and the book template. Here is the code: ---[ html/division.xsl ]--- xsl:template match=book xsl:call-template name=id.warning/ div xsl:apply-templates select=. mode=common.html.attributes/ xsl:if test=$generate.id.attributes != 0 xsl:attribute name=id xsl:call-template name=object.id/ /xsl:attribute /xsl:if xsl:call-template name=book.titlepage/ xsl:apply-templates select=dedication mode=dedication/ xsl:apply-templates select=acknowledgements mode=acknowledgements/ xsl:variable name=toc.params xsl:call-template name=find.path.params xsl:with-param name=table select=normalize-space($generate.toc)/ /xsl:call-template /xsl:variable xsl:call-template name=make.lots xsl:with-param name=toc.params select=$toc.params/ xsl:with-param name=toc xsl:call-template name=division.toc xsl:with-param name=toc.title.p select=contains($toc.params, 'title')/ /xsl:call-template /xsl:with-param /xsl:call-template xsl:apply-templates/ /div /xsl:template --- The make.lots is the part that makes the TOC and the xsl:apply-templates handles the rest of the book. Copy this template into your customization layer and switch the two. Or in other words: insert the xsl:apply-templates first and then the make.lots. I think this should do the trick, but that's just a quick look. Hope this helps. Good luck! :) --- References [1] http://sagehill.net/docbookxsl/CustomMethods.html#WriteCustomization [2] http://doccookbook.sourceforge.net/html/en/DoCookBook.html#dbc.common.dbcustomize -- Gruß/Regards, Thomas Schraitle - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
RE: [docbook-apps] Making PDFs in Windows
Hi We're transforming docbook documents to FO using the .NET library classes XmlReader and XslCompiledTransform in the namespace System.Xml and System.Xml.Xsl. The resulting formatting objects are then processed to PDF by the commercial IBEX product. We used to call FOP before but we had to drop that because of the java dependency. The open source processors that we evualuated (besides FOP) were all not fit enough for production releases - therefore the dependency on the commercial product. Cheers, Dominik _ From: Paul Tremblay [mailto:paulhtremb...@gmail.com] Sent: Thursday, April 19, 2012 3:11 AM To: docbook-apps@lists.oasis-open.org Subject: Re: [docbook-apps] Making PDFs in Windows I have used both cygwin and mingw. I prefer mingw because cygwin has so many bugs, and in fact the latest version does not work with the FOP bash script. However, as others pointed out, you can generate PDF from the windows shell. I prefer not to use the Windows shell because it has so many limitation compared to a unix-like shell. Paul On 4/18/12 9:59 AM, deannel...@aol.com wrote: Its not necessary to use Cygwin or MinGW. I use a batch file that calls XSLTPROC and FOP to generate PDFs under Windows. Check our Bob Stayton's book for more info. Regards, Dean Nelson In a message dated 4/18/2012 6:51:52 A.M. Pacific Daylight Time, yoursurrogate...@gmail.com writes: Hi guys, have you ever used Docbook to generate PDFs in Windows? Did you use Cygwin? If not, would you recommend anything else?
RE: [docbook-apps] can I move the table of contents?
Dominik, if I understood it correctly, Lorenzo talks about the table of contents, not the index. :) OFFTOPIC *laughingly* I never quite got the differences between TOC, indexes and bibliographies. To me they are all the same thing with different flavours. :-) /OFFTOPIC - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
Re: [docbook-apps] can I move the table of contents?
Hi Dominik, On Thu, 19 Apr 2012 09:23:06 +0200 Dominik Psenner dpsen...@gmail.com wrote: Dominik, if I understood it correctly, Lorenzo talks about the table of contents, not the index. :) OFFTOPIC *laughingly* I never quite got the differences between TOC, indexes and bibliographies. To me they are all the same thing with different flavours. :-) :-) It's not that difficult: * The TOC is a consecutive list of all the all titles, mainly of chapters, sections, and appendices (sometimes also from figures, tables, etc.) The titles appear in their respective order. In a book, a TOC is usually printed at the _beginning_. * The index is an alphabetically sorted list of terms. If you want to know where to find something about customization layers, you would usually search the index. In a book, the index can be found at the _end_. * A bibliography is a list of books, reports, magazines, Web pages etc. for further reading/information. For example, if you write a book about DocBook you would certainly refer (or cite) the DocBook Definitive Guide from Norman. An item in the bibliography contains the author, the ISBN number, edition, publisher, etc. to make it easy to find it. In a book, a bibliography is usually shown at the end. Look into a classical book and you will find these parts. Hope that helps. :) -- Gruß/Regards, Thomas Schraitle - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
[docbook-apps] Profiling/Conditional Text in Webhelp
Hi, I use Docbook's profiling (i.e. conditional text) facility to produce different flavours of content. This works great for HTML and PDF output. I've recently started using the Webhelp output format (http://blog.kasunbg.org/2010/08/docbook-webhelp-project.html). The problem is that Webhelp's stylesheet does not perform any conditional processing when producing its output despite I including the xhtml/profile-chunk.xsl file during the processing (as with the profiled HTML and PDF processing). Has anyone any experience with this? I'm wondering if the chunking-related templates in the Webhelp stylesheet are causing profiled-chunking to be ignored somehow? Rgds, Dermot -- View this message in context: http://old.nabble.com/Profiling-Conditional-Text-in-Webhelp-tp33715122p33715122.html Sent from the docbook apps mailing list archive at Nabble.com. - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
Re: [docbook-apps] Profiling/Conditional Text in Webhelp
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Hi Dermot, Please use the latest version from the snapshots machine: http://snapshots.docbook.org/ That version supports profiling (set the appropriate profile.* param in your build file) and includes many other improvements. A new release of the xsls will be out soon. Thanks, David On 04/19/2012 10:50 AM, Dermot O'H wrote: Hi, I use Docbook's profiling (i.e. conditional text) facility to produce different flavours of content. This works great for HTML and PDF output. I've recently started using the Webhelp output format (http://blog.kasunbg.org/2010/08/docbook-webhelp-project.html). The problem is that Webhelp's stylesheet does not perform any conditional processing when producing its output despite I including the xhtml/profile-chunk.xsl file during the processing (as with the profiled HTML and PDF processing). Has anyone any experience with this? I'm wondering if the chunking-related templates in the Webhelp stylesheet are causing profiled-chunking to be ignored somehow? Rgds, Dermot -BEGIN PGP SIGNATURE- Version: GnuPG v1.4.11 (GNU/Linux) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/ iQEcBAEBAgAGBQJPkDn8AAoJEMHeSXG7afUhPeoH/iPaDsJLI6d655YMd+tZq2KV bplVoRzp99YRl5ege6ddhKjoi1A6t093QT/tBXQDn+IjLV0e9FYUPS59i15Iolzk 5NqYck1LXhF0XxONSVuEOaLTQUWZ7/YEtnyV5z45E3rJl/8aTKnQIqztex+IQuHt 5Tk92GpWmRQCwwNzC0+MHY8a+W33F435huZwcjbhT6GDD3iengERHu/SLqVLUCmv h/WhGY6/C2dFyWZhVLM7GcUfQvNuoaSUugQNJIDYHh99sYqLGe6Op2mD+V7+pKQ+ 0EaHvin+9VkU+k7tXek66vKAVT3VPLMasl7lWOzJZyYVH5aE4LV4D3X2XpXDZ2o= =27T1 -END PGP SIGNATURE- - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
[docbook-apps] Template of what can go into the info element of an EPub book
Good evening: Is there a template of what I can use in the info element of a book to be published as EPub 3? Is there a guide of which, if any, elements are not allowed? Carlos signature.asc Description: Message signed with OpenPGP using GPGMail