Re: cross-referencing multiple documents with quickbook
Stefan Seefeld <[email protected]> Wed, 5 Aug 2015 04:07:19 -0400
| Newsgroups | gmane.comp.lib.boost.documentation |
|---|---|
| Message-ID | <[email protected]> |
On 04/08/15 06:04 PM, Daniel James wrote: > On 18 July 2015 at 16:11, John Maddock <[email protected]> wrote: >> On 18/07/2015 04:52, Stefan Seefeld wrote: >>> Hello, >>> >>> is it possible to cross-reference multiple stand-alone documents with >>> QuickBook ? >>> >>> I have tried to create a master document that includes the other >>> documents. >>> While that works fine, it doesn't display the individual documents' >>> authors. >>> >>> (For comparison, DocBook supports separate <info> (including author and >>> other metadata) for each chapter, section, etc.) >> I think you would need to make each "chapter" a separate quickbook doc, and >> then combine them in a single docbook xml book, rather like >> doc/src/boost.xml > You can do that in quickbook 1.6, so this is a 'part' (part of a book): Daniel, yes, I have been using modular quickbook documents successfully. What I haven't been able to do is have each (sub-)document have its own author, and have those displayed in the resulting (html, pdf) document. The component authors were simply ignored in my case. Do you have an example of that use-case, i.e. where each part / chapter / whatever has a different author, which get translated to boostbook such that each boostbook chapter also contains the respective author ? On a slightly unrelated point: I read in http://www.boost.org/doc/libs/1_58_0/doc/html/quickbook/syntax/structure.html#quickbook.syntax.structure.docinfo that possible document types are 'qandaset', 'reference', etc. This intrigued me as I was writing a FAQ, so a qandaset seemed appropriate (from a DocBook perspective). However, QuickBook doesn't seem to have any markup that maps to qandaset elements. (And neither reference elements for that matter). Can you give an example on how to use qandaset in QuickBook ? Thanks, Stefan -- ...ich hab' noch einen Koffer in Berlin...