Changeset 662 for rfc2629xslt/rfc2629xslt.xml
- Timestamp:
- 05/08/09 13:56:13 (13 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
rfc2629xslt/rfc2629xslt.xml
r599 r662 30 30 </author> 31 31 32 <date month=" June" year="2009"/>32 <date month="August" year="2009"/> 33 33 34 34 <keyword>RFC2629</keyword> … … 69 69 <t> 70 70 <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. 72 72 </t> 73 73 <section title="Extension elements"> … … 105 105 java -cp saxon.jar com.icl.saxon.StyleSheet source.xml rfc2629.xslt \ 106 106 xml2rfc-toc=yes xml2rfc-ext-support-rfc2731=no > result.html 107 </artwork> 108 </figure> 107 </artwork></figure> 109 108 <figure> 110 109 <preamble>Using XSLT parameters (xsltproc):</preamble> … … 232 231 <c>rfc</c> 233 232 <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> 235 234 236 235 <c>rfc</c> … … 373 372 The following XSLT engines are believed to work well: 374 373 <list style="symbols"> 375 <t> <iref item="MSXML3"/><iref item="MSXML4"/>MSXML3 and MSXML4 (<eref target="http://msdn.microsoft.com/xml"/>; these processors376 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 you374 <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 380 379 have a current version)</t> 381 380 </list> … … 383 382 </section> 384 383 385 <section title="In-Browser Engines" >384 <section title="In-Browser Engines" anchor="xslt.engines.browser"> 386 385 <t> 387 386 The following browsers seem to work fine: 388 387 <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 &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> 397 413 </list> 398 414 </t> … … 581 597 some popular extensions aren't standardized yet, the translation produces 582 598 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>, 584 600 <spanx style="verb">xsl11toXep.xslt</spanx>, <spanx style="verb">xsl11toAn.xslt</spanx>) 585 601 then provide post-processing for the individual processors. … … 632 648 <artwork type="example"> 633 649 saxon rfc2616.xml rfc2629toFo.xslt > tmp.fo 634 saxon tmp.fo xsl11toFop .xslt > rfc2629.fo650 saxon tmp.fo xsl11toFop-0.95.xslt > rfc2629.fo 635 651 </artwork> 636 652 </figure> … … 1681 1697 <seriesInfo name='RFC' value='4897' /> 1682 1698 </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> 1683 1734 </references> 1684 1735 … … 2172 2223 </section> 2173 2224 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 <?xml version="1.0"?> 2234 <?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?> 2235 2236 <!DOCTYPE rfc SYSTEM "rfc2629.dtd" [ 2237 2238 <!-- <spanx>use "&MAY;" for a BCP 14 "MAY", see <xref target="ext.element.bcp14"/></spanx> --> 2239 <!ENTITY MAY 2240 "<bcp14 xmlns='http://purl.org/net/xml2rfc/ext'>MAY</bcp14>"> 2241 2242 <!-- <spanx>re-declare "&nbsp;" as code point 160 (non-breaking space)</spanx> --> 2243 <!-- <spanx>you may need this for UAs that do not read external DTDs</spanx> --> 2244 <!ENTITY nbsp 2245 "&#160;"> 2246 2247 <!-- <spanx>allow later RFC2616 reference using "&rfc2616;"</spanx> --> 2248 <!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 <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 <xsl:transform xmlns:xsl="http://www.w3.org/1999/XSL/Transform" 2268 version="1.0"> 2269 2270 <xsl:import href="rfc2629toFO.xslt"/> 2271 2272 <xsl:attribute-set name="h1"> 2273 <xsl:attribute name="color">darkblue</xsl:attribute> 2274 <xsl:attribute name="font-family">sans-serif</xsl:attribute> 2275 <xsl:attribute name="space-before">24pt</xsl:attribute> 2276 </xsl:attribute-set> 2277 2278 <xsl:attribute-set name="h2"> 2279 <xsl:attribute name="color">darkblue</xsl:attribute> 2280 <xsl:attribute name="font-family">sans-serif</xsl:attribute> 2281 <xsl:attribute name="space-before">18pt</xsl:attribute> 2282 <xsl:attribute name="space-after">3pt</xsl:attribute> 2283 </xsl:attribute-set> 2284 2285 <xsl:attribute-set name="h3"> 2286 <xsl:attribute name="color">darkblue</xsl:attribute> 2287 <xsl:attribute name="font-family">sans-serif</xsl:attribute> 2288 <xsl:attribute name="space-before">16pt</xsl:attribute> 2289 <xsl:attribute name="space-after">2pt</xsl:attribute> 2290 </xsl:attribute-set> 2291 2292 </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 2174 2315 <section title="License" anchor="license"> 2175 2316 <t> … … 2219 2360 Experimental support for February 2009 boilerplate changes, and for 2220 2361 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. 2221 2377 </t> 2222 2378 </list></t> … … 2899 3055 Upgrade to DC-HTML from RFC 2731 (affects head/@profile). 2900 3056 </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> 2901 3064 </list></t> 2902 3065 </section> … … 2975 3138 Fix spacing in headers; add support for formatting for double-sided printing. 2976 3139 </t> 3140 <t hangText="2009-08-01"> 3141 Remove surplus empty pages when not generating double-sided output. 3142 </t> 2977 3143 </list></t> 2978 3144 </section>
Note: See TracChangeset
for help on using the changeset viewer.