forrest-svn mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From gmcdon...@apache.org
Subject svn commit: r556367 [2/2] - in /forrest/trunk/main/fresh-site/src/documentation/content/xdocs: samples/ samples1/ samples1/locationmap/ samples2/ samples2/showonlywhenselected/ samples2/subdir/
Date Sun, 15 Jul 2007 06:39:31 GMT
Added: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples1/sample.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples1/sample.xml?view=auto&rev=556367
==============================================================================
--- forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples1/sample.xml (added)
+++ forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples1/sample.xml Sat Jul 14 23:39:28 2007
@@ -0,0 +1,452 @@
+<?xml version="1.0"?>
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You 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>The Apache Forrest xdocs document-v2.0 DTD</title>
+    <notice>The content of this document doesn't make any sense at all.</notice>
+    <abstract>
+      This is a demonstration document using all possible elements in the
+      current Apache Forrest xdocs <code>document-v20.dtd</code>
+    </abstract>
+  </header>
+  <body>
+    <note>
+      This is a demonstration document using all possible elements in the
+      current Apache Forrest xdocs <code>document-v20.dtd</code> (See the
+      <a href="#changes">DTD changes</a> section at the bottom.)
+    </note>
+    <section id="sample">
+      <title>Sample Content</title>
+      <p>
+        <strong>Hint:</strong> See the xml source to see how the various
+        elements are used and see the
+<!-- FOR-321 workaround
+      <a href="ext:dtd-docs">DTD reference documentation</a>.
+-->
+        <a href="http://forrest.apache.org/docs/dtd-docs.html">DTD reference
+        documentation</a>.
+      </p>
+      <section id="block-inline">
+        <title>Block and inline elements</title>
+        <p>
+          This is a simple paragraph. Most documents contain a fair amount of
+          paragraphs. Paragraphs are called <code>&lt;p&gt;</code>.
+        </p>
+        <p xml:space="preserve">
+          With the <code>&lt;p xml:space="preserve"&gt;</code> attribute, you can declare
+          that whitespace should    be   preserved, without implying it is in any other
+          way special.
+        </p>
+        <p>
+          This next paragraph has a class attribute of 'quote'. CSS can be used
+          to present this <code>&lt;p class='quote'&gt;</code> in a different
+          style than the other paragraphs. The handling of this quoted paragraph
+          is defined in the &lt;extra-css&gt; element in the skinconf.xml.
+        </p>
+        <p class="quote">
+          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.
+        </p>
+        <p>
+          A number of in-line elements are available in the DTD, we will show
+          them inside an unordered list (<code>&lt;ul&gt;</code>):
+        </p>
+        <ul>
+          <li>Here is a simple list item (<code>&lt;li&gt;</code>).</li>
+          <li>Have you seen the use of the <code>&lt;code&gt;</code> element in the
+          previous item?</li>
+          <li>Also, we have <code>&lt;sub&gt;</code> and <code>&lt;sup&gt;</code>
+          elements to show content <sup>above</sup> or <sub>below</sub> the text
+          baseline.</li>
+          <li>There is a facility to <em>emphasize</em> certain words using the
+          <code>&lt;em&gt;</code><strong><code>&lt;strong&gt;</code></strong>
+          elements.</li>
+          <li>We can use
+          <icon height="22" width="26" src="images/icon.png" alt="feather"/><code>&lt;icon&gt;</code>s too.</li>
+          <li>Another possibility is the <code>&lt;img&gt;</code> element:
+          <img src="images/icon.png" alt="another feather" height="22" width="26"/>,
+          which offers the ability to refer to an image map.</li>
+          <li>We have elements for hyperlinking: 
+          <dl>
+              <dt><code>&lt;a href="../index.html"&gt;</code></dt>
+              <dd>Use this to
+              <a href="../index.html" title="Example of a document via link">link</a>
+              to another document. As per normal, this will open the new document
+              in the same browser window.</dd>
+              <dt><code>&lt;a href="#section"&gt;</code></dt>
+              <dd>Use this to
+              <a href="#section" title="Example of a document via local anchor">link</a>
+              to the named anchor in the current document.
+            </dd>
+              <dt><code>&lt;a href="../index.html#status"&gt;</code></dt>
+              <dd>Use this to
+              <a href="../index.html#status" title="Example of a document via link and anchor">link</a>
+              to another document and go to the named anchor. This will open
+              the new document in the same browser window.
+            </dd>
+              <dt>Targetted window control with jump and fork.</dt>
+              <dd>See demonstration
+             <a href="#link-class">using class attribute on links</a>.
+            </dd>
+            </dl></li>
+          <li>Oh, by the way, a definition list <code>&lt;dl&gt;</code> was used inside
+          the previous list item. We could put another 
+          <ul>
+              <li>unordered list</li>
+              <li>inside the list item</li>
+            </ul>
+            <table>
+              <caption>A sample nested table</caption>
+              <tr>
+                <td>Or even tables.. </td>
+                <td>
+                  <table>
+                    <tr>
+                      <td>inside tables..</td>
+                    </tr>
+                  </table>
+                </td>
+              </tr>
+              <tr>
+                <td>or inside lists, but I believe this liberty gets quickly quite
+                hairy as you see.</td>
+              </tr>
+            </table></li>
+        </ul>
+        <p>
+          So far for the in-line elements, let's look at some paragraph-level
+          elements.
+        </p>
+        <fixme author="SN">
+          The <code>&lt;fixme&gt;</code> element is used for stuff which still
+          needs work. Mind the <code>author</code> attribute!
+        </fixme>
+        <note>
+          Use the <code>&lt;note&gt;</code> element to draw attention to
+          something, e.g. ...The <code>&lt;code&gt;</code> element is used when
+          the author can't express himself clearly using normal sentences ;-)
+        </note>
+        <warning>
+          Sleep deprivation can be the result of being involved in an open
+          source project. (a.k.a. the <code>&lt;warning&gt;</code> element).
+        </warning>
+        <note label="Important">
+          If you want your own labels for notes and warnings, specify them using
+          the <code>label</code> attribute.
+        </note>
+        <p>
+          Apart from unordered lists, we have ordered lists too, of course.
+        </p>
+        <ol>
+          <li>Item 1</li>
+          <li>Item 2</li>
+          <li>This should be 3 if my math is still OK.</li>
+        </ol>
+      </section>
+      <section id="presentations">
+        <title>Various presentation formats</title>
+        <p>
+          This sample document, written in document-v20 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.
+        </p>
+        <p>
+          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
+          &#60;disable-XXX-link&#62; elements in the skinconf.xml
+        </p>
+        <table>
+          <tr>
+            <th>Presentation Format</th>
+            <th>Description</th>
+            <th>skinconf.xml Element</th>
+          </tr>
+          <tr>
+            <td><a href="sample.html">HTML</a>
+            </td>
+            <td>This document in HTML format. </td>
+            <td>Always generated by default. Cannot be turned off.</td>
+          </tr>
+          <tr>
+            <td><a href="sample.xml">XML</a>
+            </td>
+            <td>This document in its raw XML format.</td>
+            <td>&#60;disable-xml-link&#62;. By default, set to true, meaning
+            that this link will not be shown.</td>
+          </tr>
+          <tr>
+            <td><a href="sample.pdf">PDF</a>
+            </td>
+            <td>This document as Adobe PDF</td>
+            <td>&#60;disable-pdf-link&#62;. By default, set to false, meaning
+            that this link will be shown.</td>
+          </tr>
+          <tr>
+            <td>Text</td>
+            <td>
+              <p>
+                This document as straight text.
+              </p>
+              <p>
+                For additional information see the Forrest text-output plugin.
+              </p>
+            </td>
+            <td>&#60;disable-txt-link&#62;. By default, set to true, meaning
+            that this link will not be shown.</td>
+          </tr>
+          <tr>
+            <td>POD</td>
+            <td>
+              <p>
+                This document as Perl POD (Plain Old Documentation). Text with
+                minimal formatting directives. If on a *nix system with perl
+                installed, see &#34;man perlpod&#34;.
+              </p>
+              <p>
+                For additional information see the Forrest pod-output plugin.
+              </p>
+            </td>
+            <td>&#60;disable-pod-link&#62;. By default, set to true, meaning
+            that this link will not be shown.</td>
+          </tr>
+        </table>
+      </section>
+      <section id="section">
+        <title>Using sections</title>
+        <p>
+          You can use sections to put some structure in your document.
+        </p>
+      </section>
+      <section id="sub-section">
+        <title>Sections, the sequel</title>
+        <p>
+          Just some second section.
+        </p>
+        <section id="sub-sub-section">
+          <title>Section 2.1</title>
+          <p>
+            Which contains a subsection (2.1).
+          </p>
+        </section>
+      </section>
+      <section id="source">
+        <title>Showing preformatted source code</title>
+        <p>
+          Enough about these sections. Let's have a look at more interesting
+          elements, <code>&lt;source&gt;</code> for instance:
+        </p>
+        <source>
+// This example is from the book _Java in a Nutshell_ by David Flanagan.
+// Written by David Flanagan.  Copyright (c) 1996 O'Reilly &amp; Associates.
+// You may study, use, modify, and distribute this example for any purpose.
+// This example is provided WITHOUT WARRANTY either expressed or implied.
+
+import java.applet.*;    // Don't forget these import statements!
+import java.awt.*;
+
+public class FirstApplet extends Applet {
+    // This method displays the applet.
+    // The Graphics class is how you do all drawing in Java.
+    public void paint(Graphics g) {
+        g.drawString("Hello World", 25, 50);
+    }
+}</source>
+        <p>
+          CDATA sections are used within <code>&lt;source&gt;</code> elements so
+          that you can write pointy brackets without needing to escape them with
+          messy <code>&amp;lt;</code> entities ...
+        </p>
+        <source>
+<![CDATA[
+<pointy>
+  easy
+</pointy>
+]]>
+        </source>
+        <p>
+          Please take care to still use a sensible line-length within your
+          source elements.
+        </p>
+      </section>
+      <section id="table">
+        <title>Using tables</title>
+        <p>
+          And now for a table:
+        </p>
+        <table>
+          <caption>Table caption</caption>
+          <tr>
+            <th>heading cell 1</th>
+            <th>heading cell 2</th>
+            <th>heading cell 3</th>
+          </tr>
+          <tr>
+            <td>data cell</td>
+            <td colspan="2">this data cell spans two columns</td>
+          </tr>
+          <tr>
+            <td>
+              Tables can be nested:
+            </td>
+            <td>
+              <table>
+                <tr>
+                  <th>column 1</th>
+                  <th>column 2</th>
+                </tr>
+                <tr>
+                  <td>cell A</td>
+                  <td>cell B</td>
+                </tr>
+              </table>
+            </td>
+            <td>
+              <ul>
+                <li>and can include most other elements</li>
+                <li>such as lists</li>
+              </ul>
+            </td>
+          </tr>
+        </table>
+      </section>
+      <anchor id="second-figure-anchor"/>
+      <section id="figure">
+        <title>Using figures</title>
+        <p>
+          And a <code>&lt;figure&gt;</code> to end all of this. Note that this
+          can also be implemented with an <code>&lt;img&gt;</code> element.
+        </p>
+        <figure src="images/project-logo.png" alt="The fine Forrest logo" width="220" height="65"/>
+      </section>
+      <section id="link-class">
+        <title>Using class attribute on links</title>
+        <p>
+          The document-v13 had elements &lt;fork&gt; and &lt;jump&gt;. In
+          document-v20, those elements no longer exist but the functionality can
+          be duplicated by using the @class attribute. Even though the opening
+          of separate windows should be under the control of the user, these
+          techniques can still be employed.
+        </p>
+        <table>
+          <tr>
+            <th>
+              <p>
+                Document V1.3
+              </p>
+            </th>
+            <th>
+              <p>
+                Document V2.0
+              </p>
+            </th>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                &lt;fork href="../index.html"&gt;
+              </p>
+            </td>
+            <td><a class="fork" href="../index.html">&lt;a class="fork"
+            href="../index.html"&gt;</a>
+            </td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                &lt;jump href="../index.html"&gt;
+              </p>
+            </td>
+            <td>
+              <p>
+                <a class="jump" href="../index.html">&lt;a class="jump"
+                href="../index.html"&gt;</a>
+              </p>
+            </td>
+          </tr>
+        </table>
+      </section>
+    </section>
+    <section id="changes">
+      <title>DTD changes</title>
+      <p>
+        See the generated
+<!-- FOR-321 workaround
+      <a href="ext:dtd-docs">DTD reference documentation</a>.
+-->
+        <a href="http://forrest.apache.org/docs/dtd-docs.html">DTD reference
+        documentation</a>.
+      </p>
+      <section id="changes-20">
+        <title>Changes between document-v13 and document-v20</title>
+        <ul>
+          <li>Renamed <strong>&lt;link&gt;</strong>
+             to <strong>&lt;a&gt;</strong></li>
+          <li>Removed <strong>&lt;fork&gt;</strong>
+             and <strong>&lt;jump&gt;</strong> in favour of the
+             <strong>&lt;a&gt;</strong> element. See demonstration
+             <a href="#link-class">using class attribute on links</a>.
+          </li>
+        </ul>
+      </section>
+      <section id="changes-13">
+        <title>Changes between document-v12 and document-v13</title>
+        <p>
+          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.
+        </p>
+      </section>
+      <section id="changes-12">
+        <title>Changes between document-v11 and document-v12</title>
+        <p>
+          doc-v12 enhances doc-v11 by relaxing various restrictions that were
+          found to be unnecessary.
+        </p>
+        <ul>
+          <li>
+            Links ((link|jump|fork) and inline elements (br|img|icon|acronym) are
+            allowed inside title.
+          </li>
+          <li>
+            Paragraphs (p|source|note|warning|fixme), table and figure|anchor are
+            allowed inside li.
+          </li>
+          <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).
+          </li>
+          <li>
+            Inline content
+            (strong|em|code|sub|sup|br|img|icon|acronym|link|jump|fork) is
+            allowed in strong and em.
+          </li>
+        </ul>
+      </section>
+    </section>
+  </body>
+  <footer>
+    <legal>This is a legal notice, so it is <strong>important</strong>.</legal>
+  </footer>
+</document>

