Re: DOCBOOK: programlisting and email

[Bob Stayton <bobs@caldera.com>]

On Sun, Nov 24, 2002 at 12:23:33PM +0100, Volker Dierks wrote:
> Hello list,
> 
> I'm new to DocBook but managed to write my first little
> documentation with it. All examples about <programlisting>
> shows the HTML output in a gray box with the content of
> <programlisting> in it alligned left (see
> http://www.docbook.org/tdg/en/html/example.html). The HTML
> output of my documentation doesn't show the box and the
> content of <programlisting> is aligned in center position?
> Perhaps I've to give some attributes to <programlisting>?
> 
> My structure is:
> 
> <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.2//EN">
> 
> <book lang="de">
> 
> <chapter>
> <title> .. </title>
> <para>
> 
> <programlisting>
>    <![CDATA[
>      case "${archive_basename}" in
>        # sun 1.2
>        jdk-1_2*)
>          name="j2sdk1.2"
>          description="Java (TM) 2 SDK 1.2 (Sun)"
>        ;;
>     ]]>
> </programlisting>
> 
> </para>
> </chapter>
> 
> </book>

The shading of programlisting is done with the
'shade-verbatim' stylesheet parameter.  I assume you
are using the DSSSL stylesheets since your file is SGML?
You would set this parameter to '#t' to turn it on.

> An other problem: where do I have to put the <email>
> Element? The DocBook Documentation says that <email>
> can be a child of <author> ... that's my source:
> 
> <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.2//EN">
> 
> <book lang="de">
> 
> <bookinfo>
> <title> .. </title>
> <author>
>    <firstname> .. </firstname>
>    <surname> .. </surname>
>    <email> .. </email>   <-- where to put it?
>    <affiliation>
>      <shortaffil> .. </shortaffil>
>      <jobtitle> .. </jobtitle>
>      <orgname> .. </orgname>
>      <orgdiv> .. </orgdiv>
>    </affiliation>
> </author>
> <copyright>
>    <year> .. </year>
>    <holder> .. </holder>
> </copyright>
> <abstract>
>    <para> .. </para>
> </abstract>
> </bookinfo>
> 
> </book>
> 
> db2html (jade) gives the following error:
> end tag for element "AUTHOR" which is not open

Put email after affiliation.  The author content model
is a bit hard to follow:

((personname|(%person.ident.mix;)+),(personblurb|email|address)*)>

affiliation is in the %person.ident.mix; parameter entity,
and the comma says that the second group that includes email
must follow all the %person.ident.mix elements.

-- 

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