Re: switching to Docbook 4.1 XML

[Alexander Kirillov <kirillov math sunysb edu>]

Here are some suggestions - there are certainly more to come

o I'd like to have <releaseinfo> (which will be used for things like
 This manual describes version 1.4.0 of MY-GNOME-APP. It was last
 updated on 4/20/2001. ) printed in italics after copyright/license
 info, right before TOC.

o It'd look nice if we had GNOME logo placed on top of every gnome
  document, next to the title. 

o some graphics for <note>, <warning>, etc - like what we had with
  dsssl stylesheets - would be nice, too (default
  docbook.xsl stylesheet doesn't provide any)

o <variablelist>: <term> should probably be set in boldface
 
o the default docbook.xsl stylesheet produces one html file - which, of
  course, is inappropriate for large docs (imagine gnumeric manual as
  one html file). How do we want to handle it in GNOME 2.0? Is there
  an option to produce a directory with many html files (for posting
  on the web)? 

Sasha


On Tue, Oct 23, 2001 at 03:22:49PM -0500, Eric Baudais wrote:
> On Tue, Oct 23, 2001 at 03:54:11PM -0400, Alexander Kirillov wrote:
> > Questions:
> > 
> > 1. It took about 4 seconds (on PIII 500 Mhz system) - I hoped to get
> >    something closer to 1 sec. 
> > 
> > 2. Are there any GDP-customized xsl stylesheets, like what we used to
> >    have for dsssl stylesheets? Anyone willing to step forward and
> >    do this? Dcm? 
> 
> I have started on a customization xsl stylesheet.  There isn't much done yet, 
> but it is coming along.  Some things that I have done are:
> 
>  * Added Written By: <author> to the titlepage
>  * Added a maintainer role to the author tag so it outputs 
>    Maintained By: <maintainer>
>  * Emphasis tag is bold instead of italicized.
>  * Sets the default graphic extension to PNG.
> 
> Does anyone else have anything they really don't like about the html formatting
> of the current docs?
> 
> Eric Baudais