You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@subversion.apache.org by gb...@apache.org on 2013/02/22 00:12:27 UTC

svn commit: r1448847 - in /subversion/site: ./ publish/docs/community-guide/

Author: gbg
Date: Thu Feb 21 23:12:27 2013
New Revision: 1448847

URL: http://svn.apache.org/r1448847
Log:
[[[ 

Add a section to Community Guide describing procedure for obtaining
the source for the Subversion web site.  Addition of navigation links
to new page within community guide.

Add three html files creating one extra page on web site accessible at 
/docs/community-guide/web.html.  Also add README in top level directory
providing link to new web page.

* publish/docs/community-guide/web.html
  (New page): Provide the top-level html page for the new page.

* publish/docs/community-guide/web.toc.html
  (New page): Provide table-of-contents for new page.

* publish/docs/community-guide/web.part.html
  (New page): Provide body text for new page
  (Introduction): Provide brief overview of structure of web pages on 
   subversion site.
  (web_sources): Provide instructions for accessing web sources via
   https or svn.
  (web_mirror): Provide instructions for creating mirror of Subversion
   site with Apache.
  (web_validation): Provide instructions for validating changes.
  (web_patch_creation): Describe format of commit log message for 
   web changes.

* README
  (New file): Provide link to new /docs/community-guide/web.html page.

* publish/docs/community-guide/releasing.html
  (site-content): Add SSI variable pointing to web.html.

* publish/docs/community-guide/issues.html
  (site-content): Add SSI variable pointing to web.html.

* publish/docs/community-guide/guide-nav.html
  (topmenu): Add SSI variable pointing to web.html.

* publish/docs/community-guide/community-guide.html
  (site-content): Add SSI variable pointing to web.html.
  (Table of Contents): Add link to web.toc.html.

* publish/docs/community-guide/conventions.html
  (site-content): Add SSI variable pointing to web.html.

* publish/docs/community-guide/index.html
  (Table of Contents): Add link to web.html.

* publish/docs/community-guide/l10n.html
  (site-content): Add SSI variable pointing to web.html.

* publish/docs/community-guide/mailing-lists.html
  (site-content): Add SSI variable pointing to web.html.

* publish/docs/community-guide/general.html
  (site-content): Add SSI variable pointing to web.html.

* publish/docs/community-guide/roles.html
  (site-content): Add SSI variable pointing to web.html.

* publish/docs/community-guide/debugging.html
  (site-content): Add SSI variable pointing to web.html.

* publish/docs/community-guide/building.html
  (site-content): Add SSI variable pointing to web.html.

Patch by: Gabriela Gibson <gabriela.gibson{_AT_}gmail.com>
]]]

Added:
    subversion/site/README
    subversion/site/publish/docs/community-guide/web.html
    subversion/site/publish/docs/community-guide/web.part.html
    subversion/site/publish/docs/community-guide/web.toc.html
Modified:
    subversion/site/publish/docs/community-guide/building.html
    subversion/site/publish/docs/community-guide/community-guide.html
    subversion/site/publish/docs/community-guide/conventions.html
    subversion/site/publish/docs/community-guide/debugging.html
    subversion/site/publish/docs/community-guide/general.html
    subversion/site/publish/docs/community-guide/guide-nav.html
    subversion/site/publish/docs/community-guide/index.html
    subversion/site/publish/docs/community-guide/issues.html
    subversion/site/publish/docs/community-guide/l10n.html
    subversion/site/publish/docs/community-guide/mailing-lists.html
    subversion/site/publish/docs/community-guide/releasing.html
    subversion/site/publish/docs/community-guide/roles.html

Added: subversion/site/README
URL: http://svn.apache.org/viewvc/subversion/site/README?rev=1448847&view=auto
==============================================================================
--- subversion/site/README (added)
+++ subversion/site/README Thu Feb 21 23:12:27 2013
@@ -0,0 +1,10 @@
+           The Subversion Web Site
+           =======================
+
+(Note: this file is not visible on the Subversion site)
+
+This tree contains the Subversion web site.  The DocumentRoot is pointed
+at the publish/ directory.
+
+A discussion on how to set up a local mirror of the Subversion site is
+available at http://subversion.apache.org/docs/community-guide/web.html
\ No newline at end of file