Propchange: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples1/sample.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples1/static.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples1/static.xml?view=auto&rev=556367
==============================================================================
--- forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples1/static.xml (added)
+++ forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples1/static.xml Sat Jul 14 23:39:28 2007
@@ -0,0 +1,63 @@
+<?xml version="1.0"?>
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You 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>Static content - including raw un-processed files and documents</title>
+  </header>
+  <body>
+    <section>
+      <title>Linking to static content</title>
+      <p>
+        You can place some types of raw content into the xdocs directory. For
+        example, you can place a PDF file in
+        <code>src/documentation/content/xdocs</code> and link to it normally,
+        <strong>&lt;a
+        href="../hello.pdf"&gt;</strong><a href="../hello.pdf">hello.pdf</a><strong>&lt;/a&gt;</strong>
+        However, note that if the file is one that Forrest is able to process,
+        for example an HTML file, these files will be processed accordingly.
+      </p>
+      <p>
+        It is also worth noting that files in the xdocs directory will only be
+        copied into your final site if there is a link to them somewhere in the
+        site. See the next section for details of how to include content that is
+        not linked.
+      </p>
+      <p>
+        For more information see the <a href="site:linking">Linking
+        demonstration</a>.
+      </p>
+    </section>
+    <section>
+      <title>Including Static Content that is Not Linked</title>
+      <p>
+        You can include raw HTML, PDFs, plain-text, and other files. In your
+        final site by placing them in the <code>src/documentation/content</code>
+        directory. Files in this directory will be copied over automatically but
+        will not be processed in any way by Forrest, that is they will be linked
+        to as raw files.
+      </p>
+      <p>
+        You can also have sub-directories such as
+        <code>src/documentation/content/samples/subdir/</code> which reflects
+        your main <code>xdocs/</code> tree. The raw files will then end up
+        beside your documents.
+      </p>
+    </section>
+  </body>
+</document>

