[Boost-commit] svn:boost r40533 - in website/public_html/beta: . development

From: grafikrobot_at_[hidden]
Date: 2007-10-28 13:17:40

Author: grafik
Date: 2007-10-28 13:17:39 EDT (Sun, 28 Oct 2007)
New Revision: 40533
URL: http://svn.boost.org/trac/boost/changeset/40533

Log:
Add instructions for updating feeds.
Text files modified: 
   website/public_html/beta/boost-build.jam                   |    48 +++++++++++++++++++++++++++++-----      
   website/public_html/beta/development/website_updating.html |    55 ++++++++++++++++++++++++++++++++++++--- 
   website/public_html/beta/project-root.jam                  |    22 ++++++++++++++-                         
   3 files changed, 110 insertions(+), 15 deletions(-)

Modified: website/public_html/beta/boost-build.jam
==============================================================================
--- website/public_html/beta/boost-build.jam	(original)
+++ website/public_html/beta/boost-build.jam	2007-10-28 13:17:39 EDT (Sun, 28 Oct 2007)
@@ -1,11 +1,43 @@
-# Copyright 2006 Rene Rivera
+# Copyright Rene Rivera 2007.
+#
 # Distributed under the Boost Software License, Version 1.0.
-# (See accompanying file LICENSE_1_0.txt or http://www.boost.org/LICENSE_1_0.txt)
+#    (See accompanying file LICENSE_1_0.txt or copy at
+#          http://www.boost.org/LICENSE_1_0.txt)
 
-# Set the BOOST_ROOT environment variable on your command-line or in the
-# environment to point at the root of your regular Boost installation. Or
-# set the BOOST_BUILD environment variable to point to a Boost.Build V2
-# installation.
+# For instructions see project-root.jam, or "bjam --help".
 
-BOOST_BUILD ?= $(BOOST_ROOT)/tools/build/v2 ;
-boost-build $(BOOST_BUILD) ;
+local rule if-has-file ( file + : dir * )
+{
+    local result ;
+    if $(dir)
+    {
+        result = [ GLOB $(dir) : $(file) ] ;
+    }
+    return $(result[1]:P) ;
+}
+
+#~ Attempts to find the Boost source tree...
+
+local boost-src = [ if-has-file configure :
+    [ MATCH --boost=(.*) : $(ARGV) ]
+    $(BOOST)
+    $(.boost-build-file:D)/../boost
+    ] ;
+
+#~ Attempts to find the Boost.Build files...
+
+local boost-build-src = [ if-has-file bootstrap.jam :
+    [ MATCH --boost-build=(.*) : $(ARGV) ]
+    $(BOOST_BUILD_PATH)
+    $(BOOST_BUILD)
+    $(boost-src)/tools/build/v2
+    ] ;
+
+#~ Set some common vars to refer to the Boost sources...
+
+BOOST ?= $(boost-src) ;
+BOOST_ROOT ?= $(boost-src) ;
+
+#~ And load up Boost.Build...
+
+boost-build $(boost-build-src) ;

Modified: website/public_html/beta/development/website_updating.html
==============================================================================
--- website/public_html/beta/development/website_updating.html	(original)
+++ website/public_html/beta/development/website_updating.html	2007-10-28 13:17:39 EDT (Sun, 28 Oct 2007)
@@ -26,7 +26,20 @@
             </div>
 
             <div class="section-body">
-              <h2>Getting Content</h2>
+              <ul class="toc">
+                <li>Getting Content</li>
+
+                <li>Existing Page</li>
+
+                <li>New Page</li>
+
+                <li>Menus, Sidebars, and Index</li>
+
+                <li>Feeds</li>
+              </ul>
+
+              <h2><a name="GettingContent" id="GettingContent"></a>Getting
+              Content</h2>
 
               <p>The website content lives in the <a href=
               "http://svn.boost.org">Boost Subversion repository</a>. To get
@@ -41,7 +54,8 @@
 svn co https://svn.boost.org/svn/boost/website/public_html/live
 </pre>
 
