[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Problems with the DSSSL style-sheets
I've just finished converting all of my active HOWTOs to DocBook.
While doing this, I have run across one problem with DocBook itself
and two problems with the stylesheets.
1. Missing <newsgroup> tag.
The problem with the DocBook markup itself is that I cannot find any
way to semantically tag a USENET newsgroup name. This comes up
especially frequently in connection with LDP HOWTOs, which often
cite newsgroups.
We're missing a <newsgroup> element, which would be desirable for the
same reason as <email>. Consider
<newsgroup>comp.os.linux.announce</newsgroup>
In HTML output, this wants to become
<a href="news:comp.os.linux.announce";>comp.os.linux.announce</a>
But in print we probably want the equivalent of
<emphasis>comp.os.linux.announce</emphasis>
without news URL.
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.
--
<a href="http://www.tuxedo.org/~esr/";>Eric S. Raymond</a>
A man with a gun is a citizen. A man without a gun is a subject.
--
To UNSUBSCRIBE, email to [email protected]
with a subject of "unsubscribe". Trouble? Contact [email protected]