www/server/staging/standards gnu-website-guidel...

[Therese Godefroy]

CVSROOT:        /webcvs/www
Module name:    www
Changes by:     Therese Godefroy <th_g> 21/02/11 08:39:57

Modified files:
        server/staging/standards: gnu-website-guidelines.html 

Log message:
        Make h3 headings more prominent; increase spacing between big items;
        in #orthography, follow American conventions; specify 'lowercase'
        for country code; remove new line between <img> and </a>.

CVSWeb URLs:
http://web.cvs.savannah.gnu.org/viewcvs/www/server/staging/standards/gnu-website-guidelines.html?cvsroot=www&r1=1.8&r2=1.9

Patches:
Index: gnu-website-guidelines.html
===================================================================
RCS file: /webcvs/www/www/server/staging/standards/gnu-website-guidelines.html,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -b -r1.8 -r1.9
--- gnu-website-guidelines.html 11 Feb 2021 12:08:01 -0000      1.8
+++ gnu-website-guidelines.html 11 Feb 2021 13:39:56 -0000      1.9
@@ -1,10 +1,6 @@
 <!--#include virtual="/server/header.html" -->
 <!-- Parent-Version: 1.95 -->
 <title>Website Guidelines - GNU Project - Free Software Foundation</title>
-<!--<style type="text/css" media="print,screen">
-ul li { margin-top: 1em; }
-.summary { padding: 0 0 1.2em 2em; }
-</style>-->
  <!--#include virtual="/server/standards/po/gnu-website-guidelines.translist" 
-->
 <!--#include virtual="/server/banner.html" -->
 <h2>GNU Website Guidelines</h2>
@@ -14,8 +10,10 @@
   Keeping the site design simple helps accomplish that.
 </p>
 
+<div class="summary">
+<hr class="no-display" />
 <h3 class="no-display">Table of Contents</h3>
-<ul class="summary">
+<ul>
   <li><a href="#GeneralGuidelines">General Guidelines</a></li>
   <li><a href="#CopyrightGuidelines">Copyright Guidelines</a></li>
   <li><a href="#orthography">Spelling and Punctuation</a></li>
@@ -39,7 +37,7 @@
   <li><a href="#UsefulResources">Useful Resources</a></li>
 </ul>
 <hr class="no-display" />
-
+</div>
 
 <p>Please be considerate of all who access our web pages, and accommodate
 them, including those who use text-only browsers or old browsers, as well
@@ -48,10 +46,11 @@
 course, please don't install any of the proprietary web browsers
 available if you don't already use them anyway.</p>
 
-<h3 id="GeneralGuidelines">General Guidelines</h3>
 
+<h3 id="GeneralGuidelines" class="subheader">General Guidelines</h3>
 
-<ul>
+
+<ul class="para">
 <li>The GNU web server has only <a href="/philosophy/free-sw.html">free
 software</a> available.  We prefer that only free software be used to
 prepare pages for the GNU web server.</li>
@@ -107,10 +106,10 @@
 </ul>
 
 
-<h3 id="CopyrightGuidelines">Copyright Guidelines</h3>
+<h3 id="CopyrightGuidelines" class="subheader">Copyright Guidelines</h3>
 
 
-<ul>
+<ul class="para">
 <li>Every page should have a copyright notice.  See the <a
 
href="//web.cvs.savannah.gnu.org/viewvc/*checkout*/www/server/standards/boilerplate.html?root=www&amp;content-type=text%2Fplain">
 boilerplate</a>, referred below.</li>
@@ -151,10 +150,10 @@
 </ul>
 
 
-<h3 id="orthography">Spelling and Punctuation</h3> 
+<h3 id="orthography" class="subheader">Spelling and Punctuation</h3> 
 
 
-<ul>
+<ul class="para">
 <li>English pages should follow the standard American spelling,
 hyphenation and punctuation conventions.</li>
 
@@ -163,7 +162,7 @@
 consistency:
   <ul>
   <li>The term &ldquo;nonfree&rdquo; is preferred over &ldquo;non-free&rdquo;;
-  likewise, &ldquo;noncommercial&rdquo; over &ldquo;non-commercial&rdquo;.</li>
+  likewise, &ldquo;noncommercial&rdquo; over &ldquo;non-commercial.&rdquo;</li>
   <li>In ordinary text, HTML entities
   &ldquo;<code>&amp;ldquo;</code>&hellip;<code>&amp;rdquo;</code>&rdquo; and
   &ldquo;<code>&amp;lsquo;</code>&hellip;<code>&amp;rsquo;</code>&rdquo;
@@ -177,10 +176,10 @@
 
 
 <a id="FilenameAndURLGuidelines"></a>
-<h3 id="filenames">Filenames</h3>
+<h3 id="filenames" class="subheader">Filenames</h3>
 
 
-<ul>
+<ul class="para">
 <li>To make simultaneous edition of many files easier,
 try and give each HTML file a unique and descriptive name; the special filename
 <code>index.html</code> should only be used as a symbolic link, as
@@ -198,16 +197,16 @@
 <code><var>lang</var></code> should contain the two-letter language code from 
<a
 href="//www.loc.gov/standards/iso639-2/php/code_list.php">ISO 639</a>,
 and optionally an hyphen followed the two-letter country code given in
