Boost C++ Libraries: Ticket #2712: Quickbook uses article title rather than article id for links https://svn.boost.org/trac10/ticket/2712 <p> This Quickbook with a long title but short id </p> <p> [article Title of test of quickbook </p> <blockquote> <p> [quickbook 1.4] [id quick_test] [authors [Bristow, Paul A.]] [copyright 2009 Paul A. Bristow] [license </p> <blockquote> <p> Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at [@<a href="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</a>]) </p> </blockquote> <p> ] [source-mode c++] [purpose test of links that include title or article id.] </p> </blockquote> <p> ] </p> <p> <a href="https://svn.boost.org/trac10/">I expect that link would start with article id: quick_test</a> [/ And NOT the converted article title "Title of test of quickbook" [def <span class="underline">test_link [link quick_test.my_section1 Section One]] </span></p> <p> [section: my_section1 This is my 1st section] </p> <p> Section 1 ... </p> <p> [endsect] <a href="https://svn.boost.org/trac10/section:">my_section1 This is my 1st section</a> </p> <p> [/ test_q.qbk </p> <blockquote> <p> Copyright 2009 Paul A. Bristow. Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</a>). </p> </blockquote> <p> ] </p> <p> produces this output </p> <p> Note the </p> <p> &lt;section id="quick_test._my_section1_this_is_my_1st_section"&gt; </p> <blockquote> <p> <sup></sup><sup></sup><sup></sup><sup></sup><sup></sup><sup></sup><sup></sup><sup></sup><sup></sup><sup></sup><sup></sup><sup></sup><sup></sup><sup></sup><sup></sup><sup></sup><sup></sup><sup> </sup></p> </blockquote> <p> uses the converted title, and not the article id, as I expected. </p> <p> &lt;?xml version="1.0" encoding="UTF-8"?&gt; &lt;!DOCTYPE library PUBLIC "-<em>Boost</em>DTD <a class="missing wiki">BoostBook</a> XML V1.0<em>EN" "<a href="http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">http://www.boost.org/tools/boostbook/dtd/boostbook.dtd</a>"&gt; &lt;article id="quick_test" name="Title of test of quickbook" dirname="quick_test" last-revision="$Date: 2009/02/02 12:46:50 $" </em></p> <blockquote> <p> xmlns:xi=&#34;http://www.w3.org/2001/XInclude"&gt; </p> <blockquote> <p> &lt;articleinfo&gt; </p> <blockquote> <p> &lt;authorgroup&gt; &lt;author&gt; </p> <blockquote> <p> &lt;firstname&gt;Paul A.&lt;/firstname&gt; &lt;surname&gt;Bristow&lt;/surname&gt; </p> </blockquote> <p> &lt;/author&gt; &lt;/authorgroup&gt; &lt;copyright&gt; </p> <blockquote> <p> &lt;year&gt;2009&lt;/year&gt; &lt;holder&gt;Paul A. Bristow&lt;/holder&gt; </p> </blockquote> <p> &lt;/copyright&gt; &lt;legalnotice&gt; </p> <blockquote> <p> &lt;para&gt; </p> <blockquote> <p> Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at &lt;ulink url="<a href="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</a>"&gt;<a href="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</a>&lt;/ulink&gt;) </p> </blockquote> <p> &lt;/para&gt; </p> </blockquote> <p> &lt;/legalnotice&gt; &lt;articlepurpose&gt; </p> <blockquote> <p> test of links that include title or article id. </p> </blockquote> <p> &lt;/articlepurpose&gt; </p> </blockquote> <p> &lt;/articleinfo&gt; &lt;title&gt;Title of test of quickbook&lt;/title&gt; &lt;para&gt; </p> <blockquote> <p> [/ And NOT the converted article title &amp;quot;Title of test of quickbook&amp;quot; </p> </blockquote> <p> &lt;/para&gt; &lt;section id="quick_test._my_section1_this_is_my_1st_section"&gt; </p> <blockquote> <p> &lt;title&gt;&lt;link linkend="quick_test._my_section1_this_is_my_1st_section"&gt; my_section1 This is my 1st section&lt;/link&gt;&lt;/title&gt; &lt;para&gt; </p> <blockquote> <p> Section 1 ... </p> </blockquote> <p> &lt;/para&gt; </p> </blockquote> <p> &lt;/section&gt; </p> </blockquote> </blockquote> <p> &lt;/article&gt; </p> en-us Boost C++ Libraries /htdocs/site/boost.png https://svn.boost.org/trac10/ticket/2712 Trac 1.4.3 Daniel James Mon, 02 Feb 2009 13:28:25 GMT status, component changed https://svn.boost.org/trac10/ticket/2712#comment:1 https://svn.boost.org/trac10/ticket/2712#comment:1 <ul> <li><strong>status</strong> <span class="trac-field-old">new</span> → <span class="trac-field-new">assigned</span> </li> <li><strong>component</strong> <span class="trac-field-old">None</span> → <span class="trac-field-new">quickbook</span> </li> </ul> <p> OK, I think the problem is that you've got a space after the colon in your section: </p> <pre class="wiki">[section: my_section1 This is my 1st section] </pre><p> should be: </p> <pre class="wiki">[section:my_section1 This is my 1st section] </pre><p> which should work as you expect. It's not the article id that's wrong it's the section id. </p> <p> So, it's not exactly a bug, but quickbook should behave better in this circumstance - either by ignoring the space and using the section id that you were expecting, or a warning or error. The warning is the only non-breaking option, but one of the other two could be used for quickbook 1.5. </p> Ticket Daniel James Sat, 21 Feb 2009 18:18:58 GMT milestone changed https://svn.boost.org/trac10/ticket/2712#comment:2 https://svn.boost.org/trac10/ticket/2712#comment:2 <ul> <li><strong>milestone</strong> <span class="trac-field-old">Boost 1.38.0</span> → <span class="trac-field-new">Boost 1.39.0</span> </li> </ul> Ticket Daniel James Mon, 06 Apr 2009 22:54:37 GMT milestone changed https://svn.boost.org/trac10/ticket/2712#comment:3 https://svn.boost.org/trac10/ticket/2712#comment:3 <ul> <li><strong>milestone</strong> <span class="trac-field-old">Boost 1.39.0</span> → <span class="trac-field-new">To Be Determined</span> </li> </ul> Ticket Daniel James Sun, 31 May 2009 15:39:36 GMT milestone changed https://svn.boost.org/trac10/ticket/2712#comment:4 https://svn.boost.org/trac10/ticket/2712#comment:4 <ul> <li><strong>milestone</strong> <span class="trac-field-old">To Be Determined</span> → <span class="trac-field-new">Boost 1.40.0</span> </li> </ul> Ticket Daniel James Sun, 07 Jun 2009 20:34:26 GMT <link>https://svn.boost.org/trac10/ticket/2712#comment:5 </link> <guid isPermaLink="false">https://svn.boost.org/trac10/ticket/2712#comment:5</guid> <description> <p> (In <a class="changeset" href="https://svn.boost.org/trac10/changeset/53734" title="Ignore spaces after 'section:' for quickbook 1.5+ Refs #2712 And warn ...">[53734]</a>) Ignore spaces after 'section:' for quickbook 1.5+ Refs <a class="closed ticket" href="https://svn.boost.org/trac10/ticket/2712" title="#2712: Bugs: Quickbook uses article title rather than article id for links (closed: fixed)">#2712</a> </p> <p> And warn when section id is empty after colon. </p> </description> <category>Ticket</category> </item> <item> <dc:creator>Daniel James</dc:creator> <pubDate>Wed, 08 Jul 2009 21:54:07 GMT</pubDate> <title>milestone changed https://svn.boost.org/trac10/ticket/2712#comment:6 https://svn.boost.org/trac10/ticket/2712#comment:6 <ul> <li><strong>milestone</strong> <span class="trac-field-old">Boost 1.40.0</span> → <span class="trac-field-new">Boost 1.41.0</span> </li> </ul> Ticket Daniel James Mon, 31 Aug 2009 11:37:36 GMT <link>https://svn.boost.org/trac10/ticket/2712#comment:7 </link> <guid isPermaLink="false">https://svn.boost.org/trac10/ticket/2712#comment:7</guid> <description> <p> (In <a class="changeset" href="https://svn.boost.org/trac10/changeset/55911" title="Ignore spaces after 'section:' for quickbook 1.5+ Refs #2712 And warn ...">[55911]</a>) Ignore spaces after 'section:' for quickbook 1.5+ Refs <a class="closed ticket" href="https://svn.boost.org/trac10/ticket/2712" title="#2712: Bugs: Quickbook uses article title rather than article id for links (closed: fixed)">#2712</a> </p> <p> And warn when section id is empty after colon. </p> </description> <category>Ticket</category> </item> <item> <dc:creator>Daniel James</dc:creator> <pubDate>Mon, 12 Oct 2009 19:54:42 GMT</pubDate> <title/> <link>https://svn.boost.org/trac10/ticket/2712#comment:8 </link> <guid isPermaLink="false">https://svn.boost.org/trac10/ticket/2712#comment:8</guid> <description> <p> (In <a class="changeset" href="https://svn.boost.org/trac10/changeset/56752" title="Merge quickbook 1.5 from trunk. Merged revisions ...">[56752]</a>) Merge quickbook 1.5 from trunk. </p> <p> Merged revisions 55905-55917,56077,56715,56717-56719 via svnmerge from <a class="ext-link" href="https://svn.boost.org/svn/boost/trunk"><span class="icon">​</span>https://svn.boost.org/svn/boost/trunk</a> </p> <p> ........ </p> <blockquote> <p> <a class="changeset" href="https://svn.boost.org/trac10/changeset/55905" title="Update quickbook version number.">r55905</a> | danieljames | 2009-08-31 12:36:13 +0100 (Mon, 31 Aug 2009) | 1 line </p> </blockquote> <p> </p> <blockquote> <p> Update quickbook version number. </p> </blockquote> <p> ........ </p> <blockquote> <p> <a class="changeset" href="https://svn.boost.org/trac10/changeset/55906" title="Create entry for 1.5 in the change log. Starting it of with some of ...">r55906</a> | danieljames | 2009-08-31 12:36:23 +0100 (Mon, 31 Aug 2009) | 4 lines </p> </blockquote> <p> </p> <blockquote> <p> Create entry for 1.5 in the change log. </p> </blockquote> <p> </p> <blockquote> <p> Starting it of with some of the changes that have been made to quickbook since 1.4 - considering the first 1.4 release as the proper 1.4 release. </p> </blockquote> <p> ........ </p> <blockquote> <p> <a class="changeset" href="https://svn.boost.org/trac10/changeset/55907" title="Wrap the template info in a struct. So that I can add extra scoping info.">r55907</a> | danieljames | 2009-08-31 12:36:34 +0100 (Mon, 31 Aug 2009) | 3 lines </p> </blockquote> <p> </p> <blockquote> <p> Wrap the template info in a struct. </p> </blockquote> <p> </p> <blockquote> <p> So that I can add extra scoping info. </p> </blockquote> <p> ........ </p> <blockquote> <p> <a class="changeset" href="https://svn.boost.org/trac10/changeset/55908" title="Implement static/lexical scoping for 1.5. Refs #2034.">r55908</a> | danieljames | 2009-08-31 12:36:47 +0100 (Mon, 31 Aug 2009) | 1 line </p> </blockquote> <p> </p> <blockquote> <p> Implement static/lexical scoping for 1.5. Refs <a class="closed ticket" href="https://svn.boost.org/trac10/ticket/2034" title="#2034: Bugs: Problem with nesting templates with same parameter names (closed: fixed)">#2034</a>. </p> </blockquote> <p> ........ </p> <blockquote> <p> <a class="changeset" href="https://svn.boost.org/trac10/changeset/55909" title="In quickbook 1.5 don't mix '..' and whitespace seperators for template ...">r55909</a> | danieljames | 2009-08-31 12:37:04 +0100 (Mon, 31 Aug 2009) | 1 line </p> </blockquote> <p> </p> <blockquote> <p> In quickbook 1.5 don't mix '..' and whitespace seperators for template arguments. Refs <a class="closed ticket" href="https://svn.boost.org/trac10/ticket/1174" title="#1174: Tasks: Simplified template arg handling (closed: fixed)">#1174</a> </p> </blockquote> <p> ........ </p> <blockquote> <p> <a class="changeset" href="https://svn.boost.org/trac10/changeset/55910" title="Put the quickbook version numbers in a single header, along with ...">r55910</a> | danieljames | 2009-08-31 12:37:17 +0100 (Mon, 31 Aug 2009) | 2 lines </p> </blockquote> <p> </p> <blockquote> <p> Put the quickbook version numbers in a single header, along with convenience functions for using them in spirit grammars. </p> </blockquote> <p> ........ </p> <blockquote> <p> <a class="changeset" href="https://svn.boost.org/trac10/changeset/55911" title="Ignore spaces after 'section:' for quickbook 1.5+ Refs #2712 And warn ...">r55911</a> | danieljames | 2009-08-31 12:37:32 +0100 (Mon, 31 Aug 2009) | 3 lines </p> </blockquote> <p> </p> <blockquote> <p> Ignore spaces after 'section:' for quickbook 1.5+ Refs <a class="closed ticket" href="https://svn.boost.org/trac10/ticket/2712" title="#2712: Bugs: Quickbook uses article title rather than article id for links (closed: fixed)">#2712</a> </p> </blockquote> <p> </p> <blockquote> <p> And warn when section id is empty after colon. </p> </blockquote> <p> ........ </p> <blockquote> <p> <a class="changeset" href="https://svn.boost.org/trac10/changeset/55912" title="Introduce temporary id variable.">r55912</a> | danieljames | 2009-08-31 12:37:48 +0100 (Mon, 31 Aug 2009) | 1 line </p> </blockquote> <p> </p> <blockquote> <p> Introduce temporary id variable. </p> </blockquote> <p> ........ </p> <blockquote> <p> <a class="changeset" href="https://svn.boost.org/trac10/changeset/55913" title="Table ids. Refs #1194.">r55913</a> | danieljames | 2009-08-31 12:37:59 +0100 (Mon, 31 Aug 2009) | 1 line </p> </blockquote> <p> </p> <blockquote> <p> Table ids. Refs <a class="closed ticket" href="https://svn.boost.org/trac10/ticket/1194" title="#1194: Feature Requests: Add ID to table to allow linking to tables easily (closed: fixed)">#1194</a>. </p> </blockquote> <p> ........ </p> <blockquote> <p> <a class="changeset" href="https://svn.boost.org/trac10/changeset/55914" title="Separate out the current version of the template argument parser, as I ...">r55914</a> | danieljames | 2009-08-31 12:38:11 +0100 (Mon, 31 Aug 2009) | 1 line </p> </blockquote> <p> </p> <blockquote> <p> Separate out the current version of the template argument parser, as I want to create a new one for 1.5 </p> </blockquote> <p> ........ </p> <blockquote> <p> <a class="changeset" href="https://svn.boost.org/trac10/changeset/55915" title="Don't use seperators that are in brackets, or are escaped. Refs #2036.">r55915</a> | danieljames | 2009-08-31 12:38:20 +0100 (Mon, 31 Aug 2009) | 1 line </p> </blockquote> <p> </p> <blockquote> <p> Don't use seperators that are in brackets, or are escaped. Refs <a class="closed ticket" href="https://svn.boost.org/trac10/ticket/2036" title="#2036: Bugs: Crash with some invalid nested templates specification (closed: fixed)">#2036</a>. </p> </blockquote> <p> ........ </p> <blockquote> <p> <a class="changeset" href="https://svn.boost.org/trac10/changeset/55916" title="Add missing table tests.">r55916</a> | danieljames | 2009-08-31 12:38:33 +0100 (Mon, 31 Aug 2009) | 1 line </p> </blockquote> <p> </p> <blockquote> <p> Add missing table tests. </p> </blockquote> <p> ........ </p> <blockquote> <p> <a class="changeset" href="https://svn.boost.org/trac10/changeset/55917" title="Support image attributes. Refs #1157.">r55917</a> | danieljames | 2009-08-31 12:38:47 +0100 (Mon, 31 Aug 2009) | 1 line </p> </blockquote> <p> </p> <blockquote> <p> Support image attributes. Refs <a class="closed ticket" href="https://svn.boost.org/trac10/ticket/1157" title="#1157: Feature Requests: On Images (closed: fixed)">#1157</a>. </p> </blockquote> <p> ........ </p> <blockquote> <p> <a class="changeset" href="https://svn.boost.org/trac10/changeset/56077" title="fix for msvc">r56077</a> | djowel | 2009-09-07 02:35:24 +0100 (Mon, 07 Sep 2009) | 1 line </p> </blockquote> <p> </p> <blockquote> <p> fix for msvc </p> </blockquote> <p> ........ </p> <blockquote> <p> <a class="changeset" href="https://svn.boost.org/trac10/changeset/56715" title="Use qualified ids in tables, and fix a bug generating ids when there ...">r56715</a> | danieljames | 2009-10-11 17:18:04 +0100 (Sun, 11 Oct 2009) | 1 line </p> </blockquote> <p> </p> <blockquote> <p> Use qualified ids in tables, and fix a bug generating ids when there isn't a section. </p> </blockquote> <p> ........ </p> <blockquote> <p> <a class="changeset" href="https://svn.boost.org/trac10/changeset/56717" title="Document the simplified quickbook 1.5 argument separators.">r56717</a> | danieljames | 2009-10-11 19:21:11 +0100 (Sun, 11 Oct 2009) | 1 line </p> </blockquote> <p> </p> <blockquote> <p> Document the simplified quickbook 1.5 argument separators. </p> </blockquote> <p> ........ </p> <blockquote> <p> <a class="changeset" href="https://svn.boost.org/trac10/changeset/56718" title="Use quickbook 1.5 in the document block example.">r56718</a> | danieljames | 2009-10-11 19:21:32 +0100 (Sun, 11 Oct 2009) | 1 line </p> </blockquote> <p> </p> <blockquote> <p> Use quickbook 1.5 in the document block example. </p> </blockquote> <p> ........ </p> <blockquote> <p> <a class="changeset" href="https://svn.boost.org/trac10/changeset/56719" title="Add table ids to the documentation.">r56719</a> | danieljames | 2009-10-11 19:21:48 +0100 (Sun, 11 Oct 2009) | 1 line </p> </blockquote> <p> </p> <blockquote> <p> Add table ids to the documentation. </p> </blockquote> <p> ........ </p> </description> <category>Ticket</category> </item> <item> <dc:creator>Daniel James</dc:creator> <pubDate>Tue, 13 Oct 2009 21:42:57 GMT</pubDate> <title>status changed; resolution set https://svn.boost.org/trac10/ticket/2712#comment:9 https://svn.boost.org/trac10/ticket/2712#comment:9 <ul> <li><strong>status</strong> <span class="trac-field-old">assigned</span> → <span class="trac-field-new">closed</span> </li> <li><strong>resolution</strong> → <span class="trac-field-new">fixed</span> </li> </ul> Ticket