| NewbieDoc Docbook Guide | ||
|---|---|---|
| Prev | B. sgmltools | |
If you installed sgmltools-lite you should already have a working system to render SGML documents into the format you choose.
In order to format your documents in the same manner as this one you should use the NewbieDoc custom stylesheets. The stylesheets are called newbiedoc-html.XX.dsl, newbiedoc-onehtml.dsl, and newbiedoc-tar-one.dsl. Where XX is a language code. You can download them from newbiedoc cvs or you can post to: <newbiedoc-discuss@lists.sourceforge.net>. Someone on the mailing list should be able to get you a copy. Once you get the custom stylesheets, save the stylesheets in the same directory as the SGML file you wish to parse. Here's the formal usage of sgmltools:
sgmltools {-b {html | onehtml | pdf | ps}} [-s | stylesheet] {SGML-file}
If you don't understand the above syntax don't worry about it. I'll be giving specific examples of how to use the stylesheets in the following sections. Please realize that these stylesheets are customized for output that is destined for the newbiedoc website. You may need to edit them to get the output you are looking for.
Here's how you use the custom stylesheet for HTML using sgmltools:
bash$ sgmltools -b html -s newbiedoc-html.XX.dsl name-of-SGML-file.sgml |
You should execute the command exactly as you see above, substituting the name of your SGML file for name-of-SGML-file.sgml. This will create a subdirectory called name-of-SGML-file with your SGML file rendered as multiple HTML documents inside it. The SGML document is split into seperate HTML files at each <sect1> tag.
This stylesheet, as the name implies, creates one single HTML file as its output. Here's how you use the custom stylesheet for one page HTML files using sgmltools:
bash$ sgmltools -b onehtml -s newbiedoc-onehtml.dsl name-of-SGML-file.sgml |
You should execute the command exactly as you see above, substituting the name of your SGML file for name-of-SGML-file.sgml. This will create a single HTML file called name-of-SGML-file.html.