[gentoo-dev] [1/3] Automatic *XML->Wiki wiki.gentoo.org

["Robin H. Johnson" <robbat2@gentoo.org>]

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