Modified: subversion/site/publish/docs/community-guide/building.html
URL: http://svn.apache.org/viewvc/subversion/site/publish/docs/community-guide/building.html?rev=1448847&r1=1448846&r2=1448847&view=diff
==============================================================================
--- subversion/site/publish/docs/community-guide/building.html (original)
+++ subversion/site/publish/docs/community-guide/building.html Thu Feb 21 23:12:27 2013
@@ -24,6 +24,7 @@
 <!--#set var="GUIDE_MAILINGLISTS_PAGE"     value="mailing-lists.html" -->
 <!--#set var="GUIDE_RELEASING_PAGE"        value="releasing.html" -->
 <!--#set var="GUIDE_ROLES_PAGE"            value="roles.html" -->
+<!--#set var="GUIDE_WEB_PAGE"              value="web.html" -->
 
 <!--#include virtual="guide-nav.html" -->
 <!--#include virtual="building.part.html" -->

Modified: subversion/site/publish/docs/community-guide/community-guide.html
URL: http://svn.apache.org/viewvc/subversion/site/publish/docs/community-guide/community-guide.html?rev=1448847&r1=1448846&r2=1448847&view=diff
==============================================================================
--- subversion/site/publish/docs/community-guide/community-guide.html (original)
+++ subversion/site/publish/docs/community-guide/community-guide.html Thu Feb 21 23:12:27 2013
@@ -24,6 +24,7 @@
 <!--#set var="GUIDE_MAILINGLISTS_PAGE"     value="" -->
 <!--#set var="GUIDE_RELEASING_PAGE"        value="" -->
 <!--#set var="GUIDE_ROLES_PAGE"            value="" -->
+<!--#set var="GUIDE_WEB_PAGE"              value="" -->
 
 <h1>Subversion Community Guide (aka "HACKING")</h1>
 
@@ -53,6 +54,9 @@ first.</p>
 <li><a href="#debugging">Debugging&nbsp;Subversion</a>
 <!--#include virtual="debugging.toc.html"-->
 </li>
+<li><a href="#web-site-changes">Web&nbsp;Site&nbsp;Changes</a>
+<!--#include virtual="web.toc.html"-->
+</li>
 <li><a href="#mailing-lists">Mailing&nbsp;Lists</a>
 <!--#include virtual="mailing-lists.toc.html"-->
 </li>
@@ -74,6 +78,7 @@ first.</p>
 <!--#include virtual="conventions.part.html"-->
 <!--#include virtual="building.part.html"-->
 <!--#include virtual="debugging.part.html"-->
+<!--#include virtual="web.part.html"-->
 <!--#include virtual="mailing-lists.part.html"-->
 <!--#include virtual="issues.part.html"-->
 <!--#include virtual="releasing.part.html"-->

Modified: subversion/site/publish/docs/community-guide/conventions.html
URL: http://svn.apache.org/viewvc/subversion/site/publish/docs/community-guide/conventions.html?rev=1448847&r1=1448846&r2=1448847&view=diff
==============================================================================
--- subversion/site/publish/docs/community-guide/conventions.html (original)
+++ subversion/site/publish/docs/community-guide/conventions.html Thu Feb 21 23:12:27 2013
@@ -24,6 +24,7 @@
 <!--#set var="GUIDE_MAILINGLISTS_PAGE"     value="mailing-lists.html" -->
 <!--#set var="GUIDE_RELEASING_PAGE"        value="releasing.html" -->
 <!--#set var="GUIDE_ROLES_PAGE"            value="roles.html" -->
+<!--#set var="GUIDE_WEB_PAGE"              value="web.html" -->
 
 <!--#include virtual="guide-nav.html" -->
 <!--#include virtual="conventions.part.html" -->

