Rework the front page of the spec:
authorCameron McCormack <cam@mcc.id.au>
Wed, 09 May 2012 19:16:56 +0200
changeset 54 6eebb57180c6
parent 53 c26fa658414e
child 55 f76aa3405d52
Rework the front page of the spec:
* Remove mentions of translations, since we don't seem to have had them
for SVG specs for a while.
* Refresh the list of Editors, and move editors of previous versions of
the spec down to the Acknowledgements section.
* Move the Single Page link into the front list of links.
* Remove mention of a PDF version.
* Update the Abstract to focus less on XML.
* Update the custom paragraph in the SotD section to mention the broad
changes we'll have relative to SVG 1.1.

And some formatting changes:
* Use the same line-height as CSS specs.
* Fix the formatting of the minitoc to look like an abridged CSS spec
toc, but avoid uppercasing chapter names since it's ugly.
* Some style fixes to ensure headings within sections marked as
ready-for-wg-review or ready-for-wider-review don't get red
backgrounds.
* Don't use any background colour on the front page.
master/definitions.xml
master/index.html
master/publish.xml
master/style/default_svg.css
--- a/master/index.html	Wed May 09 19:11:20 2012 +0200
+++ b/master/index.html	Wed May 09 19:16:56 2012 +0200
@@ -21,29 +21,22 @@
     <dd><edit:thisversion/></dd>
     <dt>Latest version:</dt>
     <dd><edit:latestversion/></dd>
+    <edit:includelatesteditorsdraft/>
     <dt>Previous version:</dt>
     <dd><edit:previousversion/></dd>
+    <dt>Single page version:</dt>
+    <dd><edit:thisversion single-page="true"/></dd>
     <dt>Public comments:</dt>
     <dd><a href="mailto:www-svg@w3.org" class='url'>www-svg@w3.org</a> (<a href="http://lists.w3.org/Archives/Public/www-svg/">archive</a>)</dd>
     <dt class="top-editors">Editors:</dt>
+    <dd>Tavmjong Bah, Invited Expert &lt;<a href="mailto:tavmjong@free.fr" class='url'>tavmjong@free.fr</a>&gt;</dd>
     <dd>Erik Dahlström, Opera Software &lt;<a href="mailto:ed@opera.com" class='url'>ed@opera.com</a>&gt;</dd>
-    <dd>Patrick Dengler, Microsoft Corporation &lt;<a href="mailto:patd@microsoft.com" class='url'>patd@microsoft.com</a>&gt;</dd>
-    <dd>Anthony Grasso, Canon Inc. &lt;<a href="mailto:anthony.grasso@cisra.canon.com.au" class='url'>anthony.grasso@cisra.canon.com.au</a>&gt;</dd>
-    <dd>Chris Lilley, W3C &lt;<a href="mailto:chris@w3.org" class='url'>chris@w3.org</a>&gt;</dd>
     <dd>Cameron McCormack, Mozilla Corporation &lt;<a href="mailto:cam@mcc.id.au" class='url'>cam@mcc.id.au</a>&gt;</dd>
-    <dd>Doug Schepers, W3C &lt;<a href="mailto:schepers@w3.org" class='url'>schepers@w3.org</a>&gt;</dd>
     <dd>Jonathan Watt, Mozilla Corporation &lt;<a href="mailto:jwatt@jwatt.org" class='url'>jwatt@jwatt.org</a>&gt;</dd>
-    <dd class="top-editors">Jon Ferraiolo, ex Adobe Systems &lt;<a href="mailto:jferrai@us.ibm.com" class='url'>jferrai@us.ibm.com</a>&gt; <span class="authornote">(Versions 1.0 and 1.1 First Edition; until 10 May 2006)</span></dd>
-    <dd>&#34276;&#27810; &#28147; (FUJISAWA Jun), Canon Inc. &lt;<a href="mailto:fujisawa.jun@canon.co.jp" class='url'>fujisawa.jun@canon.co.jp</a>&gt; <span class="authornote">(Version 1.1 First Edition)</span></dd>
-    <dd>Dean Jackson, ex W3C &lt;<a href="mailto:dean@w3.org" class='url'>dean@w3.org</a>&gt; <span class="authornote">(Version 1.1 First Edition; until February 2007)</span></dd>
   </dl>
