Return-Path: Delivered-To: apmail-forrest-svn-archive@www.apache.org Received: (qmail 72201 invoked from network); 28 Jul 2005 05:01:26 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur.apache.org with SMTP; 28 Jul 2005 05:01:26 -0000 Received: (qmail 67951 invoked by uid 500); 28 Jul 2005 05:01:25 -0000 Delivered-To: apmail-forrest-svn-archive@forrest.apache.org Received: (qmail 67912 invoked by uid 500); 28 Jul 2005 05:01:24 -0000 Mailing-List: contact svn-help@forrest.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: List-Post: Reply-To: "Forrest Developers List" List-Id: Delivered-To: mailing list svn@forrest.apache.org Received: (qmail 67899 invoked by uid 99); 28 Jul 2005 05:01:24 -0000 Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 27 Jul 2005 22:01:24 -0700 X-ASF-Spam-Status: No, hits=-9.3 required=10.0 tests=ALL_TRUSTED,NO_REAL_NAME,WEIRD_PORT X-Spam-Check-By: apache.org Received: from [209.237.227.194] (HELO minotaur.apache.org) (209.237.227.194) by apache.org (qpsmtpd/0.29) with SMTP; Wed, 27 Jul 2005 22:01:14 -0700 Received: (qmail 72128 invoked by uid 65534); 28 Jul 2005 05:01:19 -0000 Message-ID: <20050728050119.72127.qmail@minotaur.apache.org> Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r225685 [1/3] - in /forrest/site: ./ docs_0_60/ docs_0_60/howto/ docs_0_70/ docs_0_70/howto/ docs_0_70/howto/cvs-ssh/ docs_0_80/ docs_0_80/howto/ docs_0_80/howto/cvs-ssh/ docs_0_80/howto/multi/ dtdx/ pluginDocs/plugins_0_70/ pluginDocs/plug... Date: Thu, 28 Jul 2005 05:00:57 -0000 To: svn@forrest.apache.org From: crossley@apache.org X-Mailer: svnmailer-1.0.2 X-Virus-Checked: Checked by ClamAV on apache.org X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N Author: crossley Date: Wed Jul 27 21:59:26 2005 New Revision: 225685 URL: http://svn.apache.org/viewcvs?rev=225685&view=rev Log: Automatic publish from forrestbot Added: forrest/site/docs_0_80/howto/howto-dev.html (with props) forrest/site/docs_0_80/howto/howto-dev.pdf (with props) Modified: forrest/site/abs-linkmap forrest/site/abs-menulinks forrest/site/body-index.html forrest/site/contrib.html forrest/site/docs_0_60/build.html forrest/site/docs_0_60/catalog.html forrest/site/docs_0_60/compliance.html forrest/site/docs_0_60/faq.html forrest/site/docs_0_60/forrest-contract.html forrest/site/docs_0_60/howto/howto-howto.html forrest/site/docs_0_60/howto/howto-pdf-tab.html forrest/site/docs_0_60/linking.html forrest/site/docs_0_60/project-sitemap.html forrest/site/docs_0_60/searching.html forrest/site/docs_0_60/sitemap-ref.html forrest/site/docs_0_60/validation.html forrest/site/docs_0_60/your-project.html forrest/site/docs_0_70/build.html forrest/site/docs_0_70/catalog.html forrest/site/docs_0_70/compliance.html forrest/site/docs_0_70/faq.html forrest/site/docs_0_70/forrest-contract.html forrest/site/docs_0_70/howto/cvs-ssh/howto-cvs-ssh.html forrest/site/docs_0_70/howto/howto-asf-mirror.html forrest/site/docs_0_70/howto/howto-buildPlugin.html forrest/site/docs_0_70/howto/howto-custom-html-source.html forrest/site/docs_0_70/howto/howto-editcss.html forrest/site/docs_0_70/howto/howto-howto.html forrest/site/docs_0_70/howto/howto-pdf-tab.html forrest/site/docs_0_70/howto/howto-view-contracts.html forrest/site/docs_0_70/howto/howto-view-dsl.html forrest/site/docs_0_70/howto/howto-view-install.html forrest/site/docs_0_70/libre-intro.html forrest/site/docs_0_70/linking.html forrest/site/docs_0_70/primer.html forrest/site/docs_0_70/project-sitemap.html forrest/site/docs_0_70/searching.html forrest/site/docs_0_70/sitemap-ref.html forrest/site/docs_0_70/validation.html forrest/site/docs_0_70/views.html forrest/site/docs_0_70/your-project.html forrest/site/docs_0_80/build.html forrest/site/docs_0_80/cap.html forrest/site/docs_0_80/catalog.html forrest/site/docs_0_80/changes.html forrest/site/docs_0_80/compliance.html forrest/site/docs_0_80/dreams.html forrest/site/docs_0_80/faq.html forrest/site/docs_0_80/forrest-contract.html forrest/site/docs_0_80/howto/cvs-ssh/howto-cvs-ssh.html forrest/site/docs_0_80/howto/howto-asf-mirror.html forrest/site/docs_0_80/howto/howto-buildPlugin.html forrest/site/docs_0_80/howto/howto-corner-images.html forrest/site/docs_0_80/howto/howto-custom-html-source.html forrest/site/docs_0_80/howto/howto-editcss.html forrest/site/docs_0_80/howto/howto-forrest-from-maven.html forrest/site/docs_0_80/howto/howto-howto.html forrest/site/docs_0_80/howto/howto-howto.pdf forrest/site/docs_0_80/howto/howto-pdf-tab.html forrest/site/docs_0_80/howto/howto-view-contracts.html forrest/site/docs_0_80/howto/howto-view-dsl.html forrest/site/docs_0_80/howto/howto-view-install.html forrest/site/docs_0_80/howto/index.html forrest/site/docs_0_80/howto/index.pdf forrest/site/docs_0_80/howto/multi/howto-multi.html forrest/site/docs_0_80/howto/multi/step1.html forrest/site/docs_0_80/howto/multi/step2.html forrest/site/docs_0_80/howto/multi/step3.html forrest/site/docs_0_80/index.html forrest/site/docs_0_80/libre-intro.html forrest/site/docs_0_80/linking.html forrest/site/docs_0_80/locationmap.html forrest/site/docs_0_80/menu-index.html forrest/site/docs_0_80/primer.html forrest/site/docs_0_80/project-sitemap.html forrest/site/docs_0_80/searching.html forrest/site/docs_0_80/sitemap-ref.html forrest/site/docs_0_80/skin-package.html forrest/site/docs_0_80/skins.html forrest/site/docs_0_80/todo.html forrest/site/docs_0_80/upgrading_08.html forrest/site/docs_0_80/validation.html forrest/site/docs_0_80/views.html forrest/site/docs_0_80/your-project.html forrest/site/dtdx/document-v12.html forrest/site/dtdx/document-v13.dtdx.html forrest/site/dtdx/document-v13.html forrest/site/dtdx/document-v20.dtdx.html forrest/site/dtdx/document-v20.html forrest/site/dtdx/dtd-docs.html forrest/site/dtdx/faq-v13.dtdx.html forrest/site/dtdx/faq-v20.dtdx.html forrest/site/dtdx/howto-v13.dtdx.html forrest/site/dtdx/howto-v20.dtdx.html forrest/site/events.html forrest/site/forrest-issues.html forrest/site/forrest-issues.pdf forrest/site/index.html forrest/site/index.pdf forrest/site/live-sites.html forrest/site/live-sites.pdf forrest/site/mail-lists.html forrest/site/pluginDocs/plugins_0_70/pluginInfrastructure.html forrest/site/pluginDocs/plugins_0_80/pluginInfrastructure.html forrest/site/proposal-asf-forrestbot.html forrest/site/skin/basic.css forrest/site/tools/eclipse.html forrest/site/tools/eclipse.pdf forrest/site/tools/forrestbar.html forrest/site/tools/forrestbot-web-interface.html forrest/site/tools/forrestbot.html forrest/site/tools/xxe.html forrest/site/who.html forrest/site/who.pdf Modified: forrest/site/abs-linkmap URL: http://svn.apache.org/viewcvs/forrest/site/abs-linkmap?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/abs-linkmap (original) +++ forrest/site/abs-linkmap Wed Jul 27 21:59:26 2005 @@ -209,6 +209,7 @@ + Modified: forrest/site/abs-menulinks URL: http://svn.apache.org/viewcvs/forrest/site/abs-menulinks?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/abs-menulinks (original) +++ forrest/site/abs-menulinks Wed Jul 27 21:59:26 2005 @@ -209,6 +209,7 @@ + Modified: forrest/site/body-index.html URL: http://svn.apache.org/viewcvs/forrest/site/body-index.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/body-index.html (original) +++ forrest/site/body-index.html Wed Jul 27 21:59:26 2005 @@ -64,7 +64,7 @@
  • -
    +
    Note
    The first time you run Forrest it will attempt to retrieve some plugins from the Internet. This will happen whenever a new plugin is specified. For more Modified: forrest/site/contrib.html URL: http://svn.apache.org/viewcvs/forrest/site/contrib.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/contrib.html (original) +++ forrest/site/contrib.html Wed Jul 27 21:59:26 2005 @@ -336,7 +336,7 @@

    If you use a downloaded released version of Forrest, then do 'diff -u faq.xml.orig faq.xml > faq.xml.diff'

    -
    +
    Note
    Please send all contributions via our issue tracker. Modified: forrest/site/docs_0_60/build.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_60/build.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_60/build.html (original) +++ forrest/site/docs_0_60/build.html Wed Jul 27 21:59:26 2005 @@ -247,7 +247,7 @@

    Step-by-step Subversion (SVN) instructions

    -
    +
    Note
    If you are behind a proxy, see this FAQ.
    @@ -288,7 +288,7 @@

    Building and Installing Forrest

    -
    +
    Note
    This document applies to the past 0.6 release version. Modified: forrest/site/docs_0_60/catalog.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_60/catalog.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_60/catalog.html (original) +++ forrest/site/docs_0_60/catalog.html Wed Jul 27 21:59:26 2005 @@ -294,7 +294,7 @@ entity resolver. To use these tools with documents based on the Forrest DTDs, you need to configure the tools.

    -
    +
    Note
    The information provided here is not intended to endorse any Modified: forrest/site/docs_0_60/compliance.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_60/compliance.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_60/compliance.html (original) +++ forrest/site/docs_0_60/compliance.html Wed Jul 27 21:59:26 2005 @@ -299,7 +299,7 @@
  • FIXME: need to list other issues here, or attend to them.
    • -
    +
    Note
    The forrest-site skin does not have any missing alts. Perhaps Bobby does not like the trick with empty alt attributes. However, it only Modified: forrest/site/docs_0_60/faq.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_60/faq.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_60/faq.html (original) +++ forrest/site/docs_0_60/faq.html Wed Jul 27 21:59:26 2005 @@ -613,7 +613,7 @@ </cocoon>

    This is just an example, and you should modify it appropriately for your site.

    -
    +
    Note
    Wildcards may be used. These are a powerful feature of Cocoon's @@ -728,7 +728,7 @@ Packages

    -
    +
    Note
    Due to Sun's licensing, we cannot redistribute Jimi or JAI with Forrest.
    Modified: forrest/site/docs_0_60/forrest-contract.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_60/forrest-contract.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_60/forrest-contract.html (original) +++ forrest/site/docs_0_60/forrest-contract.html Wed Jul 27 21:59:26 2005 @@ -236,7 +236,7 @@
