From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from pigeon.gentoo.org ([208.92.234.80] helo=lists.gentoo.org)
	by finch.gentoo.org with esmtp (Exim 4.60)
	(envelope-from <gentoo-qa+bounces-99-garchives=archives.gentoo.org@lists.gentoo.org>)
	id 1OmwF3-0006bG-7N
	for garchives@archives.gentoo.org; Sat, 21 Aug 2010 22:09:00 +0000
Received: from pigeon.gentoo.org (localhost [127.0.0.1])
	by pigeon.gentoo.org (Postfix) with SMTP id 4AC88E0AF9
	for <garchives@archives.gentoo.org>; Sat, 21 Aug 2010 22:08:43 +0000 (UTC)
Received: from mail-wy0-f181.google.com (mail-wy0-f181.google.com [74.125.82.181])
	by pigeon.gentoo.org (Postfix) with ESMTP id 0B059E0882
	for <gentoo-qa@lists.gentoo.org>; Sat, 21 Aug 2010 21:43:13 +0000 (UTC)
Received: by wyf28 with SMTP id 28so6109943wyf.40
        for <gentoo-qa@lists.gentoo.org>; Sat, 21 Aug 2010 14:43:13 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=gmail.com; s=gamma;
        h=domainkey-signature:received:received:subject:from:to:in-reply-to
         :references:content-type:date:message-id:mime-version:x-mailer;
        bh=LV3LlA9Z/fAU1gPwZCEAffZiTtmyezg9Kw/xmWtVmHs=;
        b=HKWA/8FKIvrKpQl4SbTftJHIN/h3Z+f3qsCdgHzEGeQMCk4oNzPM7urbJoGdaw/3Rs
         W9Dy5ZTkvQH3C1zfbs5CUnZmmVLN/h2z7bHziSO5icIFhOoozACrfWSyhVJ0vZdz6rm5
         EdttACsOlxRXfWYy3QH4rrUvgSIoD11T99zFc=
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=subject:from:to:in-reply-to:references:content-type:date:message-id
         :mime-version:x-mailer;
        b=Oavlc47ewUYrUrs98q4Ar4Rajhx/r8kTZ0ndRatyePdUDHh3AmRSbK3yw+U9JleoIC
         xG1lvw4EOnDR0m7fHhy+5tzt/jtozZmVEX6ZcR2DzN0ojLDWhxXlNRVN2cOeboqPhYU8
         64PbfHPozbNxtkZEwqEqv+8QN2JtcJbetrSXA=
Received: by 10.227.147.141 with SMTP id l13mr2587695wbv.229.1282426993391;
        Sat, 21 Aug 2010 14:43:13 -0700 (PDT)
Received: from [172.28.8.1] (host249-252-static.95-94-b.business.telecomitalia.it [94.95.252.249])
        by mx.google.com with ESMTPS id b23sm3493342wbb.10.2010.08.21.14.43.12
        (version=SSLv3 cipher=RC4-MD5);
        Sat, 21 Aug 2010 14:43:12 -0700 (PDT)
Subject: [gentoo-qa] Converting DevManual to Docbook 5 [WAS: Re: Official request for
 having Gtk+ and similar in tree p.masked before ~arch]
From: Diego Elio =?UTF-8?Q?=E2=80=9CFlameeyes=E2=80=9D_?= =?ISO-8859-1?Q?Petten=F2?= <flameeyes@gmail.com>
To: gentoo-qa@lists.gentoo.org
In-Reply-To: <20100821210115.GA29545@Mystical>
References: <1282350682.6067.19.camel@yamato.local>
	 <201008210033.57789.vapier@gentoo.org>
	 <1282404061.6067.23.camel@yamato.local>
	 <20100821165440.GA23066@halcy0n.com> <1282410564.445.10.camel@yamato.local>
	 <20100821210115.GA29545@Mystical>
