[Laszlo-checkins] r12805 - in openlaszlo/trunk/docs: includes src/xsl

[hqm@openlaszlo.org]

Author: hqm
Date: 2009-02-09 17:56:29 -0800 (Mon, 09 Feb 2009)
New Revision: 12805

Added:
   openlaszlo/trunk/docs/includes/commentwidget.js
Modified:
   openlaszlo/trunk/docs/src/xsl/common-html.xsl
   openlaszlo/trunk/docs/src/xsl/parameters.xsl
Log:
Change 20090209-hqm-Y by hqm at badtzmaru.home on 2009-02-09 20:54:26 EST
    in /Users/hqm/openlaszlo/trunk-clean
    for http://svn.openlaszlo.org/openlaszlo/trunk

Summary: add support for user comments in docs

New Features:

Bugs Fixed:

Technical Reviewer: liorio
QA Reviewer: (pending)
Doc Reviewer: (pending)

Documentation:

Release Notes:

Details:

+ Added new flag in docs/src/xsl/parameters.xsl, show.usercomments

 <!-- Add link for display/submission of user community comments -->
 <xsl:param name="show.usercomments">1</xsl:param>

When enabled, this adds in a user comments link at the bottom of each
doc page, via the common-html.xsl user.footer.content template.

The page docs/includes/commentwidget.js can be configured to point to
the server which supplies the comments. If the server is unavailable,
the comments will silently be omitted from the page.

Tests:

This is will be testable in the docs when the next nightly build of
the docs goes up on labs at
http://labs.openlaszlo.org/trunk-nightly/docs/reference/



Added: openlaszlo/trunk/docs/includes/commentwidget.js


Property changes on: openlaszlo/trunk/docs/includes/commentwidget.js
___________________________________________________________________
Name: svn:mime-type
   + text/plain
Name: svn:eol-style
   + native

Modified: openlaszlo/trunk/docs/src/xsl/common-html.xsl
===================================================================
--- openlaszlo/trunk/docs/src/xsl/common-html.xsl	2009-02-09 23:18:50 UTC (rev 12804)
+++ openlaszlo/trunk/docs/src/xsl/common-html.xsl	2009-02-10 01:56:29 UTC (rev 12805)
@@ -452,6 +452,9 @@
   </xsl:template>
 
   <xsl:template name="user.footer.content">
+    <xsl:if test="$show.usercomments != 0">
+      <script type="text/javascript" src="../includes/commentwidget.js"></script>
+    </xsl:if>
     <hr/>
 <!-- * H_LZ_COPYRIGHT_BEGIN *********************************************** -->
 <p class="copyright">Copyright &#xA9; 2002-2008 <a target="_top"

Modified: openlaszlo/trunk/docs/src/xsl/parameters.xsl
===================================================================
--- openlaszlo/trunk/docs/src/xsl/parameters.xsl	2009-02-09 23:18:50 UTC (rev 12804)
+++ openlaszlo/trunk/docs/src/xsl/parameters.xsl	2009-02-10 01:56:29 UTC (rev 12805)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- * X_LZ_COPYRIGHT_BEGIN ***************************************************
-* Copyright 2001-2008 Laszlo Systems, Inc.  All Rights Reserved.              *
+* Copyright 2001-2009 Laszlo Systems, Inc.  All Rights Reserved.              *
 * Use is subject to license terms.                                            *
 * X_LZ_COPYRIGHT_END ****************************************************** -->
 <xsl:stylesheet
@@ -55,6 +55,9 @@
   <!-- Miscellaneous -->
   <xsl:param name="show.comments">1</xsl:param>
 
+  <!-- Add link for display/submission of user community comments -->
+  <xsl:param name="show.usercomments">1</xsl:param>
+
    <!-- Reference appearance -->
    <xsl:param name="navig.showtitles">1</xsl:param>
    <xsl:param name="suppress.header.navigation">0</xsl:param>