Propchange: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples1/static.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples1/svg.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples1/svg.xml?view=auto&rev=556367
==============================================================================
--- forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples1/svg.xml (added)
+++ forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples1/svg.xml Sat Jul 14 23:39:28 2007
@@ -0,0 +1,41 @@
+<?xml version="1.0"?>
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You 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>Using Scalable Vector Graphics (SVG)</title>
+  </header>
+  <body>
+    <p>
+      Forrest can deliver raw SVG files for capable browsers, e.g. Firefox. See
+      <a href="ellipse.svg">example</a>.
+    </p>
+    <p>
+      Forrest can convert SVG files into Portable Network Graphic (PNG). See
+      <a href="ellipse.png">example</a>. Note that Forrest will first look for a
+      pre-prepared PNG file, and if not found then it will generate the PNG from
+      the SVG.
+    </p>
+    <p>
+      Be careful. We only provide a local copy of the SVG 1.0 DTD so if you use
+      SVG 1.1 then there will be network trips for the DTDs.
+      <a href="http://forrest.apache.org/docs/dev/validation.html#catalog">Configure</a>
+      your local catalog entity resolver for your local DTD copies.
+    </p>
+  </body>
+</document>

Propchange: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples1/svg.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples1/usemap.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples1/usemap.xml?view=auto&rev=556367
==============================================================================
--- forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples1/usemap.xml (added)
+++ forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples1/usemap.xml Sat Jul 14 23:39:28 2007
@@ -0,0 +1,63 @@
+<?xml version="1.0"?>
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You 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>Interactive client-side imagemaps - the usemap attribute</title>
+  </header>
+  <body>
+    <section id="demo">
+      <title>Imagemap demo</title>
+      <p>
+        <img src="/images/usemap.gif" usemap="#my-map"
+          alt="usemap demo" width="256" height="256"/>
+      </p>
+      <p>
+        <map name="my-map">
+          <area shape="rect" coords="173,14,240,71"
+             alt="Rectangle" href="ext:forrest"/>
+          <area shape="circle" coords="53,172,28"
+             alt="Circle" href="../index.html"/>
+          <area shape="default" coords="0,0.256,256"
+             alt="Default" href="http://www.apache.org"/>
+        </map>
+      </p>
+    </section>
+    <section id="source">
+      <title>Source code</title>
+      <source>
+<![CDATA[
+      <p>
+        <img src="/images/usemap.gif" usemap="#my-map"
+          alt="usemap demo" width="256" height="256"/>
+      </p>
+      <p>
+        <map name="my-map">
+          <area shape="rect" coords="173,14,240,71"
+             alt="Rectangle" href="ext:forrest"/>
+          <area shape="circle" coords="53,172,28"
+             alt="Circle" href="../index.html"/>
+          <area shape="default" coords="0,0.256,256"
+             alt="Default" href="http://www.apache.org"/>
+        </map>
+      </p>
+]]>
+      </source>
+    </section>
+  </body>
+</document>