+  <!--
   <p>Please refer to the <a href="http://www.w3.org/2011/08/REC-SVG11-20110802-errata"><strong>errata</strong></a> for this document, which may include some normative corrections.</p>
-
-  <p>This document is also available in these non-normative formats: a
-  <a href="single-page.html">single-page version</a>, a
-  <a href="REC-SVG11-20110802.zip">zip archive of HTML</a> (without external dependencies),
-  and a <a href="REC-SVG11-20110802.pdf">PDF</a>.
-  See also <a href="http://www.w3.org/Graphics/SVG/svg-updates/translations"><strong>translations</strong></a>, noting that the English version of this specification is the only normative version.</p>
+  -->
   <edit:copyright/>
 </div>
 
@@ -52,46 +45,45 @@
 <h2 id="abstract">Abstract</h2>
 
 <p>This specification defines the features and syntax for Scalable
-Vector Graphics (SVG) Version 1.1, a modularized language for describing
-two-dimensional vector and mixed vector/raster graphics in XML.</p>
+Vector Graphics (SVG) Version 2.0, a language for describing
+two-dimensional vector and mixed vector/raster graphics.  Although
+an XML serialization is given, processing is defined in terms of a
+DOM.</p>
 
 <h2 id="status">Status of this document</h2>
 
-<p><em>This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the <a href="http://www.w3.org/TR/">W3C technical reports index</a>  at http://www.w3.org/TR/.</em></p>
-
-<p>This document is the <edit:date/> SVG 1.1
-Second Edition Recommendation.  The Second Edition incorporates a
-number of corrections that were published as
-<a href="http://www.w3.org/2003/01/REC-SVG11-20030114-errata">errata against the First Edition</a>,
-as well as numerous other changes that help make the specification
-more readable and unambiguous.  The <a href="changes.html">Changes</a>
-appendix lists all of the changes that were made since the 
-first Proposed Recommendation publication of the Second Edition.  For all changes made
-between the First Edition and the Second Edition, see:</p>
+<p><em>This section describes the status of this document at the time of its
+publication. Other documents may supersede this document. A list of current W3C
+publications and the latest revision of this technical report can be found in
+the <a href="http://www.w3.org/TR/">W3C technical reports index</a> at http://www.w3.org/TR/</em>.</p>
 
-<ul>
-  <li><a href="http://www.w3.org/TR/2010/WD-SVG11-20100622/changes.html">Changes between the SVG 1.1 First Edition Recommendation and the first Last Call Working Draft of SVG 1.1 Second Edition</a></li>
-  <li><a href="http://www.w3.org/TR/2011/WD-SVG11-20110512/changes.html">Changes between the first and second Last Call Working Drafts of SVG 1.1 Second Edition</a></li>
-  <li><a href="http://www.w3.org/TR/2011/PR-SVG11-20110609/changes.html">Changes between the second Last Call Working Draft and the Proposed Recommendation of SVG 1.1 Second Edition</a></li>
-  <li><a href="changes.html">Changes between the Proposed Recommendation and this document</a></li>
-</ul>
+<p>This document is the <edit:date/> <strong><edit:maturity/></strong> of SVG 2.0.  This version of SVG
+builds upon <a href="http://www.w3.org/2011/08/REC-SVG11-20110816/">SVG 1.1 Second Edition</a>
+by improving the usability of the language and by adding new features commonly
+requested by authors.  The <a href="changes.html">Changes</a> appendix lists all
+of the changes that have been made since SVG 1.1 Second Edition.</p>
 
-<p>Comments on this Recommendation are welcome.  Corrections
+<p>Comments on this <edit:maturity/> are welcome.  <!--Corrections
 against the specification will be published as errata,
-and subsequently will be incorporated into future editions of SVG 1.1 or into
-SVG 2.0.  Comments can be sent to <a href="mailto:www-svg@w3.org" class='url'>www-svg@w3.org</a>, the public email
-list for issues related to vector graphics on the Web. This list is
+and subsequently will be incorporated into future editions of SVG 2.0.-->
+Comments can be sent to <a href="mailto:www-svg@w3.org" class='url'>www-svg@w3.org</a>,
+the public email list for issues related to vector graphics on the Web. This list is
 <a href="http://lists.w3.org/Archives/Public/www-svg/">archived</a> and
 senders must agree to have their message publicly archived from their
