Re: [docbook] How to build html from multiple files?

["Bob Stayton" <bobs@sagehill.net>]



Hi,

There are at least two ways to assemble multiple docbook files into a single book: system entities and XInclude.  That crash-course book uses system entitites.  If you look into the file named "crash-course.docbook", you will see that it declares system entities for the other files and then references them.  If you process crash-course.docbook, those entity references will be resolved by the XML parser and you will get the whole book.

 

The alternative to system entities is XInclude.  That is described in this chapter of my book, available free for reading online at:

 

http://www.sagehill.net/docbookxsl/ModularDoc.html

 

My book has a lot of other information on how to generate output using Docbook XSL.

 

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net

 

 

----- Original Message -----

From: Lyre

To: docbook@lists.oasis-open.org

Sent: Tuesday, December 21, 2010 6:49 PM

Subject: [docbook] How to build html from multiple files?

Hi all:

    I'm learning to use the docbook. I've read some tutorials, most of them just tell me how to write the docbook xml files, but did not mention how to generate the final documents (html, pdf...etc).

    for example, the Crash-course to DocBook povide its source, but i don't know how the build the html, the source structure look like this:

lyre@linux-4179e1:~/Desktop/

crash-course> tree
.
|-- en
|   |-- basic-notions.docbook
|   |-- bookinfo.docbook
|   |-- crash-course.docbook
|   |-- declaration.docbook
|   |-- duck.dsl
|   |-- emacs.docbook
|   |-- fdl-licence
|   |-- getting-started.docbook
|   |-- glossary.docbook
|   |-- graphics.docbook
|   |-- interface.docbook
|   |-- introduction.docbook
|   |-- licence.docbook
|   |-- links.docbook
|   |-- lists.docbook
|   |-- meta-information.docbook
|   |-- miscellaneous.docbook
|   |-- next.docbook
|   `-- tables.docbook
`-- images
    |-- duck.eps
    |-- duck.jpg
    |-- rectangles.eps
    `-- rectangles.png

I've tried the 'docbook2htm' & 'xsltproc' it mentioned, but they seems to work on only one file.

Thanks!