brian m. carlson | 5 Mar 21:35 2010

DocBook 5 support in yelp/gnome-doc-utils

I'm interested in adding DocBook 5 support to yelp and gnome-doc-utils.
However, before I spend a large amount of time developing code, I'd like
to know if (at least theoretically) this would be accepted into the main
repository.

My rationale for wanting to do so is that I have a very large collection
of DocBook 5 files (>250) and think it would be useful to have a
more-or-less general-purpose viewer for them.

My general plan of attack would be to modify the current XSLT
stylesheets in gnome-doc-utils to handle DocBook files correctly whether
they are version 4 or version 5.  I anticipate that most of the DocBook
5 handling code would be isolated in a small number of stylesheets.
Also, this would also include code for handling basic XLink features,
which are used for linking in DocBook 5.  I don't expect to touch much
yelp code at all, although currently there are few assumptions in the
code that don't hold true for DocBook 5 that would need to be fixed.

If I've got the wrong list, please give me a kick in the right
direction.  Thanks.

--

-- 
brian m. carlson / brian with sandals: Houston, Texas, US
+1 713 440 7475 | http://crustytoothpaste.ath.cx/~bmc | My opinion only
OpenPGP: RSA v4 4096b 88AC E9B2 9196 305B A994 7552 F1BA 225C 0223 B187
_______________________________________________
gnome-doc-devel-list mailing list
gnome-doc-devel-list@...
(Continue reading)

Shaun McCance | 5 Mar 22:17 2010
Picon

Re: DocBook 5 support in yelp/gnome-doc-utils

On Fri, 2010-03-05 at 20:35 +0000, brian m. carlson wrote:
> I'm interested in adding DocBook 5 support to yelp and gnome-doc-utils.
> However, before I spend a large amount of time developing code, I'd like
> to know if (at least theoretically) this would be accepted into the main
> repository.

Absolutely.  I have no qualms whatsoever with adding support
for DocBook 5 into Yelp.  It's just not something I can spend
time on right now.

> My rationale for wanting to do so is that I have a very large collection
> of DocBook 5 files (>250) and think it would be useful to have a
> more-or-less general-purpose viewer for them.
> 
> My general plan of attack would be to modify the current XSLT
> stylesheets in gnome-doc-utils to handle DocBook files correctly whether
> they are version 4 or version 5.  I anticipate that most of the DocBook
> 5 handling code would be isolated in a small number of stylesheets.
> Also, this would also include code for handling basic XLink features,
> which are used for linking in DocBook 5.  I don't expect to touch much
> yelp code at all, although currently there are few assumptions in the
> code that don't hold true for DocBook 5 that would need to be fixed.

Some notes:

Gnome 2.30 will be the last release for gnome-doc-utils.  New
development on the stylesheets is in yelp-xsl.  For information
about how Yelp stuff is being split up for 3.0, see here:

http://mail.gnome.org/archives/desktop-devel-list/2010-February/msg00047.html
(Continue reading)


Gmane