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

[Lorenzo L. Ancora]

CVSROOT:        /web/www
Module name:    www
Changes by:     Lorenzo L. Ancora <lorenzoancora>       21/02/07 13:38:17

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

Log message:
        Add patch by th_g; suggestions by ineiev; icon alignment; permalinks

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

Patches:
Index: gnu-website-guidelines.html
===================================================================
RCS file: /web/www/www/server/staging/standards/gnu-website-guidelines.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -b -r1.1 -r1.2
--- gnu-website-guidelines.html 29 Jan 2021 17:08:31 -0000      1.1
+++ gnu-website-guidelines.html 7 Feb 2021 18:38:17 -0000       1.2
@@ -3,6 +3,7 @@
 <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" -->
@@ -191,8 +192,8 @@
 file to handle this.</li>
 
 <li id="NamingTranslations">If you translate your web page in different
-languages, please name the English file <code>ARTICLE.html</code>, and
-its translations <code>ARTICLE.LANG.html</code>.  LANG should contain the
+languages, please name the English file <code><var>article</var>.html</code>, 
and
+its translations 
<code><var>article.lang</var>.html</code>&mdash;<code><var>lang</var></code> 
should contain the
 two-letter language code from <a
 href="https://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
@@ -239,15 +240,7 @@
 <li>Consider others linking to your page when removing an anchor or
 <code>id</code> attribute from any header tag.</li>
 