Modified: subversion/site/publish/docs/community-guide/debugging.html
URL: http://svn.apache.org/viewvc/subversion/site/publish/docs/community-guide/debugging.html?rev=1448847&r1=1448846&r2=1448847&view=diff
==============================================================================
--- subversion/site/publish/docs/community-guide/debugging.html (original)
+++ subversion/site/publish/docs/community-guide/debugging.html Thu Feb 21 23:12:27 2013
@@ -24,6 +24,7 @@
 <!--#set var="GUIDE_MAILINGLISTS_PAGE"     value="mailing-lists.html" -->
 <!--#set var="GUIDE_RELEASING_PAGE"        value="releasing.html" -->
 <!--#set var="GUIDE_ROLES_PAGE"            value="roles.html" -->
+<!--#set var="GUIDE_WEB_PAGE"              value="web.html" -->
 
 <!--#include virtual="guide-nav.html" -->
 <!--#include virtual="debugging.part.html" -->

Modified: subversion/site/publish/docs/community-guide/general.html
URL: http://svn.apache.org/viewvc/subversion/site/publish/docs/community-guide/general.html?rev=1448847&r1=1448846&r2=1448847&view=diff
==============================================================================
--- subversion/site/publish/docs/community-guide/general.html (original)
+++ subversion/site/publish/docs/community-guide/general.html Thu Feb 21 23:12:27 2013
@@ -24,6 +24,7 @@
 <!--#set var="GUIDE_MAILINGLISTS_PAGE"     value="mailing-lists.html" -->
 <!--#set var="GUIDE_RELEASING_PAGE"        value="releasing.html" -->
 <!--#set var="GUIDE_ROLES_PAGE"            value="roles.html" -->
+<!--#set var="GUIDE_WEB_PAGE"              value="web.html" -->
 
 <!--#include virtual="guide-nav.html" -->
 <!--#include virtual="general.part.html" -->

Modified: subversion/site/publish/docs/community-guide/guide-nav.html
URL: http://svn.apache.org/viewvc/subversion/site/publish/docs/community-guide/guide-nav.html?rev=1448847&r1=1448846&r2=1448847&view=diff
==============================================================================
--- subversion/site/publish/docs/community-guide/guide-nav.html (original)
+++ subversion/site/publish/docs/community-guide/guide-nav.html Thu Feb 21 23:12:27 2013
@@ -8,6 +8,7 @@
 <li><a href="/docs/community-guide/conventions.html">Coding&nbsp;and&nbsp;Commit&nbsp;Conventions</a></li>
 <li><a href="/docs/community-guide/building.html">Building&nbsp;and&nbsp;Testing</a></li>
 <li><a href="/docs/community-guide/debugging.html">Debugging&nbsp;Subversion</a></li>
+<li><a href="/docs/community-guide/web.html">Web&nbsp;Site&nbsp;Changes</a></li>
 <li><a href="/docs/community-guide/mailing-lists.html">Mailing&nbsp;Lists</a></li>
 <li><a href="/docs/community-guide/issues.html">Bugs/Issues</a></li>
 <li><a href="/docs/community-guide/releasing.html">Making&nbsp;Subversion&nbsp;Releases</a></li>

Modified: subversion/site/publish/docs/community-guide/index.html
URL: http://svn.apache.org/viewvc/subversion/site/publish/docs/community-guide/index.html?rev=1448847&r1=1448846&r2=1448847&view=diff
==============================================================================
--- subversion/site/publish/docs/community-guide/index.html (original)
+++ subversion/site/publish/docs/community-guide/index.html Thu Feb 21 23:12:27 2013
@@ -44,6 +44,9 @@ first.</p>
 <li><a href="debugging.html">Debugging&nbsp;Subversion</a>
 <!--#include virtual="debugging.toc.html"-->
 </li>
