Ignore:
Timestamp:
Aug 5, 2009, 6:56:13 AM (10 years ago)
Author:
julian.reschke@…
Message:

update to latest version of rfc2629.xslt, bump up document dates

File:
1 edited

Legend:

Unmodified
Added
Removed
  • rfc2629xslt/rfc2629xslt.xml

    r599 r662  
    3030        </author>
    3131     
    32     <date month="June" year="2009"/>
     32    <date month="August" year="2009"/>
    3333
    3434    <keyword>RFC2629</keyword>
     
    6969<t>
    7070  <spanx style="verb">rfc2629.xslt</spanx> supports both all RFC2629 grammar elements and the extensions
    71   implemented in xml2rfc 1.21.
     71  implemented in xml2rfc 1.33.
    7272</t>
    7373<section title="Extension elements">
     
    105105java -cp saxon.jar com.icl.saxon.StyleSheet source.xml rfc2629.xslt \
    106106  xml2rfc-toc=yes xml2rfc-ext-support-rfc2731=no > result.html
    107 </artwork>
    108 </figure>
     107</artwork></figure>
    109108<figure>
    110109<preamble>Using XSLT parameters (xsltproc):</preamble>
     
    232231  <c>rfc</c>
    233232  <c>include<iref item="include PI pseudo-attribute"/><iref item="Processing Instruction pseudo attributes" subitem="include"/></c>
    234   <c>incompatible with XML/XSLT processing model</c>
     233  <c>incompatible with XML/XSLT processing model, please use external entities instead</c>
    235234
    236235  <c>rfc</c>
     
    373372  The following XSLT engines are believed to work well:
    374373  <list style="symbols">
    375     <t><iref item="MSXML3"/><iref item="MSXML4"/>MSXML3 and MSXML4 (<eref target="http://msdn.microsoft.com/xml"/>; these processors
    376     do not support exsl:node-set(), but have a similar proprietary extension)</t>
    377     <t><iref item="Saxon"/>Saxon (<eref target="http://saxon.sourceforge.net/"/>)</t>
    378     <t><iref item="Xalan"/>Xalan (<eref target="http://xml.apache.org/xalan-j/"/>)</t>
    379     <t><iref item="xsltproc"/>xsltproc (libxslt) (<eref target="http://xmlsoft.org/XSLT/"/>, make sure that you
     374    <t>Windows: <iref item="MSXML3"/><iref item="MSXML4"/>MSXML3 and MSXML4 (<eref target="http://msdn.microsoft.com/xml"/>;
     375      command line processor "msxsl" is available from <eref target="http://www.microsoft.com/downloads/details.aspx?FamilyID=2FB55371-C94E-4373-B0E9-DB4816552E41">Microsoft Download Center</eref>)</t>
     376    <t>Java: <iref item="Saxon"/>Saxon (<eref target="http://saxon.sourceforge.net/"/>)</t>
     377    <t>Java: <iref item="Xalan"/>Xalan (<eref target="http://xml.apache.org/xalan-j/"/>)</t>
     378    <t>C/C++: <iref item="xsltproc"/>xsltproc (libxslt) (<eref target="http://xmlsoft.org/XSLT/"/>, make sure that you
    380379    have a current version)</t>
    381380  </list>
     
    383382</section>
    384383
    385 <section title="In-Browser Engines">
     384<section title="In-Browser Engines" anchor="xslt.engines.browser">
    386385<t>
    387386  The following browsers seem to work fine:
    388387  <list style="symbols">
    389     <t><iref item="Internet Explorer 5.5"/>Internet Explorer 5.5 (Windows version, if MSXML3 is installed)</t>
    390     <t><iref item="Internet Explorer 6"/>Internet Explorer 6</t>
    391     <t><iref item="Internet Explorer 7"/>Internet Explorer 7</t>
    392     <t><iref item="Internet Explorer 8"/>Internet Explorer 8</t>
    393     <t anchor="firefox3"><iref item="Mozilla"/><iref item="Firefox" subitem="3.*"/>Firefox 3.0</t>
    394     <t><iref item="Safari"/><iref item="Safari" subitem="3.*"/>Safari 3 (starting with version 3.0.4)</t>
    395     <t><iref item="Google Chrome"/>Google Chrome (beta available)</t>
    396     <t><iref item="Opera"/>Opera 10 (alpha version available)</t>
     388    <x:lt>
     389      <t><iref item="Internet Explorer 5.5"/>Internet Explorer 5.5 (Windows version, if MSXML3 is installed)</t>
     390    </x:lt>
     391    <x:lt>
     392      <t><iref item="Internet Explorer 6"/><iref item="Internet Explorer 7"/><iref item="Internet Explorer 8"/>Internet Explorer 6 and newer</t>
     393    </x:lt>
     394    <x:lt>
     395      <t anchor="firefox3"><iref item="Mozilla"/><iref item="Firefox" subitem="3.*"/>Firefox 3.0 and newer</t>
     396      <t>
     397        <list style="symbols">
     398          <t>Be aware that XSLT execution can be suppressed using <iref item="NoScript"/><eref target="https://addons.mozilla.org/de/firefox/addon/722">NoScript</eref></t>
     399          <t>Firefox does not load external DTDs, see <eref target="https://bugzilla.mozilla.org/show_bug.cgi?id=22942">Mozilla Bug 22942</eref>, thus entities
     400          like &amp;nbsp; need to be declared in the internal subset (<xref target="examples.internalsubset"/>)</t>
     401        </list>
     402      </t>
     403    </x:lt>
     404    <x:lt>
     405      <t><iref item="Safari"/><iref item="Safari" subitem="3.*"/>Safari 3 (starting with version 3.0.4)</t>
     406    </x:lt>
     407    <x:lt>
     408      <t><iref item="Google Chrome"/>Google Chrome (beta available)</t>
     409    </x:lt>
     410    <x:lt>
     411      <t><iref item="Opera"/>Opera 10 (beta version available)</t>
     412    </x:lt>
    397413  </list>
    398414</t>
     
    581597  some popular extensions aren't standardized yet, the translation produces
    582598  a generic output (hopefully) conforming to <xref target="XSL-FO"/>.
    583   Specific backends (<spanx style="verb">xsl11toFop.xslt</spanx>,
     599  Specific backends (<spanx style="verb">xsl11toFop-0.95xslt</spanx>,
    584600  <spanx style="verb">xsl11toXep.xslt</spanx>, <spanx style="verb">xsl11toAn.xslt</spanx>)
    585601  then provide post-processing for the individual processors.
     
    632648<artwork type="example">
    633649saxon rfc2616.xml rfc2629toFo.xslt > tmp.fo
    634 saxon tmp.fo xsl11toFop.xslt > rfc2629.fo
     650saxon tmp.fo xsl11toFop-0.95.xslt > rfc2629.fo
    635651</artwork>
    636652</figure>
     
    16811697  <seriesInfo name='RFC' value='4897' />
    16821698</reference>
     1699
     1700<reference anchor="XML" target="http://www.w3.org/TR/2008/REC-xml-20081126/">
     1701  <front>
     1702    <title>Extensible Markup Language (XML) 1.0 (Fifth Edition)</title>
     1703    <author initials="T." surname="Bray" fullname="Tim Bray">
     1704      <organization>Textuality and Netscape</organization>
     1705      <address>
     1706        <email>tbray@textuality.com</email>
     1707      </address>
     1708    </author>
     1709    <author initials="J." surname="Paoli" fullname="Jean Paoli">
     1710      <organization>Microsoft</organization>
     1711      <address>
     1712        <email>jeanpa@microsoft.com</email>
     1713      </address>
     1714    </author>
     1715    <author initials="C.M." surname="Sperberg-McQueen" fullname="C. M. Sperberg-McQueen">
     1716      <organization>W3C</organization>
     1717      <address>
     1718        <email>cmsmcq@w3.org</email>
     1719      </address>
     1720    </author>
     1721    <author initials="E." surname="Maler" fullname="Eve Maler">
     1722      <organization>Sun Microsystems</organization>
     1723      <address>
     1724        <email>eve.maler@east.sun.com</email>
     1725      </address>
     1726    </author>
     1727    <author initials="F." surname="Yergeau" fullname="Francois Yergeau">
     1728      <organization/>
     1729    </author>
     1730    <date day="26" month="November" year="2008"/>
     1731  </front>
     1732  <seriesInfo name="W3C" value="REC-xml-20081126"/>
     1733</reference>
    16831734</references>
    16841735
     
    21722223  </section>
    21732224 
     2225  <section title="Examples" anchor="examples">
     2226
     2227  <section title="Using the 'Internal Subset'" anchor="examples.internalsubset">
     2228  <t>
     2229    The prolog of the XML document can both be used to refer to an external
     2230    DTD, and also to define internal entities (<xref target="XML" x:fmt="of" x:sec="2.8" x:rel="#sec-prolog-dtd"/>):
     2231  </t>
     2232  <figure><artwork type="example">
     2233&lt;?xml version="1.0"?>
     2234&lt;?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?>
     2235
     2236&lt;!DOCTYPE rfc SYSTEM "rfc2629.dtd" [
     2237
     2238  &lt;!-- <spanx>use "&amp;MAY;" for a BCP 14 "MAY", see <xref target="ext.element.bcp14"/></spanx> -->
     2239  &lt;!ENTITY MAY
     2240  "&lt;bcp14 xmlns='http://purl.org/net/xml2rfc/ext'>MAY&lt;/bcp14>">
     2241
     2242  &lt;!-- <spanx>re-declare "&amp;nbsp;" as code point 160 (non-breaking space)</spanx> -->
     2243  &lt;!-- <spanx>you may need this for UAs that do not read external DTDs</spanx> -->
     2244  &lt;!ENTITY nbsp
     2245  "&amp;#160;">
     2246
     2247  &lt;!-- <spanx>allow later RFC2616 reference using "&amp;rfc2616;"</spanx> -->
     2248  &lt;!ENTITY rfc2616 PUBLIC ''
     2249  "http://xml.resource.org/public/rfc/bibxml/reference.RFC.2616.xml">
     2250
     2251]>
     2252</artwork></figure>
     2253 
     2254  </section>
     2255
     2256  <section title="Customization" anchor="examples.customizing">
     2257  <t>
     2258    The XSLT code can be customized by creating a custom XSLT file that
     2259    uses &lt;xsl:import> to include the original code, and just overrides
     2260    particular rules.
     2261  </t>
     2262  <figure>
     2263  <preamble>For instance, the code below overrides several attributes in
     2264  <spanx style="verb">rfc2629toFO.xslt</spanx>, changing the color, spacing and font family for
     2265  headers.</preamble>
     2266  <artwork type="example">
     2267&lt;xsl:transform xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
     2268               version="1.0">
     2269
     2270  &lt;xsl:import href="rfc2629toFO.xslt"/>
     2271 
     2272  &lt;xsl:attribute-set name="h1">
     2273    &lt;xsl:attribute name="color">darkblue&lt;/xsl:attribute>
     2274    &lt;xsl:attribute name="font-family">sans-serif&lt;/xsl:attribute>
     2275    &lt;xsl:attribute name="space-before">24pt&lt;/xsl:attribute>
     2276  &lt;/xsl:attribute-set>
     2277 
     2278  &lt;xsl:attribute-set name="h2">
     2279    &lt;xsl:attribute name="color">darkblue&lt;/xsl:attribute>
     2280    &lt;xsl:attribute name="font-family">sans-serif&lt;/xsl:attribute>
     2281    &lt;xsl:attribute name="space-before">18pt&lt;/xsl:attribute>
     2282    &lt;xsl:attribute name="space-after">3pt&lt;/xsl:attribute>
     2283  &lt;/xsl:attribute-set>
     2284 
     2285  &lt;xsl:attribute-set name="h3">
     2286    &lt;xsl:attribute name="color">darkblue&lt;/xsl:attribute>
     2287    &lt;xsl:attribute name="font-family">sans-serif&lt;/xsl:attribute>
     2288    &lt;xsl:attribute name="space-before">16pt&lt;/xsl:attribute>
     2289    &lt;xsl:attribute name="space-after">2pt&lt;/xsl:attribute>
     2290  &lt;/xsl:attribute-set>
     2291
     2292&lt;/xsl:transform>
     2293</artwork></figure>
     2294<x:note>
     2295  <t>
     2296    <x:h>Note:</x:h> the name for the attribute sets may change in the future
     2297    as more working is done with respect to customizability. In any case,
     2298    overriding the settings in a separate file will be easier to maintain.
     2299    Please contact the author if you find yourself trying to override style
     2300    definitions that currently do not use attribute sets.
     2301  </t>
     2302  <t>
     2303    <x:h>Note:</x:h> the CSS style information used in <spanx style="verb">rfc2629.xslt</spanx>
     2304    can be overriden in a similar (but less granular) way: just overwrite the
     2305    template called "insertCss". As for XSL-FO, the class names may change in
     2306    future.
     2307  </t>
     2308</x:note>
     2309
     2310
     2311  </section>
     2312
     2313  </section>
     2314 
    21742315  <section title="License" anchor="license">
    21752316  <t>
     
    22192360    Experimental support for February 2009 boilerplate changes, and for
    22202361    the x:boilerplate element.
     2362</t>
     2363<t hangText="2009-07-08">
     2364    Support new boilerplate ordering in RFCs published since July 2009.
     2365    Fix problems with one-column text tables.
     2366</t>
     2367<t hangText="2009-07-19">
     2368    When possible, calculate the actual Expiry date for Internet Drafts
     2369    (full date must be available).
     2370</t>
     2371<t hangText="2009-08-01">
     2372    For '$xml2rfc-ext-authors-section='end'", move the index in front of the
     2373    authors section.
     2374</t>
     2375<t hangText="2009-08-04">
     2376    Consider /rfc/@ipr="pre5378Trust200902" when producing RFCs, not IDs.
    22212377</t>
    22222378      </list></t>
     
    28993055  Upgrade to DC-HTML from RFC 2731 (affects head/@profile).
    29003056</t>
     3057<t hangText="2009-07-08">
     3058  Remove table/@summary in output; the value getting inserted was just
     3059  repeating stuff that appeared in the preamble.
     3060</t>
     3061<t hangText="2009-08-01">
     3062  Implement table alignment (HTML output only for now).
     3063</t>
    29013064      </list></t>
    29023065    </section>
     
    29753138    Fix spacing in headers; add support for formatting for double-sided printing.
    29763139</t>
     3140<t hangText="2009-08-01">
     3141    Remove surplus empty pages when not generating double-sided output.
     3142</t>
    29773143     </list></t>
    29783144    </section>
Note: See TracChangeset for help on using the changeset viewer.