You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by rj...@apache.org on 2012/12/15 23:25:14 UTC

svn commit: r1422392 - in /tomcat/tc7.0.x/trunk: ./ webapps/docs/ webapps/docs/appdev/ webapps/docs/architecture/ webapps/docs/config/ webapps/docs/funcspecs/ webapps/docs/tribes/

Author: rjung
Date: Sat Dec 15 22:25:12 2012
New Revision: 1422392

URL: http://svn.apache.org/viewvc?rev=1422392&view=rev
Log:
Add user comments system to docs.

Backport of r1417476 from trunk.

Added:
    tomcat/tc7.0.x/trunk/webapps/docs/comments.xml
      - copied unchanged from r1417476, tomcat/trunk/webapps/docs/comments.xml
Modified:
    tomcat/tc7.0.x/trunk/   (props changed)
    tomcat/tc7.0.x/trunk/webapps/docs/appdev/project.xml
    tomcat/tc7.0.x/trunk/webapps/docs/architecture/project.xml
    tomcat/tc7.0.x/trunk/webapps/docs/config/project.xml
    tomcat/tc7.0.x/trunk/webapps/docs/funcspecs/project.xml
    tomcat/tc7.0.x/trunk/webapps/docs/project.xml
    tomcat/tc7.0.x/trunk/webapps/docs/tomcat-docs.xsl
    tomcat/tc7.0.x/trunk/webapps/docs/tribes/project.xml

Propchange: tomcat/tc7.0.x/trunk/
------------------------------------------------------------------------------
  Merged /tomcat/trunk:r1417476

Modified: tomcat/tc7.0.x/trunk/webapps/docs/appdev/project.xml
URL: http://svn.apache.org/viewvc/tomcat/tc7.0.x/trunk/webapps/docs/appdev/project.xml?rev=1422392&r1=1422391&r2=1422392&view=diff
==============================================================================
--- tomcat/tc7.0.x/trunk/webapps/docs/appdev/project.xml (original)
+++ tomcat/tc7.0.x/trunk/webapps/docs/appdev/project.xml Sat Dec 15 22:25:12 2012
@@ -31,6 +31,7 @@
         <item name="Docs Home"             href="../index.html"/>
         <item name="App Dev Guide Home"    href="index.html"/>
         <item name="FAQ"                   href="http://wiki.apache.org/tomcat/FAQ" />
+        <item name="User Comments"         href="#comments_section"/>
     </menu>
 
     <menu name="Contents">

Modified: tomcat/tc7.0.x/trunk/webapps/docs/architecture/project.xml
URL: http://svn.apache.org/viewvc/tomcat/tc7.0.x/trunk/webapps/docs/architecture/project.xml?rev=1422392&r1=1422391&r2=1422392&view=diff
==============================================================================
--- tomcat/tc7.0.x/trunk/webapps/docs/architecture/project.xml (original)
+++ tomcat/tc7.0.x/trunk/webapps/docs/architecture/project.xml Sat Dec 15 22:25:12 2012
@@ -31,6 +31,7 @@
         <item name="Docs Home"             href="../index.html" />
         <item name="Architecture Home"     href="index.html"/>
         <item name="FAQ"                   href="http://wiki.apache.org/tomcat/FAQ" />
+        <item name="User Comments"         href="#comments_section"/>
     </menu>
 
     <menu name="Contents">

Modified: tomcat/tc7.0.x/trunk/webapps/docs/config/project.xml
URL: http://svn.apache.org/viewvc/tomcat/tc7.0.x/trunk/webapps/docs/config/project.xml?rev=1422392&r1=1422391&r2=1422392&view=diff
==============================================================================
--- tomcat/tc7.0.x/trunk/webapps/docs/config/project.xml (original)
+++ tomcat/tc7.0.x/trunk/webapps/docs/config/project.xml Sat Dec 15 22:25:12 2012
@@ -31,6 +31,7 @@
         <item name="Docs Home"             href="../index.html"/>
         <item name="Config Ref. Home"      href="index.html"/>
         <item name="FAQ"                   href="http://wiki.apache.org/tomcat/FAQ" />
+        <item name="User Comments"         href="#comments_section"/>
     </menu>
 
     <menu name="Top Level Elements">

Modified: tomcat/tc7.0.x/trunk/webapps/docs/funcspecs/project.xml
URL: http://svn.apache.org/viewvc/tomcat/tc7.0.x/trunk/webapps/docs/funcspecs/project.xml?rev=1422392&r1=1422391&r2=1422392&view=diff
==============================================================================
--- tomcat/tc7.0.x/trunk/webapps/docs/funcspecs/project.xml (original)
+++ tomcat/tc7.0.x/trunk/webapps/docs/funcspecs/project.xml Sat Dec 15 22:25:12 2012
@@ -30,6 +30,7 @@
         <item name="Docs Home"             href="../index.html"/>
         <item name="Functional Specs"      href="index.html"/>
         <item name="FAQ"                   href="http://wiki.apache.org/tomcat/FAQ" />
+        <item name="User Comments"         href="#comments_section"/>
     </menu>
 
     <menu name="Administrative Apps">