Propchange: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples1/usemap.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples1/xml-entities.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples1/xml-entities.xml?view=auto&rev=556367
==============================================================================
--- forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples1/xml-entities.xml (added)
+++ forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples1/xml-entities.xml Sat Jul 14 23:39:28 2007
@@ -0,0 +1,81 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You 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" [
+<!ENTITY % symbols-project
+    PUBLIC "-//Apache Forrest//ENTITIES Symbols Project v1.0//EN"
+    "symbols-project-v10.ent"> 
+  %symbols-project;
+]>
+<document>
+  <header>
+    <title>Using XML entities for character replacements</title>
+  </header>
+  <body>
+    <p>
+      All of the normal xml character entities are available for use in your
+      source documents. So you can use "<code>&amp;trade;</code>" for the
+      trademark symbol (&trade;) and use "<code>&amp;ouml;</code>" for special
+      accents (&ouml;).
+    </p>
+    <p>
+      Forrest also has some default sets of symbols. There is one set for the
+      core of Forrest. These are automatically available for use in the
+      "document-v*" series of document types. (If you want to use them in
+      another document type, then you need to specify them in the document type
+      declaration of your xml instance documents or in your custom DTD. See
+      below.)
+    </p>
+    <p>
+      For example, use "<code>&amp;for-s;</code>" to represent the strong text
+      string "&for-s;". See the list of available symbols at
+      <code>main/webapp/resources/schema/entity/symbols-core-v10.ent</code>
+      which shows that that example entity was declared as <code>
+<![CDATA[<strong>Apache Forrest</strong>]]>
+      </code>.
+    </p>
+    <p>
+      You can supply lists of symbols for your own project too. Create a fresh
+      site with 'forrest seed' and see the set
+      <code>src/documentation/resources/schema/symbols-project-v10.ent</code>
+    </p>
+    <p>
+      For example, use "<code>&amp;myp-t;</code>" to represent the project name
+      together with trademark symbol "&myp-t;".
+    </p>
+    <p>
+      The set of project symbols is already configured. To use the symbols in
+      your documents, add to the document type declaration. For example, see the
+      source for this document
+      (<code>src/documentation/content/xdocs/samples/xml-entites.xml</code>)
+      which declares the project symbol set ...
+    </p>
+    <source>
+<![CDATA[
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd" [
+<!ENTITY % symbols-project
+    PUBLIC "-//Apache Forrest//ENTITIES Symbols Project v1.0//EN"
+    "symbols-project-v10.ent"> 
+  %symbols-project;
+]>
+<document> 
+  ...
+]]>
+    </source>
+  </body>
+</document>

