Re: [docbook-apps] Getting started with docbook, <screen> tag problems.

[Bob Stayton <bobs at sco dot com>]

If you are just getting started with DocBook, you might
consider using XML rather than SGML.  There are more tools
and help for XML, and more future development.
And you can still use jade and DSSSL with XML
if you choose to.


Bob Stayton                                 400 Encinal Street
Publications Architect                      Santa Cruz, CA  95060
Technical Publications                      voice: (831) 427-7796
The SCO Group                               fax:   (831) 429-1887
                                            email: bobs@sco.com

On Sat, Oct 18, 2003 at 02:10:50PM +0100, davidc wrote:
> Hi,
> 
> I'm just getting started with docbook and I'm running across a few problems.
> I've been reading an excellent tutorial here:
> http://nis-www.lanl.gov/~rosalia/mydocs/docbook-intro/docbook-intro.html.
> My main problem is with the <screen> and <programlisting> tags, the document
> leads me to believe if I use them the HTML output should have some sort of
> grey background, which is what I'd ideally like.  When I make my html files
> from my sgml source I don't see this however.  I'm also using the <prompt>
> and <userinput> tags, the latter of which doesn't seem to bold the text.
> 
> If I look at the source for that actual document though it uses them and the
> output on the URL above shows this working fine (along with grey backgrounds
> on relevant bits).  If I try to recreate the html file for docbook-intro
> from the source provided I get a fixed width font but no background on the
> <programlisting> sections.
> 
> I've tried a few different ways now.  The first is simply using:
> 
> $ db2html myfile.sgml
> 
> Which runs jade fine and gives me the output I desire, less the background.
> 
> I also tried downloading the dsl stylesheets manually from sourceforge,
> expanding them to a directory and running:
> 
> $ openjade -t sgml -d /path/to/stylesheets/html/docbook.dsl myfile.sgml
> 
> Again, the output isn't what I'd expect with regards to the afforementioned
> style aspects.  I'm guessing this is some sort of stylesheet error, probably
> on my behalf!
> 
> For my second question, I'd like to know how I can force jade/openjade to
> use "nice" filenames when producing HTML output.  At present it calls the
> chapters "cXX.html", where XX appears to be a random number.  Each of my
> <chapter> tags has an id with a unique name in.
> 
> I've included one of the chapters and the top parts of my sgml file for all
> to see.  I've adapted the source from the docbook-intro file to create my
> own book.
> 
> Thank you,
> 
> David
> 
> 
> <!doctype book PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
> ]>
> <book>
>   <bookinfo>
>     <date>16/10/2003</date>
>     <title>Networking UML using bridging</title>
>     <subtitle>A quick howto</subtitle>
>     <authorgroup>
>       <author>
>         <firstname>-davidc</firstname>
>       </author>
>     </authorgroup>
>   </bookinfo>
>   <toc></toc>
> 
>   <chapter id="host-kernel">
>     <title>The host kernel</title>
>     <para>Blah blah blah.</para>
>     <screen><prompt>#</prompt> <userinput>make
> menuconfig</userinput></screen>
>   </chapter>
> 
> </book>
> 
> 
> To unsubscribe from this list, send a post to docbook-apps-unsubscribe@lists.oasis-open.org, or visit http://www.oasis-open.org/mlmanage/.
> 
> 

To unsubscribe from this list, send a post to docbook-apps-unsubscribe@lists.oasis-open.org, or visit http://www.oasis-open.org/mlmanage/.