Gentoo Archives: gentoo-qa

From: Markos Chandras <hwoarang@g.o>
To: gentoo-qa@l.g.o
Subject: Re: [gentoo-qa] Converting DevManual to Docbook 5 [WAS: Re: Official request for having Gtk+ and similar in tree p.masked before ~arch]
Date: Sun, 22 Aug 2010 01:04:47
Message-Id: 20100822001555.GA315@Mystical
In Reply to: [gentoo-qa] Converting DevManual to Docbook 5 [WAS: Re: Official request for having Gtk+ and similar in tree p.masked before ~arch] by "Diego Elio “Flameeyes” Pettenò"
1 On Sat, Aug 21, 2010 at 11:43:25PM +0200, Diego Elio “Flameeyes” Pettenò wrote:
2 > Il giorno dom, 22/08/2010 alle 00.01 +0300, Markos Chandras ha scritto:
3 > >
4 > > As I already told you, I am willing to work with you on that, but I
5 > > will need you to
6 > > explain me briefly the technical details ( not the docbook syntax as I
7 > > know it
8 > > ) on how to convert guidexml -> docbook. If you have a repo for that
9 > > please
10 > > add me as collaborator so I can work on that and finally deal with
11 > > it ;-)
12 >
13 > The repository is already on our hardware:
14 > http://sources.gentoo.org/gitweb/?p=devmanual.git;a=shortlog;h=refs/heads/docbook (although I'd like to have this on gogo so that we can get the help of other people beside developers; a lot of the layout work here has been done by Mauro who's not a developer — although I was meaning to recruit him quite a while ago).
15 >
16 > As for the conversion, I'm attaching the xsl I've been using; it only
17 > gives a rough draft to starts with, then it's manual labour.
18 >
19 > It does not lose any feature during the move as Docbook 5 is much more
20 > expressive; and Mauro prepared a working syntax highlighter for the
21 > ebuild syntax.
22 >
23 > --
24 > Diego Elio Pettenò — “Flameeyes”
25 > http://blog.flameeyes.eu/
26 >
27 > If you found a .asc file in this mail and know not what it is,
28 > it's a GnuPG digital signature: http://www.gnupg.org/
29 >
30
31 Ah thanks :) So from what I understand is that you need to run something like
32 xsltproc <your xsl file> <every .xml file on devmanual>
33
34 --
35 Markos Chandras (hwoarang)
36 Gentoo Linux Developer
37 Web: http://hwoarang.silverarrow.org
38 Key ID: 441AC410
39 Key FP: AAD0 8591 E3CD 445D 6411 3477 F7F7 1E8E 441A C410

Replies