Subject: Re: [Boost-docs] Quickbook documentation
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2008-12-08 17:42:43
> -----Original Message-----
> From: boost-docs-bounces_at_[hidden] [mailto:boost-docs-
> bounces_at_[hidden]] On Behalf Of John Maddock
> Sent: 08 December 2008 12:15
> To: Discussion of Boost Documentation
> Subject: Re: [Boost-docs] Quickbook documentation
> Vladimir Prus wrote:
> >> I'm reading Quickbook documentation, and see this under:
> >> "Heading 6":
> >> [link section_id.normalized_header_text The link text]
> >> and cannot understand it. What is "normalized_header_text", and why
> >> do I need that if I want just to refer to a section name?
> OK, to refer to a section you need it's ID in the Docbook markup - the
> easiest way to do that IMO is to generate the HTML docs and then navigate
> the section you want to link to and copy it's URL, so for example:
> would have the section ID:
> But otherwise...
> Quickbook generates nested section ID's:
> for nested sections, and each part of the name is either:
> * The name you gave the section if you used [section:myname My Title].
> * The section title with whitespace replaced with "_" if you used [section
> My Title].
Can I just add that this means that it is a really good idea to always give
section title IDs - or you may end up with section id that
As I reader and editor, I have also found it very useful to add a comment to
the end of the section when you create the section, by copying and pasting
and converting to a comment with a /
[section_1 section 1
] [/end section_1 section 1]
This avoids puzzling about the nesting afterwards (QuickBook doesn't give
too much help if you mismatch them).
And don't forget a Boost licence as a comment at the end of each and every
file - or a nag will come round later.
--- Paul A. Bristow Prizet Farmhouse Kendal, UK LA8 8AB +44 1539 561830, mobile +44 7714330204 pbristow_at_[hidden]
This archive was generated by hypermail 2.1.7 : 2017-11-11 08:50:40 UTC