-
+
Note
This document describes the formal contract between the @@ -247,7 +247,7 @@
-
+
Note
Some terminology will assist: {docroot} is the location Modified: forrest/site/docs_0_60/howto/howto-howto.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_60/howto/howto-howto.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_60/howto/howto-howto.html (original) +++ forrest/site/docs_0_60/howto/howto-howto.html Wed Jul 27 21:59:26 2005 @@ -340,7 +340,7 @@ contributing your document. -
+
Note
See the DTD documentation which explains the document structure.
Modified: forrest/site/docs_0_60/howto/howto-pdf-tab.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_60/howto/howto-pdf-tab.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_60/howto/howto-pdf-tab.html (original) +++ forrest/site/docs_0_60/howto/howto-pdf-tab.html Wed Jul 27 21:59:26 2005 @@ -318,7 +318,7 @@

Edit project sitemap.xmap

-
+
Note
This is a workaround for Issue FOR-202 @@ -410,7 +410,7 @@ <sample-wiki label="Wiki page" href="wiki-sample.html" description="wiki-sample" wholesite="true"/> -
+
Note
This attribute will be inherited by all children of the element. Do not use it in the parent element that contains the @@ -466,7 +466,7 @@ <map:parameter name="title" value="{conf:project-name}: Still My Foo Site"/>