+<li><a href="web.html">Web&nbsp;Site&nbsp;Changes</a>
+<!--#include virtual="web.toc.html"-->
+</li>
 <li><a href="mailing-lists.html">Mailing&nbsp;Lists</a>
 <!--#include virtual="mailing-lists.toc.html"-->
 </li>

Modified: subversion/site/publish/docs/community-guide/issues.html
URL: http://svn.apache.org/viewvc/subversion/site/publish/docs/community-guide/issues.html?rev=1448847&r1=1448846&r2=1448847&view=diff
==============================================================================
--- subversion/site/publish/docs/community-guide/issues.html (original)
+++ subversion/site/publish/docs/community-guide/issues.html Thu Feb 21 23:12:27 2013
@@ -24,6 +24,7 @@
 <!--#set var="GUIDE_MAILINGLISTS_PAGE"     value="mailing-lists.html" -->
 <!--#set var="GUIDE_RELEASING_PAGE"        value="releasing.html" -->
 <!--#set var="GUIDE_ROLES_PAGE"            value="roles.html" -->
+<!--#set var="GUIDE_WEB_PAGE"              value="web.html" -->
 
 <!--#include virtual="guide-nav.html" -->
 <!--#include virtual="issues.part.html" -->

Modified: subversion/site/publish/docs/community-guide/l10n.html
URL: http://svn.apache.org/viewvc/subversion/site/publish/docs/community-guide/l10n.html?rev=1448847&r1=1448846&r2=1448847&view=diff
==============================================================================
--- subversion/site/publish/docs/community-guide/l10n.html (original)
+++ subversion/site/publish/docs/community-guide/l10n.html Thu Feb 21 23:12:27 2013
@@ -24,6 +24,7 @@
 <!--#set var="GUIDE_MAILINGLISTS_PAGE"     value="mailing-lists.html" -->
 <!--#set var="GUIDE_RELEASING_PAGE"        value="releasing.html" -->
 <!--#set var="GUIDE_ROLES_PAGE"            value="roles.html" -->
+<!--#set var="GUIDE_WEB_PAGE"              value="web.html" -->
 
 <!--#include virtual="guide-nav.html" -->
 <!--#include virtual="l10n.part.html" -->

Modified: subversion/site/publish/docs/community-guide/mailing-lists.html
URL: http://svn.apache.org/viewvc/subversion/site/publish/docs/community-guide/mailing-lists.html?rev=1448847&r1=1448846&r2=1448847&view=diff
==============================================================================
--- subversion/site/publish/docs/community-guide/mailing-lists.html (original)
+++ subversion/site/publish/docs/community-guide/mailing-lists.html Thu Feb 21 23:12:27 2013
@@ -24,6 +24,7 @@
 <!--#set var="GUIDE_MAILINGLISTS_PAGE"     value="mailing-lists.html" -->
 <!--#set var="GUIDE_RELEASING_PAGE"        value="releasing.html" -->
 <!--#set var="GUIDE_ROLES_PAGE"            value="roles.html" -->
+<!--#set var="GUIDE_WEB_PAGE"              value="web.html" -->
 
 <!--#include virtual="guide-nav.html" -->
 <!--#include virtual="mailing-lists.part.html" -->

Modified: subversion/site/publish/docs/community-guide/releasing.html
URL: http://svn.apache.org/viewvc/subversion/site/publish/docs/community-guide/releasing.html?rev=1448847&r1=1448846&r2=1448847&view=diff
==============================================================================
--- subversion/site/publish/docs/community-guide/releasing.html (original)
+++ subversion/site/publish/docs/community-guide/releasing.html Thu Feb 21 23:12:27 2013
@@ -24,6 +24,7 @@
 <!--#set var="GUIDE_MAILINGLISTS_PAGE"     value="mailing-lists.html" -->
 <!--#set var="GUIDE_RELEASING_PAGE"        value="releasing.html" -->
 <!--#set var="GUIDE_ROLES_PAGE"            value="roles.html" -->
