Daryle Walker wrote:
On 3/21/06 6:49 PM, "Joel de Guzman" <[EMAIL PROTECTED]> wrote:
I think there's been a big misunderstanding here. I never looked at any of
the pages besides the first one Joel explicitly mentioned in the original
message. I didn't realize that Joel applied the technique at a sub-section
level too. (The sub-sections link to themselves, like '<a name="hi"
href="#hi">') I feel that I'm right at the whole-page level, but I don't
have a fully-formed opinion at the section level yet. I see why it could be
helpful, but couldn't you use an explicit mnemonic instead (maybe a linked
"bookmark this" button next to the title)?
Big misunderstanding indeed. In fact, I realized now that even the
top section is correct as far as DocBook/BoostBook is concerned.
With DocBook, sections really have no relation to pages. There
is actually no notion of pages. For example, this:
http://tinyurl.com/z3p7f is the same as the one I originally
posted: http://snipurl.com/no8s albeit in one whole HTML file
instead of separate pages. Notice how the Introduction section,
in this case, becomes now a sub-section in the whole HTML page.
XSLT params control the chunking of HTML files. This, I guess, is
where the similarity with ReST (MPL manuals) ends. QuickBook
has to treat sections and section headings uniformly; hence
self-link.
(BTW, I stopped posting to boost.devel for this thread)
Regards,
--
Joel de Guzman
http://www.boost-consulting.com
http://spirit.sf.net
-------------------------------------------------------
This SF.Net email is sponsored by xPML, a groundbreaking scripting language
that extends applications into web and mobile media. Attend the live webcast
and join the prime developer group breaking into this new coding territory!
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=110944&bid=241720&dat=121642
_______________________________________________
Boost-docs mailing list
[email protected]
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs
