[PATCH 1/2: xorg-sgml-doctools] Provide common CSS & XSL stylesheets for DocBook docs

[Dan Nicholson]

On Fri, Jun 18, 2010 at 9:56 AM, Alan Coopersmith
<alan.coopersmith at oracle.com> wrote:
> Dan Nicholson wrote:
>> It's a stretch to put the css files in this directory. The ent and xsl
>> files make sense since xsltproc will search for them here and include
>> them. Not so for the css file.
>> I'm not sure what a better alternative would be, though. Just for a datapoint:
>>
>> $ find /usr/share/sgml -name '*.css' | wc -l
>> 0
>>
>> Maybe pkgdatadir would be more appropriate, but I guess I'm OK
>> overloading this path.
>
> Yeah, I saw there were other .xsl files in that subdir on my machine, such as
> the upstream docbook stylesheets, but didn't know where to put the .css.  Since
> it's referenced in the .xsl putting in the same directory made the most sense to
> me.

Good point.

>>> +  <xsl:param name="saxon.character.representation" select="'entity;decimal'"/>
>>
>> This setting isn't really useful for xorg since we use xsltproc and
>> not saxon. However, this appears to be the default value anyway:
>>
>> http://docbook.sourceforge.net/release/xsl/current/doc/html/saxon.character.representation.html
>
> I don't remember why I put that in originally - it's been cargo-culted around as
> this style sheet has been copied from module to module.
>
> Once this is in git, I'll go back and apply changes similar to the libXmu patch
> to replace the prior copies in app/xfs & lib/libXfont.

OK. Here's a couple other parameters I had when I was foolish enough
to attempt converting the XKB docs to docbook. I'm not sure they're
useful for all the docs, but I'm pretty sure section.autolabel makes
the <article> docs look more like the SGML ones.

  <xsl:param name="section.autolabel" select="1"/>
  <xsl:param name="section.label.includes.component.label" select="1"/>
  <xsl:param name="autotoc.label.separator">
    <xsl:text> </xsl:text>
  </xsl:param>

--
Dan