This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
Re: programlisting and email
- From: Bob Stayton <bobs at caldera dot com>
- To: Volker Dierks <v dot dierks at sonic dot homeunix dot net>,docbook ml <docbook at lists dot oasis-open dot org>
- Date: Sun, 24 Nov 2002 11:26:14 -0800
- Subject: Re: DOCBOOK: programlisting and email
- References: <3DE0B6B5.308@sonic.homeunix.net>
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