-first posting. To subscribe send an email to <a href="mailto:www-svg-request@w3.org" class='url'>www-svg-request@w3.org</a> with
-the word <code>subscribe</code> in the
-subject line.</p>
+first posting. To subscribe send an email to
+<a href="mailto:www-svg-request@w3.org" class='url'>www-svg-request@w3.org</a> with
+the word <code>subscribe</code> in the subject line.</p>
+
+<!--
+XXX At some point we will need to publish the new test suite in Mercurial and
+link to it from here.
 
 <p>The W3C SVG Working Group has released an expanded 
 <a href="http://dev.w3.org/SVG/profiles/1.1F2/test/harness/index.html">test suite</a> for SVG 1.1
 along with an
 <a href="http://dev.w3.org/SVG/profiles/1.1F2/test/status/implementation_matrix.html">implementation report</a>.
 This test suite will continue to be updated with new tests to improve interoperability even after Recommendation phase.</p>
+-->
 
 <p>This document has been produced by the
 <a href="http://www.w3.org/Graphics/SVG/WG">W3C SVG Working Group</a> as part of
@@ -105,19 +97,22 @@
 this document are the SVG Working Group participants.</p>
 
 <p>This document was produced by a group operating under the
-  <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5 February 2004 W3C Patent Policy</a>. 
-  W3C maintains a <a rel="disclosure" href="http://www.w3.org/2004/01/pp-impl/19480/status">public list of any patent disclosures</a> made in connection with the deliverables of the group; that page also includes instructions for disclosing a patent. An individual who has actual knowledge of a patent which the individual believes contains <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/#def-essential">Essential Claim(s)</a> must disclose the information in accordance with <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/#sec-Disclosure">section 6 of the W3C Patent Policy</a>. </p>
+<a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5 February 2004 W3C Patent Policy</a>. 
+W3C maintains a <a rel="disclosure" href="http://www.w3.org/2004/01/pp-impl/19480/status">public list of any patent disclosures</a> made in connection with the deliverables of the group; that page also includes instructions for disclosing a patent. An individual who has actual knowledge of a patent which the individual believes contains <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/#def-essential">Essential Claim(s)</a> must disclose the information in accordance with <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/#sec-Disclosure">section 6 of the W3C Patent Policy</a>.</p>
 
-<p>A list of current W3C Recommendations and
-other technical documents can be found at
+<p>A list of current W3C Recommendations and other technical documents can be found at
 <a href="http://www.w3.org/TR/" class='url'>http://www.w3.org/TR/</a>. W3C publications
 may be updated, replaced, or obsoleted by other documents at any time.</p>
 
+<!--
+XXX I don't think people have been translating SVG specifications for a while.
+
 <h3 id="AvailableLanguages">Available languages</h3>
 
 <p>The English version of this specification is the only normative version.
 However, for translations in other languages see
 <a href="http://www.w3.org/Graphics/SVG/svg-updates/translations.html" class='url'>http://www.w3.org/Graphics/SVG/svg-updates/translations.html</a>.</p>
+-->
 
 <div id="minitoc-section">
 <h2 id="minitoc">Table of Contents</h2>
@@ -136,11 +131,19 @@
 </p>
 
 <p>In addition, the SVG Working Group would like to acknowledge the