-              <h2>Existing Page</h2>
+              <h2><a name="ExistingPage" id="ExistingPage"></a>Existing
+              Page</h2>
 
               <p>The web content is structured to be as simple as possible to
               make generic editing possible. At minimum only a text editor
@@ -121,7 +135,7 @@
                 </tr>
               </table>
 
-              <h2>New Page</h2>
+              <h2><a name="NewPage" id="NewPage"></a>New Page</h2>
 
               <p>To make adding new pages easier there is a <a href=
               "http://svn.boost.org/svn/boost/website/workplace/template.html">
@@ -244,7 +258,8 @@
               needs to add an entry to the page so it can be accessed from
               the sidebar and index. See below...</p>
 
-              <h2>Menus, Sidebars, and Index</h2>
+              <h2><a name="Menus" id="Menus"></a>Menus, Sidebars, and
+              Index</h2>
 
               <p>The various navigation elements are structured to make
               adding new entries easy and to keep all places where wuch
@@ -267,6 +282,36 @@
 
                 <li>Documentation: <tt>/common/menu-doc.html</tt></li>
               </ul>
+
+              <h2><a name="Feeds" id="Feeds"></a>Feeds</h2>
+
+              <p>There are various section of the web site that correspond to
+              RSS feeds: news, downloads, and the version history. Even
+              though they are displayed in various locations on the site the
+              source feed documents are in the <tt>/feed</tt> directory. The
+              content is not directly editable, but instead is generated from
+              source Quickbook documents. For example to add a news item one
+              would:</p>
+
+              <ol>
+                <li>Create a new file in the <tt>/feed/news</tt> directory,
+                say <tt>/feed/news/gui_review_ends.qbk</tt>.</li>
+
+                <li>In a shell, go to the <tt>/feed</tt> directory, and run
+                <tt>bjam --boost-build=/path/to/tools/build/v2</tt>, or
+                <tt>bjam --boost=/path/to/boost-root</tt>. This will generate
+                the BoostBook XML for the new news item and regenerate the
+                <tt>/feed/news.rss</tt> file.</li>
+
+                <li>Add the new files to the SVN repository, and commit.</li>
+              </ol>
+
+              <p>The same procedure applies to the other feeds, but keep in
+              mind that some feeds may combine entries from more than one
+              feed subdirectory. Currently this requires Quickbook be
+              precompiled and preconfigured in your <tt>user-config.jam</tt>.
+              And also requires Python, in the path, to do the BoostBook to
+              RSS translation.</p>
             </div>
           </div>
         </div>
@@ -288,7 +333,7 @@
       </div>
 
       <div id="copyright">
-        <p>Copyright Rene Rivera 2006.</p>
+        <p>Copyright Rene Rivera 2006-2007.</p>
       </div><!--#include virtual="/common/footer-license.html" -->
     </div>
 

Modified: website/public_html/beta/project-root.jam
==============================================================================
--- website/public_html/beta/project-root.jam	(original)
+++ website/public_html/beta/project-root.jam	2007-10-28 13:17:39 EDT (Sun, 28 Oct 2007)
@@ -1,3 +1,21 @@
-# Copyright 2006 Rene Rivera
+# Copyright Rene Rivera 2007.
+#
 # Distributed under the Boost Software License, Version 1.0.
-# (See accompanying file LICENSE_1_0.txt or http://www.boost.org/LICENSE_1_0.txt)
+#    (See accompanying file LICENSE_1_0.txt or copy at
+#          http://www.boost.org/LICENSE_1_0.txt)
+
+# Usage:
+#
+#   bjam [options | properties | targets]
+#
+# Options:
+#
+#   --boost=<BOOST>         The directotory of a Boost source tree.
+#                           Default; BOOST env var (if found)
+#                           Default; ../boost (if found)
+#
+#   --boost-build=<BOOST_BUILD>
+#                           The directory for the Boost.Build v2 files.
+#                           Default; BOOST_BUILD_PATH env var (if found)
+#                           Default; BOOST_BUILD env var (if found)
+#                           Default; <BOOST>/tools/build/v2 (if found)