+<!--#set var="GUIDE_WEB_PAGE"              value="web.html" -->
 
 <!--#include virtual="guide-nav.html" -->
 <!--#include virtual="releasing.part.html" -->

Modified: subversion/site/publish/docs/community-guide/roles.html
URL: http://svn.apache.org/viewvc/subversion/site/publish/docs/community-guide/roles.html?rev=1448847&r1=1448846&r2=1448847&view=diff
==============================================================================
--- subversion/site/publish/docs/community-guide/roles.html (original)
+++ subversion/site/publish/docs/community-guide/roles.html Thu Feb 21 23:12:27 2013
@@ -24,6 +24,7 @@
 <!--#set var="GUIDE_MAILINGLISTS_PAGE"     value="mailing-lists.html" -->
 <!--#set var="GUIDE_RELEASING_PAGE"        value="releasing.html" -->
 <!--#set var="GUIDE_ROLES_PAGE"            value="roles.html" -->
+<!--#set var="GUIDE_WEB_PAGE"              value="web.html" -->
 
 <!--#include virtual="guide-nav.html" -->
 <!--#include virtual="roles.part.html" -->

Added: subversion/site/publish/docs/community-guide/web.html
URL: http://svn.apache.org/viewvc/subversion/site/publish/docs/community-guide/web.html?rev=1448847&view=auto
==============================================================================
--- subversion/site/publish/docs/community-guide/web.html (added)
+++ subversion/site/publish/docs/community-guide/web.html Thu Feb 21 23:12:27 2013
@@ -0,0 +1,34 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 
+   "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+<title>Apache Subversion - Community Guide - Making Changes to the Web Site</title>
+<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
+<style type="text/css">
+  @import url("/style/site.css");
+</style>
+</head>
+
+<body>
+<!--#include virtual="/site-banner.html" -->
+<!--#include virtual="/site-nav.html" -->
+<div id="site-content">
+<!--#include virtual="/site-notice.html" -->
+
+<!--#set var="GUIDE_BUILDING_PAGE"         value="building.html" -->
+<!--#set var="GUIDE_CONVENTIONS_PAGE"      value="conventions.html" -->
+<!--#set var="GUIDE_DEBUGGING_PAGE"        value="debugging.html" -->
+<!--#set var="GUIDE_GENERAL_PAGE"          value="general.html" -->
+<!--#set var="GUIDE_ISSUES_PAGE"           value="issues.html" -->
+<!--#set var="GUIDE_L10N_PAGE"             value="l10n.html" -->
+<!--#set var="GUIDE_MAILINGLISTS_PAGE"     value="mailing-lists.html" -->
+<!--#set var="GUIDE_RELEASING_PAGE"        value="releasing.html" -->
+<!--#set var="GUIDE_ROLES_PAGE"            value="roles.html" -->
+<!--#set var="GUIDE_WEB_CHANGES_PAGE"      value="web.html" -->
+
+<!--#include virtual="guide-nav.html" -->
+<!--#include virtual="web.part.html" -->
+
+</div> <!-- #site-content -->
+</body>
+</html>