Propchange: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples1/xml-entities.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/demo-i18n.de.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/demo-i18n.de.xml?view=auto&rev=556367
==============================================================================
--- forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/demo-i18n.de.xml (added)
+++ forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/demo-i18n.de.xml Sat Jul 14 23:39:28 2007
@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You 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>Wilkommen zu "MyProj"</title>
+  </header>
+  <body>
+    <section id="overview">
+      <title>Bravo!</title>
+      <p>
+        Sie haben ein <a href="ext:forrest">Apache Forrest</a> basiertes Projekt
+        generiert. Diese Seite wird von einer xdocs konformen Datei
+        <code>src/documentation/content/xdocs/samples/demo-i18n.de.xml</code>
+      </p>
+    </section>
+    <section id="see-english">
+      <title>Übersetzungen</title>
+      <p>
+        Im Site-Skeleton ist nur diese Seite übersetzt, um die i18n-Features zu
+        testen.
+      </p>
+      <p>
+        Für mehr Informationen, konsultieren Sie bitte die
+        <a href="site:i18n">i18n</a>.
+      </p>
+    </section>
+  </body>
+</document>

Propchange: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/demo-i18n.de.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/demo-i18n.fr.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/demo-i18n.fr.xml?view=auto&rev=556367
==============================================================================
--- forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/demo-i18n.fr.xml (added)
+++ forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/demo-i18n.fr.xml Sat Jul 14 23:39:28 2007
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You 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>Bienvenue sur "MyProj"</title>
+  </header>
+  <body>
+    <section id="overview">
+      <title>Félicitations</title>
+      <p>
+        Vous avez généré un site basé sur
+        <a
+          href="ext:forrest">Apache Forrest</a>. Cette page provient
+        du squelette de site fourni avec Forrest, son contenu se trouve dans le
+        fichier
+        <code>src/documentation/content/xdocs/samples/demo-i18n.fr.xml</code>
+      </p>
+    </section>
+    <section id="see-english">
+      <title>Traductions</title>
+      <p>
+        Ce squelette de site n'est pas traduit, seule cette page est fournie en
+        français pour tester le mécanisme i18n.
+      </p>
+      <p>
+        Pour plus d'infos, voir la <a href="site:i18n">i18n</a>.
+      </p>
+    </section>
+  </body>
+</document>

