Instructions for editing WCAG 2.0 materials

Editing the Source

The source for the WCAG 2.0 Checkpoint and Guidelines is wcag-src.html

Place holding information - DO NOT EDIT

• Version Info (front matter) is generated by the XSLT. The following is the actual markup for the placeholding div element. Do not make changes to this element.

  <div id="versionInfo"> <h1>Update version variables in gl.xsl</h1> </div>

• The Version Info is followed by the copyright info. Please do not edit this.

  <p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice-20000612#Copyright">Copyright</a> <!-- &copy; --> ..... </p>

• There is a place holding div element for the Table of Contents. Please do not edit this:

  <div id="toc"> </div>

• The entire introduction is included in a div element of id "intro". <div class="intro">

Conventions in the document

• Every heading element (h1-h3) needs an id so that it is included properly in the table of contents. h4-h6 elements are not included in the table of contents. e.g.

  <h2 id="abstract">Abstract</h2>

• The text of each guideline is included in a div element of class='guidelines' (the div is closed before the first checkpoint)
• Checkpoint text and success criteria are grouped in a div of class "normative".
• Success criteria are grouped in a div of class "criteria"
• Each criterion is a list item in an ordered list.
• Issues are marked with class="issue"
• Definitions are grouped in a div of class "defn"
• Benefits are grouped in a div of class "benefits"
• Examples are grouped in a div of class "example"

Generating the document

gl.xsl is the XSLT to generate the document.

Editing the XSLT

The versioning information is stored in the XSLT in the following variables:

Draft date to be used at the top of the document.

<xsl:variable name="draftDate">13 August 2001</xsl:variable>

"This version" link info

<xsl:variable name="thisVersion">http://www.w3.org/WAI/GL/WCAG20/WD-WCAG20-20010813.html</xsl:var iable>

Previous version link info

<xsl:variable name="previousVersion">http://www.w3.org/WAI/GL/WCAG20/WD-WCAG20-20010813.html</xsl :variable>

Latest version link info - don't change this one.

<xsl:variable name="latestVersion">http://www.w3.org/WAI/GL/WCAG20/</xsl:variable>

To include issues in the draft use:

<!-- xsl:template match="*[@class='issue']"/ -->

To not include issues in the draft use (this is the current setting):

<xsl:template match="*[@class='issue']"/>

Publishing the document

If using the XALAN java XSLT engine* the command line is:
java org.apache.xalan.xslt.Process -IN wcag-src.html -XSL gl.xsl -OUT temp1.html

*Note: you must remove the doctype and any namespace information from the beginning of the source document otherwise the front matter and table of contents will not be generated.

If using the XSLT processor on tux.w3.org, the command line is:
@@Jason - what do you use?

This will create a file called "temp1.html." Publish temp1.html on the w3c site at the address given in the "This version" variable from above.

Run the Pubrules checker on the file to make sure that it is valid, that links are not broken, etc.

$Date: 2002/06/11 21:02:08 $ Wendy Chisholma