Added: subversion/site/publish/docs/community-guide/web.part.html
URL: http://svn.apache.org/viewvc/subversion/site/publish/docs/community-guide/web.part.html?rev=1448847&view=auto
==============================================================================
--- subversion/site/publish/docs/community-guide/web.part.html (added)
+++ subversion/site/publish/docs/community-guide/web.part.html Thu Feb 21 23:12:27 2013
@@ -0,0 +1,185 @@
+<div class="h1" id="web-site-changes">
+<h1>Web Site Changes
+  <a class="sectionlink" 
+     href="<!--#echo var="GUIDE_WEB_PAGE" -->#web-site-changes"
+     title="Link to this section">&para;</a>
+</h1></div> <!-- web-site-changes -->
+
+<!--#include virtual="web.toc.html" -->
+
+<div class="h2" id="web_intro">
+<h2>Introduction
+  <a class="sectionlink" 
+     href="<!--#echo var="GUIDE_WEB_CHANGES_PAGE" -->#web_intro" 
+     title="Link to this section">&para; </a>
+</h2>
+
+<p>The Subversion project welcomes improvements to its web site.
+  However, the process is not as simple as clicking "Save As" in a
+  browser, editing and mailing the change.  For one thing, many pages
+  are actually composed of three or more files so browsers do not save
+  a correctly rendered copy.
+</p>
+<p>
+  Because of this, if you're planning to submit substantial changes,
+  we recommend that you obtain a copy of the sources and set up a
+  testing mirror to check your changes.
+</p>
+<p>
+  Of course, for small changes, simply inspecting the patch visually
+  will often be sufficient.
+</p>
+   
+</div> <!-- web_intro -->
+
+<div class="h2" id="web_sources">
+<h2>Obtaining the web site sources
+  <a class="sectionlink" 
+     href="<!--#echo var="GUIDE_WEB_CHANGES_PAGE" -->#web_sources" 
+     title="Link to this section">&para; </a>
+</h2>
+
+<p>The source to the website is available from a Subversion repository.
+   To browse the sources, go to 
+       <a href="https://svn.apache.org/repos/asf/subversion/site/">
+	 https://svn.apache.org/repos/asf/subversion/site/</a>
+</p>
+<p>To download a copy to <code>~/projects/svn</code>, which is the
+  location used for the rest of this page, use the following commands:
+</p>
+<pre>  mkdir -p ~/projects/svn
+  cd ~/projects/svn
+  svn co https://svn.apache.org/repos/asf/subversion/site/ site</pre>
+
+<p>If you download to another location, you will need to adjust paths
+  in your web server configuration to point there.</p>
+
+</div> <!-- web_sources -->
+
+<div class="h2" id="web_mirror">
+<h2>Setting up a mirror for testing
+  <a class="sectionlink" 
+     href="<!--#echo var="GUIDE_WEB_CHANGES_PAGE" -->#web_mirror" 
+     title="Link to this section">&para;</a>
+</h2>
+
+<p>The Subversion web site uses <i>Server Side Includes (SSI)</i> to
+   assemble pages within the web server.  This means that to validate
+   any changes you might wish to make, you need view the relevant
+   pages through a web browser connected to a server installed on your
+   system, either
+   <a href="http://httpd.apache.org/docs/2.2/install.html">Apache 2.2</a> 
+  or
+   <a href="http://httpd.apache.org/docs/2.4/install.html">Apache 2.4</a>. 
+
+</p>
+
+<p>The following steps should provide an <i>Apache virtualhost</i>
+    that correctly renders a local copy of the Subversion web site on
+    a Unix-type system.  This is likely to be located under
+    <code>/etc/apache2, /etc/httpd</code> or a similiar directory,
+    depending on your system.  These instructions have been tested on
+    Apache 2.2 and Apache 2.4.</p>
+
+<ol>
+   <li>Obtain the web site sources as described in the section above.
+   <br />For the purpose of the following discussion, we will assume
+   that these are in the directory <code>/home/user/projects/svn/site</code></li>
+
+   <li>Configure an Apache server to use the <code>site/publish</code>
+       directory within the working copy mentioned above as DocumentRoot 
+       for either the main server or a VirtualHost.</li>
+
+   <li>Check your Apache server includes <code>mod_include.so</code></li>
+
+   <li>Enable Server Side Includes for the relevant DocumentRoot. The
+       relevant Apache directive is:
+     <pre>Options +Include
+</pre></li>
+
+   <li>Turn on SSI parsing for html files for the relevant DocumentRoot.
+       The relevant Apache directive is:
+     <pre>AddOutputFilter INCLUDE .html
+</pre></li>
+</ol>
+
+<p>Putting it all together, an example VirtualHost configuration is:</p>
+
+<pre>&lt;VirtualHost *:8080&gt;
+        ServerAdmin webmaster@localhost
+
+        DocumentRoot /home/user/projects/svn/site/publish
+        &lt;Directory /&gt;
+                Options +Includes
+                AddOutputFilter INCLUDES .html
+        &lt;/Directory&gt;
+        &lt;Directory /home/user/projects/svn/site/publish/&gt;
+                Options +Includes
+                AddOutputFilter INCLUDES .html
+        &lt;/Directory&gt;
+
+        ErrorLog ${APACHE_LOG_DIR}/error.log
+
+        # Possible values include: debug, info, notice, warn, error, crit,
+        # alert, emerg.
+        LogLevel debug
+
+        CustomLog ${APACHE_LOG_DIR}/access.log combined
+&lt;/VirtualHost&gt;
+</pre>
+
+<p>After restarting or reloading the server, you should see a copy of
+   the <i>Subversion community guide Web Changes</i> page if you use
+   the following link:
+
+  <a href="http://127.0.0.1:8080/docs/community-guide/<!--#echo var="GUIDE_WEB_CHANGES_PAGE" -->#web_mirror">
+<pre>http://127.0.0.1:8080/docs/community-guide/<!--#echo var="GUIDE_WEB_CHANGES_PAGE" -->#web_mirror</pre></a>
+</p>
+
+</div> <!-- web_mirror -->
+
+<div class="h2" id="web_validation">
+<h2>Validating your changes
+  <a class="sectionlink" 
+     href="<!--#echo var="GUIDE_WEB_CHANGES_PAGE" -->#web_validation" 
+     title="Link to this section">&para;</a>
+</h2>
+
+<p>Please validate all patches which make substantial changes to the
+   web site.</p>
+
+<p>If you have set up a mirror of the website as advised on this page,
+use the command line to fetch a correctly rendered copy of the page
+you've changed with
+<pre>wget http://127.0.0.1:8080/docs/community-guide/YOUR_CHANGED_PAGE.html
+</pre>
+</p>
+<p>then upload the resulting file to a HTML validator, for
+example, <a href="http://validator.w3.org/">W3C validator service</a>.
+
+</div> <!-- web_validation -->
+
+<div class="h2" id="web_patch_creation">
+<h2>Creating a patch and a log message
+  <a class="sectionlink" 
+     href="<!--#echo var="GUIDE_WEB_CHANGES_PAGE" -->#web_patch_creation" 
+     title="Link to this section">&para;</a>
+</h2>
+
+<p>
+ When writing log messages for patches regarding the project's web pages, eg:
+</p>
+<pre>http://subversion.apache.org/docs/community-guide/some_page.html#section-name
+</pre>
+<p> list the names of files modified in the patch in the log message,
+ relative to the <code>site/</code> directory and list anchors of
+ sections added or modified like this:
+ <pre>
+ * docs/community-guide/some_page.html
+   (section-name): fixed issue xyz
+</pre>
+<p>For a full discussion of the Subversion patch requirements, please 
+  follow the project 
+  <a href="<!--#echo var="GUIDE_GENERAL_PAGE" -->#patches">general patch guidelines</a>
+  and
+  <a href="<!--#echo var="GUIDE_CONVENTIONS_PAGE" -->#log-messages">log message guidelines</a>.</p>