Propchange: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/demo-i18n.fr.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/demo-i18n.nl.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/demo-i18n.nl.xml?view=auto&rev=556367
==============================================================================
--- forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/demo-i18n.nl.xml (added)
+++ forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/demo-i18n.nl.xml Sat Jul 14 23:39:28 2007
@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You 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>Welkom bij MijnProject</title>
+  </header>
+  <body>
+    <section id="overview">
+      <title>Gefeliciteerd!</title>
+      <p>
+        U hebt succesvol een <a
+          href="ext:forrest">Apache Forrest</a>
+        site aangemaakt. Deze pagina komt uit een site template. Dit template
+        vind u in
+        <code>src/documentation/content/xdocs/samples/demo-i18n.nl.xml</code>
+      </p>
+    </section>
+  </body>
+</document>

Propchange: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/demo-i18n.nl.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/demo-i18n.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/demo-i18n.xml?view=auto&rev=556367
==============================================================================
--- forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/demo-i18n.xml (added)
+++ forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/demo-i18n.xml Sat Jul 14 23:39:28 2007
@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You 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>Welcome to MyProj</title>
+  </header>
+  <body>
+    <section id="overview">
+      <title>Congratulations</title>
+      <p>
+        You have successfully generated and rendered an
+        <a
+          href="ext:forrest">Apache Forrest</a> site. This page is
+        from the site template. It is found in
+        <code>src/documentation/content/xdocs/samples/demo-i18n.xml</code>
+      </p>
+    </section>
+    <section id="see-english">
+      <title>Translations</title>
+      <p>
+        For more information, see the <a href="site:i18n">i18n</a>.
+      </p>
+    </section>
+  </body>
+</document>

