From 9d6e6241954d001a5b49e4ea9a48c10e2a792958 Mon Sep 17 00:00:00 2001 From: "Chris St. Pierre" Date: Mon, 10 Dec 2012 17:19:54 -0600 Subject: generate XML schema docs from XML schemas themselves --- schemas/genshi.xsd | 290 ++++++++++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 264 insertions(+), 26 deletions(-) (limited to 'schemas/genshi.xsd') diff --git a/schemas/genshi.xsd b/schemas/genshi.xsd index 35d81e2f1..0131363be 100644 --- a/schemas/genshi.xsd +++ b/schemas/genshi.xsd @@ -6,67 +6,202 @@ elementFormDefault="qualified"> - Genshi schema - Chris St. Pierre + Genshi XML templating language schema + + + `for directive + <http://genshi.edgewall.org/wiki/Documentation/xml-templates.html#id3>`_ + + - + + + + The loop iterator + + + + + + `if directive + <http://genshi.edgewall.org/wiki/Documentation/xml-templates.html#id1>`_ + + - + + + + The statement giving the value to test + + + + + + `match directive + <http://genshi.edgewall.org/wiki/Documentation/xml-templates.html#id5>`_ + + - - - - + + + + XPath expression to search for in the template. + + + + + + + Whether the engine should stop looking for more matching + elements after the first match. Use this on match templates + that match elements that can only occur once in the stream, + such as the <head> or <body> elements in an HTML + template, or elements with a specific ID. + + + + + + + Whether the matched content should be buffered in + memory. Buffering can improve performance a bit at the cost + of needing more memory during rendering. Buffering is + *required* for match templates that contain more than one + invocation of the ``select()`` function. If there is only + one call, and the matched content can potentially be very + long, consider disabling buffering to avoid excessive memory + use. + + + + + + + Whether the match template should be applied to its own + output. Note that once implies non-recursive behavior, so + this attribute only needs to be set for match templates that + don't also have once set. + + + + + + `def directive + <http://genshi.edgewall.org/wiki/Documentation/xml-templates.html#id4>`_ + + - + + + + The function prototype + + + + + + `with directive + <http://genshi.edgewall.org/wiki/Documentation/xml-templates.html#py-with>`_ + + - + + + + A semicolon-delimited list of variables to define and their + values. + + + + + + `replace directive + <http://genshi.edgewall.org/wiki/Documentation/xml-templates.html#id8>`_ + + - + + + + The value to replace the contents with. + + + + + + `choose directive + <http://genshi.edgewall.org/wiki/Documentation/xml-templates.html#id2>`_ + + - + + + + The ``when`` directive is used inside + :xml:type:`py:chooseType` or + :xml:attribute:`py:genshiAttrs:choose` to handle a single + specific condition. + + + + minOccurs="0"/> - + + + + If ``test`` is set, the child :xml:element:`py:when` + directives are tested for equality to the value of the + expression. + + + + + + The ``otherwise`` directive is used inside + :xml:type:`py:chooseType` or + :xml:attribute:`py:genshiAttrs:choose` to handle all + conditions not handled by a :xml:element:`py:when`. + + @@ -74,6 +209,13 @@ + + + Most Genshi templating directives can be used either as + standalone elements or as attributes on existing elements. + This element group defines the standalone tags. + + @@ -87,17 +229,113 @@ - - - - - - - - - - - - + + + Most Genshi templating directives can be used either as + standalone elements or as attributes on existing elements. + This attribute group defines the attribute directives. + + + + + + `if directive + <http://genshi.edgewall.org/wiki/Documentation/xml-templates.html#id1>`_ + + + + + + + + `choose directive + <http://genshi.edgewall.org/wiki/Documentation/xml-templates.html#id2>`_ + + + + + + + The ``when`` directive is used inside + :xml:type:`py:chooseType` or + :xml:attribute:`py:genshiAttrs:choose` to handle a single + specific condition. + + + + + + + The ``otherwise`` directive is used inside + :xml:type:`py:chooseType` or + :xml:attribute:`py:genshiAttrs:choose` to handle all + conditions not handled by a :xml:element:`py:when`. + + + + + + + `for directive + <http://genshi.edgewall.org/wiki/Documentation/xml-templates.html#id3>`_ + + + + + + + `def directive + <http://genshi.edgewall.org/wiki/Documentation/xml-templates.html#id4>`_ + + + + + + + `match directive + <http://genshi.edgewall.org/wiki/Documentation/xml-templates.html#id5>`_ + + + + + + + `with directive + <http://genshi.edgewall.org/wiki/Documentation/xml-templates.html#py-with>`_ + + + + + + + `attrs directive + <http://genshi.edgewall.org/wiki/Documentation/xml-templates.html#id6>`_ + + + + + + + `content directive + <http://genshi.edgewall.org/wiki/Documentation/xml-templates.html#id7>`_ + + + + + + + `replace directive + <http://genshi.edgewall.org/wiki/Documentation/xml-templates.html#id8>`_ + + + + + + + `strip directive + <http://genshi.edgewall.org/wiki/Documentation/xml-templates.html#id9>`_ + + + -- cgit v1.2.3-1-g7c22