This section presents an XSL stylesheet designed
to transform W3C documents conformant to
W3C XML Specification DTD
into XSL Formatting Objects (W3C Recommendation of
October 15, 2001). This same stylesheet was used to produce
the official PDF version of the XSL Recommendation itself.
This page shows results of its application to other W3C
documents -
XML Specification (Second Edition),
XPath,
XSLT, and
XLink W3C Recommendations.
For all of these, we present XSL FO files
produced by the stylesheet and PDF files resulted from
rendering them by XEP.
After some localization, the stylesheet can be used to format
translations of W3C documents as well. Below, we present a Japanese
localization of the stylesheet and its application to the Japanese
translation of XML Specification by Murata Makoto.
The Stylesheet
Here is the stylesheet: xmlspec20.xsl.
To the best of our knowledge, it covers the majority of
elements/constructs found in the DTD, with one important exception:
IDL-related markup from DOM Spec is omitted, as it is left
undocumented in the DTD description.
We have tried to build a style for real documents,
rather than for an abstract DTD. Therefore, the style also comprises
elements specific to certain documents (e.g. element syntax
descriptors in XSLT Specification, change markers in XML 2nd edition,
etc). Moreover, in cases where real usage of an element in documents
contradicted the formatting intent as specified in the XMLSpec DTD
docs, we have privileged the real-life usage (see e.g. treatment of
<slist> elements).
Not all the features of XSL FO required by this stylesheet are
currently supported by XEP, so rendering results may be not
quite perfect. Most salient problem is lacked support for
automatic table layout - table column widths are often badly
balanced.
Adjustable parameters
The stylesheet has five global parameters:
title-color
-
Specifies the color to be used for all headers and the
left sidebar.
attr-color
-
Specifies the color to be used for all hyperlinks.
lhs-width
rhs-width
-
Control the width of the left-hand and right-hand columns
in BNF productions, respectively (see the description of
scrap element in the XMLSpec DTD docs). These
parameters are used to tweak single documents individually.
gif-replacement
-
Extension to replace ".gif" in image names. Sometimes,
it is preferrable to use images in different format than
specified in the XML source; for example, the official
PDF version of the XSL Rec was produced using TIFF graphics
instead of GIFs referenced from the XML source. This parameter
sets a new file extension for images.
The stylesheet has been optimized for use with XEP; please refer
to the XEP Documentation
for implementation details.
Copyright Notice for W3C Documents
Copyright © 1994-2001
World Wide Web Consortium
(Massachusetts Institute of Technology,
Institut National de Recherche en Informatique et en Automatique,
Keio University). All Rights Reserved.
See also the full text of the W3C copyright notice:
http://www.w3.org/Consortium/Legal/copyright-documents.html
We have made all possible efforts to make the proposed stylesheet
produce nice and correct files. However, RenderX gives no guarantee
about the integrity of the transformation and rendering results.
All documents except for the original XML sources cannot be considered
as exactly reproducing the correspondent W3C normatives; RenderX assumes
no liability for eventual alterations/omissions in the text due
to errors in the stylesheet or formatter. Use at your own risk.
Results
The stylesheet has been tested on four W3C documents.
Relative XML sources are publicly available from the
W3C site. No changes were made
to the XML sources.
Parameters: lhs-width="1in" rhs-width="3.25in"
FO: xml2e.fo,
PDF: xml2e.pdf
Parameters: lhs-width="2in" rhs-width="3.5in"
FO: xpath.fo,
PDF: xpath.pdf
Parameters: lhs-width="1.75in" rhs-width="3.75in"
FO: xslt.fo,
PDF: xslt.pdf
Parameters: lhs-width="1in" rhs-width="3.25in"
FO: xlink.fo,
PDF: xlink.pdf
Japanese version of the stylesheet
The localized Japanese version of the stylesheet
[jaxmlspec20.xsl] differs
only in fonts and text strings. To view the resulting
PDF, you will need either a Japanese version of Acrobat
Reader or a Japanese font pack for Acrobat, downloadable from
Adobe site.
Here are the results of its application to the Japanese translation
of the XML Specification. Thanks to Murata Makoto who kindly permitted
using his translation of the Recommendation!
Parameters: lhs-width="1in" rhs-width="3.25in"
FO: jaxml.fo,
PDF: jaxml.pdf
|