Propchange: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/demo-i18n.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/i18n.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/i18n.xml?view=auto&rev=556367
==============================================================================
--- forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/i18n.xml (added)
+++ forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/i18n.xml Sat Jul 14 23:39:28 2007
@@ -0,0 +1,50 @@
+<?xml version="1.0"?>
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You 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>Internationalisation (i18n)</title>
+  </header>
+  <body>
+    <section id="intro">
+      <title>Introduction</title>
+      <p></p>
+    </section>
+    <fixme author="">
+      This sample will explain and demonstrate the i18n capabilities. Issue
+      <a href="http://issues.apache.org/jira/browse/FOR-707">FOR-707</a> has
+      some discussion and doc links. We need to summarise it all into this demo.
+    </fixme>
+    <section id="locale-request-param">
+      <title>Using the locale request parameter</title>
+      <p>
+        As a simple example of Forrest's i18n functionality, you can view
+        <a href="site:i18n-demo">this demo page</a>. To see alternative language
+        versions of this page, append the <code>locale</code> request parameter,
+        e.g. <code>localhost:8888/samples/demo-i18n.html?locale=fr</code>
+      </p>
+      <p>
+        There are some other laguage demos (de, fr, nl).
+      </p>
+      <p>
+        This only works in 'forrest run' mode. There are other ways to switch,
+        this is just one way of demonstrating these features.
+      </p>
+    </section>
+  </body>
+</document>

Propchange: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/i18n.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/index.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/index.xml?view=auto&rev=556367
==============================================================================
--- forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/index.xml (added)
+++ forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/index.xml Sat Jul 14 23:39:28 2007
@@ -0,0 +1,57 @@
+<?xml version="1.0"?>
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You 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>Samples 2 Documentation</title>
+  </header>
+  <body>
+    <section id="samples2-intro">
+      <title>Samples 2 Documentation Overview</title>
+      <p>
+              Samples are currently split into two areas. This is purely to help
+              envisage and document by example the usage of tabs and sub-tabs.
+              One section is no more important than the other.
+      </p>
+      <ul>
+              <li>The Navigation Menu will show documentation contained in the 'samples2' directory.</li>
+              <li>The Navigation highlights the current page. (This index.html page has a label of 'Overview')</li>
+              <li>The current selected 'Tab' will show 'Samples'.</li>
+              <li>The current selected 'SubTab' will show 'Samples 2'</li>
+      </ul>
+    </section>
+    <section id="samples2-docs">
+      <title>Documentation contained in Samples 2</title>
+      <ul>
+              <li><a href="site:docs-samples2/i18n">Internationalisation (i18n)</a> A quick intro into the usage of i18n within Forrest.</li>
+              <li><a href="site:docs-samples2/i18n-demo">i18n Demonstration</a> An i18n Demonstration page.</li>
+              <li><a href="site:docs-samples1/faq">FAQ</a> Frequently Asked Questions.</li>
+              <li><a href="site:docs-samples2/subdir/index">Subdir</a> Links to an index page which is a sub-directory of 'samples2'.</li>
+              <li><a href="site:docs-samples2/showonlywhenselected/page1">Conditional Display</a> Conditional display of menu items example.</li>
+
+      </ul>
+</section>
+<section id="samples2-where-else">
+        <title>Links to other Sample Documentation</title>
+      <p>
+              Take a look at <a href="site:samples/overview">the Samples Index</a> to view other
+              samples sections. (Currently we have '<a href="site:docs-samples1/index">Samples 1</a>' and 'Samples 2')
+      </p>
+    </section>
+  </body>
+</document>

Propchange: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/index.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/showonlywhenselected/page1.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/showonlywhenselected/page1.xml?view=auto&rev=556367
==============================================================================
--- forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/showonlywhenselected/page1.xml (added)
+++ forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/showonlywhenselected/page1.xml Sat Jul 14 23:39:28 2007
@@ -0,0 +1,43 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You 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>ShowWhenSelected-Demo, Startpage</title>
+  </header>
+  <body>
+    <section>
+      <title>Always Visible</title>
+      <note>
+        This feature requires the use of the 'scales'-skin. Used in any other
+        skin, both pages will show normally.
+      </note>
+      <p>
+        This page is always visible and just another Forrest document.
+      </p>
+      <p>
+        The link below (please read on!) opens the second page of this demo.
+      </p>
+      <p>
+        It is also referenced in site.xml, but, because if the type-attribute
+        "showWhenSelected", it will not normally appear on the menu. Unless you
+        follow the <a href="page2.html">link</a> and select it.
+      </p>
+    </section>
+  </body>
+</document>