-ISO 3166.  For example, the German translation of <code>not-ipr.html</code>
+ISO 3166 (lowercase).  For example, the German translation of 
<code>not-ipr.html</code>
 should be named <code>not-ipr.de.html</code>; the Brazilian Portuguese
 translation should be named <code>not-ipr.pt-br.html</code>.</li>
 </ul>
 
 
-<h3 id="urls">URLs</h3>
+<h3 id="urls" class="subheader">URLs</h3>
 
 
-<ul>
+<ul class="para">
 <li>Hand-written URLs that refer to other files on www.gnu.org should be
 absolute, starting from the root page.  That is, paths should start
 with <code>/</code> (e.g., <code>/gnu/about-gnu.html</code>; <em>not</em>
@@ -280,10 +279,10 @@
 </ul>
 
 
-<h3 id="HTMLGuidelines">HTML Guidelines</h3>
+<h3 id="HTMLGuidelines" class="subheader">HTML Guidelines</h3>
 
 
-<ul>
+<ul class="para">
 <li>HTML on the GNU web server should be strictly compliant with
 <a href="//www.w3.org/standards/">W3C standards</a>.</li>
 
@@ -346,10 +345,10 @@
 </ul>
 
 
-<h3 id="tables">Tables and menus</h3>
+<h3 id="tables" class="subheader">Tables and menus</h3>
 
 
-<ul>
+<ul class="para">
 <li>Please use tables to organize data, not the presentation of the
 web page.</li>
 
@@ -375,10 +374,10 @@
 </ul>
 
 
-<h3 id="templating">Using our page template</h3>
+<h3 id="templating" class="subheader">Using our page template</h3>
 
 
-<ul>
+<ul class="para">
 <li>To help people follow the above guidelines, a page template (or
 &ldquo;boilerplate&rdquo;) is provided for both the main part of the GNU
 website, and the software projects.  Its use is mandatory for new pages in
@@ -396,12 +395,12 @@
 </ul>
 
 
-<h3 id="styling">Styling</h3>
+<h3 id="styling" class="subheader">Styling</h3>
 
 
 <h4>Styling of templated pages</h4>
 
-<ul>
+<ul class="para">
 <li>Generic styling for desktops and smartphones is provided by 
 <code>/layout.css</code>; it covers most of our use cases.</li>
 
@@ -435,7 +434,7 @@
 
 <h4>Other stylesheets</h4>
 
-<ul>
+<ul class="para">
 <li>Historical pages (unmaintained translations for the most part) refer
 to <code>/gnu.css</code>, which in turn loads <code>/mini.css</code>,
 as these pages are
@@ -458,10 +457,10 @@
 </ul>
 
 
-<h3 id="UseofGraphics">Use of Graphics</h3>
+<h3 id="UseofGraphics" class="subheader">Use of Graphics</h3>
 
 
-<ul>
+<ul class="para">
 <li>The use of graphics should be minimized, so pages load fast
 over slow links, especially animations.</li>
 
@@ -541,16 +540,16 @@
 <a href="/graphics/agnuhead.html"><img
    src="/graphics/gnu-head-sm.jpg"
    alt="&nbsp;[Image of the Head of a GNU]&nbsp;"
-   style="width: 8em" />
-</a></p>
+   style="width: 8em" /></a>
+</p>
 
 <pre class="emph-box">
 &lt;p class="imgleft"&gt;
 &lt;a href="/graphics/agnuhead.html"&gt;
 &lt;img src="/graphics/gnu-head-sm.jpg"
      alt="&nbsp;[Image of the Head of a GNU]&nbsp;"
-     style="width: 8em" /&gt;
-&lt;/a&gt;&lt;/p&gt;
+     style="width: 8em" /&gt;&lt;/a
+&gt;&lt;/p&gt;
 </pre>
 <div style="clear: both"></div>
 
@@ -559,7 +558,7 @@
 </ul>
 
 
-<h3 id="pollinking">Appendix 1 - Linking Policies</h3>
+<h3 id="pollinking" class="subheader">Appendix 1 - Linking Policies</h3>
 
 
 <p>One of the most complex aspects of maintaining web pages is following the
@@ -716,12 +715,12 @@
 </dl>
 
 
-<h3 id="repo">Appendix 2 - Working with Web CVS Repositories</h3>
+<h3 id="repo" class="subheader">Appendix 2 - Working with Web CVS 
Repositories</h3>
 
 
 <h4 id="cvs">Basic CVS commands</h4>
 
-<ul>
+<ul class="para">
 <li>For reference manual, execute <kbd>info cvs</kbd>.</li>
 
 <li>
@@ -917,10 +916,10 @@
 unless you have a specific reason to do so.</p>
 
 
-<h3 id="UsefulResources">Useful Resources</h3>
+<h3 id="UsefulResources" class="subheader">Useful Resources</h3>
 
 
-<ul>
+<ul class="para">
 <li>Outside gnu.org:
   <ul>
     <li>We follow the guidelines of the <a
@@ -1038,7 +1037,7 @@
 
 <p class="unprintable">Updated:
 <!-- timestamp start -->
-$Date: 2021/02/11 12:08:01 $
+$Date: 2021/02/11 13:39:56 $
 <!-- timestamp end --></p>
 </div>
 </div><!-- for class="inner", starts in the banner include -->