-contributions of the editors and authors of
-<a href='http://www.w3.org/TR/2001/REC-SVG-20010904/'>SVG 1.0</a> and
-<a href='http://www.w3.org/TR/2003/REC-SVG11-20030114/'>SVG 1.1 (First Edition)</a>,
-as much of the text in this document derives from these earlier
-versions of the SVG specification.</p>
+contributions of the editors and authors of the previous versions
+of SVG – as much of the text in this document derives from these
+earlier specifications – including:</p>
+
+<ul class="old-editor-list">
+  <li>Patrick Dengler, Microsoft Corporation &lt;<a href="mailto:patd@microsoft.com" class='url'>patd@microsoft.com</a>&gt; <span class="authornote">(Version 1.1 Second Edition)</span></li>
+  <li>Jon Ferraiolo, ex Adobe Systems &lt;<a href="mailto:jferrai@us.ibm.com" class='url'>jferrai@us.ibm.com</a>&gt; <span class="authornote">(Versions 1.0 and 1.1 First Edition; until 10 May 2006)</span></li>
+  <li>Anthony Grasso, Canon Inc. &lt;<a href="mailto:anthony.grasso@cisra.canon.com.au" class='url'>anthony.grasso@cisra.canon.com.au</a>&gt; <span class="authornote">(Version 1.1 Second Edition)</span></li>
+  <li>Dean Jackson, ex W3C &lt;<a href="mailto:dean@w3.org" class='url'>dean@w3.org</a>&gt; <span class="authornote">(Version 1.1 First Edition; until February 2007)</span></li>
+  <li>&#34276;&#27810; &#28147; (FUJISAWA Jun), Canon Inc. &lt;<a href="mailto:fujisawa.jun@canon.co.jp" class='url'>fujisawa.jun@canon.co.jp</a>&gt; <span class="authornote">(Version 1.1 First Edition)</span></li>
+  <li>Chris Lilley, W3C &lt;<a href="mailto:chris@w3.org" class='url'>chris@w3.org</a>&gt; <span class="authornote">(Versions 1.0, 1.1 First Edition and 1.1 Second Edition)</span></li>
+  <li>Doug Schepers, W3C &lt;<a href="mailto:schepers@w3.org" class='url'>schepers@w3.org</a>&gt; <span class="authornote">(Version 1.1 Second Edition)</span></li>
+</ul>
 
 <p>Finally, the SVG Working Group would like to acknowledge the
 great many people outside of the SVG Working Group who help with the
--- a/master/publish.xml	Wed May 09 19:11:20 2012 +0200
+++ b/master/publish.xml	Wed May 09 19:16:56 2012 +0200
@@ -10,8 +10,10 @@
 
   <versions>
     <cvs href='http://dvcs.w3.org/hg/svg2'/>
-    <this href='http://www.w3.org/TR/...'/>
-    <previous href='http://www.w3.org/TR/2011/REC-SVG11-20110802/'/>
+    <cvs-single href='http://dvcs.w3.org/hg/svg2/raw-file/single-page.html'/>
+    <this href='http://www.w3.org/TR/2012/WD-SVG2-2012xxxx/'/>
+    <this-single href='http://www.w3.org/TR/WD-SVG2-2012xxxx/single-page.html'/>
+    <previous href='http://www.w3.org/TR/2011/REC-SVG11-20110816/'/>
     <latest href='http://www.w3.org/TR/SVG2/'/>
     <latestrec href='http://www.w3.org/TR/SVG/'/>
   </versions>
--- a/master/style/default_svg.css	Wed May 09 19:11:20 2012 +0200
+++ b/master/style/default_svg.css	Wed May 09 19:16:56 2012 +0200
@@ -66,8 +66,6 @@
     font-size: 90%
 }
 
-body { line-height: 1.3; }
-
 /* Added to match new style sheet */
 div.element-summary {
 	border-color: #52A7E0;
@@ -206,6 +204,11 @@
     margin-top: 2px;
 }
 
+ul.old-editor-list { list-style-type: none !important }
+.authornote { font-size: 80% }
+
+ul.toc { text-transform: none }
+
 /*
  * Temporary styles for use only while the spec is in development:
  */
@@ -215,11 +218,22 @@
     background-color: #FFEEEE ! important;
 }
 
+body.ready-for-wg-review,
+h1.ready-for-wg-review,
+h2.ready-for-wg-review,
+h3.ready-for-wg-review,
 .ready-for-wg-review {
     background-color: #FBFBB6 ! important;
 }
 
+body.chapter-index,
+body.chapter-index h1,
+body.chapter-index h2,
+body.chapter-index h3,
+body.ready-for-wider-review,
+h1.ready-for-wider-review,
+h2.ready-for-wider-review,
+h3.ready-for-wider-review,
 .ready-for-wider-review {
     background-color: white ! important;
 }
-