Propchange: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/showonlywhenselected/page1.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/showonlywhenselected/page2.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/showonlywhenselected/page2.xml?view=auto&rev=556367
==============================================================================
--- forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/showonlywhenselected/page2.xml (added)
+++ forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/showonlywhenselected/page2.xml Sat Jul 14 23:39:28 2007
@@ -0,0 +1,42 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You 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>ShowWhenSelected-Demo, Linked Page</title>
+  </header>
+  <body>
+    <section>
+      <title>Conditionally visible</title>
+      <note>
+        This feature requires the use of the 'scales'-skin. Used in any other
+        skin, both pages will show normally.
+      </note>
+      <p>
+        This page will only become visible on the menu when it is already the
+        current page. Since it doesn't normally appear on the menu, this can
+        only happen, if you link to it from another page or from another site.
+      </p>
+      <p>
+        Open another page by menu-selection or follwing a
+        <a href="page1.html">link</a> to make this page disappear from this
+        menu.
+      </p>
+    </section>
+  </body>
+</document>

Propchange: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/showonlywhenselected/page2.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/subdir/book-sample.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/subdir/book-sample.xml?view=auto&rev=556367
==============================================================================
--- forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/subdir/book-sample.xml (added)
+++ forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/subdir/book-sample.xml Sat Jul 14 23:39:28 2007
@@ -0,0 +1,42 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You 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 book PUBLIC "-//APACHE//DTD Cocoon Documentation Book V1.0//EN" "http://forrest.apache.org/dtd/book-cocoon-v10.dtd">
+<!-- Sample book.xml file.  If this file is renamed to 'book.xml', it will be
+used to define the menu in this subdirectory, instead of that generated from
+the usual site.xml mechanism. The normal relative and absolute hrefs are also
+available. -->
+<book software="MyProj"
+  title="MyProj"
+  copyright="@year@ The Apache Software Foundation"
+  xmlns:xlink="http://www.w3.org/1999/xlink">
+  <menu label="About">
+<!-- using the normal site.xml linking mechanism -->
+    <menu-item label="Index" href="site:index"/>
+<!-- using relative URIs with relative path -->
+    <menu-item label="Sample page" href="../sample.html"/>
+<!-- using relative URIs with absolute path -->
+    <menu-item label="Sample ihtml page" href="/samples/ihtml-sample.html"/>
+<!-- using the normal site.xml linking mechanism -->
+    <menu-item label="FAQ" href="site:faq"/>
+    <menu-item label="Changes" href="site:changes"/>
+    <menu-item label="Todo" href="site:todo"/>
+  </menu>
+  <menu label="Subdir">
+    <menu-item label="index" href="site:subdir/index"/>
+  </menu>
+</book>

Propchange: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/subdir/book-sample.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/subdir/hello.zip
URL: http://svn.apache.org/viewvc/forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/subdir/hello.zip?view=auto&rev=556367
==============================================================================
Binary file - no diff available.

Propchange: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/subdir/hello.zip
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/subdir/index.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/subdir/index.xml?view=auto&rev=556367
==============================================================================
--- forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/subdir/index.xml (added)
+++ forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/subdir/index.xml Sat Jul 14 23:39:28 2007
@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You 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>Page generated from a sub-directory</title>
+    <authors>
+      <person name="Joe Bloggs" email="joe@joescompany.org" />
+    </authors>
+  </header>
+  <body>
+    <section>
+      <title>A sub-directory</title>
+      <p>
+        This was generated from a sub-directory.
+      </p>
+      <p>
+        When creating new subdirectories, remember that these <em>must</em> be
+        declared in site.xml or each directory must have a book.xml file.
+      </p>
+    </section>
+  </body>
+</document>

Propchange: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples2/subdir/index.xml
------------------------------------------------------------------------------
    svn:eol-style = native



Mime
View raw message