You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@subversion.apache.org by Maxime Petazzoni <ma...@bulix.org> on 2004/06/04 16:05:47 UTC

[BOOK PATCH] Subversion book in DevHelp

Hi,

I recently discovered a little Gtk-2 tool called DevHelp[1]. It is a 
documentation browser, initially designed for the Gnome developpers.
But it's simplicity and flexibility made it become a general 
documentation browser.

Several books are available[2] for DevHelp, such as MySQL, Gtk+, SDL, 
Emacs, Atk, Pango etc.

The Subversion book is free, and docbook sources are available. That's 
why I decided to create a XLS Template that builds a DevHelp index file 
(a simple XML file) in order to make this book browsable in DevHelp.

You'll find in attachment a little patch that tweaks the Makefile in 
order to provide two new rules : book-devhelp and book-devhelp-clean, 
and the contents of the XLST (devhelp.xsl).

If you want to take a look at the result, follow these instructions :

% cd ~
% svn co http://svn.collab.net/repos/svn/trunk/doc/book/ svnbook
% cd svnbook/
% patch -p1 ../svnbook-to-devhelp.patch
% make book-devhelp
[... building the svnbook.devhelp file ...]
[... building an html-chunk version ...]
% mkdir -p ~/.devhelp/books/
% cd $_
% ln -s ~/svnbook/book/devhelp/ svnbook
% devhelp

That's it. I hope you'll like this little add-on !

Regards,
- Sam

[1] http://www.imendio.com/projects/devhelp/
[2] http://htmlhelp.berlios.de/books/devhelp.php
-- 
Maxime Petazzoni - sam@bulix.org - http://www.bulix.org
Gobelins' core team leader       - http://gobelins.nekeme.net
GPG fingerprint: D694 DAB9 8F4E 68A8 4C17  F011 ECAB 0E7B 83E6 AE0D
Jabber: sam@jabber.dk ICQ: 100551837 AIM: maximepetazzoni