Return-Path:
Delivered-To: apmail-forrest-svn-archive@www.apache.org
Received: (qmail 42320 invoked from network); 4 Dec 2006 03:24:22 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2)
by minotaur.apache.org with SMTP; 4 Dec 2006 03:24:22 -0000
Received: (qmail 92991 invoked by uid 500); 4 Dec 2006 03:24:30 -0000
Delivered-To: apmail-forrest-svn-archive@forrest.apache.org
Received: (qmail 92946 invoked by uid 500); 4 Dec 2006 03:24:30 -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 92935 invoked by uid 99); 4 Dec 2006 03:24:30 -0000
Received: from herse.apache.org (HELO herse.apache.org) (140.211.11.133)
by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 03 Dec 2006 19:24:30 -0800
X-ASF-Spam-Status: No, hits=-9.4 required=10.0
tests=ALL_TRUSTED,NO_REAL_NAME
X-Spam-Check-By: apache.org
Received: from [140.211.11.3] (HELO eris.apache.org) (140.211.11.3)
by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 03 Dec 2006 19:24:12 -0800
Received: by eris.apache.org (Postfix, from userid 65534)
id 9DF891A9846; Sun, 3 Dec 2006 19:23:32 -0800 (PST)
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
Subject: svn commit: r482028 [1/2] - in
/forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src:
./ resources/ resources/xslt/ xdocs/ xdocs/images/ xdocs/samples/
xdocs/samples/subdir/
Date: Mon, 04 Dec 2006 03:23:31 -0000
To: svn@forrest.apache.org
From: rgardler@apache.org
X-Mailer: svnmailer-1.1.0
Message-Id: <20061204032332.9DF891A9846@eris.apache.org>
X-Virus-Checked: Checked by ClamAV on apache.org
Author: rgardler
Date: Sun Dec 3 19:23:29 2006
New Revision: 482028
URL: http://svn.apache.org/viewvc?view=rev&rev=482028
Log:
The start of an example that processes a Forrest1 seed site.
Almost none of this is working right now, but the structure
is there. The first task is to complete the conversion of the
XDoc source files to the XHTML2 subset used in Forrest2.
This initial contribution provides an input plugin for this
but lots of work on the stylesheet is still needed.
see FOR-950
Added:
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/forrestContext.xml (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/locationmap.xml (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/resources/
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/resources/xslt/
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/resources/xslt/xdoc2-to-internal.xsl (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/favicon.ico (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/hello.pdf (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/group-logo.gif (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/group.svg (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/icon-e.png (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/icon.png (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/project-logo.gif (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/project.svg (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/usemap.gif (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/index.xml (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/ascii-art.xml (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/custom.xml (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/customSchema.xml (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/demo-i18n.de.xml (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/demo-i18n.nl.xml (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/demo-i18n.xml (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/document-v13.xml (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/ellipse.svg (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/embedded_html.html (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/hello-v10.dtd (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/helloAgain.pdf (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/i18n.xml (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/icon-d.png (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/index.xml (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/linking.xml (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/sample.xml (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/static.xml (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/subdir/
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/subdir/book-sample.xml (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/subdir/index.xml (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/svg.xml (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/usemap.xml (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/xml-entities.xml (with props)
forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/tabs.xml (with props)
Added: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/forrestContext.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/forrestContext.xml?view=auto&rev=482028
==============================================================================
--- forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/forrestContext.xml (added)
+++ forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/forrestContext.xml Sun Dec 3 19:23:29 2006
@@ -0,0 +1,48 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Propchange: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/forrestContext.xml
------------------------------------------------------------------------------
svn:eol-style = native
Added: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/locationmap.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/locationmap.xml?view=auto&rev=482028
==============================================================================
--- forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/locationmap.xml (added)
+++ forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/locationmap.xml Sun Dec 3 19:23:29 2006
@@ -0,0 +1,22 @@
+
+
+
+
+
+
+
\ No newline at end of file
Propchange: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/locationmap.xml
------------------------------------------------------------------------------
svn:eol-style = native
Added: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/resources/xslt/xdoc2-to-internal.xsl
URL: http://svn.apache.org/viewvc/forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/resources/xslt/xdoc2-to-internal.xsl?view=auto&rev=482028
==============================================================================
--- forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/resources/xslt/xdoc2-to-internal.xsl (added)
+++ forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/resources/xslt/xdoc2-to-internal.xsl Sun Dec 3 19:23:29 2006
@@ -0,0 +1,42 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Propchange: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/resources/xslt/xdoc2-to-internal.xsl
------------------------------------------------------------------------------
svn:eol-style = native
Added: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/favicon.ico
URL: http://svn.apache.org/viewvc/forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/favicon.ico?view=auto&rev=482028
==============================================================================
Binary file - no diff available.
Propchange: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/favicon.ico
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/hello.pdf
URL: http://svn.apache.org/viewvc/forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/hello.pdf?view=auto&rev=482028
==============================================================================
Binary file - no diff available.
Propchange: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/hello.pdf
------------------------------------------------------------------------------
svn:mime-type = application/pdf
Added: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/group-logo.gif
URL: http://svn.apache.org/viewvc/forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/group-logo.gif?view=auto&rev=482028
==============================================================================
Binary file - no diff available.
Propchange: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/group-logo.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/group.svg
URL: http://svn.apache.org/viewvc/forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/group.svg?view=auto&rev=482028
==============================================================================
--- forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/group.svg (added)
+++ forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/group.svg Sun Dec 3 19:23:29 2006
@@ -0,0 +1,82 @@
+
+
+
+
+
+
+
Propchange: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/group.svg
------------------------------------------------------------------------------
svn:eol-style = native
Added: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/icon-e.png
URL: http://svn.apache.org/viewvc/forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/icon-e.png?view=auto&rev=482028
==============================================================================
Binary file - no diff available.
Propchange: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/icon-e.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/icon.png
URL: http://svn.apache.org/viewvc/forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/icon.png?view=auto&rev=482028
==============================================================================
Binary file - no diff available.
Propchange: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/icon.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/project-logo.gif
URL: http://svn.apache.org/viewvc/forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/project-logo.gif?view=auto&rev=482028
==============================================================================
Binary file - no diff available.
Propchange: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/project-logo.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/project.svg
URL: http://svn.apache.org/viewvc/forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/project.svg?view=auto&rev=482028
==============================================================================
--- forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/project.svg (added)
+++ forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/project.svg Sun Dec 3 19:23:29 2006
@@ -0,0 +1,82 @@
+
+
+
+
+
+
+
Propchange: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/project.svg
------------------------------------------------------------------------------
svn:eol-style = native
Added: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/usemap.gif
URL: http://svn.apache.org/viewvc/forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/usemap.gif?view=auto&rev=482028
==============================================================================
Binary file - no diff available.
Propchange: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/images/usemap.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/index.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/index.xml?view=auto&rev=482028
==============================================================================
--- forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/index.xml (added)
+++ forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/index.xml Sun Dec 3 19:23:29 2006
@@ -0,0 +1,49 @@
+
+
+
+
+
+ Welcome to MyProj
+
+
+
+ Congratulations
+
You have successfully generated and rendered an Apache Forrest site.
+ This page is from the site template. It is found in
+ src/documentation/content/xdocs/index.xml
+ Please edit it and replace this text with content of your own.
+
+
+
+ Using examples as templates
+
+ This demo site has many examples. See the menu at the left.
+ The sources for these examples are in the directory
+ src/documentation/content/xdocs/
+
+
+ The sources for the Apache Forrest website are also included
+ in your distribution at $FORREST_HOME/site-author/
+
+
You can also extend the functionality of Forrest via
+ plugins,
+ these will often come with more samples for you to out.
To create a .png image like the one below with ASCII art, just save
+ the text file with the .aart extension and then link from any page
+ as an image (<image src="asci-art-file.png"/>).
+
+
Here is the source file that has created the above image.
+
+
An ascii art pad recognized following ascii characters:
+
+
'-' horizontal SVG line
+
'|' vertical SVG line
+
'+' corner
+
\ oblique line
+
String starting with letter, digit, or '_' is converted to a SVG text.
Forrest comes with a set of schemas for common documents, however, if you have existing documents
+ that use a different schema you will want to tell Forrest how to work with them. The best way of doing
+ this is to build a plugin
+ so that you can easily reuse the functionality on different projects. Plugins also allow you to share
+ this new functionality with other users, and to benefit from their contributions to your work.
+
+
If you don't want to build a plugin you can make Forrest process them within your project sitemap
+ (but this won't really save you any work since the process is almost the same). This sample site has
+ a demonstration of using a custom DTD. If you request <a href="custom.html">
+ you can see the results.
+
+
+ Look at the project sitemap.xmap to see how it is done.
+ View the xml source at
+ "src/documentation/content/samples/custom.xml" and
+ refer to the DTD and its configuration at
+ "src/documentation/resources/schema/".
+ See the project sitemap at "src/documentation/sitemap.xmap" for how
+ the custom doctype is processed and the stylesheet is applied.
+
+
+ See the
+ full story
+ about handling custom document types.
+
+
+ Adding custom schemas with a plugin has the added benefit of being able to add the schema
+ definition to the catalog file rather than having to reference it directly from within the XML
+ document.
+
+
Propchange: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/customSchema.xml
------------------------------------------------------------------------------
svn:eol-style = native
Added: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/demo-i18n.de.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/demo-i18n.de.xml?view=auto&rev=482028
==============================================================================
--- forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/demo-i18n.de.xml (added)
+++ forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/demo-i18n.de.xml Sun Dec 3 19:23:29 2006
@@ -0,0 +1,45 @@
+
+
+
+
+
+ Wilkommen zu "MyProj"
+
+
+
+ Bravo!
+
Sie haben ein Apache Forrest basiertes
+ Projekt generiert. Diese Seite wird von einer xdocs konformen Datei
+ src/documentation/content/xdocs/samples/demo-i18n.de.xml
+
+
+
+
+ Ãbersetzungen
+
+ Im Site-Skeleton ist nur diese Seite übersetzt, um die i18n-Features
+ zu testen.
+
+
+ Für mehr Informationen, konsultieren Sie bitte die
+ i18n.
+
U hebt succesvol een Apache Forrest site aangemaakt.
+ Deze pagina komt uit een site template. Dit template vind u in
+ src/documentation/content/xdocs/samples/demo-i18n.nl.xml
+
You have successfully generated and rendered an Apache Forrest site.
+ This page is from the site template. It is found in
+ src/documentation/content/xdocs/samples/demo-i18n.xml
+
+
+
+
Propchange: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/demo-i18n.xml
------------------------------------------------------------------------------
svn:eol-style = native
Added: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/document-v13.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/document-v13.xml?view=auto&rev=482028
==============================================================================
--- forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/document-v13.xml (added)
+++ forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/document-v13.xml Sun Dec 3 19:23:29 2006
@@ -0,0 +1,381 @@
+
+
+
+
+
+ The Apache Forrest xdocs document-v1.3 DTD
+ The content of this document doesn't make any sense at all.
+ This is a demonstration document using all possible elements in
+ the current Apache Forrest xdocs document-v13.dtd
+
+
+
+
+ This is a demonstration document using all possible elements in the
+ current Apache Forrest xdocs document-v13.dtd
+ (See the DTD changes section at the bottom.)
+
+
+ Sample Content
+
Hint: See the xml source to see how the various
+ elements are used and see the
+
+ DTD reference documentation.
+
+
+ Block and inline elements
+
This is a simple paragraph. Most documents contain a fair amount of
+ paragraphs. Paragraphs are called <p>.
+
With the <p xml:space="preserve"> attribute, you can declare
+ that whitespace should be preserved, without implying it is in any other
+ way special.
+
+ This next paragraph has a class attribute of 'quote'. CSS can
+ be used to present this <p class='quote'> in
+ a different style than the other paragraphs. The handling of
+ this quoted paragraph is defined in the <extra-css>
+ element in the skinconf.xml.
+
+
+ Anyway, like I was sayin', shrimp is the fruit of the sea. You can
+ barbecue it, boil it, broil it, bake it, sautee it. Dey's uh,
+ shrimp-kabobs, shrimp creole, shrimp gumbo. Pan fried, deep fried,
+ stir-fried. There's pineapple shrimp, lemon shrimp, coconut shrimp,
+ pepper shrimp, shrimp soup, shrimp stew, shrimp salad, shrimp and
+ potatoes, shrimp burger, shrimp sandwich. That- that's about it.
+
+
A number of in-line elements are available in the DTD, we will show them
+ inside an unordered list (<ul>):
+
+
Here is a simple list item (<li>).
+
Have you seen the use of the <code> element in the
+ previous item?
+
Also, we have <sub> and <sup>
+ elements to show content above or below the text
+ baseline.
+
There is a facility to emphasize certain words using the
+ <em><strong>
+ elements.
+
We can use
+
+ <icon>s too.
+
Another possibility is the <img> element:
+ ,
+ which offers the ability to refer to an image map.
+
We have elements for hyperlinking:
+
+
<link href="faq.html">
+
Use this to
+ link
+ to another document. As per normal, this will open the new document
+ in the same browser window.
+
+
<link href="#section">
+
Use this to
+ link
+ to the named anchor in the current document.
+
+
+
<link href="faq.html#forrest">
+
Use this to
+ link
+ to another document and go to the named anchor. This will open
+ the new document in the same browser window.
+
+
+
<jump href="faq.html">
+
Use this to
+ jump
+ to another document and optionally go to a named
+ anchor
+ within that document. This will open the new document in the same
+ browser window. So what is the difference between link and jump?
+ The jump behaves differently, in that it will replace any frames
+ in the current window.
+ This is the equivalent of
+ <a ... target="_top">
+
+
+
<fork href="faq.html">
+
Use this to
+ fork
+ your webbrowser to another document. This will open the document
+ in a new, unnamed browser window.
+ This is the equivalent of
+ <a ... target="_blank">
+
+
+
+
Oh, by the way, a definition list <dl> was used inside
+ the previous list item. We could put another
+
+
unordered list
+
inside the list item
+
+
+
A sample nested table
+
Or even tables..
+
inside tables..
+
+
or inside lists, but I believe this liberty gets quickly quite
+ hairy as you see.
+
+
+
+
So far for the in-line elements, let's look at some paragraph-level
+ elements.
+ The <fixme> element is used for stuff
+ which still needs work. Mind the author attribute!
+ Use the <note> element to draw attention to something, e.g. ...The <code> element is used when the author can't
+ express himself clearly using normal sentences ;-)
+ Sleep deprivation can be the result of being involved in an open
+ source project. (a.k.a. the <warning> element).
+
+ If you want your own labels for notes and
+ warnings, specify them using the label attribute.
+
+
Apart from unordered lists, we have ordered lists too, of course.
+
+
Item 1
+
Item 2
+
This should be 3 if my math is still OK.
+
+
+
+
+ Various presentation formats
+
+
This sample document, written in document-v13 XML can be presented
+ via Forrest in a number of different formats. The links in the
+ following list show this document in each of the currently available
+ formats.
+
+
Each of the formats can be made available as a link near the top of
+ the page. Actual placement of those links depends on the skin
+ currently in use. Those links are enabled in the skinconf.xml via the
+ <disable-XXX-link> elements in the skinconf.xml
+
+
+
+
Presentation Format
+
+
Description
+
+
skinconf.xml Element
+
+
+
+
HTML
+
+
This document in HTML format.
+
+
Always generated by default. Cannot be turned off.
+
+
+
+
XML
+
+
This document in its raw XML format.
+
+
<disable-xml-link>. By default, set to true, meaning
+ that this link will not be shown.
+
+
+
+
PDF
+
+
This document as Adobe PDF
+
+
<disable-pdf-link>. By default, set to false, meaning
+ that this link will be shown.
+
+
+
+
Text
+
+
This document as straight text.
+
For additional information see the Forrest text-output
+ plugin.
+
+
<disable-txt-link>. By default, set to true, meaning
+ that this link will not be shown.
+
+
+
+
POD
+
+
This document as Perl POD (Plain Old Documentation). Text
+ with minimal formatting directives. If on a *nix system with perl
+ installed, see "man perlpod".
+
For additional information see the Forrest pod-output
+ plugin.
+
+
<disable-pod-link>. By default, set to true, meaning
+ that this link will not be shown.
+
+
+
+
+ Using sections
+
You can use sections to put some structure in your document. For some
+ strange historical reason, the section title is an attribute of the
+ <section> element.
+
+
+ Sections, the sequel
+
Just some second section.
+
+ Section 2.1
+
Which contains a subsection (2.1).
+
+
+
+
+ Showing preformatted source code
+
Enough about these sections. Let's have a look at more interesting
+ elements, <source> for instance:
+
+
CDATA sections are used within
+ <source> elements so that you can write pointy
+ brackets without needing to escape them with messy
+ < entities ...
+
+
+
Please take care to still use a sensible line-length within your
+ source elements.
+
+
+
+ Using tables
+
And now for a table:
+
+
Table caption
+
+
heading cell 1
+
heading cell 2
+
heading cell 3
+
+
+
data cell
+
this data cell spans two columns
+
+
+
+ Tables can be nested:
+
+
+
+
+
column 1
+
column 2
+
+
+
cell A
+
cell B
+
+
+
+
+
and can include most other elements
such as lists
+
+
+
+
+
+
+
+ Using figures
+
And a <figure> to end all of this.
+ Note that this can also be implemented with an
+ <img> element.
+
+
+
+
+
+
+ DTD changes
+
See the generated
+
+ DTD reference documentation.
+
+
+ Changes since document-v12
+
+ All v1.2 docs will work fine as v1.3 DTD. The main change is the
+ addition of a @class attribute to every element, which enables the
+ "extra-css" section in the skinconf to be put to good use.
+
+
+
+ Changes since document-v11
+
+ doc-v12 enhances doc-v11 by relaxing various restrictions that were
+ found to be unnecessary.
+
+
+
+ Links ((link|jump|fork) and inline elements (br|img|icon|acronym) are
+ allowed inside title.
+
+
+ Paragraphs (p|source|note|warning|fixme), table and figure|anchor are
+ allowed inside li.
+
+
+ Paragraphs (p|source|note|warning|fixme), lists (ol|ul|dl), table,
+ figure|anchor are allowed inside definition lists (dd) and tables (td
+ and dh).
+
+
+ Inline content
+ (strong|em|code|sub|sup|br|img|icon|acronym|link|jump|fork) is
+ allowed in strong and em.
+
An HTML document is used as the source for this page, and translated
+to the intermediate Apache Forrest xdocs document structure. The sitemap then
+does the normal aggregation with the navigation content and application of
+the skin.
+
+
+
+The html is being interpreted by Forrest and transformed to the
+intermediate Apache xdocs document structure. That stylesheet cannot deal
+with every possibility in unstructured html, so it tries to guess how to
+build <section> elements and such.
+It needs <h1> (<h2> etc.) headings in the source html
+in order to identify sections. Patches are welcome to enhance
+that transformer.
+
+
+
+XHTML can also be used, but it is just treated as interpreted
+html. Future versions of Forrest will take much more advantage of XHTML.
+
+
+
+
Some example uses of HTML
+
+There are situations when the Apache Forrest xdocs DTD is not sufficient.
+The use of embedded HTML enables you to use HTML code in these situations.
+
+This paragraph has a missing closing tag for the <p> element. If you look
+at the XML created by Forrest you'll notice that
+Forrest has fixed this.
+
+
Potentially Invalid XDocs
+
+However, it should also be noted that the resultant XML is not a valid document
+since it contains the additional HTML elements. If you are intending to use
+the intermediate XDocs for any purpose be aware of this fact.
+
+
Other non-standard html-type abilities
+
+Use other HTML .
+
+
+
Propchange: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/embedded_html.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/hello-v10.dtd
URL: http://svn.apache.org/viewvc/forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/hello-v10.dtd?view=auto&rev=482028
==============================================================================
--- forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/hello-v10.dtd (added)
+++ forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/hello-v10.dtd Sun Dec 3 19:23:29 2006
@@ -0,0 +1,49 @@
+
+
+
+
+
+
+
+
Propchange: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/hello-v10.dtd
------------------------------------------------------------------------------
svn:eol-style = native
Added: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/helloAgain.pdf
URL: http://svn.apache.org/viewvc/forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/helloAgain.pdf?view=auto&rev=482028
==============================================================================
Binary file - no diff available.
Propchange: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/helloAgain.pdf
------------------------------------------------------------------------------
svn:mime-type = application/pdf
Added: forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/i18n.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/i18n.xml?view=auto&rev=482028
==============================================================================
--- forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/i18n.xml (added)
+++ forrest/trunk/whiteboard/forrest2/core/src/examples/forrest1SeedSite/src/xdocs/samples/i18n.xml Sun Dec 3 19:23:29 2006
@@ -0,0 +1,52 @@
+
+
+
+
+
+ Internationalisation (i18n)
+
+
+
+ Introduction
+
+
+
+This sample will explain and demonstrate the i18n capabilities.
+Issue FOR-707 has some discussion and doc links.
+We need to summarise it all into this demo.
+
+
+
+ Using the locale request parameter
+
+ As a simple example of Forrest's i18n functionality, you can view
+ this demo page. To see alternative language
+ versions of this page, append the locale request parameter,
+ e.g. localhost:8888/samples/demo-i18n.html?locale=fr
+
+
+
+ There are some other laguage demos (de, fr, nl).
+
+
This only works in 'forrest run' mode.
+ There are other ways to switch, this is just one way of
+ demonstrating these features.
+