forrest-svn mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cross...@apache.org
Subject svn commit: r613043 - in /forrest/trunk/site-author/content/xdocs: docs_0_80/faq.xml docs_0_80/upgrading_08.xml docs_0_90/faq.xml
Date Fri, 18 Jan 2008 02:41:44 GMT
Author: crossley
Date: Thu Jan 17 18:41:41 2008
New Revision: 613043

URL: http://svn.apache.org/viewvc?rev=613043&view=rev
Log:
Explain that "wholesite" aggregation is broken in forrest-0.8 by no linkmap handling. FOR-733.
Mention that there are also other issues.
Add "wholesite" to list of claimed patterns.

Modified:
    forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml
    forrest/trunk/site-author/content/xdocs/docs_0_80/upgrading_08.xml
    forrest/trunk/site-author/content/xdocs/docs_0_90/faq.xml

Modified: forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml?rev=613043&r1=613042&r2=613043&view=diff
==============================================================================
--- forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml (original)
+++ forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml Thu Jan 17 18:41:41 2008
@@ -329,7 +329,9 @@
       <question>How can I generate one pdf-file out of the whole site or selected pages
of the site?</question>
       <answer>
         <p>
-          Add the following entries to your site.xml file:
+          Add the following entries to your site.xml file.
+          Note that the href must be exactly "wholesite" or "site" which triggers
+          a special match in the sitemap to aggregate all documents.
         </p>
         <source>
 <![CDATA[
@@ -342,14 +344,23 @@
         </source>
         <p>
           In this case the menu labeled "About" will have 2 new items: "Full
-          PDF" and "Full HTML". (See also <link href="site:pdf-tab">How to
-          create a PDF document for each tab</link>.)
+          PDF" and "Full HTML".
+        </p>
+        <p>
+          See also <link href="site:pdf-tab">How to
+          create a PDF document for each tab</link>.
         </p>
         <p>
           This assumes that you use the
           <link href="site:linking">site.xml</link> method for your site
           structure and navigation, rather than the old book.xml method.
         </p>
+        <warning>
+          There are many issues with the "wholesite" aggregation. Search the
+          issue tracker and mail lists.
+          The main issue is for Forrest-0.8 and the new locationmap
+          (<link href="http://issues.apache.org/jira/browse/FOR-733">FOR-733</link>).
+        </warning>
       </answer>
     </faq>
     <faq id="pageBreaks">
@@ -930,7 +941,7 @@
       <answer>
         <p>
           Certain patterns are claimed by the default sitemaps for special
-          processing. These reserved words include: <code>site, changes, todo,
+          processing. These reserved words include: <code>site, wholesite, changes,
todo,
           faq, images, my-images, skinconf, community, howto</code>
         </p>
         <p>

Modified: forrest/trunk/site-author/content/xdocs/docs_0_80/upgrading_08.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/docs_0_80/upgrading_08.xml?rev=613043&r1=613042&r2=613043&view=diff
==============================================================================
--- forrest/trunk/site-author/content/xdocs/docs_0_80/upgrading_08.xml (original)
+++ forrest/trunk/site-author/content/xdocs/docs_0_80/upgrading_08.xml Thu Jan 17 18:41:41
2008
@@ -177,6 +177,12 @@
         See <a href="http://issues.apache.org/jira/browse/FOR-1015">FOR-1015</a>.
       </p>
     </section>
+    <section id="wholesite">
+      <title>The "wholesite" aggregation is not functioning</title>
+      <p>
+        See notes in the <a href="site:faq">FAQ</a> about "wholesite".
+      </p>
+    </section>
     <section id="xmlformat">
       <title>Whitespace and indenting of xml files with xmlformat</title>
       <p>

Modified: forrest/trunk/site-author/content/xdocs/docs_0_90/faq.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/docs_0_90/faq.xml?rev=613043&r1=613042&r2=613043&view=diff
==============================================================================
--- forrest/trunk/site-author/content/xdocs/docs_0_90/faq.xml (original)
+++ forrest/trunk/site-author/content/xdocs/docs_0_90/faq.xml Thu Jan 17 18:41:41 2008
@@ -339,7 +339,9 @@
       <question>How can I generate one pdf-file out of the whole site or selected pages
of the site?</question>
       <answer>
         <p>
-          Add the following entries to your site.xml file:
+          Add the following entries to your site.xml file.
+          Note that the href must be exactly "wholesite" or "site" which triggers
+          a special match in the sitemap to aggregate all documents.
         </p>
         <source>
 <![CDATA[
@@ -352,14 +354,23 @@
         </source>
         <p>
           In this case the menu labeled "About" will have 2 new items: "Full
-          PDF" and "Full HTML". (See also <link href="site:pdf-tab">How to
-          create a PDF document for each tab</link>.)
+          PDF" and "Full HTML".
+        </p>
+        <p>
+          See also <link href="site:pdf-tab">How to
+          create a PDF document for each tab</link>.
         </p>
         <p>
           This assumes that you use the
           <link href="site:linking">site.xml</link> method for your site
           structure and navigation, rather than the old book.xml method.
         </p>
+        <warning>
+          There are many issues with the "wholesite" aggregation. Search the
+          issue tracker and mail lists.
+          The main issue is for Forrest-0.8 and the new locationmap
+          (<link href="http://issues.apache.org/jira/browse/FOR-733">FOR-733</link>).
+        </warning>
       </answer>
     </faq>
     <faq id="pageBreaks">
@@ -970,7 +981,7 @@
       <answer>
         <p>
           Certain patterns are claimed by the default sitemaps for special
-          processing. These reserved words include: <code>site, changes, todo,
+          processing. These reserved words include: <code>site, wholesite, changes,
todo,
           faq, images, my-images, skinconf, community, howto</code>
         </p>
         <p>



Mime
View raw message