Added: subversion/site/publish/docs/community-guide/web.toc.html
URL: http://svn.apache.org/viewvc/subversion/site/publish/docs/community-guide/web.toc.html?rev=1448847&view=auto
==============================================================================
--- subversion/site/publish/docs/community-guide/web.toc.html (added)
+++ subversion/site/publish/docs/community-guide/web.toc.html Thu Feb 21 23:12:27 2013
@@ -0,0 +1,18 @@
+<!--#if expr='"$DOCUMENT_NAME" = "web.html" || "$DOCUMENT_NAME" = "community-guide.html"' -->
+<ul>
+  <li><a href="#web_intro">Introduction</a></li>
+  <li><a href="#web_sources">Obtaining the web site source</a></li>
+  <li><a href="#web_mirror">Setting up a mirror for testing</a></li>
+  <li><a href="#web_validation">Validating your changes</a></li>
+  <li><a href="#web_patch_creation">Creating a patch and a log message</a></li>
+</ul>
+<!--#else -->
+<ul>
+  <li><a href="web.html#web_intro">Introduction</a></li>
+  <li><a href="web.html#web_sources">Obtaining the web site source</a></li>
+  <li><a href="web.html#web_mirror">Setting up a mirror for testing</a></li>
+  <li><a href="web.html#web_validation">Validating your changes</a></li>
+  <li><a href="web.html#web_patch_creation">Creating a patch and a log message</a></li>
+</ul>
+<!--#endif -->
+



