From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gentoo-dev+bounces-60847-garchives=archives.gentoo.org@lists.gentoo.org>
Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80])
	by finch.gentoo.org (Postfix) with ESMTP id B37D71381F3
	for <garchives@archives.gentoo.org>; Sun, 16 Jun 2013 00:29:31 +0000 (UTC)
Received: from pigeon.gentoo.org (localhost [127.0.0.1])
	by pigeon.gentoo.org (Postfix) with SMTP id CA6B4E09E7;
	Sun, 16 Jun 2013 00:28:55 +0000 (UTC)
Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183])
	(using TLSv1 with cipher AECDH-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by pigeon.gentoo.org (Postfix) with ESMTPS id E0CB8E09E2
	for <gentoo-dev@lists.gentoo.org>; Sun, 16 Jun 2013 00:28:54 +0000 (UTC)
Received: from grubbs.orbis-terrarum.net (localhost [127.0.0.1])
	(using TLSv1.2 with cipher ECDHE-RSA-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by smtp.gentoo.org (Postfix) with ESMTPS id D91B033E348
	for <gentoo-dev@lists.gentoo.org>; Sun, 16 Jun 2013 00:28:53 +0000 (UTC)
Received: (qmail 26094 invoked by uid 10000); 16 Jun 2013 00:28:53 -0000
Date: Sun, 16 Jun 2013 00:28:53 +0000
From: "Robin H. Johnson" <robbat2@gentoo.org>
To: gentoo-dev@lists.gentoo.org
Subject: [gentoo-dev] [1/3] Automatic *XML->Wiki wiki.gentoo.org
Message-ID: <20130616002853.GD29913@orbis-terrarum.net>
References: <CAHmME9qBS3G1oOMZtNt0cEa2QXWFEbWQDmNQgKjZK_-AD8C5PA@mail.gmail.com>
 <09a1a991-ec2a-42ff-ae30-fd4ad737d3ad@email.android.com>
 <5250810.ak2l4ZvGqZ@xzibit>
 <51B714E1.6050906@gentoo.org>
 <20130613163330.GA9073@gentoo.org>
Precedence: bulk
List-Post: <mailto:gentoo-dev@lists.gentoo.org>
List-Help: <mailto:gentoo-dev+help@lists.gentoo.org>
List-Unsubscribe: <mailto:gentoo-dev+unsubscribe@lists.gentoo.org>
List-Subscribe: <mailto:gentoo-dev+subscribe@lists.gentoo.org>
List-Id: Gentoo Linux mail <gentoo-dev.gentoo.org>
X-BeenThere: gentoo-dev@lists.gentoo.org
Reply-to: gentoo-dev@lists.gentoo.org
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20130613163330.GA9073@gentoo.org>
User-Agent: Mutt/1.5.21 (2010-09-15)
X-Archives-Salt: f5b9a47b-7fbd-4a6a-9d3b-8fd2c28922c2
X-Archives-Hash: c1eabb5b2959b59ffbe37f2b7303cbf7

>From the infra perspective, I would like to add that I support this
move, I just have a few concerns on the conversion, one of which is
dealt with here.

> I've committed my draft XSL to the gentoo/xml/htdocs/xsl location, named
> guidexml2wiki.xsl. It still requires some updates that I'll work on soon
> (such as handling internal links) as I'll be using it more and more for the
> guides on gentoo.org/doc/en to move to the wiki as well.
> ProjectXML generates towards GuideXML, so should be usable chained.
It would be nice to move the foundation/ content to the Wiki as well I
think.

> PS An ebuild for a single stylesheet seems like overkill to me, but i've
> been proven incorrect in the past...
I think it would help a lot of the devs that are put off by the concept
of XML/XSLT. Just give them a little wrapper script to generate wiki
output.

One of my large concerns was how to handle some of the tag conversion.
We have a lot of custom tags, plus some interesting behavior in some
tags. 

Sven's XSL makes a very good start, but somebody needs to put in some
TLC for the following tags in conversion, and/or can we have it emit
something useful so we know when we hit a tag that's missing in the
XSLT.

Here's my list of tags found in proj/ that aren't in the XSLT so far:
(the "/>" is just because I collapsed the tag of any attributes, there probably
needs to be an audit of how the XSL handles attributes).

  179 <body/>
  145 <i/>
   74 <mail/> (optional attribute link)
   27 <dev/>
   25 <br/>
   18 <license/>
   15 <extrachapter/> (optional attribute position)
    9 <resource/> (attribute resource)
    7 <project/>
    7 <name/>
    7 <longname/>
    7 <longdescription/>
    7 <description/>
    6 <subproject/> (attribute ref)
    4 <goals/>
    2 <summary/>
    2 <requirements/>
    2 <recruitment/>
    2 <keyword/>
    2 <job/>
    2 <details/>
    2 <contact/>
    1 <var/>
    1 <subtitle/>
    1 <stmt/>
    1 <ident/>
    1 <extraproject/> (attribute name)
    1 <const/>

-- 
Robin Hugh Johnson
Gentoo Linux: Developer, Trustee & Infrastructure Lead
E-Mail     : robbat2@gentoo.org
GnuPG FP   : 11ACBA4F 4778E3F6 E4EDF38E B27B944E 34884E85