Content-Type: multipart/mixed; boundary="=-+wF5CCZ5+GX6E1dp/hFp"
Date: Sat, 21 Aug 2010 23:43:25 +0200
Message-ID: <1282427005.445.61.camel@yamato.local>
Precedence: bulk
List-Post: <mailto:gentoo-qa@lists.gentoo.org>
List-Help: <mailto:gentoo-qa+help@lists.gentoo.org>
List-Unsubscribe: <mailto:gentoo-qa+unsubscribe@lists.gentoo.org>
List-Subscribe: <mailto:gentoo-qa+subscribe@lists.gentoo.org>
List-Id: Gentoo Linux mail <gentoo-qa.gentoo.org>
X-BeenThere: gentoo-qa@lists.gentoo.org
Reply-to: gentoo-qa@lists.gentoo.org
Mime-Version: 1.0
X-Mailer: Evolution 2.30.2 
X-Archives-Salt: 0bfc310f-76aa-4619-b0a3-fc17fcf160cf
X-Archives-Hash: 8cd052ca6591b348f24258666e5b7382


--=-+wF5CCZ5+GX6E1dp/hFp
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

Il giorno dom, 22/08/2010 alle 00.01 +0300, Markos Chandras ha scritto:
>=20
> 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 ;-)=20

The repository is already on our hardware:
http://sources.gentoo.org/gitweb/?p=3Ddevmanual.git;a=3Dshortlog;h=3Drefs=
/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 her=
e has been done by Mauro who's not a developer =E2=80=94 although I was m=
eaning 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.

--=20
Diego Elio Petten=C3=B2 =E2=80=94 =E2=80=9CFlameeyes=E2=80=9D
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/


--=-+wF5CCZ5+GX6E1dp/hFp
Content-Type: application/xslt+xml; name="abomination2docbook.xsl"
Content-Disposition: attachment; filename="abomination2docbook.xsl"
Content-Transfer-Encoding: quoted-printable

<?xml version=3D"1.0" encoding=3D"utf-8"?>
<xsl:stylesheet version=3D'1.0' xmlns:xsl=3D'http://www.w3.org/1999/XSL/T=
ransform'
  xmlns:str=3D"http://exslt.org/strings"
  xmlns:exslt=3D"http://exslt.org/common"
  xmlns:regexp=3D"http://exslt.org/regular-expressions"
  extension-element-prefixes=3D"str exslt xsl regexp"
  exclude-result-prefixes=3D"str exslt xsl regexp"
  xmlns=3D"http://docbook.org/ns/docbook"
  xmlns:xl=3D"http://www.w3.org/1999/xlink"
  xmlns:xi=3D"http://www.w3.org/2001/XInclude">

  <xsl:output encoding=3D"utf-8" />

  <xsl:template match=3D"@*|node()">
    <xsl:copy>
      <xsl:apply-templates select=3D"@*|node()"/>
    </xsl:copy>
  </xsl:template>

  <xsl:template match=3D"guide|body">
    <xsl:apply-templates />
  </xsl:template>

  <xsl:template match=3D"subsection">
    <section>
      <xsl:apply-templates />
    </section>
  </xsl:template>

  <xsl:template match=3D"chapter">
    <xsl:variable name=3D"newid">
      <xsl:value-of select=3D"str:replace(../@self, '/', '.')" />
    </xsl:variable>

    <section>
      <xsl:attribute name=3D"xml:id">
	<xsl:value-of select=3D"substring($newid, '0', string-length($newid))" /=
