[gentoo-qa] Converting DevManual to Docbook 5 [WAS: Re: Official request for having Gtk+ and similar in tree p.masked before ~arch]

[gentoo-qa] Converting DevManual to Docbook 5 [WAS: Re: Official request for having Gtk+ and similar in tree p.masked before ~arch]

[Diego Elio “Flameeyes” Pettenò]

[-- Attachment #1: Type: text/plain, Size: 1277 bytes --]

Il giorno dom, 22/08/2010 alle 00.01 +0300, Markos Chandras ha scritto:
> 
> As I already told you, I am willing to work with you on that, but I
> will need you to
> explain me briefly the technical details ( not the docbook syntax as I
> know it
> ) on how to convert guidexml -> docbook. If you have a repo for that
> please
> add me as collaborator so I can work on that and finally deal with
> it ;-) 

The repository is already on our hardware:
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).

As for the conversion, I'm attaching the xsl I've been using; it only
gives a rough draft to starts with, then it's manual labour.

It does not lose any feature during the move as Docbook 5 is much more
expressive; and Mauro prepared a working syntax highlighter for the
ebuild syntax.

-- 
Diego Elio Pettenò — “Flameeyes”
http://blog.flameeyes.eu/

If you found a .asc file in this mail and know not what it is,
it's a GnuPG digital signature: http://www.gnupg.org/


[-- Attachment #2: abomination2docbook.xsl --]
[-- Type: application/xslt+xml, Size: 4621 bytes --]

Re: [gentoo-qa] Converting DevManual to Docbook 5 [WAS: Re: Official request for having Gtk+ and similar in tree p.masked before ~arch]

[Markos Chandras]

[-- Attachment #1: Type: text/plain, Size: 1731 bytes --]

On Sat, Aug 21, 2010 at 11:43:25PM +0200, Diego Elio “Flameeyes” Pettenò wrote:
> Il giorno dom, 22/08/2010 alle 00.01 +0300, Markos Chandras ha scritto:
> > 
> > As I already told you, I am willing to work with you on that, but I
> > will need you to
> > explain me briefly the technical details ( not the docbook syntax as I
> > know it
> > ) on how to convert guidexml -> docbook. If you have a repo for that
> > please
> > add me as collaborator so I can work on that and finally deal with
> > it ;-) 
> 
> The repository is already on our hardware:
> 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).
> 
> As for the conversion, I'm attaching the xsl I've been using; it only
> gives a rough draft to starts with, then it's manual labour.
> 
> It does not lose any feature during the move as Docbook 5 is much more
> expressive; and Mauro prepared a working syntax highlighter for the
> ebuild syntax.
> 
> -- 
> Diego Elio Pettenò — “Flameeyes”
> http://blog.flameeyes.eu/
> 
> If you found a .asc file in this mail and know not what it is,
> it's a GnuPG digital signature: http://www.gnupg.org/
> 

Ah thanks :) So from what I understand is that you need to run something like
xsltproc <your xsl file> <every .xml file on devmanual>

-- 
Markos Chandras (hwoarang)
Gentoo Linux Developer
Web: http://hwoarang.silverarrow.org
Key ID: 441AC410
Key FP: AAD0 8591 E3CD 445D 6411 3477 F7F7 1E8E 441A C410

[-- Attachment #2: Type: application/pgp-signature, Size: 198 bytes --]

Re: [gentoo-qa] Converting DevManual to Docbook 5 [WAS: Re: Official request for having Gtk+ and similar in tree p.masked before ~arch]

[Diego Elio “Flameeyes” Pettenò]

Il giorno dom, 22/08/2010 alle 03.15 +0300, Markos Chandras ha scritto:
> Ah thanks :) So from what I understand is that you need to run
> something like
> xsltproc <your xsl file> <every .xml file on devmanual>
> 
Yeah... note that I think a good part of it was already converted on the
branch there, but some might need to be updated so that the changes that
went on master after I branched are present.

I tried to keep the reworking and rewording to a minimal during
conversion, but some pages have been changed quite a bit, so it might
require a bit of attention.

OTOH Mark opened the bug[1] to ask moving the repository to gogo; we can
then ask Mauro to help us again in case.
> 
[1] https://bugs.gentoo.org/show_bug.cgi?id=333891

-- 
Diego Elio Pettenò — “Flameeyes”
http://blog.flameeyes.eu/

If you found a .asc file in this mail and know not what it is,
it's a GnuPG digital signature: http://www.gnupg.org/