[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>