Re: svn commit: r1448847 - in /subversion/site: ./ publish/docs/community-guide/

Posted by Gabriela Gibson <ga...@gmail.com>.
On 21/02/13 23:18, Daniel Shahaf wrote:
> On Thu, Feb 21, 2013 at 11:12:27PM -0000, gbg@apache.org wrote:
>> Patch by: Gabriela Gibson <gabriela.gibson{_AT_}gmail.com>
>
> Also, please add an "Approved by: danielsh" tag, and add yourself to
> trunk/COMMITTERS.
>
Almost all done(rest happens tomorrow), thank you very much for all the 
help! :)


Re: svn commit: r1448847 - in /subversion/site: ./ publish/docs/community-guide/

Posted by Gabriela Gibson <ga...@gmail.com>.
On 21/02/13 23:18, Daniel Shahaf wrote:
> On Thu, Feb 21, 2013 at 11:12:27PM -0000, gbg@apache.org wrote:
>> Patch by: Gabriela Gibson <gabriela.gibson{_AT_}gmail.com>
>
> Also, please add an "Approved by: danielsh" tag, and add yourself to
> trunk/COMMITTERS.
>
Almost all done(rest happens tomorrow), thank you very much for all the 
help! :)


Re: svn commit: r1448847 - in /subversion/site: ./ publish/docs/community-guide/

Posted by Daniel Shahaf <da...@apache.org>.
On Thu, Feb 21, 2013 at 11:12:27PM -0000, gbg@apache.org wrote:
> Patch by: Gabriela Gibson <gabriela.gibson{_AT_}gmail.com>

Also, please add an "Approved by: danielsh" tag, and add yourself to
trunk/COMMITTERS.

Re: svn commit: r1448847 - in /subversion/site: ./ publish/docs/community-guide/

Posted by Daniel Shahaf <da...@apache.org>.
On Thu, Feb 21, 2013 at 11:12:27PM -0000, gbg@apache.org wrote:
> Patch by: Gabriela Gibson <gabriela.gibson{_AT_}gmail.com>

Also, please add an "Approved by: danielsh" tag, and add yourself to
trunk/COMMITTERS.

Re: svn commit: r1448847 - in /subversion/site: ./ publish/docs/community-guide/

Posted by Daniel Shahaf <da...@apache.org>.
On Thu, Feb 21, 2013 at 11:12:27PM -0000, gbg@apache.org wrote:
> Log:
> [[[ 
> 

You should have removed the [[[..]]] before committing.  Please fix.

> Add a section to Community Guide describing procedure for obtaining
> the source for the Subversion web site.  Addition of navigation links
> to new page within community guide.
> 

And while you're there, you might as well s/Addition/Add/ in the second line.


Thanks,

Daniel

Re: svn commit: r1448847 - in /subversion/site: ./ publish/docs/community-guide/

Posted by Daniel Shahaf <da...@apache.org>.
On Thu, Feb 21, 2013 at 11:12:27PM -0000, gbg@apache.org wrote:
> Log:
> [[[ 
> 

You should have removed the [[[..]]] before committing.  Please fix.

> Add a section to Community Guide describing procedure for obtaining
> the source for the Subversion web site.  Addition of navigation links
> to new page within community guide.
> 

And while you're there, you might as well s/Addition/Add/ in the second line.


Thanks,

Daniel