Re: [Webware-devel] Re: [Webware-discuss] Documentation

[Ian B. <ia...@co...>]

On Fri, 2002-10-25 at 10:34, Ray Leyva wrote:
    Reading through the rest of the postings I've was trying to think of
    a very lite mark-up that was easily transformable, and I thought of
    YAML.  Very, very lite.  Can be tranformed relatively easily to
    Xml.  I still haven't looked at reST, but we would still have to
    write the tranformation tool from rest to Xml, and I don't know if
    that would be easier to do from reST2Xml, or yaml2xml.  Ian? 
    Aaron?  I can go either way for the original, but there needs to be
    a way to take the "original" content and transform it to Xml, for
    all the further transformation so as to be able to utilize Xslt.

I guess the question I have is what would an actual YAML document look
like?  I suspect it's not going to work well for inline markup, and may
look weird as text (like how are paragraphs separated?)

If you want to try reST, you can use FFK docs as an example:
  http://funformkit.sourceforge.net/FunFormKit/Docs/QuickStart.txt
The automatically-generated HTML at:
  http://funformkit.sourceforge.net/FunFormKit/Docs/QuickStart.html
I put the generated XML at:
  http://funformkit.sourceforge.net/QuickStart.xml

Looking at it, I'm guessing it might not be that hard to translate that
XML into Gentoo or another format.  It doesn't differentiate between
some things, like different kinds of literals, or kinds of literal
blocks.  I think the literals are okay, and we might be able to fix the
literal blocks.

  Ian