[Boostbook] Navigation links
Hi, I have several .*qbk files that I build in separated folders, each one with is own index.html. However, I couldn't make that one of them to be the main root so when I click in home button it goes to the main root, independently from which file I am. I could only manage to get up and home button to go to file's own index. There's any solution for this or I must build everything in the same file? This is my jamfile: project doc ; import boostbook : boostbook ; xml mainXml : src/main.qbk ; xml clientXml : src/app/client.qbk ; xml serverXml : src/app/server.qbk ; boostbook main_base : mainXml : xsl:paramboost.image.src="./images/logo.png" xsl:paramboost.image.w=100 xsl:paramboost.image.h=100 xsl:paramnav.layout=none xsl:parambase.dir=../doc/html/ xsl:paramroot.filename=index xsl:paramhtml.stylesheet=./style.css xsl:paramgenerate.manifest=0 ; boostbook client : clientXml : xsl:paramboost.image.src="./../../images/logo.png" xsl:paramboost.image.w=100 xsl:paramboost.image.h=100 xsl:paramnav.layout=none xsl:parambase.dir=../doc/html/app/client/ xsl:paramroot.filename=index xsl:paramhtml.stylesheet=./../../style.css xsl:paramgenerate.manifest=0 ; boostbook server : serverXml : xsl:paramboost.image.src="./../../images/logo.png" xsl:paramboost.image.w=100 xsl:paramboost.image.h=100 xsl:paramnav.layout=none xsl:parambase.dir=../doc/html/app/server/ xsl:paramroot.filename=index xsl:paramhtml.stylesheet=./../../style.css xsl:paramgenerate.manifest=0 ;
I have several .*qbk files that I build in separated folders, each one with is own index.html. However, I couldn't make that one of them to be the main root so when I click in home button it goes to the main root, independently from which file I am. I could only manage to get up and home button to go to file's own index. There's any solution for this or I must build everything in the same file?
I think yes you need to build as a single document (you can still have separate quickbook files for easier maintenance - but you'll need a master file that includes the others). You could make each part either a separate section, or a separate chapter depending how you want to organize things. But basically if you want one master index, then you need to build as a single "book". HTH, John.
I must be tried all xsl params trying to do this. However, it seems that the
only way is to merge everything. Thanks.
Just one more question. The reason why I separated everything was because it
was merging everything in the same page. When you talk about chapters it can
be done differently?
Carlos
On Wed, Jun 30, 2010 at 11:46 AM, John Maddock
I have several .*qbk files that I build in separated folders, each one
with is own index.html. However, I couldn't make that one of them to be the main root so when I click in home button it goes to the main root, independently from which file I am. I could only manage to get up and home button to go to file's own index. There's any solution for this or I must build everything in the same file?
I think yes you need to build as a single document (you can still have separate quickbook files for easier maintenance - but you'll need a master file that includes the others). You could make each part either a separate section, or a separate chapter depending how you want to organize things. But basically if you want one master index, then you need to build as a single "book".
HTH, John. _______________________________________________ Boost-users mailing list Boost-users@lists.boost.org http://lists.boost.org/mailman/listinfo.cgi/boost-users
2010/6/30 Carlos Guimarães
I must be tried all xsl params trying to do this. However, it seems that the only way is to merge everything. Thanks. Just one more question. The reason why I separated everything was because it was merging everything in the same page. When you talk about chapters it can be done differently?
You could try using a boostbook file which xi:includes the quickbook documentation. An example of this is the combined boost documentation. The build file is at 'doc/Jamfile.v2', the boostbook code is at 'doc/src/boost.xml' (look at how accumulators, foreach, hash are handled). Currently it's hard to do this just using quickbook, I think there's an existing bug report for it. Daniel
I must be tried all xsl params trying to do this. However, it seems that the only way is to merge everything. Thanks. Just one more question. The reason why I separated everything was because it was merging everything in the same page. When you talk about chapters it can be done differently?
You can control whether sections or chapters are on separate pages, and whether the first section/chapter is on the first page or not using xsl:param's, you can also control how deep the TOC goes etc. Take a look at libs/math/doc/sf_and_dist/Jamfile.v2 for some examples. HTH, John.
participants (3)
-
Carlos Guimarães -
Daniel James -
John Maddock