You are viewing a plain text version of this content. The canonical link for it is here.
Posted to svn@forrest.apache.org by cr...@apache.org on 2008/01/18 03:45:43 UTC
svn commit: r613044 - in
/forrest/branches/forrest_08_branch/site-author/content/xdocs/docs_0_80:
faq.xml upgrading_08.xml
Author: crossley
Date: Thu Jan 17 18:45:40 2008
New Revision: 613044
URL: http://svn.apache.org/viewvc?rev=613044&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/branches/forrest_08_branch/site-author/content/xdocs/docs_0_80/faq.xml
forrest/branches/forrest_08_branch/site-author/content/xdocs/docs_0_80/upgrading_08.xml
Modified: forrest/branches/forrest_08_branch/site-author/content/xdocs/docs_0_80/faq.xml
URL: http://svn.apache.org/viewvc/forrest/branches/forrest_08_branch/site-author/content/xdocs/docs_0_80/faq.xml?rev=613044&r1=613043&r2=613044&view=diff
==============================================================================
--- forrest/branches/forrest_08_branch/site-author/content/xdocs/docs_0_80/faq.xml (original)
+++ forrest/branches/forrest_08_branch/site-author/content/xdocs/docs_0_80/faq.xml Thu Jan 17 18:45:40 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/branches/forrest_08_branch/site-author/content/xdocs/docs_0_80/upgrading_08.xml
URL: http://svn.apache.org/viewvc/forrest/branches/forrest_08_branch/site-author/content/xdocs/docs_0_80/upgrading_08.xml?rev=613044&r1=613043&r2=613044&view=diff
==============================================================================
--- forrest/branches/forrest_08_branch/site-author/content/xdocs/docs_0_80/upgrading_08.xml (original)
+++ forrest/branches/forrest_08_branch/site-author/content/xdocs/docs_0_80/upgrading_08.xml Thu Jan 17 18:45:40 2008
@@ -174,6 +174,13 @@
upgrade notes in the $FORREST_HOME/etc/cocoon_upgrade directory. You
might be able to advance a bit beyond the SVN revision, but not much.
Please help to rectify this situation.
+ 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">