-
+
Note
In the original aggregate.xmap there is the line @@ -495,7 +495,7 @@ In the future, this ability will probably be incorporated into the main Forrest process.

-
+
Fixme (open)
This document will need to be modified when Issue FOR-202 is solved. Modified: forrest/site/docs_0_60/linking.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_60/linking.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_60/linking.html (original) +++ forrest/site/docs_0_60/linking.html Wed Jul 27 21:59:26 2005 @@ -527,7 +527,7 @@ unspecified, nodes inherit the "tab" of their parent. Thus everything in the <about> section has an implicit tab="home" attribute.

-
+
Note
You can see this by viewing your site's abs-menulinks pipeline in a @@ -702,7 +702,7 @@ Thus by modifying the XPath prefix and suffix, almost any XML format can be accommodated.

-
+
Note
Actually, the XPath is applied to XML generated dynamically from Modified: forrest/site/docs_0_60/project-sitemap.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_60/project-sitemap.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_60/project-sitemap.html (original) +++ forrest/site/docs_0_60/project-sitemap.html Wed Jul 27 21:59:26 2005 @@ -246,7 +246,7 @@ to our sitemaps, without needing to copy the main sitemaps and keep them them synchonised. This will enable hassle-free update to future Forrest versions.

-
+
Note
We advise you to spend time to understand the Apache Cocoon sitemap. Modified: forrest/site/docs_0_60/searching.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_60/searching.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_60/searching.html (original) +++ forrest/site/docs_0_60/searching.html Wed Jul 27 21:59:26 2005 @@ -314,7 +314,7 @@ http://localhost:8888/lucene-update.html. This generates the search index and provides some information about the index generation process.

-
+
Note
You may have to substitute a different hostname, port, or path, depending on your configuration. The path mentioned here Modified: forrest/site/docs_0_60/sitemap-ref.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_60/sitemap-ref.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_60/sitemap-ref.html (original) +++ forrest/site/docs_0_60/sitemap-ref.html Wed Jul 27 21:59:26 2005 @@ -307,7 +307,7 @@ Forrest.

-
+
Note
We advise you to spend time to understand the Apache Cocoon sitemap. Modified: forrest/site/docs_0_60/validation.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_60/validation.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_60/validation.html (original) +++ forrest/site/docs_0_60/validation.html Wed Jul 27 21:59:26 2005 @@ -302,7 +302,7 @@ forrest.properties: 

