[QuickBook] missing prev/next
Hello all, I have generate the Boost.Units documentatiom using Boost.QuickBook from the latest Boost release 1.45.0 but the HTML pages are missing the prev and next page links. I only have the up and home links in the navbar. How can I get the prev and next links to show? Do I need to enable some XLS configuration in the Jamfile? Thank you very much. -- Sent from my mobile device Lorenzo
On 17 December 2010 13:35, Lorenzo Caminiti <lorcaminiti@gmail.com> wrote:
I have generate the Boost.Units documentatiom using Boost.QuickBook from the latest Boost release 1.45.0 but the HTML pages are missing the prev and next page links. I only have the up and home links in the navbar.
How can I get the prev and next links to show? Do I need to enable some XLS configuration in the Jamfile?
I've never seen that, I guess it could be a problem with the docbook chunker. Do you know which version of the docbook xsl stylesheets you're using? Also which version of xsltproc (run 'xsltproc --version', will need to see all the output). Daniel
On Sun, Dec 19, 2010 at 9:40 AM, Daniel James <dnljms@gmail.com> wrote:
On 17 December 2010 13:35, Lorenzo Caminiti <lorcaminiti@gmail.com> wrote:
I have generate the Boost.Units documentatiom using Boost.QuickBook from the latest Boost release 1.45.0 but the HTML pages are missing the prev and next page links. I only have the up and home links in the navbar.
How can I get the prev and next links to show? Do I need to enable some XLS configuration in the Jamfile?
I've never seen that, I guess it could be a problem with the docbook chunker. Do you know which version of the docbook xsl stylesheets you're using? Also which version of xsltproc (run 'xsltproc --version', will need to see all the output).
xsltproc --version Using libxml 20707, libxslt 10126 and libexslt 815 xsltproc was compiled against libxml 20706, libxslt 10126 and libexslt 815 libxslt 10126 was compiled against libxml 20706 libexslt 815 was compiled against libxml 20706 I am using MS Windows XP Professional. I am not familiar with the QuickBook tools so just let me know how I can provide additional debug info. Thanks for looking into this. -- Lorenzo
-----Original Message----- From: boost-bounces@lists.boost.org [mailto:boost-bounces@lists.boost.org] On Behalf Of Daniel James Sent: Sunday, December 19, 2010 2:41 PM To: boost@lists.boost.org Subject: Re: [boost] [QuickBook] missing prev/next
On 17 December 2010 13:35, Lorenzo Caminiti <lorcaminiti@gmail.com> wrote:
I have generate the Boost.Units documentatiom using Boost.QuickBook from the latest Boost release 1.45.0 but the HTML pages are missing the prev and next page links. I only have the up and home links in the navbar.
How can I get the prev and next links to show? Do I need to enable some XLS configuration in the Jamfile?
Are you quite sure that the next.png and prev.png files are present where they should be (with home.png ... of course)? (I've managed to fail to get them in the right place with my faulty docs builds - with the symptom you describe). Perhaps authors should be encouraged to run the W3C validation test? (The current system is a bit untidy in that there have to be copies of *all* these files in the right places, often in a /image folder. I've tried to make these link absolute to use a single version in a higher level Boost directory, but the docs build system doesn't always work right with absolute links.) So each Boost release contains a boost.png, prev.png ... for *every* library with docs, bloating the files system - but there you go... (This is good in that it permits packaging of a complete index.html and all linked files into a single zip - but we won't really make much use of that?) Paul --- Paul A. Bristow, Prizet Farmhouse, Kendal LA8 8AB UK +44 1539 561830 07714330204 pbristow@hetp.u-net.com
On Sun, Dec 19, 2010 at 11:44 AM, Paul A. Bristow <pbristow@hetp.u-net.com> wrote:
-----Original Message----- From: boost-bounces@lists.boost.org [mailto:boost-bounces@lists.boost.org] On Behalf Of Daniel James Sent: Sunday, December 19, 2010 2:41 PM To: boost@lists.boost.org Subject: Re: [boost] [QuickBook] missing prev/next
On 17 December 2010 13:35, Lorenzo Caminiti <lorcaminiti@gmail.com> wrote:
I have generate the Boost.Units documentatiom using Boost.QuickBook from the latest Boost release 1.45.0 but the HTML pages are missing the prev and next page links. I only have the up and home links in the navbar.
How can I get the prev and next links to show? Do I need to enable some XLS configuration in the Jamfile?
Are you quite sure that the next.png and prev.png files are present where they should be (with home.png ... of course)? (I've managed to fail to get them in the right place with my faulty docs builds - with the symptom you describe).
Yes, I have the next/prev.png together with home.png: $ ls /cygdrive/c/Program\ Files/boost/boost_1_45_0/doc/src/images/ alert.png callouts caution.svg home.png important.png next.png next_disabled.png note.svg prev.svg smiley.png tip.svg toc-minus.png up.png up_disabled.png warning.svg blank.png caution.png draft.png home.svg important.svg next.svg note.png prev.png prev_disabled.png tip.png toc-blank.png toc-plus.png up.svg warning.png Here is the HTML generated by QuickBook (you can see the path of home.png is the same as the `ls` above): <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"> <title>Tutorial</title> <link rel="stylesheet" href="C:%5CPROGRA~1%5Cboost%5Cboost_1_45_0/doc/src/boostbook.css" type="text/css"> <meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"> <link rel="home" href="../index.html" title="Boost.Local 0.0.1 (development)"> <link rel="up" href="../index.html" title="Boost.Local 0.0.1 (development)"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> <table cellpadding="2" width="100%"><tr> <td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="C:%5CPROGRA~1%5Cboost%5Cboost_1_45_0/boost.png"></td> <td align="center"><a href="C:%5CPROGRA~1%5Cboost%5Cboost_1_45_0/index.html">Home</a></td> <td align="center"><a href="C:%5CPROGRA~1%5Cboost%5Cboost_1_45_0/libs/libraries.htm">Libraries</a></td> <td align="center"><a href="http://www.boost.org/users/people.html">People</a></td> <td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td> <td align="center"><a href="C:%5CPROGRA~1%5Cboost%5Cboost_1_45_0/more/index.htm">More</a></td> </tr></table> <hr> <div class="spirit-nav"> <a accesskey="u" href="../index.html"><img src="C:%5CPROGRA~1%5Cboost%5Cboost_1_45_0/doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="C:%5CPROGRA~1%5Cboost%5Cboost_1_45_0/doc/src/images/home.png" alt="Home"></a> </div> <div class="section"> <div class="titlepage"><div><div><h2 class="title" style="clear: both"> <a name="boost_local.tutorial"></a><a class="link" href="tutorial.html" title="Tutorial">Tutorial</a> </h2></div></div></div> <p> This section illustrates the basic library features that support all local functions, local blocks, and local exits. </p> ... **Is there any way I can pullout debug info from XSL or similar?** I looked at navbar.xsl and I see code that test is `count($prev)>0` but I am really not familiar with this XSL stuff... <div class = "spirit-nav"> <!-- prev --> <xsl:if test = "count($prev)>0"><a accesskey = "p"> <xsl:attribute name = "href"><xsl:call-template name = "href.target"> <xsl:with-param name = "object" select = "$prev"/> </xsl:call-template></xsl:attribute> <xsl:call-template name = "navig.content"> <xsl:with-param name = "direction" select = "'prev'"/> </xsl:call-template> </a></xsl:if> Thanks a lot! -- Lorenzo
-----Original Message----- From: boost-bounces@lists.boost.org [mailto:boost-bounces@lists.boost.org] On Behalf Of Lorenzo Caminiti Sent: Tuesday, December 21, 2010 2:32 AM To: boost@lists.boost.org Subject: Re: [boost] [QuickBook] missing prev/next
On Sun, Dec 19, 2010 at 11:44 AM, Paul A. Bristow <pbristow@hetp.u-net.com> wrote:
-----Original Message----- From: boost-bounces@lists.boost.org [mailto:boost-bounces@lists.boost.org] On Behalf Of Daniel James Sent: Sunday, December 19, 2010 2:41 PM To: boost@lists.boost.org Subject: Re: [boost] [QuickBook] missing prev/next
On 17 December 2010 13:35, Lorenzo Caminiti <lorcaminiti@gmail.com> wrote:
I have generate the Boost.Units documentatiom using Boost.QuickBook from the latest Boost release 1.45.0 but the HTML pages are missing the prev and next page links. I only have the up and home links in the navbar.
How can I get the prev and next links to show? Do I need to enable some XLS configuration in the Jamfile?
Are you quite sure that the next.png and prev.png files are present where they should be (with home.png ... of course)? (I've managed to fail to get them in the right place with my faulty docs builds - with the symptom you describe).
Yes, I have the next/prev.png together with home.png:
Clearly you have - I just thought it was worth checking. I would look at the html source and compare link to up.png with those to prev.png - in the Units library itself. Does the Units library have its own /images section? which might be missing the prev/next? But I no really good suggestions :-( Paul --- Paul A. Bristow, Prizet Farmhouse, Kendal LA8 8AB UK +44 1539 561830 07714330204 pbristow@hetp.u-net.com
On 21 December 2010 02:31, Lorenzo Caminiti <lorcaminiti@gmail.com> wrote:
<link rel="stylesheet" href="C:%5CPROGRA~1%5Cboost%5Cboost_1_45_0/doc/src/boostbook.css" type="text/css">
You shouldn't be using local absolute paths - they're not going to work on other computers. The Jamfile for units sets 'boost.root' to use the correct relative path so this shouldn't be a problem.
<link rel="home" href="../index.html" title="Boost.Local 0.0.1 (development)"> <link rel="up" href="../index.html" title="Boost.Local 0.0.1 (development)">
Where does 'Boost.Local 0.0.1' come from? Can you try building the documentation with a clean copy of boost and see if that works? If not please post your user-config.jam and 'bin.v2/boostbook_catalog.xml' so we can see how you've set it up.
**Is there any way I can pullout debug info from XSL or similar?**
You can use an <xsl:message> tag to write to stdout, such as: <xsl:message> count($prev) = <xsl:value-of select="count($prev)"/> </xsl:message> http://www.sagehill.net/docbookxsl/DebuggingXSL.html Daniel
On Tue, Dec 21, 2010 at 6:10 AM, Daniel James <dnljms@gmail.com> wrote:
On 21 December 2010 02:31, Lorenzo Caminiti <lorcaminiti@gmail.com> wrote:
<link rel="stylesheet" href="C:%5CPROGRA~1%5Cboost%5Cboost_1_45_0/doc/src/boostbook.css" type="text/css">
You shouldn't be using local absolute paths - they're not going to work on other computers. The Jamfile for units sets 'boost.root' to use the correct relative path so this shouldn't be a problem.
<link rel="home" href="../index.html" title="Boost.Local 0.0.1 (development)"> <link rel="up" href="../index.html" title="Boost.Local 0.0.1 (development)">
Where does 'Boost.Local 0.0.1' come from? Can you try building the documentation with a clean copy of boost and see if that works? If not please post your user-config.jam and 'bin.v2/boostbook_catalog.xml' so we can see how you've set it up.
**Is there any way I can pullout debug info from XSL or similar?**
You can use an <xsl:message> tag to write to stdout, such as:
<xsl:message> count($prev) = <xsl:value-of select="count($prev)"/> </xsl:message>
Unfortunately, I was not able to figure this out... my knowledge of these tools is very limited... I have posted the generated HTML on the web: http://contractpp.sourceforge.net/boost-local_0_1_0-818/libs/local/doc/html/... The Quick Book source is in the Boost Vault under "Function Objects" boost-local_0_1_0-818.zip (see libs/local/doc/qbk) with the related Jamfiles. It would be great if someone could build this documentation and see if the prev/next links show up. If so then the issue is just with my Quick/Boost Book configuration and not with my .qbk or .jam files... Thank you. -- Lorenzo
-----Original Message----- From: boost-bounces@lists.boost.org [mailto:boost-bounces@lists.boost.org] On Behalf Of Lorenzo Caminiti Sent: Wednesday, January 05, 2011 4:11 PM To: boost@lists.boost.org Subject: Re: [boost] [QuickBook] missing prev/next
On Tue, Dec 21, 2010 at 6:10 AM, Daniel James <dnljms@gmail.com> wrote:
On 21 December 2010 02:31, Lorenzo Caminiti <lorcaminiti@gmail.com> wrote:
<link rel="stylesheet" href="C:%5CPROGRA~1%5Cboost%5Cboost_1_45_0/doc/src/boostbook.css" type="text/css">
You shouldn't be using local absolute paths - they're not going to work on other computers. The Jamfile for units sets 'boost.root' to use the correct relative path so this shouldn't be a problem.
<link rel="home" href="../index.html" title="Boost.Local 0.0.1 (development)"> <link rel="up" href="../index.html" title="Boost.Local 0.0.1 (development)">
Where does 'Boost.Local 0.0.1' come from? Can you try building the documentation with a clean copy of boost and see if that works? If not please post your user-config.jam and 'bin.v2/boostbook_catalog.xml' so we can see how you've set it up.
**Is there any way I can pullout debug info from XSL or similar?**
You can use an <xsl:message> tag to write to stdout, such as:
<xsl:message> count($prev) = <xsl:value-of select="count($prev)"/> </xsl:message>
Unfortunately, I was not able to figure this out... my knowledge of these tools is very limited...
I have posted the generated HTML on the web: http://contractpp.sourceforge.net/boost-local_0_1_0- 818/libs/local/doc/html/index.html The Quick Book source is in the Boost Vault under "Function Objects" boost-local_0_1_0-818.zip (see libs/local/doc/qbk) with the related Jamfiles.
It would be great if someone could build this documentation and see if the prev/next links show up. If so then the issue is just with my Quick/Boost Book configuration and not with my .qbk or .jam files...
Looking nice (if you want local functions ;-). (Aside - other libraries all use a jamfile.v2, and have a different directory structure. I think you'd do better to get your proposed library in the sandbox, and follow the structure used by others - though there is some variation - and it would be a good idea if everyone had the same folder'n'file layout to ease maintenance - and answering questions like this!). I've only glanced at this, but do you now have to ask for a navigation bar? <xsl:param>nav.layout=horizontal # to get a horizontal navigation bar (you probably DO want this). <xsl:param>boost.image=Boost # options are: none (no logo), Boost (for boost.png), or your own logo like inspired_by_boost.png <xsl:param>boost.image.src=./images/boost.png # <<<<<<<<< note implied location of /images <xsl:param>boost.image.w=180 # Width of logo in pixels. <xsl:param>boost.image.h=90 # Height of logo in pixels. # HTML options: <xsl:param>navig.graphics=1 # Use graphics not text for navigation. <xsl:param>chunk.section.depth=10 # How far down we chunk nested sections, basically all of them. <xsl:param>chunk.first.sections=1 # Don't put the first section on the same page as the TOC. <xsl:param>toc.section.depth=10 # How far down sections get TOCs. <xsl:param>toc.max.depth=4 # Max depth in each TOC. <xsl:param>generate.section.toc.level=10 # How far down we go with TOCs. are in many libraries, and may help. HTH Paul --- Paul A. Bristow, Prizet Farmhouse, Kendal LA8 8AB UK +44 1539 561830 07714330204 pbristow@hetp.u-net.com
On 5 January 2011 16:11, Lorenzo Caminiti <lorcaminiti@gmail.com> wrote:
It would be great if someone could build this documentation and see if the prev/next links show up. If so then the issue is just with my Quick/Boost Book configuration and not with my .qbk or .jam files...
It builds fine for me on OS X. I uploaded it to: http://boost-sandbox.sourceforge.net/libs/local/doc/html/index.html There are some other odd differences in your build. You're missing the section contents which are at the start of most pages. Also you get a border around your tables: http://contractpp.sourceforge.net/boost-local_0_1_0-818/libs/local/doc/html/... http://boost-sandbox.sourceforge.net/libs/local/doc/html/boost_local/Example... Which I think suggests that you've got some odd settings somewhere. How did you install xsltproc and docbook? Daniel
On Wed, Jan 5, 2011 at 2:25 PM, Daniel James <dnljms@gmail.com> wrote:
On 5 January 2011 16:11, Lorenzo Caminiti <lorcaminiti@gmail.com> wrote:
It would be great if someone could build this documentation and see if the prev/next links show up. If so then the issue is just with my Quick/Boost Book configuration and not with my .qbk or .jam files...
It builds fine for me on OS X. I uploaded it to:
http://boost-sandbox.sourceforge.net/libs/local/doc/html/index.html
There are some other odd differences in your build. You're missing the section contents which are at the start of most pages. Also you get a border around your tables:
http://contractpp.sourceforge.net/boost-local_0_1_0-818/libs/local/doc/html/... http://boost-sandbox.sourceforge.net/libs/local/doc/html/boost_local/Example...
Which I think suggests that you've got some odd settings somewhere. How did you install xsltproc and docbook?
Thanks a lot for checking into this! I installed xsltproc and docbook following the instructions on the Boost website for Windows (but I am sure I messed up something...). Is there a way I can check/post specific XSL/DocBook configuration files? Where are these configuration files? Also, how can I get the Doxygen reference documentation to have hyper links? I would like for both for Doxygen to link Doxygen pages as well as the QuickBook sections. I had to manually use the <a> HTML command but it that is not ideal and it broke in the build you have posted on boost-sandbox website... Thanks, -- Lorenzo
On 7 January 2011 16:29, Lorenzo Caminiti <lorcaminiti@gmail.com> wrote:
I installed xsltproc and docbook following the instructions on the Boost website for Windows (but I am sure I messed up something...). Is there a way I can check/post specific XSL/DocBook configuration files? Where are these configuration files?
There are a few different places with installation instructions - can you link to the page you followed? Also are you using cygwin and did you use the setup_boostbook script, or did you write your user-config.jam yourself? Can you post your user-config.jam if you did.
Also, how can I get the Doxygen reference documentation to have hyper links? I would like for both for Doxygen to link Doxygen pages as well as the QuickBook sections. I had to manually use the <a> HTML command but it that is not ideal and it broke in the build you have posted on boost-sandbox website...
I'm not sure as I don't use doxygen, I'll look into it. Can you link to a page where it didn't work? I can't find any anchors in your headers. Daniel
On Fri, Jan 7, 2011 at 11:58 AM, Daniel James <dnljms@gmail.com> wrote:
On 7 January 2011 16:29, Lorenzo Caminiti <lorcaminiti@gmail.com> wrote:
I installed xsltproc and docbook following the instructions on the Boost website for Windows (but I am sure I messed up something...). Is there a way I can check/post specific XSL/DocBook configuration files? Where are these configuration files?
There are a few different places with installation instructions - can you link to the page you followed? Also are you using cygwin and did
I followed: http://www.boost.org/doc/libs/1_45_0/doc/html/quickbook/install.html#quickbo...
you use the setup_boostbook script, or did you write your user-config.jam yourself? Can you post your user-config.jam if you did.
I am not using CygWin. I wrote my user-config.jam: import os ; local BOOST_ROOT = [ os.environ BOOST_ROOT ] ; using msvc ; # Toolset. # Boost.QuickBook (and related tools). using quickbook : $(BOOST_ROOT)"/bin.v2/tools/quickbook/src/msvc-8.0/debug/link-static/threading-multi/quickbook.exe" : ; using xsltproc : "C:/Users/example/Documents/boost/xml/bin/xsltproc.exe" ; using boostbook : "C:/Users/example/Documents/boost/xml/docbook-xsl" : "C:/Users/example/Documents/boost/xml/docbook-xml" ; using doxygen : "C:/Program Files/doxygen/bin/doxygen.exe" ;
Also, how can I get the Doxygen reference documentation to have hyper links? I would like for both for Doxygen to link Doxygen pages as well as the QuickBook sections. I had to manually use the <a> HTML command but it that is not ideal and it broke in the build you have posted on boost-sandbox website...
I'm not sure as I don't use doxygen, I'll look into it. Can you link to a page where it didn't work? I can't find any anchors in your headers.
I am using the @Ref (link to from Doxygen to Doxygen) and @Sect (link from Doxygen to QuickBook) alias defined in the jamfile.jam which expand to a <a>...</a> HTML commands -- this is probably a bad idea, that's why I am asking how to do this right. However, I just realized that this manual <a> command also work in the documentation build you generated (before I was getting an error on something else... sorry). That said, is there a better way to link from Doxygen to other Doxygen pages and to QuickBook pages when the Doxygen documentation is generated for QuickBook? -- Lorenzo
AMDG On 1/7/2011 9:26 AM, Lorenzo Caminiti wrote:
I'm not sure as I don't use doxygen, I'll look into it. Can you link to a page where it didn't work? I can't find any anchors in your headers. I am using the @Ref (link to from Doxygen to Doxygen) and @Sect (link from Doxygen to QuickBook) alias defined in the jamfile.jam which expand to a<a>...</a> HTML commands -- this is probably a bad idea, that's why I am asking how to do this right.
However, I just realized that this manual<a> command also work in the documentation build you generated (before I was getting an error on something else... sorry). That said, is there a better way to link from Doxygen to other Doxygen pages and to QuickBook pages when the Doxygen documentation is generated for QuickBook?
You can use BoostBook markup: @xmlonly <link linkend="boost_random.reference.concepts.random_distribution">random distribution</link> @endxmlonly @xmlonly <classname alt="boost::lagged_fibonacci607">lagged_fibonacci607</classname> @endxmlonly In Christ, Steven Watanabe
On 7 January 2011 17:26, Lorenzo Caminiti <lorcaminiti@gmail.com> wrote:
I followed: http://www.boost.org/doc/libs/1_45_0/doc/html/quickbook/install.html#quickbo...
I know what went wrong. When you click on the link to download the xsl stylesheets on a windows machine, sourceforge says: 'Looking for the latest version? Download docbook-xsl-ns-1.76.1.zip (5.3 MB)' You downloaded it (quite sensibly) but it's the wrong file. Oddly, it links to the right file when using OS X. You need 'docbook-xsl-1.76.1.zip', which you'll find here: http://sourceforge.net/projects/docbook/files/docbook-xsl/1.76.1/docbook-xsl... I'll try to make the documentation a bit clearer. Daniel
On Fri, Jan 7, 2011 at 3:56 PM, Daniel James <dnljms@gmail.com> wrote:
On 7 January 2011 17:26, Lorenzo Caminiti <lorcaminiti@gmail.com> wrote:
I followed: http://www.boost.org/doc/libs/1_45_0/doc/html/quickbook/install.html#quickbo...
I know what went wrong. When you click on the link to download the xsl stylesheets on a windows machine, sourceforge says:
'Looking for the latest version? Download docbook-xsl-ns-1.76.1.zip (5.3 MB)'
You downloaded it (quite sensibly) but it's the wrong file. Oddly, it links to the right file when using OS X. You need 'docbook-xsl-1.76.1.zip', which you'll find here:
http://sourceforge.net/projects/docbook/files/docbook-xsl/1.76.1/docbook-xsl...
I'll try to make the documentation a bit clearer.
Yes, I indeed downloaded xsl-ns. I have downloaded the correct xsl now but I am getting the errors below (these might be unrelated errors but they do not show up with xsl-ns). Thanks a lot. ...patience... ...found 363 targets... ...updating 1 target... xslt-xsltproc-dir.windows html\standalone_HTML.manifest warning: failed to load external entity "http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl" compilation error: file file:///C:/Program%20Files/boost/boost_1_45_0/tools/boostbook/xsl/html.xsl line 16 element import xsl:import : unable to load http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl warning: failed to load external entity "http://docbook.sourceforge.net/release/xsl/current/html/math.xsl" compilation error: file file:///C:/Program%20Files/boost/boost_1_45_0/tools/boostbook/xsl/html.xsl line 18 element import xsl:import : unable to load http://docbook.sourceforge.net/release/xsl/current/html/math.xsl warning: failed to load external entity "http://docbook.sourceforge.net/release/xsl/current/html/chunkfast.xsl" compilation error: file file:///C:/Program%20Files/boost/boost_1_45_0/tools/boostbook/xsl/html.xsl line 23 element include xsl:include : unable to load http://docbook.sourceforge.net/release/xsl/current/html/chunkfast.xsl warning: failed to load external entity "http://docbook.sourceforge.net/release/xsl/current/html/formal.xsl" compilation error: file file:///C:/Program%20Files/boost/boost_1_45_0/tools/boostbook/xsl/docbook-layout.xsl line 16 element import xsl:import : unable to load http://docbook.sourceforge.net/release/xsl/current/html/formal.xsl warning: failed to load external entity "http://docbook.sourceforge.net/release/xsl/current/html/admon.xsl" compilation error: file file:///C:/Program%20Files/boost/boost_1_45_0/tools/boostbook/xsl/admon.xsl line 12 element import xsl:import : unable to load http://docbook.sourceforge.net/release/xsl/current/html/admon.xsl warning: failed to load external entity "http://docbook.sourceforge.net/release/xsl/current/html/xref.xsl" compilation error: file file:///C:/Program%20Files/boost/boost_1_45_0/tools/boostbook/xsl/xref.xsl line 16 element import xsl:import : unable to load http://docbook.sourceforge.net/release/xsl/current/html/xref.xsl warning: failed to load external entity "http://docbook.sourceforge.net/release/xsl/current/lib/lib.xsl" compilation error: file file:///C:/Program%20Files/boost/boost_1_45_0/tools/boostbook/xsl/relative-href.xsl line 12 element import xsl:import : unable to load http://docbook.sourceforge.net/release/xsl/current/lib/lib.xsl warning: failed to load external entity "http://docbook.sourceforge.net/release/xsl/current/html/callout.xsl" compilation error: file file:///C:/Program%20Files/boost/boost_1_45_0/tools/boostbook/xsl/callout.xsl line 13 element import xsl:import : unable to load http://docbook.sourceforge.net/release/xsl/current/html/callout.xsl set XML_CATALOG_FILES=../../../bin/boostbook_catalog.xml "C:/Users/example/Documents/boost/xml/bin/xsltproc.exe" --stringparam boost.defaults "Boost" --stringparam boost.root "../../../../.." --stringparam generate.section.toc.level "10" --stringparam manifest "standalone_HTML.manifest" --stringparam toc.max.depth "1" --stringparam toc.section.depth "3" --xinclude -o "html/" "C:\Program Files\boost\boost_1_45_0\tools\boostbook\xsl\html.xsl" "bin\msvc-8.0\debug\threading-multi\doc.docbook" ...failed xslt-xsltproc-dir.windows html\standalone_HTML.manifest... ...failed updating 1 target... -- Lorenzo
AMDG On 1/9/2011 11:19 AM, Lorenzo Caminiti wrote:
Yes, I indeed downloaded xsl-ns. I have downloaded the correct xsl now but I am getting the errors below (these might be unrelated errors but they do not show up with xsl-ns). Thanks a lot.
...patience... ...found 363 targets... ...updating 1 target... xslt-xsltproc-dir.windows html\standalone_HTML.manifest warning: failed to load external entity "http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl" compilation error: file file:///C:/Program%20Files/boost/boost_1_45_0/tools/boostbook/xsl/html.xsl line 16 element import xsl:import : unable to load http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl <snip>
set XML_CATALOG_FILES=../../../bin/boostbook_catalog.xml <snip>
...failed xslt-xsltproc-dir.windows html\standalone_HTML.manifest... ...failed updating 1 target...
What are the contents of boostbook_catalog.xml? In Christ, Steven Watanabe
On Sun, Jan 9, 2011 at 6:02 PM, Steven Watanabe <watanabesj@gmail.com> wrote:
AMDG
On 1/9/2011 11:19 AM, Lorenzo Caminiti wrote:
Yes, I indeed downloaded xsl-ns. I have downloaded the correct xsl now but I am getting the errors below (these might be unrelated errors but they do not show up with xsl-ns). Thanks a lot.
...patience... ...found 363 targets... ...updating 1 target... xslt-xsltproc-dir.windows html\standalone_HTML.manifest warning: failed to load external entity "http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl" compilation error: file file:///C:/Program%20Files/boost/boost_1_45_0/tools/boostbook/xsl/html.xsl line 16 element import xsl:import : unable to load http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl <snip>
set XML_CATALOG_FILES=../../../bin/boostbook_catalog.xml <snip>
...failed xslt-xsltproc-dir.windows html\standalone_HTML.manifest... ...failed updating 1 target...
What are the contents of boostbook_catalog.xml?
This is boostbook_catalog.xml: <?xml version="1.0"?> <!DOCTYPE catalog PUBLIC "-//OASIS/DTD Entity Resolution XML Catalog V1.0//EN" "http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd"> <catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog"> <rewriteURI uriStartString="http://www.boost.org/tools/boostbook/dtd/" rewritePrefix="file:///C:/Program%20Files/boost/boost_1_45_0/tools/boostbook/dtd/"/> <rewriteURI uriStartString="http://docbook.sourceforge.net/release/xsl/current/" rewritePrefix="file:///C:/Users/example/Documents/boost/xml/docbook-xsl/"/> <rewriteURI uriStartString="http://www.oasis-open.org/docbook/xml/4.2/" rewritePrefix="file:///C:/Users/example/Documents/boost/xml/docbook-xml/"/> </catalog> Thanks a lot! -- Lorenzo
AMDG On 1/9/2011 3:08 PM, Lorenzo Caminiti wrote:
On Sun, Jan 9, 2011 at 6:02 PM, Steven Watanabe<watanabesj@gmail.com> wrote:
On 1/9/2011 11:19 AM, Lorenzo Caminiti wrote:
<snip> xslt-xsltproc-dir.windows html\standalone_HTML.manifest warning: failed to load external entity "http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl" <snip> What are the contents of boostbook_catalog.xml? This is boostbook_catalog.xml:
<?xml version="1.0"?> <!DOCTYPE catalog PUBLIC "-//OASIS/DTD Entity Resolution XML Catalog V1.0//EN" "http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd"> <catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog"> <rewriteURI uriStartString="http://www.boost.org/tools/boostbook/dtd/" rewritePrefix="file:///C:/Program%20Files/boost/boost_1_45_0/tools/boostbook/dtd/"/> <rewriteURI uriStartString="http://docbook.sourceforge.net/release/xsl/current/" rewritePrefix="file:///C:/Users/example/Documents/boost/xml/docbook-xsl/"/> <rewriteURI uriStartString="http://www.oasis-open.org/docbook/xml/4.2/" rewritePrefix="file:///C:/Users/example/Documents/boost/xml/docbook-xml/"/> </catalog>
Okay, does C:/Users/example/Documents/boost/xml/docbook-xsl/html/chunk.xsl exist? What does xsltproc --version say? In Christ, Steven Watanabe
On Sun, Jan 9, 2011 at 6:18 PM, Steven Watanabe <watanabesj@gmail.com> wrote:
AMDG
On 1/9/2011 3:08 PM, Lorenzo Caminiti wrote:
On Sun, Jan 9, 2011 at 6:02 PM, Steven Watanabe<watanabesj@gmail.com> wrote:
On 1/9/2011 11:19 AM, Lorenzo Caminiti wrote:
<snip> xslt-xsltproc-dir.windows html\standalone_HTML.manifest warning: failed to load external entity "http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl" <snip>
What are the contents of boostbook_catalog.xml?
This is boostbook_catalog.xml:
<?xml version="1.0"?> <!DOCTYPE catalog PUBLIC "-//OASIS/DTD Entity Resolution XML Catalog V1.0//EN" "http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd"> <catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog"> <rewriteURI uriStartString="http://www.boost.org/tools/boostbook/dtd/"
rewritePrefix="file:///C:/Program%20Files/boost/boost_1_45_0/tools/boostbook/dtd/"/> <rewriteURI uriStartString="http://docbook.sourceforge.net/release/xsl/current/"
rewritePrefix="file:///C:/Users/example/Documents/boost/xml/docbook-xsl/"/> <rewriteURI uriStartString="http://www.oasis-open.org/docbook/xml/4.2/"
rewritePrefix="file:///C:/Users/example/Documents/boost/xml/docbook-xml/"/> </catalog>
Okay, does C:/Users/example/Documents/boost/xml/docbook-xsl/html/chunk.xsl exist? What does xsltproc --version say?
Sorry for wasting your time... I just realized that I uncompressed docbook-xsl into the wrong directory. When I unzipped xsl-ns it created a subdirectory docbook-xsl/ inside the directory dcbook-xsl/. Since I installed xsl in place of xsl-ns and in the correct directory :), everything works fine (I have next/prev, no borders around tables, contents at beginning of each page, etc). This issue is resolved. Thanks a lot to everyone for all your help! -- Lorenzo
-----Original Message----- From: boost-bounces@lists.boost.org [mailto:boost-bounces@lists.boost.org] On Behalf Of Lorenzo Caminiti Sent: Friday, January 07, 2011 4:29 PM To: boost@lists.boost.org Subject: Re: [boost] [QuickBook] missing prev/next
Also, how can I get the Doxygen reference documentation to have hyper
I recollect that specific versions of XSL and Docbook are required. (The latest versions don't work as I recall). links? I
would like for both for Doxygen to link Doxygen pages as well as the QuickBook sections. I had to manually use the <a> HTML command but it that is not ideal and it broke in the build you have posted on boost-sandbox website...
I do use Doxygen, but I'm not quite sure what you want. I've used a \mainpage to provide docs in both html/pdf from Quickbook and native Doxygen formats. (see attached example), but I'm not sure that is what you want. There should be lots of hyperlinks from function names, for example, that show up underlined when you hover over them. Click should jump to the function reference info. Paul --- Paul A. Bristow, Prizet Farmhouse, Kendal LA8 8AB UK +44 1539 561830 07714330204 pbristow@hetp.u-net.com
On Fri, Jan 7, 2011 at 12:50 PM, Paul A. Bristow <pbristow@hetp.u-net.com> wrote:
-----Original Message----- From: boost-bounces@lists.boost.org [mailto:boost-bounces@lists.boost.org] On Behalf Of Lorenzo Caminiti Sent: Friday, January 07, 2011 4:29 PM To: boost@lists.boost.org Subject: Re: [boost] [QuickBook] missing prev/next
I recollect that specific versions of XSL and Docbook are required. (The latest versions don't work as I recall).
Also, how can I get the Doxygen reference documentation to have hyper links? I would like for both for Doxygen to link Doxygen pages as well as the QuickBook sections. I had to manually use the <a> HTML command but it that is not ideal and it broke in the build you have posted on boost-sandbox website...
I do use Doxygen, but I'm not quite sure what you want.
I've used a \mainpage to provide docs in both html/pdf from Quickbook and native Doxygen formats. (see attached example), but I'm not sure that is what you want.
There should be lots of hyperlinks from function names, for example, that show up underlined when you hover over them. Click should jump to the function reference info.
Let me try to explain better. 1) Links from Doxygen to Doxygen: If I build the Doxygen documentation standalone using doxygen directly, I have hyperlinks for funcitons, macros, etc -- that's good :) However, if I build the Doxygen documentation from the jamfile.jam in a way that it generates a .xml file that I can included using `[include ...]` into by QuickBook documentation, all the usual Doxygen hyperlinks disappear. 2) Links from Doxygen to QuickBook: I would also like from within Doxygen to link to a QuickBook `[section ...]` or similar (so using the QuickBook identifiers). So I manually used HTML commands `<a>...</a>` to link pages within Doxygen. This works but I was wondering if there was a better way which uses the identifiers instead of the actual HTML page URLs. On Fri, Jan 7, 2011 at 12:46 PM, Steven Watanabe <watanabesj@gmail.com> wrote:
You can use BoostBook markup: @xmlonly <link linkend="boost_random.reference.concepts.random_distribution">random distribution</link> @endxmlonly @xmlonly <classname alt="boost::lagged_fibonacci607">lagged_fibonacci607</classname> @endxmlonly
OK, I will try this -- this uses the QuickBook and code identifiers as in `boost_random.reference.concepts.random_distribution` and `boost::lagged_fibonacci607` so it should be what I was looking for. Thanks. -- Lorenzo
participants (4)
-
Daniel James -
Lorenzo Caminiti -
Paul A. Bristow -
Steven Watanabe