forrest-svn mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cross...@apache.org
Subject svn commit: rev 56836 - forrest/trunk/site/content/xdocs
Date Sun, 07 Nov 2004 10:21:28 GMT
Author: crossley
Date: Sun Nov  7 02:21:27 2004
New Revision: 56836

Added:
   forrest/trunk/site/content/xdocs/flyer.xml   (contents, props changed)
Modified:
   forrest/trunk/site/content/xdocs/site.xml
Log:
Add one-page flyer. Initial content grabbed from home page.


Added: forrest/trunk/site/content/xdocs/flyer.xml
==============================================================================
--- (empty file)
+++ forrest/trunk/site/content/xdocs/flyer.xml	Sun Nov  7 02:21:27 2004
@@ -0,0 +1,98 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Copyright 2002-2004 The Apache Software Foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
+<document>
+  <header>
+    <title>Apache Forrest: documentation framework</title>
+  </header>
+  <body>
+    <p>
+      Apache Forrest
+      (<a href="site:forrest">forrest.apache.org</a>)
+       is an XML standards-oriented documentation framework
+      based upon Apache Cocoon, providing XSLT stylesheets and schemas,
+      images and other resources. Forrest uses these to render the source
+      content into various output formats via command-line, robot, or
+      dynamic application.
+    </p>
+    <p>
+      By <strong>separating content from
+      presentation</strong>, providing <strong>content templates</strong>
+      and <strong>pre-written skins</strong>, Forrest is unequalled at enabling
+      content producers to get their message out fast.  This separation of
+      concerns makes Forrest excellent
+      to publish <strong>project documentation</strong> (notably software projects),
+      <strong>intranets</strong>, and <strong>home pages</strong>.
+    </p>
+    <p>
+      Forrest is
+      built on one of the world's leading XML application frameworks, 
+      <a href="ext:cocoon">Apache Cocoon</a>, which provides advanced
+      users with extremely powerful publishing capabilities.
+    </p>
+    <ul>
+      <li>Multiple task-specific source XML formats can be used
+       (<a href="site:howto">How-To</a>,
+        <a href="site:faq"><acronym title="Frequently Asked
+            Questions">FAQ</acronym></a>,
+        <a href="site:changes">changelogs</a> and
+        <a href="site:todo">todo lists</a> supported natively).
+        Source formats include: Apache xdocs xml format, plain html
+        documents, some Wiki formats, a subset of DocBook, ...
+      </li>
+      <li>Multiple output formats supported, for example HTML and PDF (using
+        <a href="ext:fop">Apache FOP</a>).
+      </li>
+      <li>SVG to PNG rendering (using <a href="ext:batik">Apache
+        Batik</a>). Simply drop the SVG in the appropriate directory
+        and it will be rendered as PNG.</li>
+      <li>
+        Transparent inclusion and aggregation of external content, like
+        <a href="site:changes-rss">RSS feeds</a>.
+      </li>
+      <li>
+        Anything else possible with the
+        <a href="ext:cocoon/sitemap">Cocoon sitemap</a>.  Using database
+        queries, <a href="ext:apache-stats">charting</a>, web services
+        integration; the possibilities are constantly growing as Cocoon grows.
+        See the <a href="ext:cocoon/features">Cocoon Features</a> list
+        for the full suite of capabilities.
+      </li>
+      <li>
+        Based on Java, Forrest is platform-independent, making for a
+        documentation system that is just as portable as the XML data it
+        processes.
+      </li>
+      <li>
+        Your development team does not need Java experience, or even XML
+        skills, to use Forrest. The framework lets you concentrate on
+        content and design.
+      </li>
+    </ul>
+    <p>
+      Unique amongst comparable documentation tools, Forrest generates
+      sites that can run both <strong>interactively</strong> as a dynamic
+      web application, or as statically rendered pages.
+      Running as a webapp has a major advantage during development:
+      content can be written, and
+      then the rendered output viewed almost instantly in a web browser.
+      This <a href="site:your-project/webapp">webapp technique</a>
+      enables the edit/review cycle to be faster than command-line
+      transformation tools.
+    </p>
+  </body>
+</document>

Modified: forrest/trunk/site/content/xdocs/site.xml
==============================================================================
--- forrest/trunk/site/content/xdocs/site.xml	(original)
+++ forrest/trunk/site/content/xdocs/site.xml	Sun Nov  7 02:21:27 2004
@@ -22,6 +22,7 @@
     <download label="Download" href="http://forrest.apache.org/mirrors.cgi"/>
     <download_html href="mirrors.html"/>
     <who label="Who we are" href="who.html"/>
+    <flyer label="Flyer" href="flyer.html"/>
     <faq label="FAQs" href="faq.html">
       <docbook href="#docbook"/>
       <ignoring_javadocs href="#ignoring_javadocs"/>

Mime
View raw message