Modified: tomcat/tc7.0.x/trunk/webapps/docs/project.xml
URL: http://svn.apache.org/viewvc/tomcat/tc7.0.x/trunk/webapps/docs/project.xml?rev=1422392&r1=1422391&r2=1422392&view=diff
==============================================================================
--- tomcat/tc7.0.x/trunk/webapps/docs/project.xml (original)
+++ tomcat/tc7.0.x/trunk/webapps/docs/project.xml Sat Dec 15 22:25:12 2012
@@ -30,6 +30,7 @@
     <menu name="Links">
         <item name="Docs Home"             href="index.html"/>
         <item name="FAQ"                   href="http://wiki.apache.org/tomcat/FAQ" />
+        <item name="User Comments"         href="#comments_section"/>
     </menu>
 
     <menu name="User Guide">

Modified: tomcat/tc7.0.x/trunk/webapps/docs/tomcat-docs.xsl
URL: http://svn.apache.org/viewvc/tomcat/tc7.0.x/trunk/webapps/docs/tomcat-docs.xsl?rev=1422392&r1=1422391&r2=1422392&view=diff
==============================================================================
--- tomcat/tc7.0.x/trunk/webapps/docs/tomcat-docs.xsl (original)
+++ tomcat/tc7.0.x/trunk/webapps/docs/tomcat-docs.xsl Sat Dec 15 22:25:12 2012
@@ -61,6 +61,7 @@
   <xsl:variable name="attributes-color" select="'#023264'"/>
   <xsl:variable name="table-th-bg"      select="'#039acc'"/>
   <xsl:variable name="table-td-bg"      select="'#a0ddf0'"/>
+  <xsl:variable name="commentslink">/<xsl:value-of select="$sitedir"/>comments.html</xsl:variable>
 
   <!-- Process an entire document into an HTML page -->
   <xsl:template match="document">
@@ -172,6 +173,53 @@
 
       </tr>
 
+      <tr class="noPrint">
+
+        <td width="20%" valign="top" nowrap="nowrap" class="noPrint">
+        </td>
+        <td width="80%" valign="top" align="left">
+          <table border="0" cellspacing="0" cellpadding="2">
+            <!-- Comment heading -->
+            <tr><td bgcolor="{$banner-bg}">
+                <font color="{$banner-fg}" face="arial,helvetica.sanserif">
+                <a name="comments_section" id="comments_section"><strong>Comments</strong></a></font>
+              </td>
+            </tr>
+            <!-- Comment body -->
+            <tr><td>
+            <blockquote>
+            <p class="notice">
+              <strong>Notice: </strong>This is not a Q&amp;A section.
+              The Apache Comments System is explained
+              <a href="{$commentslink}">here</a>.
+              Comments should be pointed towards suggestions on improving the documentation
+              or server, and may be removed again by our moderators if they are either
+              implemented or considered invalid/off-topic.
+              Questions on how to manage Apache Tomcat should be directed
+              to our <a href="http://tomcat.apache.org/lists.html">mailing lists</a>.</p>
+              <script type="text/javascript">
+              <xsl:text disable-output-escaping="yes"><![CDATA[<!--//--><![CDATA[//><!--
+              var comments_shortname = 'tomcat';
+              var comments_identifier = 'http://tomcat.apache.org/]]></xsl:text><xsl:value-of select="$sitedir"/><xsl:value-of select="$subdir"/><xsl:value-of select="substring($filename,1,string-length($filename)-4)"/><xsl:text disable-output-escaping="yes"><![CDATA[.html';
+              (function(w, d) {
+                  if (w.location.hostname.toLowerCase() == "tomcat.apache.org") {
+                      d.write('<div id="comments_thread"><\/div>');
+                      var s = d.createElement('script');
+                      s.type = 'text/javascript';
+                      s.async = true;
+                      s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
+                      (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
+                  }
+                  else {
+                      d.write('<div id="comments_thread"><strong>Comments are disabled for this page at the moment.</strong><\/div>');
+                  }
+              })(window, document);
+              //--><!]]]]>></xsl:text></script>
+            </blockquote></td></tr>
+          </table>
+        </td>
+      </tr>
+
       <xsl:comment>FOOTER SEPARATOR</xsl:comment>
       <tr>
         <td colspan="2">

Modified: tomcat/tc7.0.x/trunk/webapps/docs/tribes/project.xml
URL: http://svn.apache.org/viewvc/tomcat/tc7.0.x/trunk/webapps/docs/tribes/project.xml?rev=1422392&r1=1422391&r2=1422392&view=diff
==============================================================================
--- tomcat/tc7.0.x/trunk/webapps/docs/tribes/project.xml (original)
+++ tomcat/tc7.0.x/trunk/webapps/docs/tribes/project.xml Sat Dec 15 22:25:12 2012
@@ -29,6 +29,7 @@
         <item name="Docs Home"             href="../index.html"/>
         <item name="Tribes Docs Home"      href="index.html"/>
         <item name="FAQ"                   href="http://wiki.apache.org/tomcat/FAQ" />
+        <item name="User Comments"         href="#comments_section"/>
     </menu>
 
     <menu name="User Guide">



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org