[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
DocBook stylesheet errors
Norman Walsh <ndw@nwalsh.com>:
> / "Eric S. Raymond" <esr@snark.thyrsus.com> was heard to say:
> | We're missing a <newsgroup> element, which would be desirable for the
> | same reason as <email>. Consider
>
> Yep. Looks like an oversight. I'll see that an RFE gets created for
> it (to see outstanding issues, http://docbook.org/rfe/)
>
> | 2. Stylesheet problems in HTML output.
> |
> | Using the docbook-style-dsssl-1.54-4 package, I note that in HTML output
> |
> | A: Contents and title are badly ordered. That is, the table of
> | contents is set before the document title and front matter.
> |
> | B: No break between front matter and first body section.
> |
> | C: Contents of the author tag is rendered as a single run-on-line with
> | no line breaks or spacing.
>
> Can you send me a small document that demonstrates this problem,
> please? I've never heard of this but unfortunately I don't run any of
> the packaged distributions so sometimes it's my fault and sometimes it
> isn't.
--
<a href="http://www.tuxedo.org/~esr/">Eric S. Raymond</a>
It would be thought a hard government that should tax its people one tenth
part.
-- Benjamin Franklin
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
<!--
Here's the environment:
docbook-dtd31-sgml-1.0-4.noarch.rpm jade-1.2.1-6.i386.rpm
docbook-dtd40-sgml-1.0-4.noarch.rpm jadetex-2.7-5.noarch.rpm
docbook-dtd41-sgml-1.0-4.noarch.rpm perl-SGMLSpm-1.03ii-3.noarch.rpm
docbook-style-dsssl-1.54-4.noarch.rpm psgml-1.2.1-2.i386.rpm
docbook-utils-0.5.2-1.noarch.rpm sgml-common-0.2-2.noarch.rpm
Format this with docbook2html sample.sgml and observe the following
in the resulting HTML:
Table of Contents
1. Introduction
The Linux XFree86 HOWTO
Eric Steven Raymond$Date: 2000/08/21 18:32:21 $Copyright © 2000 by
Eric S. Raymond
Copyright
Permission is granted to copy, distribute and/or modify this document
under the terms of the Open Publication License, version 2.0.
Revision History
Revision 7.0 21 August 2000 Revised by: esr
First DocBook version.
This document describes how to obtain, install, and configure version
4.0 of the XFree86 version of the X Window System (X11R6) for Linux
systems. It is a step-by-step guide to configuring XFree86 on your
system.
Note the placement of the TOC and the run-on line just after the title.
-->
<article>
<articleinfo>
<title>The Linux XFree86 HOWTO</title>
<author>
<firstname>Eric</firstname>
<othername>Steven</othername>
<surname>Raymond</surname>
<affiliation>
<orgname><ulink url="http://www.tuxedo.org/~esr/">
Thyrsus Enterprises</ulink></orgname>
<address>
<email>esr@thyrsus.com</email>
</address>
</affiliation>
</author>
<pubdate role="cvs">$Date: 2000/08/21 18:32:21 $</pubdate>
<releaseinfo>This is version 7.0</releaseinfo>
<copyright>
<year>2000</year>
<holder role="mailto:esr@thyrsus.com">Eric S. Raymond</holder>
</copyright>
<legalnotice>
<title>Copyright</title>
<para>Permission is granted to copy, distribute and/or modify
this document under the terms of the Open Publication License,
version 2.0.</para>
</legalnotice>
<revhistory>
<revision>
<revnumber>7.0</revnumber>
<date>21 August 2000</date>
<authorinitials>esr</authorinitials>
<revremark>
First DocBook version.
</revremark>
</revision>
</revhistory>
<abstract>
<para>This document describes how to obtain, install, and configure
version 4.0 of the XFree86 version of the X Window System (X11R6)
for Linux systems. It is a step-by-step guide to configuring
XFree86 on your system.</para>
</abstract>
</articleinfo>
<sect1><title>Introduction</title>
<para>[Text omitted for demonstration purposes]</para>
</sect1>
</article>