-<li>Cite FTP locations of source code with the full URL of the
-directory they are in:
-<p class="emph-box"><code>
-&lt;a 
href="https://ftp.gnu.org/gnu/foo"&gt;https://ftp.gnu.org/gnu/foo&lt;/a&gt;
-</code></p>
-which browsers display this way:<br />
-<a href="https://ftp.gnu.org/gnu/";>https://ftp.gnu.org/gnu/foo</a><br />
-
-We encourage FTP sites to use a directory for each package, and only put
+<li>We encourage FTP sites to use a directory for each package, and only put
 one package's files in each directory, so that the users can see what
 versions of that package and related information can be downloaded
 (e.g., a <code>README</code> file, information of what versions are
@@ -291,6 +284,8 @@
 <ul>
 <li>HTML 5 and CSS 3 are preferred over older (X)HTML and CSS standards.</li>
 
+<li>The subset of HTML used must be composed only by W3C Recommendations.</li>
+
 <li>All markup on the GNU web server should be strictly compliant with
 <a href="https://www.w3.org/standards/";>W3C standards</a>.</li>
 
@@ -309,7 +304,7 @@
 
 <li>The &lt;head&gt; element should contain this line:
 <p class="emph-box">
-<code>&lt;link rev="made" href="mailto:webmasters@gnu.org"&gt;</code></p>
+<code>&lt;link rel="author" href="mailto:webmasters@gnu.org"&gt;</code></p>
 Some browsers use this information to allow users to easily report
 problems they find on a page.</li>
 
@@ -330,7 +325,7 @@
 
 <li>Acronyms/abbreviations:
   <ul>
-  <li>Never use <code>&lt;acronym&gt;</code>: HTML 5 obsoletes it in
+  <li>Never use <code>&lt;acronym&gt;</code>: HTML&nbsp;5 obsoletes it in
   favor of <code>&lt;abbr&gt;</code>.</li>
 
   <li>Don't use <code>&lt;abbr&gt;</code> unless for a really
@@ -459,7 +454,7 @@
 
 <li>Some software manuals use a dedicated CSS, <code>/style.css</code>.</li>
 
-<li>Translators maintain stylesheets (<code>/style.LANG.css</code>) that
+<li>Translators maintain stylesheets (<code>/style.<var>lang</var>.css</code>) 
that
 modify layout.css according to their own needs.  The RTL languages (Arabic,
 Persian, and Hebrew) use <code>/style.rtl.css</code>.</li>
 </ul>
@@ -736,7 +731,7 @@
 with your Savannah login:</p>
 
 <pre class="emph-box">
-cvs -z3 -d:ext:&lt;username&gt;@cvs.savannah.gnu.org:/web/www co www
+cvs -z3 -d:ext:<var>username</var>@cvs.savannah.gnu.org:/web/www co www
 </pre>
 
 <p>You will get a working directory, <code>www</code>, with the same
@@ -756,7 +751,7 @@
 <p>Check out the web repository of the fooproject:</p>
 
 <pre class="emph-box">
-cvs -z3 -d:ext:&lt;username&gt;@cvs.savannah.gnu.org:/web/fooproject co 
fooproject
+cvs -z3 
-d:ext:<var>username</var>@cvs.savannah.gnu.org:/web/<var>fooproject</var> co 
<var>fooproject</var>
 </pre>
 
 <p>You will get a working directory, <code>fooproject</code>, with the same
@@ -864,12 +859,12 @@
 <p>On each line the first file name must be a relative path name to an
 existing file.  The second file name may not contain any slash; it is the
 name of the symbolic link to be created in the present directory.  For
-instance, if a page named <code>DIR.html</code> exists in the
-<code>/DIR</code> directory, and <code>index.html</code> does not exist,
-<code>/DIR/.symlinks</code> should contain a line like this:</p>
+instance, if a page named <code><var>dir</var>.html</code> exists in the
+<code>/<var>dir</var></code> directory, and <code>index.html</code> does not 
exist,
+<code>/<var>dir</var>/.symlinks</code> should contain a line like this:</p>
 
 <pre class="emph-box">
-DIR.html index.html
+<var>dir</var>.html index.html
 </pre>
 
 <p>The <code>ln -s</code> analogy accounts for only part of the story.
@@ -879,8 +874,8 @@
 href="#NamingTranslations">naming
 conventions</a>.  This makes it impossible to use
 symlinks to redirect to and from HTML files whose names look like
-translations, that is, <code>page.<var>LL</var>.html</code> or
-<code>page.<var>LL-CC</var>.html</code>, where LL and CC are two-letter
+translations, that is, <code>page.<var>ll</var>.html</code> or
+<code>page.<var>ll-cc</var>.html</code>, where ll and cc are two-letter
 codes.  When you need such redirections, use the <a
 href="#htaccess">htaccess mechanism</a>.</p>
 
@@ -899,7 +894,7 @@
 
 <p class="emph-box"><code>
 &lt;meta http-equiv="refresh" content="0;
-  url=http://www.gnu.org/target"&gt;
+  url=https://www.gnu.org/<var>target</var>"&gt;
 </code></p>
 
 
@@ -926,12 +921,14 @@
   <ul>
     <li>We follow the guidelines of the <a
     href="https://www.anybrowser.org/campaign/"; rel="noopener"
-    style="text-decoration: none; vertical-align: middle;">
+    style="text-decoration: none;">
       <img src="/graphics/icons/anybrowser.png" width="80px" height="15px"
-      title="Best Viewed on Any Browser" alt="Icon of the Any Browser 
campaign">
-    </a> campaign;</li>
+      title="Best Viewed on Any Browser"
+      alt="Icon of the 'Best Viewed on Any Browser' initiative"
+      style="vertical-align: middle;">
+    </a> campaign.</li>
 
-    <!-- Removed on 01/2021 because of declared obsolescence.
+    <!-- Removed on 01/2021; superseded by HTML 5 (W3C Recommendation).
     <li>Use of the <a
     href="https://www.cs.tcd.ie/15445/UG.HTML";>ISO</a> standard for the
     <a href="https://www.w3.org/MarkUp/";>Hypertext Markup Language
@@ -943,10 +940,10 @@
     href="https://www.w3.org/Provider/Style/Overview.html";>Style
     Guide</a>.</li>-->
 
-    <li>Use of <a href="https://w3.org/TR/html52/"; rel="noopener">HTML 5.2</a>
-    allows for consistent backwards compatibility among web browsers;</li>
+    <li>Use of <a href="https://w3.org/TR/2021/SPSD-html52-20210128/"; 
rel="noopener">HTML&nbsp;5.2</a>
+    allows for consistent backwards compatibility among web browsers.</li>
 
-    <li>Use of <a href="https://w3.org/TR/WCAG21/"; rel="noopener">WCAG 2.1</a>
+    <li>Use of <a href="https://www.w3.org/TR/2018/REC-WCAG21-20180605/"; 
rel="noopener">WCAG&nbsp;2.1</a>
     ensures accessibility for a wide range of people with disabilities.</li>
   </ul>
 </li>
@@ -955,12 +952,9 @@
   <ul>
     <li><a href="#content">The GNU Website Guidelines</a> (this page);</li>
 
-    <li><a href="/philosophy/kind-communication.html">
-    The GNU Kind Communication Guidelines</a>;</li>
-
     <li>The
-    <a href="https://www.gnu.org/software/trans-coord/manual/cvs/";>
-    full reference manual</a> of our CVS;</li>
+    <a href="/software/trans-coord/manual/cvs/">reference manual</a> of our CVS
+    (also offline by executing <i>info cvs</i>);</li>
 
     <li>Guidelines for
     <a href="/server/standards/README.editors.html">Web Page Creation</a> at
@@ -992,7 +986,7 @@
     administrators</a>, and occasionally by GNU webmasters, to update
     the <code>/*/allgnupkgs.html</code> files in www);</li>
 
-    <li>Here is the <a href="/server/tasks.html">help</a> we need with our
+    <li><a href="/server/tasks.html">How to help</a> with our
     <a href="/server/server.html">web server</a>.</li>
   </ul>
 </li>
@@ -1056,7 +1050,7 @@
 
 <p class="unprintable">Updated:
 <!-- timestamp start -->
-$Date: 2021/01/29 17:08:31 $
+$Date: 2021/02/07 18:38:17 $
 <!-- timestamp end --></p>
 </div>
 </div><!-- for class="inner", starts in the banner include -->