>
      </xsl:attribute>
      <xsl:apply-templates />

      <xsl:for-each select=3D"//include">
	<xi:include parse=3D"xml">
	  <xsl:attribute name=3D"href">
	    <xsl:value-of select=3D"//@self" />
	    <xsl:value-of select=3D"substring(@href, 1, string-length(@href) - 1=
)" />
	    <xsl:text>.xmli</xsl:text>
	  </xsl:attribute>
	</xi:include>
      </xsl:for-each>
    </section>
  </xsl:template>

  <xsl:template match=3D"d">
    <xsl:text>=E2=80=94</xsl:text>
  </xsl:template>

  <xsl:template match=3D"p" priority=3D"10">
    <para>
      <xsl:apply-templates />
    </para>
  </xsl:template>

  <xsl:template match=3D"title|section|">
    <xsl:element name=3D"{local-name(.)}">
      <xsl:apply-templates />
    </xsl:element>
  </xsl:template>

  <xsl:template match=3D"warning|note|important">
    <xsl:element name=3D"{local-name(.)}">
      <para>
	<xsl:apply-templates />
      </para>
    </xsl:element>
  </xsl:template>

  <xsl:template match=3D"e|b">
    <emphasis>
      <xsl:apply-templates />
    </emphasis>
  </xsl:template>

  <xsl:template match=3D"c">
    <TOCHANGE>
      <xsl:apply-templates />
    </TOCHANGE>
  </xsl:template>

  <xsl:template match=3D"uri">
    <xsl:choose>
      <xsl:when test=3D"starts-with(@link, '::')">
	<xref>
	  <xsl:variable name=3D"newlinkend">
	    <xsl:choose>
	      <xsl:when test=3D"substring(@link, string-length(@link), 1) =3D '.=
'">
		<xsl:value-of select=3D"substring(@link, 3, string-length(@link) - 3)" =
/>
	      </xsl:when>
	      <xsl:otherwise>
		<xsl:value-of select=3D"substring(@link, 3, string-length(@link) - 2)" =
/>
	      </xsl:otherwise>
	    </xsl:choose>
	  </xsl:variable>
	  <xsl:attribute name=3D"linkend">
	    <xsl:value-of select=3D"translate($newlinkend, '/', '.')" />
	  </xsl:attribute>
	</xref>
      </xsl:when>
      <xsl:otherwise>
	<link xl:href=3D"{@link}"><xsl:apply-templates /></link>
      </xsl:otherwise>
    </xsl:choose>
  </xsl:template>

  <xsl:template match=3D"ul">
    <itemizedlist>
      <xsl:apply-templates />
    </itemizedlist>
  </xsl:template>

  <xsl:template match=3D"ol">
    <orderedlist>
      <xsl:apply-templates />
    </orderedlist>
  </xsl:template>

  <xsl:template match=3D"li">
    <listitem>
      <para>
	<xsl:apply-templates />
      </para>
    </listitem>
  </xsl:template>

  <xsl:template match=3D"todo">
    <xsl:comment>
      <xsl:text> TODO </xsl:text>
      <xsl:value-of select=3D"." />
    </xsl:comment>
  </xsl:template>

  <xsl:template match=3D"table">
    <table>
      <title> ... </title>

      <tgroup cols=3D"{count(./tr[1]/*)}">
	<thead>
	  <xsl:apply-templates select=3D"./tr[position() =3D 1]" />
	</thead>

	<tbody>
	  <xsl:apply-templates select=3D"./tr[position() &gt; 1]" />
	</tbody>
      </tgroup>
    </table>
  </xsl:template>

  <xsl:template match=3D"tr">
    <row><xsl:apply-templates /></row>
  </xsl:template>

  <xsl:template match=3D"ti|th">
    <entry><xsl:apply-templates /></entry>
  </xsl:template>

  <xsl:template match=3D"codesample">
    <programlisting>
      <xsl:attribute name=3D"language">
	<xsl:value-of select=3D"@lang" />
      </xsl:attribute>

      <xsl:value-of select=3D"." />
    </programlisting>
  </xsl:template>

  <xsl:template match=3D"pre">
    <programlisting>
      <xsl:value-of select=3D"." />
    </programlisting>
  </xsl:template>

  <xsl:template match=3D"include">
  </xsl:template>

</xsl:stylesheet>

--=-+wF5CCZ5+GX6E1dp/hFp--