forrest.validate.xdocs.excludes=slides.xml, manual/**
-
+
Note
The failonerror properties only work for files validated @@ -461,7 +461,7 @@

We now have a DTD for the 'download' document type.

-
+
Note
@@ -488,7 +488,7 @@ break. The solution Forrest uses is to ignore the system id, and rely on a mapping from the public ID to a stable DTD location, via a Catalog file.

-
+
Note
See this article for a good Modified: forrest/site/docs_0_60/your-project.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_60/your-project.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_60/your-project.html (original) +++ forrest/site/docs_0_60/your-project.html Wed Jul 27 21:59:26 2005 @@ -467,7 +467,7 @@ BUILD SUCCESSFUL Total time: 5 seconds -
+
Note
As you have probably noticed, we like to document things right in the @@ -538,8 +538,8 @@ To render this to HTML, type 'forrest'. You should have a HTML site rendered into the build/site directory:

-
-New project
+
+New project

Practise with adding new content. Change to the directory src/documentation/content/xdocs and copy the file @@ -767,7 +767,7 @@ layout to Forrest's. If you generated your site with 'forrest seed', you will have one pre-written, with all the entries commented out.

-
+
Note
You only need to un-comment entries if you are going to change them @@ -823,7 +823,7 @@ project.images-dir=${project.content-dir}/images project.skinconf=${project.content-dir}/skinconf.xml -
+
Note
Internally, Forrest rearranges the specified directory into the default @@ -863,8 +863,8 @@ for more details, and again, consult Forrest's own docs for a usage example.

-
-Tabs
+
+Tabs

You can have one or two levels of tabs. The images above show a single level. However, you can create a second level that will only be displayed when its parent tab is selected. For example, @@ -952,7 +952,7 @@ "Using project sitemaps" and some worked examples are shown in the following sections here.

-
+
Note
We advise you to spend time to understand the Apache Cocoon sitemap. @@ -1072,7 +1072,7 @@ transformation of our custom xml structure into the Forrest intermediate xdocs structure.

-
+
Note
The Sitemap @@ -1127,7 +1127,7 @@
  • Tell the system about your catalog.
    • -
    +
    Note
    Please see XML Validation @@ -1246,7 +1246,7 @@ To change the skin, edit the forrest.properties file to set project.skin=leather-dev or some other skin name.

    -
    +
    Note
    Forrest supplies a collection of Modified: forrest/site/docs_0_70/build.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_70/build.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_70/build.html (original) +++ forrest/site/docs_0_70/build.html Wed Jul 27 21:59:26 2005 @@ -286,7 +286,7 @@

    Step-by-step Subversion (SVN) instructions

    -
    +
    Note
    If you are behind a proxy, see this FAQ.
    @@ -327,7 +327,7 @@

    Building and installing Forrest

    -
    +
    Note
    This document applies to the current 0.7 release version. @@ -365,7 +365,7 @@ [/svn/forrest]$ export FORREST_HOME=`pwd` [/svn/forrest]$ export PATH=$PATH:$FORREST_HOME/bin -
    +
    Warning
    After updating the Forrest source from SVN, if there have been certain types of Modified: forrest/site/docs_0_70/catalog.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_70/catalog.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_70/catalog.html (original) +++ forrest/site/docs_0_70/catalog.html Wed Jul 27 21:59:26 2005 @@ -333,7 +333,7 @@ entity resolver. To use these tools with documents based on the Forrest DTDs, you need to configure the tools.

    -
    +
    Note
    The information provided here is not intended to endorse any Modified: forrest/site/docs_0_70/compliance.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_70/compliance.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_70/compliance.html (original) +++ forrest/site/docs_0_70/compliance.html Wed Jul 27 21:59:26 2005 @@ -338,7 +338,7 @@
  • FIXME: need to list other issues here, or attend to them.
    • -
    +
    Note
    The forrest-site skin does not have any missing alts. Perhaps Bobby does not like the trick with empty alt attributes. However, it only Modified: forrest/site/docs_0_70/faq.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_70/faq.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_70/faq.html (original) +++ forrest/site/docs_0_70/faq.html Wed Jul 27 21:59:26 2005 @@ -690,7 +690,7 @@ http://java.sun.com/products/java-media/jai). For more info, see FOP Graphics Packages

    -
    +
    Note
    Due to Sun's licensing, we cannot redistribute Jimi or JAI with Forrest.
    @@ -949,7 +949,7 @@ <uri src="favicon.ico"/> </cocoon>

    This is just an example, and you should modify it appropriately for your site.

    -
    +
    Note
    Wildcards may be used. These are a powerful feature of Cocoon's sitemap. For example, foo/* would match foo/bar, but not foo/bar/baz — use Modified: forrest/site/docs_0_70/forrest-contract.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_70/forrest-contract.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_70/forrest-contract.html (original) +++ forrest/site/docs_0_70/forrest-contract.html Wed Jul 27 21:59:26 2005 @@ -275,7 +275,7 @@
    -
    +
    Note
    This document describes the formal contract between the @@ -286,7 +286,7 @@
    -
    +
    Note
    Some terminology will assist: {docroot} is the location Modified: forrest/site/docs_0_70/howto/cvs-ssh/howto-cvs-ssh.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_70/howto/cvs-ssh/howto-cvs-ssh.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_70/howto/cvs-ssh/howto-cvs-ssh.html (original) +++ forrest/site/docs_0_70/howto/cvs-ssh/howto-cvs-ssh.html Wed Jul 27 21:59:26 2005 @@ -169,7 +169,7 @@ -
    +
    Note
    If you are behind a firewall check that you can communicate through the 22 port. For anonymous access you will need 2401 one.
    @@ -193,14 +193,14 @@ -
    +
    Note
    $ represents local, % remote machine.

    Setting up domain users

    -
    +
    Note
    This step is necessary only for Windows users. Linux users can happily skip this section and pass to Setting up SSH access section
    @@ -218,7 +218,7 @@ $ mkpasswd -d | grep 'userxxx' >> /etc/passwd $ exit -
    +
    Note
    Replace 'userxxx' by your account name
    @@ -250,7 +250,7 @@

    Now you have configured SSH on your machine. Next you have to setup access to the CVS machine.

    -
    +
    Warning
    Having an empty passphrase isn't recommended for security reasons. See ssh-agent documentation on how to configure automatic passphrase retaining.
    @@ -267,7 +267,7 @@ % chmod 600 ~/.ssh/* % exit -
    +
    Note
    Note, that the account name on CVS machine can differ from your local account name.
    @@ -277,7 +277,7 @@ 
     $ ssh userxxx@cvs.apache.org
    -
    +
    Note
    If this command doesn't work then it can mean that you have an old version of SSH. In this case try ssh -l userxxx cvs.apache.org. Run ssh --help to get all available options.
    Modified: forrest/site/docs_0_70/howto/howto-asf-mirror.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_70/howto/howto-asf-mirror.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_70/howto/howto-asf-mirror.html (original) +++ forrest/site/docs_0_70/howto/howto-asf-mirror.html Wed Jul 27 21:59:26 2005 @@ -405,7 +405,7 @@ there. Run the 'forrest' command. The mirrors.html page will be generated with the skin applied.

    -
    +
    Note
    Due to Issue Modified: forrest/site/docs_0_70/howto/howto-buildPlugin.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_70/howto/howto-buildPlugin.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_70/howto/howto-buildPlugin.html (original) +++ forrest/site/docs_0_70/howto/howto-buildPlugin.html Wed Jul 27 21:59:26 2005 @@ -351,7 +351,7 @@

    Users needing to add additional input formats or output formats or to change the operation of the Forrest internals.

    -
    +
    Warning
    The Plugin Infrastructure is still at an early stage of design and implementation, consequently this How-To may be out of date @@ -359,7 +359,7 @@ described, please ask for help on the developers mailing list (and then provide patches for this document).
    -
    +
    Warning
    Please make sure that you are using forrest 0.7 if you want use plugins. Forrest 0.6 will not work!!!
    @@ -437,14 +437,14 @@

    The above ant target will ask you the name of the plugin and will build a minimal plugin directory structure and configuration. You will need to customise these files to build your plugin.

    -
    +
    Note
    Although you can name your project anything you like we do have some naming conventions that we recommend you follow. Plugins intended to be held at forrest.apache.org must follow the naming convention.
    -
    +
    Note
    If you plan on building your plugin elsewhere you can copy the build.xml build file to your own plugin work directory and @@ -459,7 +459,7 @@

    You now have a skeleton plugin project. However, it doesn't do anything useful yet. Now is a good time to edit some of the files provided.

    -
    +
    Note
    For plugins intended to be held at forrest.apache.org please @@ -538,7 +538,7 @@

    See the examples below for more details.

    Create the Necessary Resource Files

    -
    +
    Fixme (rdg)
    Discuss the XSL files and other such resources
    @@ -562,7 +562,7 @@

    Run the command ant test in the plugins directory.

    Of course, the build should complete without errors.

    -
    +
    Note
    You can also use forrest run to interactively examine your documentation (point your browser at @@ -582,11 +582,11 @@

    Releasing a Plugin

    Register the Plugin with Apache Forrest

    -
    +
    Fixme (rdg)
    Describe the plugins.xml file
    -
    +
    Fixme (rdg)
    Describe making a request of Forrest devs for inclusion
    @@ -605,7 +605,7 @@ can build the zip of your plugin with ant dist and then copy the zip file from build/dist to wherever you intend to host the plugin.

    -
    +
    Note
    Running this command on any plugin will also deploy any changes to the plugins.xml file. If you are deploying to @@ -613,7 +613,7 @@ plugins.xml and ask the Forrest committers to publish the new document.
    -
    +
    Warning
    Running the deploy or dist targets will always run the test target first. This is to ensure @@ -626,19 +626,19 @@ steps discussed above.

    Input Plugin

    -
    +
    Fixme (RDG)
    Discuss OpenOffice.org plugin here

    Output Plugin

    -
    +
    Fixme (RDG)
    Discuss s5 plugin here

    Internal Plugin

    -
    +
    Fixme (RDG)
    Discuss IMSManifest plugin here
    @@ -655,7 +655,7 @@

    Summarise the Entire Process

    -
    +
    Fixme (rdg)
    In a few sentences, remind the reader what they have just learned. This helps to reinforce the main points of your How-To.
    Modified: forrest/site/docs_0_70/howto/howto-custom-html-source.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_70/howto/howto-custom-html-source.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_70/howto/howto-custom-html-source.html (original) +++ forrest/site/docs_0_70/howto/howto-custom-html-source.html Wed Jul 27 21:59:26 2005 @@ -428,7 +428,7 @@ Open the file 'main/webapp/sitemap.xmap' in Forrest's program directory with a text editor of your choice.

    -
    +
    Note
    Any simple text editor will suffice, since the XML in @@ -824,7 +824,7 @@ As a result, we now hand back the content of the html-document in Forrest standard document format to the calling pipeline

    -
    +
    Note
    To look at the output of this pipeline you can simply @@ -874,7 +874,7 @@ -
    +
    Note
    To look at the output of this pipeline you can simply @@ -1037,7 +1037,7 @@ Don't forget to view the pages to verify that it is working properly.

    -
    +
    Note
    Our pipeline does not exactly do what the original pipeline does. Modified: forrest/site/docs_0_70/howto/howto-editcss.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_70/howto/howto-editcss.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_70/howto/howto-editcss.html (original) +++ forrest/site/docs_0_70/howto/howto-editcss.html Wed Jul 27 21:59:26 2005 @@ -330,7 +330,7 @@
  • Browser-access to the Forrest-site you want to experiment with. Starting with a new 'forrest seed' site is good for your first attempt. -
    +
    Note
    You can even experiment with Forrest's core skins CSS. Please send patches if @@ -351,7 +351,7 @@ and installs in just a few seconds from the Install-Link at http://editcss.mozdev.org/ -
    +
    Note
    With standard security settings in place, Firefox will pop up a line at the top @@ -399,7 +399,7 @@ sidebar right back into the style-settings of the main window, so that effects will show right away.

    -
    +
    Note
    On slow systems or when inserting big changes it might be a good idea to paste Modified: forrest/site/docs_0_70/howto/howto-howto.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_70/howto/howto-howto.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_70/howto/howto-howto.html (original) +++ forrest/site/docs_0_70/howto/howto-howto.html Wed Jul 27 21:59:26 2005 @@ -389,7 +389,7 @@ contributing your document.
    • -
    +
    Note
    See the DTD documentation which explains the document structure.
    Modified: forrest/site/docs_0_70/howto/howto-pdf-tab.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_70/howto/howto-pdf-tab.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_70/howto/howto-pdf-tab.html (original) +++ forrest/site/docs_0_70/howto/howto-pdf-tab.html Wed Jul 27 21:59:26 2005 @@ -402,7 +402,7 @@

    Edit your site.xml

    -
    +
    Note
    Do not use directories with "." in it. Replace them by "_" @@ -441,7 +441,7 @@ <sample-wiki label="Wiki page" href="wiki-sample.html" description="wiki-sample" wholesite="true"/> -
    +
    Note
    This attribute will be inherited by all children of the element. Do not use it in the parent element that contains the Modified: forrest/site/docs_0_70/howto/howto-view-contracts.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_70/howto/howto-view-contracts.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_70/howto/howto-view-contracts.html (original) +++ forrest/site/docs_0_70/howto/howto-view-contracts.html Wed Jul 27 21:59:26 2005 @@ -301,7 +301,7 @@

    Intended Audience

    -
    +
    Warning
    "Views" are new functionality which is still in development phase. That is why it is in the @@ -345,7 +345,7 @@

    Steps

    -
    +
    Note
    The following content is from many mails around the topic, this how-to tries to be the consolidation of this thread. It is mainly based on the [RT] Why using views - @@ -396,7 +396,7 @@ <xsl:template name="siteinfo-last-published"/> and apply it in any position where it is placed.

    -
    +
    Note
    Now this refactoring of the site2xhtml.xsl is exactly what we doing in creating contracts for views. @@ -439,7 +439,7 @@ The most important is the name of the contract <forrest:contract name="blank"/>. This name is the same as the file name of the contract (without file extension) blank.ft.

    -
    +
    Note
    This is a naming convention that you have to always met. All @name has to be file name of the contract without file extension! @@ -469,7 +469,7 @@ Besides this a xsl-template has to indicate this in the naming. A template that add content to the html body has to end with "-body"!!!

    -
    +
    Note
    It is possible to use contracts in different in/output-formats. @@ -490,7 +490,7 @@

    Create a new contract

    -
    +
    Fixme (thorsten)
    We need to explain basic naming convention for contracts. Like @@ -573,7 +573,7 @@ The contract usage contains the contract-tag <forrest:contract name="siteinfo-last-published-howto"/> Please see Getting started with forrest:view DSL for more details.

    -
    +
    Fixme (thorsten)
    Let us now look into advanced features of views. Modified: forrest/site/docs_0_70/howto/howto-view-dsl.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_70/howto/howto-view-dsl.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_70/howto/howto-view-dsl.html (original) +++ forrest/site/docs_0_70/howto/howto-view-dsl.html Wed Jul 27 21:59:26 2005 @@ -302,7 +302,7 @@

    Intended Audience

    -
    +
    Warning
    "Views" are new functionality which is still in development phase. That is why it is in the @@ -344,7 +344,7 @@

    Steps

    -
    +
    Note
    When developing with views we assume you are using 'forrest run' and the following workflow:
    @@ -505,7 +505,7 @@ Now we have to add a new tag to tell that we want to override the default.css. We are doing this by adding the tag <forrest:css url="howTo.css"/> to our view.

    -
    +
    Note
    @@ -555,7 +555,7 @@

    We are now able to place contracts into layout container and add custom css to the view.

    -
    +
    Fixme (thorsten)
    Let us now look into advanced features of views. Modified: forrest/site/docs_0_70/howto/howto-view-install.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_70/howto/howto-view-install.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_70/howto/howto-view-install.html (original) +++ forrest/site/docs_0_70/howto/howto-view-install.html Wed Jul 27 21:59:26 2005 @@ -304,7 +304,7 @@

    Intended Audience

    -
    +
    Warning
    "Views" are new functionality which is still in development phase. That is why it is in the @@ -382,7 +382,7 @@ Now we have to change the project skin to leather-dev. The reason is that the plugins are still not independend form the "old fashion skins".

    -
    +
    Note
    We exchanging only site2xhtml.xsl of leather-dev skin by the plugins and some contracts are based @@ -401,7 +401,7 @@

    then point to http://localhost:8888/ and you should see the default view based skin.

    -
    +
    Note
    When developing styles with views 'forrest run' is the quickest way. You will see you do not have to build your project to see the Modified: forrest/site/docs_0_70/libre-intro.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_70/libre-intro.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_70/libre-intro.html (original) +++ forrest/site/docs_0_70/libre-intro.html Wed Jul 27 21:59:26 2005 @@ -348,7 +348,7 @@

    Intro

    -
    +
    Warning
    This document is still relevant for ideas and potential solutions. However, the experimental code for Libre was removed from @@ -384,7 +384,7 @@

    Using Libre now (0.0 alfa)

    -
    +
    Warning
    Disclaimer: most of what you read below is 'how it was intended' . To what extent that matches the actual execution process is largely dependent @@ -511,7 +511,7 @@ -
    +
    Fixme (mpo)
    This last remarks actually means (1) I need to update the DTD to reflect this and (2) check the code for actually doing @@ -612,7 +612,7 @@ results in passing the test. -
    +
    Warning
    This currently breaks for non xml (*.gif) files, so get your filter right please, and in the mean time: sorry for not @@ -754,7 +754,7 @@

    Next Libre (0.1)

    -
    +
    Note
    Next libre is in fact largely in your hands... just drop the forrest-dev mail list Modified: forrest/site/docs_0_70/linking.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_70/linking.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_70/linking.html (original) +++ forrest/site/docs_0_70/linking.html Wed Jul 27 21:59:26 2005 @@ -571,7 +571,7 @@ unspecified, nodes inherit the "tab" of their parent. Thus everything in the <about> section has an implicit tab="home" attribute.

    -
    +
    Note
    You can see this by viewing your site's abs-menulinks pipeline in a @@ -807,7 +807,7 @@ Thus by modifying the XPath prefix and suffix, almost any XML format can be accommodated.

    -
    +
    Note
    Actually, the XPath is applied to XML generated dynamically from Modified: forrest/site/docs_0_70/primer.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_70/primer.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_70/primer.html (original) +++ forrest/site/docs_0_70/primer.html Wed Jul 27 21:59:26 2005 @@ -313,7 +313,7 @@
    -
    +
    Warning
    This document is very out of date. There is a lot of good information here, but the focus of the project has shifted away from the @@ -372,7 +372,7 @@ of XSLT stylesheets that produce HTML renditions of XML documents using these DTDs.

    The primary mode of operations for Forrest will be as follows:

    -
    +
    Note
    This process is not quite ready for prime time yet, but it gives you an idea where we are heading to. Website generation with skins currently @@ -573,7 +573,7 @@

    Once you retrieved Forrest from its CVS repository, you will end up with a filesystem hierarchy similar to this inside the xml-forrest home directory:

    -
    +
    Warning
    This is highly volatile information!
    @@ -714,8 +714,8 @@ Serializer. Forrest also makes use of Cocoon's aggregation capabilities that merge multiple pipelines into one resulting output document.

    A typical page generated using Forrest looks like this:

    -
    -Pages areas
    +
    +Pages areas

    This page is currently composed of two XML sources which are transformed by a different XSLT stylesheet, aggregated by Cocoon with a post-aggregation stylesheet adding the overall page grid and look & feel. Modified: forrest/site/docs_0_70/project-sitemap.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_70/project-sitemap.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_70/project-sitemap.html (original) +++ forrest/site/docs_0_70/project-sitemap.html Wed Jul 27 21:59:26 2005 @@ -285,7 +285,7 @@ the core sitemaps, without needing to copy the main sitemaps and keep them synchonised. This will enable hassle-free update to future Forrest versions.

    -
    +
    Note
    We advise you to spend time to understand the Apache Cocoon sitemap. Modified: forrest/site/docs_0_70/searching.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_70/searching.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_70/searching.html (original) +++ forrest/site/docs_0_70/searching.html Wed Jul 27 21:59:26 2005 @@ -353,7 +353,7 @@ http://localhost:8888/lucene-update.html. This generates the search index and provides some information about the index generation process.

    -
    +
    Note
    You may have to substitute a different hostname, port, or path, depending on your configuration. The path mentioned here Modified: forrest/site/docs_0_70/sitemap-ref.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_70/sitemap-ref.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_70/sitemap-ref.html (original) +++ forrest/site/docs_0_70/sitemap-ref.html Wed Jul 27 21:59:26 2005 @@ -346,7 +346,7 @@ Forrest.

    -
    +
    Note
    We advise you to spend time to understand the Apache Cocoon sitemap. Modified: forrest/site/docs_0_70/validation.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_70/validation.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_70/validation.html (original) +++ forrest/site/docs_0_70/validation.html Wed Jul 27 21:59:26 2005 @@ -341,7 +341,7 @@ forrest.properties: 

    forrest.validate.xdocs.excludes=slides.xml, manual/**
    -
    +
    Note
    The failonerror properties only work for files validated @@ -500,7 +500,7 @@

    We now have a DTD for the 'download' document type.

    -
    +
    Note
    @@ -527,7 +527,7 @@ break. The solution Forrest uses is to ignore the system id, and rely on a mapping from the public ID to a stable DTD location, via a Catalog file.

    -
    +
    Note
    See this article for a good Modified: forrest/site/docs_0_70/views.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_70/views.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_70/views.html (original) +++ forrest/site/docs_0_70/views.html Wed Jul 27 21:59:26 2005 @@ -276,7 +276,7 @@
    -
    +
    Warning
    This document is heavily under development
    Modified: forrest/site/docs_0_70/your-project.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_70/your-project.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_70/your-project.html (original) +++ forrest/site/docs_0_70/your-project.html Wed Jul 27 21:59:26 2005 @@ -554,7 +554,7 @@ BUILD SUCCESSFUL Total time: 5 seconds -
    +
    Note
    As you have probably noticed, we like to document things right in the @@ -625,8 +625,8 @@ To render this to HTML, type 'forrest'. You should have a HTML site rendered into the build/site directory:

    -
    -New project
    +
    +New project

    Practise with adding new content. Change to the directory src/documentation/content/xdocs and copy the file @@ -854,7 +854,7 @@ layout to Forrest's. If you generated your site with 'forrest seed', you will have one pre-written, with all the entries commented out.

    -
    +
    Note
    You only need to un-comment entries if you are going to change them @@ -910,7 +910,7 @@ project.images-dir=${project.content-dir}/images project.skinconf=${project.content-dir}/skinconf.xml -
    +
    Note
    Internally, Forrest rearranges the specified directory into the default @@ -950,8 +950,8 @@ for more details, and again, consult Forrest's own docs for a usage example.

    -
    -Tabs
    +
    +Tabs

    You can have one or two levels of tabs. The images above show a single level. However, you can create a second level that will only be displayed when its parent tab is selected. For example, @@ -1042,7 +1042,7 @@ "Using project sitemaps" and some worked examples are shown in the following sections here.

    -
    +
    Note
    We advise you to spend time to understand the Apache Cocoon sitemap. @@ -1169,7 +1169,7 @@ transformation of our custom xml structure into the Forrest intermediate xdocs structure.

    -
    +
    Note
    The Sitemap @@ -1227,7 +1227,7 @@
  • Tell the system about your catalog.
    • -
    +
    Note
    Please see XML Validation @@ -1359,7 +1359,7 @@ To change the skin, edit the forrest.properties file to set project.skin=leather-dev or some other skin name.

    -
    +
    Note
    Forrest supplies a collection of @@ -1438,7 +1438,7 @@ This will protect your skin from changes in the Forrest common skin, but you must remember to update this skin in order to take advantage of new features added over time by the Forrest team.

    -
    +
    Note
    The above paragraph means that if you do copy an existing skin as this section recomends you will also need to copy the common skin @@ -1507,7 +1507,7 @@ </target> </project> -
    +
    Warning
    There is a bug in the plugin download mechanism in Forrest 0.7 that may prevent Modified: forrest/site/docs_0_80/build.html URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/build.html?rev=225685&r1=225684&r2=225685&view=diff ============================================================================== --- forrest/site/docs_0_80/build.html (original) +++ forrest/site/docs_0_80/build.html Wed Jul 27 21:59:26 2005 @@ -131,13 +131,16 @@ Maven Integration
    +Be a developer +
    +
    Build a Plugin
    Custom html source
    - - - -