[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

Re: [PATCH] Re: Suggestion for book TOC: one level deeper

From: Brian Denny <brian_at_briandenny.net>
Date: 2003-11-12 04:34:28 CET

On Wed, Nov 12, 2003 at 01:39:50AM +0000, Julian Foad wrote:
> Brian Denny wrote:
> >[Reposting with PATCH in the subject line. I'd commit this but would
> >prefer a +1 from a book author first.]
>
> I want a table of contents that lists each svn command individually.

Yeah, me too.

 
> Your patch puts tables of contents in subsections as well as at the
> beginning of each chapter, and this seems to force the generation of a
> table of svn commands as a side effect, but I do not much like having so
> many tables of contents.

Right.

> could be displayed in a more visible style, which might be achieved by
> making it a <sect3> or whatever. I would prefer that, if there is some way
> that that can be done while remaining compatible with O'Reilly's rules.
> Maybe O'Reilly is aware of the problem and has a work-around or updated
> rules.

My assumption is that O'Reilly has their own XSL stylesheets and/or
tools to convert the XML into whatever form they use for their books.
It follows that we can make any customizations we want at the XSL layer
just so long as we don't go fiddling with the XML. (That's not to say
that we couldn't potentially wrap the <refentry>s in <sect3>s, I don't
know about that).

My patch merely sets an XSL customization property that is already
defined by the existing docbook-xsl stylesheets. However, it is
possible to define an XSL customization layer that overrides entire
XSL templates. I am 99% sure that it is possible to get what we want
this way, without touching the XML. It's just a question of how (and
how much work). If I knew more XSL I probably would have done it
already. Maybe I'll look into it some more.

-brian

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Wed Nov 12 04:25:38 2003

This is an archived mail posted to the Subversion Dev mailing list.