You are viewing a plain text version of this content. The canonical link for it is here.
Posted to svn@forrest.apache.org by cr...@apache.org on 2005/04/11 17:12:19 UTC
svn commit: r160902 [7/28] - in forrest/site/0.6: ./ docs/ docs/images/ dtd/
entity/ howto/ images/ skin/ skin/css/ skin/images/ skin/scripts/ skins/
Propchange: forrest/site/0.6/docs/document-v13.dtdx.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: forrest/site/0.6/docs/document-v13.dtdx.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/0.6/docs/document-v13.dtdx.pdf?view=auto&rev=160902
==============================================================================
Binary file - no diff available.
Propchange: forrest/site/0.6/docs/document-v13.dtdx.pdf
------------------------------------------------------------------------------
svn:mime-type = application/pdf
Added: forrest/site/0.6/docs/document-v13.html
URL: http://svn.apache.org/viewcvs/forrest/site/0.6/docs/document-v13.html?view=auto&rev=160902
==============================================================================
--- forrest/site/0.6/docs/document-v13.html (added)
+++ forrest/site/0.6/docs/document-v13.html Mon Apr 11 08:11:56 2005
@@ -0,0 +1,787 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.7-dev">
+<meta name="Forrest-skin-name" content="pelt">
+<meta-data></meta-data>
+<title>The Apache Forrest xdocs document-v1.3 DTD (v0.6)</title>
+<link type="text/css" href="../skin/basic.css" rel="stylesheet">
+<link media="screen" type="text/css" href="../skin/screen.css" rel="stylesheet">
+<link media="print" type="text/css" href="../skin/print.css" rel="stylesheet">
+<link type="text/css" href="../skin/profile.css" rel="stylesheet">
+<script src="../skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="../skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="../skin/fontsize.js" language="javascript" type="text/javascript"></script>
+<link rel="shortcut icon" href="../favicon.ico">
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">apache</a> > <a href="http://forrest.apache.org/">forrest</a><script src="../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+ |header
+ +-->
+<div class="header">
+<!--+
+ |start group logo
+ +-->
+<div class="grouplogo">
+<a href="http://www.apache.org/"><img class="logoImage" alt="Apache" src="../images/apache-forrest.png" title="The Apache Software Foundation"></a>
+</div>
+<!--+
+ |end group logo
+ +-->
+<!--+
+ |start Project Logo
+ +-->
+<div class="projectlogo">
+<a href="http://forrest.apache.org/"><img class="logoImage" alt="Forrest" src="../images/project-logo.gif" title="Apache Forrest"></a>
+</div>
+<!--+
+ |end Project Logo
+ +-->
+<!--+
+ |start Search
+ +-->
+<div class="searchbox">
+<form action="http://www.google.com/search" method="get" class="roundtopsmall">
+<input value="forrest.apache.org" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google:');" value="Search the site with google:" size="25" name="q" id="query" type="text">
+ <input name="Search" value="Search" type="submit">
+</form>
+</div>
+<!--+
+ |end search
+ +-->
+<!--+
+ |start Tabs
+ +-->
+<ul id="tabs">
+<li>
+<a class="base-not-selected" href="../index.html">Welcome</a>
+</li>
+<li>
+<a class="base-not-selected" href="../contrib.html">Project</a>
+</li>
+<li class="current">
+<a class="base-selected" href="../docs/index.html">O.6 Docs</a>
+</li>
+<li>
+<a class="base-not-selected" href="../howto/index.html">0.6 How-To</a>
+</li>
+</ul>
+<!--+
+ |end Tabs
+ +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+ |start Subtabs
+ +-->
+<div id="level2tabs">
+<a class="base-selected" href="../docs/your-project.html">Core</a> | <a class="base-selected" href="../docs/forrestbot.html">ForrestBot</a> | <a class="base-selected" href="../docs/forrestbar.html">ForrestBar</a>
+</div>
+<!--+
+ |end Endtabs
+ +-->
+<script type="text/javascript" language="JavaScript"><!--
+ document.write("Published: " + document.lastModified);
+ // --></script>
+</div>
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+
+
+ </div>
+<!--+
+ |start Menu, mainarea
+ +-->
+<!--+
+ |start Menu
+ +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_1.1', '../skin/')" id="menu_1.1Title" class="menutitle">Documentation</div>
+<div id="menu_1.1" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../docs/index.html">Index</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/your-project.html">Using Forrest</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/validation.html">XML Validation</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/linking.html">Menus and Linking</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/searching.html">Searching</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/skins.html">Default Skins</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/skin-package.html">Skin Packages</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/forrest-contract.html">Our Contract</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/compliance.html">Standards Compliance</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.10', '../skin/')" id="menu_1.1.10Title" class="menutitle">Advanced Topics</div>
+<div id="menu_1.1.10" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../docs/catalog.html">Using DTD Catalogs</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/sitemap-ref.html">Sitemap Reference</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/project-sitemap.html">Project sitemap</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/cap.html">Sourcetype Action</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.1.11', '../skin/')" id="menu_1.1.11Title" class="menutitle">Upgrading</div>
+<div id="menu_1.1.11" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../docs/upgrading_06.html">Upgrading to 0.6</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/upgrading_05.html">Upgrading to 0.5</a>
+</div>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.2', '../skin/')" id="menu_1.2Title" class="menutitle">SubProjects</div>
+<div id="menu_1.2" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../docs/forrestbar.html">ForrestBar</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/forrestbot.html">Forrestbot</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/forrestbot-web-interface.html">Forrestbot Webapp</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.3', '../skin/')" id="menu_selected_1.3Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Reference docs</div>
+<div id="menu_selected_1.3" class="selectedmenuitemgroup" style="display: block;">
+<div onclick="SwitchMenu('menu_1.3.1', '../skin/')" id="menu_1.3.1Title" class="menutitle">DTD documentation</div>
+<div id="menu_1.3.1" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../docs/dtd-docs.html">Overview</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/document-v20.dtdx.html">document-v20</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/howto-v20.dtdx.html">howto-v20</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/faq-v20.dtdx.html">faq-v20</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/document-v13.dtdx.html">document-v13</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/howto-v13.dtdx.html">howto-v13</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/faq-v13.dtdx.html">faq-v13</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.3.2', '../skin/')" id="menu_selected_1.3.2Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Doc samples</div>
+<div id="menu_selected_1.3.2" class="selectedmenuitemgroup" style="display: block;">
+<div class="menupage">
+<div class="menupagetitle">document-v13</div>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/document-v20.html">document-v20</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/wiki-sample.html">JSPWiki Reference</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/oowriter.html">OpenOffice.Org Writer</a>
+</div>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.4', '../skin/')" id="menu_1.4Title" class="menutitle">Older Docs</div>
+<div id="menu_1.4" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../docs/primer.html">Forrest Primer</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/libre-intro.html">Libre</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/dreams.html">Dream list</a>
+</div>
+</div>
+<div id="credit">
+<hr>
+ This is documentation for past release v0.6
+ (<a href="http://forrest.apache.org/docs.html">More</a> ...)</div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="../skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+ |alternative credits
+ +-->
+</div>
+<!--+
+ |end Menu
+ +-->
+<!--+
+ |start content
+ +-->
+<div id="content">
+<div title="Portable Document Format" class="pdflink">
+<a class="dida" href="document-v13.pdf"><img alt="PDF -icon" src="../skin/images/pdfdoc.gif" class="skin"><br>
+ PDF</a>
+</div>
+<div class="trail">
+ Font size:
+ <input value="Reset" class="resetfont" title="Reset text" onclick="ndeSetTextSize('reset'); return false;" type="button">
+ <input value="-a" class="smallerfont" title="Shrink text" onclick="ndeSetTextSize('decr'); return false;" type="button">
+ <input value="+a" class="biggerfont" title="Enlarge text" onclick="ndeSetTextSize('incr'); return false;" type="button">
+</div>
+<h1>The Apache Forrest xdocs document-v1.3 DTD</h1>
+<div class="abstract">This is a demonstration document using all possible elements in
+ the current Apache Forrest xdocs document-v13.dtd
+ </div>
+<div id="motd-area">
+ This is documentation for past release v0.6
+ (<a href="http://forrest.apache.org/docs.html">More</a> ...)</div>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#sample">Sample Content</a>
+<ul class="minitoc">
+<li>
+<a href="#block-inline">Block and inline elements</a>
+</li>
+<li>
+<a href="#presentations">Various presentation formats</a>
+</li>
+<li>
+<a href="#section">Using sections</a>
+</li>
+<li>
+<a href="#sub-section">Sections, the sequel</a>
+<ul class="minitoc">
+<li>
+<a href="#sub-sub-section">Section 2.1</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#source">Showing preformatted source code</a>
+</li>
+<li>
+<a href="#table">Using tables</a>
+</li>
+<li>
+<a href="#figure">Using figures</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#changes">DTD changes</a>
+<ul class="minitoc">
+<li>
+<a href="#changes-13">Changes since document-v12</a>
+</li>
+<li>
+<a href="#changes-12">Changes since document-v11</a>
+</li>
+</ul>
+</li>
+</ul>
+</div>
+
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">
+ This is a demonstration document using all possible elements in the
+ current Apache Forrest xdocs <span class="codefrag">document-v13.dtd</span>
+ (See the <a href="#changes">DTD changes</a> section at the bottom.)
+ </div>
+</div>
+
+<a name="N10020"></a><a name="sample"></a>
+<h2 class="underlined_10">Sample Content</h2>
+<div class="section">
+<p>
+<strong>Hint:</strong> See the xml source to see how the various
+ elements are used and see the
+<!-- FOR-321 workaround
+ <link href="site:dtd-docs">DTD reference documentation</link>.
+-->
+ <a href="dtd-docs.html">DTD documentation</a>.
+ </p>
+<a name="N10031"></a><a name="block-inline"></a>
+<h3 class="underlined_5">Block and inline elements</h3>
+<p>This is a simple paragraph. Most documents contain a fair amount of
+ paragraphs. Paragraphs are called <span class="codefrag"><p></span>.</p>
+<div class="pre">With the <span class="codefrag"><p xml:space="preserve"></span> attribute, you can declare
+ that whitespace should be preserved, without implying it is in any other
+ way special.</div>
+<p>
+ This next paragraph has a class attribute of 'quote'. CSS can
+ be used to present this <span class="codefrag"><p class='quote'></span> 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.
+ </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 (<span class="codefrag"><ul></span>):</p>
+<ul>
+
+<li>Here is a simple list item (<span class="codefrag"><li></span>).</li>
+
+<li>Have you seen the use of the <span class="codefrag"><code></span> element in the
+ previous item?</li>
+
+<li>Also, we have <span class="codefrag"><sub></span> and <span class="codefrag"><sup></span>
+ 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
+ <span class="codefrag"><em></span> <strong><span class="codefrag"><strong></span></strong>
+ elements.</li>
+
+<li>We can use
+ <img class="icon" alt="feather" height="22" src="images/icon.png" width="26">
+ <span class="codefrag"><icon></span>s too.</li>
+
+<li>Another possibility is the <span class="codefrag"><img></span> element:
+ <img alt="another feather" height="22" src="images/icon.png" width="26">,
+ which offers the ability to refer to an image map.</li>
+
+<li>We have elements for hyperlinking:
+ <dl>
+
+<dt>
+<span class="codefrag"><link href="../faq.html"></span>
+</dt>
+
+<dd>Use this to
+ <a href="../faq.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>
+<span class="codefrag"><link href="#section"></span>
+</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>
+<span class="codefrag"><link href="../faq.html#overview"></span>
+</dt>
+
+<dd>Use this to
+ <a href="../faq.html#overview" 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>
+<span class="codefrag"><jump href="../faq.html"></span>
+</dt>
+
+<dd>Use this to
+ <a target="_top" href="../faq.html">jump</a>
+ to another document and optionally go to a named
+ <a target="_top" href="../faq.html#overview">anchor</a>
+ 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
+ <span class="codefrag"><a ... target="_top"></span>
+
+</dd>
+
+
+<dt>
+<span class="codefrag"><fork href="../faq.html"></span>
+</dt>
+
+<dd>Use this to
+ <a target="_blank" href="../faq.html">fork</a>
+ your webbrowser to another document. This will open the document
+ in a new, unnamed browser window.
+ This is the equivalent of
+ <span class="codefrag"><a ... target="_blank"></span>
+
+</dd>
+
+</dl>
+</li>
+
+
+<li>Oh, by the way, a definition list <span class="codefrag"><dl></span> was used inside
+ the previous list item. We could put another
+ <ul>
+
+<li>unordered list</li>
+
+<li>inside the list item</li>
+
+</ul>
+
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+
+<caption>A sample nested table</caption>
+
+<tr>
+<td colspan="1" rowspan="1">Or even tables.. </td><td colspan="1" rowspan="1">
+
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+<tr>
+<td colspan="1" rowspan="1">inside tables..</td>
+</tr>
+</table>
+
+</td>
+</tr>
+
+<tr>
+<td colspan="1" rowspan="1">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>
+<div class="frame fixme">
+<div class="label">Fixme (SN)</div>
+<div class="content">The <span class="codefrag"><fixme></span> element is used for stuff
+ which still needs work. Mind the <span class="codefrag">author</span> attribute!</div>
+</div>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">Use the <span class="codefrag"><note></span> element to draw attention to something, e.g. ...The <span class="codefrag"><code></span> element is used when the author can't
+ express himself clearly using normal sentences ;-)</div>
+</div>
+<div class="frame warning">
+<div class="label">Warning</div>
+<div class="content">Sleep deprivation can be the result of being involved in an open
+ source project. (a.k.a. the <span class="codefrag"><warning></span> element).
+ </div>
+</div>
+<div class="frame note">
+<div class="label">Important</div>
+<div class="content">If you want your own labels for notes and
+ warnings, specify them using the <span class="codefrag">label</span> attribute.
+ </div>
+</div>
+<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>
+<a name="N10142"></a><a name="presentations"></a>
+<h3 class="underlined_5">Various presentation formats</h3>
+<p>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.</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
+ <disable-XXX-link> elements in the skinconf.xml</p>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+
+<tr>
+
+<th colspan="1" rowspan="1">Presentation Format</th>
+
+ <th colspan="1" rowspan="1">Description</th>
+
+ <th colspan="1" rowspan="1">skinconf.xml Element</th>
+
+</tr>
+
+
+<tr>
+
+<td colspan="1" rowspan="1"><a href="document-v13.html">HTML</a></td>
+
+ <td colspan="1" rowspan="1">This document in HTML format. </td>
+
+ <td colspan="1" rowspan="1">Always generated by default. Cannot be turned off.</td>
+
+</tr>
+
+
+<tr>
+
+<td colspan="1" rowspan="1"><a href="document-v13.xml">XML</a></td>
+
+ <td colspan="1" rowspan="1">This document in its raw XML format.</td>
+
+ <td colspan="1" rowspan="1"><disable-xml-link>. By default, set to true, meaning
+ that this link will not be shown.</td>
+
+</tr>
+
+
+<tr>
+
+<td colspan="1" rowspan="1"><a href="document-v13.pdf">PDF</a></td>
+
+ <td colspan="1" rowspan="1">This document as Adobe PDF</td>
+
+ <td colspan="1" rowspan="1"><disable-pdf-link>. By default, set to false, meaning
+ that this link will be shown.</td>
+
+</tr>
+
+
+<tr>
+
+<td colspan="1" rowspan="1">Text</td>
+
+ <td colspan="1" rowspan="1">This document as straight text.</td>
+
+ <td colspan="1" rowspan="1"><disable-txt-link>. By default, set to true, meaning
+ that this link will not be shown. NOT YET IMPLEMENTED.</td>
+
+</tr>
+
+
+<tr>
+
+<td colspan="1" rowspan="1"><a href="document-v13.pod">POD</a></td>
+
+ <td colspan="1" rowspan="1">This document as Perl POD (Plain Old Documentation). Text with
+ minimal formatting directives. If on a *nix system with perl
+ installed, see "man perlpod".</td>
+
+ <td colspan="1" rowspan="1"><disable-pod-link>. By default, set to true, meaning
+ that this link will not be shown.</td>
+
+</tr>
+
+</table>
+<a name="N101C6"></a><a name="section"></a>
+<h3 class="underlined_5">Using sections</h3>
+<p>You can use sections to put some structure in your document. For some
+ strange historical reason, the section title is an attribute of the
+ <span class="codefrag"><section></span> element.</p>
+<a name="N101D3"></a><a name="sub-section"></a>
+<h3 class="underlined_5">Sections, the sequel</h3>
+<p>Just some second section.</p>
+<a name="N101DC"></a><a name="sub-sub-section"></a>
+<h4>Section 2.1</h4>
+<p>Which contains a subsection (2.1).</p>
+<a name="N101E7"></a><a name="source"></a>
+<h3 class="underlined_5">Showing preformatted source code</h3>
+<p>Enough about these sections. Let's have a look at more interesting
+ elements, <span class="codefrag"><source></span> for instance:</p>
+<pre class="code">
+// This example is from the book _Java in a Nutshell_ by David Flanagan.
+// Written by David Flanagan. Copyright (c) 1996 O'Reilly & 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);
+ }
+}</pre>
+<p>CDATA sections are used within
+ <span class="codefrag"><source></span> elements so that you can write pointy
+ brackets without needing to escape them with messy
+ <span class="codefrag">&lt;</span> entities ...
+ </p>
+<pre class="code">
+<pointy>
+ easy
+</pointy>
+</pre>
+<p>Please take care to still use a sensible line-length within your
+ source elements.</p>
+<a name="N10208"></a><a name="table"></a>
+<h3 class="underlined_5">Using tables</h3>
+<p>And now for a table:</p>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+
+<caption>Table caption</caption>
+
+<tr>
+
+<th colspan="1" rowspan="1">heading cell 1</th>
+ <th colspan="1" rowspan="1">heading cell 2</th>
+ <th colspan="1" rowspan="1">heading cell 3</th>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">data cell</td>
+ <td colspan="2" rowspan="1">this data cell spans two columns</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+ Tables can be nested:
+ </td>
+ <td colspan="1" rowspan="1">
+
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+
+<tr>
+
+<th colspan="1" rowspan="1">column 1</th>
+ <th colspan="1" rowspan="1">column 2</th>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">cell A</td>
+ <td colspan="1" rowspan="1">cell B</td>
+
+</tr>
+
+</table>
+
+</td>
+ <td colspan="1" rowspan="1">
+
+<ul>
+<li>and can include most other elements</li>
+<li>such as lists</li>
+</ul>
+
+</td>
+
+</tr>
+
+</table>
+<a name="second-figure-anchor"></a><a name="N1026F"></a><a name="figure"></a>
+<h3 class="underlined_5">Using figures</h3>
+<p>And a <span class="codefrag"><figure></span> to end all of this.
+ Note that this can also be implemented with an
+ <span class="codefrag"><img></span> element.
+ </p>
+<div style="text-align: center;">
+<img class="figure" alt="The fine Forrest logo" src="images/project-logo.png" height="65" width="220"></div>
+</div>
+
+
+<a name="N10286"></a><a name="changes"></a>
+<h2 class="underlined_10">DTD changes</h2>
+<div class="section">
+<p>See the generated
+<!-- FOR-321 workaround
+ <link href="site:dtd-docs">DTD reference documentation</link>.
+-->
+ <a href="dtd-docs.html">DTD documentation</a>.
+ </p>
+<a name="N10295"></a><a name="changes-13"></a>
+<h3 class="underlined_5">Changes since document-v12</h3>
+<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>
+<a name="N1029F"></a><a name="changes-12"></a>
+<h3 class="underlined_5">Changes since document-v11</h3>
+<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>
+</div>
+
+</div>
+<!--+
+ |end content
+ +-->
+<div class="clearboth"> </div>
+</div>
+<div id="footer">
+<!--+
+ |start bottomstrip
+ +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+// --></script>
+</div>
+<div class="copyright">
+ Copyright © 2002-2004 The Apache Software Foundation.</div>
+<!--+
+ |end bottomstrip
+ +-->
+</div>
+</body>
+</html>
Propchange: forrest/site/0.6/docs/document-v13.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: forrest/site/0.6/docs/document-v13.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/0.6/docs/document-v13.pdf?view=auto&rev=160902
==============================================================================
Binary file - no diff available.
Propchange: forrest/site/0.6/docs/document-v13.pdf
------------------------------------------------------------------------------
svn:mime-type = application/pdf
Added: forrest/site/0.6/docs/document-v13.pod
URL: http://svn.apache.org/viewcvs/forrest/site/0.6/docs/document-v13.pod?view=auto&rev=160902
==============================================================================
--- forrest/site/0.6/docs/document-v13.pod (added)
+++ forrest/site/0.6/docs/document-v13.pod Mon Apr 11 08:11:56 2005
@@ -0,0 +1,484 @@
+
+=head1 NAME
+
+document-v13 - The Apache Forrest xdocs document-v1.3 DTD
+
+
+=head1 DESCRIPTION
+
+B<Note:>
+
+ ------------------------------------------------------------
+
+
+=over 4
+
+This is a demonstration document using all possible elements in the current Apache Forrest xdocs C<document-v13.dtd > (See the L<DTD changes|/"changes"> section at the bottom.)
+
+
+=back
+
+ ------------------------------------------------------------
+
+
+
+=head2 Sample Content
+
+B<Hint: > See the xml source to see how the various elements are used and see the L<DTD documentation|dtd-docs> .
+
+
+
+=head3 Block and inline elements
+
+This is a simple paragraph. Most documents contain a fair amount of paragraphs. Paragraphs are called C<<p> > .
+
+With the C<<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 C<<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 ( C<<ul> > ):
+
+
+
+
+=over 4
+
+
+
+=item *
+
+
+Here is a simple list item ( C<<li> > ).
+
+
+=item *
+
+
+Have you seen the use of the C<<code> > element in the previous item?
+
+
+=item *
+
+
+Also, we have C<<sub> > and C<<sup> > elements to show content above or below the text baseline.
+
+
+=item *
+
+
+There is a facility to I<emphasize > certain words using the C<<em> > B<C<<strong> > > elements.
+
+
+=item *
+
+
+We can use [icon: feather] C<<icon> > s too.
+
+
+=item *
+
+
+Another possibility is the C<<img> > element: [img: another feather] , which offers the ability to refer to an image map.
+
+
+=item *
+
+
+We have elements for hyperlinking:
+
+B<C<<link href="../faq.html"> > >
+
+
+=over 4
+
+Use this to L<link|../faq> to another document. As per normal, this will open the new document in the same browser window.
+
+
+=back
+
+B<C<<link href="#section"> > >
+
+
+=over 4
+
+Use this to L<link|/"section"> to the named anchor in the current document.
+
+
+=back
+
+B<C<<link href="../faq.html#overview"> > >
+
+
+=over 4
+
+Use this to L<link|../faq/"overview"> to another document and go to the named anchor. This will open the new document in the same browser window.
+
+
+=back
+
+B<C<<jump href="../faq.html"> > >
+
+
+=over 4
+
+Use this to L<jump|../faq> to another document and optionally go to a named L<anchor|../faq/"overview"> 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 C<<a ... target="_top"> >
+
+
+=back
+
+B<C<<fork href="../faq.html"> > >
+
+
+=over 4
+
+Use this to L<fork|../faq> your webbrowser to another document. This will open the document in a new, unnamed browser window. This is the equivalent of C<<a ... target="_blank"> >
+
+
+=back
+
+
+
+
+=item *
+
+
+Oh, by the way, a definition list C<<dl> > was used inside the previous list item. We could put another
+
+
+=over 4
+
+
+
+=item *
+
+
+unordered list
+
+
+=item *
+
+
+inside the list item
+
+
+=back
+
+
+ A sample nested table
+ +---------------------------------+---------------------------------+
+ | Or even tables.. | inside tables.. |
+ +---------------------------------+---------------------------------+
+ | or inside lists, but I believe | |
+ | this liberty gets quickly quite | |
+ | hairy as you see. | |
+ +---------------------------------+---------------------------------+
+
+
+
+
+
+=back
+
+
+So far for the in-line elements, let's look at some paragraph-level elements.
+
+B<Fixme (SN):>
+
+ ------------------------------------------------------------
+
+
+=over 4
+
+The C<<fixme> > element is used for stuff which still needs work. Mind the C<author > attribute!
+
+
+=back
+
+ ------------------------------------------------------------
+
+B<Note:>
+
+ ------------------------------------------------------------
+
+
+=over 4
+
+Use the C<<note> > element to draw attention to something, e.g. ...The C<<code> > element is used when the author can't express himself clearly using normal sentences ;-)
+
+
+=back
+
+ ------------------------------------------------------------
+
+B<Warning:>
+
+ ------------------------------------------------------------
+
+
+=over 4
+
+Sleep deprivation can be the result of being involved in an open source project. (a.k.a. the C<<warning> > element).
+
+
+=back
+
+ ------------------------------------------------------------
+
+B<Important>
+
+ ------------------------------------------------------------
+
+
+=over 4
+
+If you want your own labels for notes and warnings, specify them using the C<label > attribute.
+
+
+=back
+
+ ------------------------------------------------------------
+
+Apart from unordered lists, we have ordered lists too, of course.
+
+
+
+
+=over 4
+
+
+
+=item 1.
+
+Item 1
+
+
+=item 2.
+
+Item 2
+
+
+=item 3.
+
+This should be 3 if my math is still OK.
+
+
+=back
+
+
+
+
+
+
+=head3 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 Elemen |
+ | | | t |
+ +---------------------+---------------------+---------------------+
+ | document-v13 | This document in HT | Always generated by |
+ | | ML format. | default. Cannot be |
+ | | | turned off. |
+ +---------------------+---------------------+---------------------+
+ | document-v13.xml | This document in it | <disable-xml-link>. |
+ | | s raw XML format. | By default, set to |
+ | | | true, meaning that |
+ | | | this link will not |
+ | | | be shown. |
+ +---------------------+---------------------+---------------------+
+ | document-v13.pdf | This document as Ad | <disable-pdf-link>. |
+ | | obe PDF | By default, set to |
+ | | | false, meaning tha |
+ | | | t this link will be |
+ | | | shown. |
+ +---------------------+---------------------+---------------------+
+ | Text | This document as st | <disable-txt-link>. |
+ | | raight text. | By default, set to |
+ | | | true, meaning that |
+ | | | this link will not |
+ | | | be shown. NOT YET |
+ | | | IMPLEMENTED. |
+ +---------------------+---------------------+---------------------+
+ | document-v13.pod | This document as Pe | <disable-pod-link>. |
+ | | rl POD (Plain Old D | By default, set to |
+ | | ocumentation). Text | true, meaning that |
+ | | with minimal forma | this link will not |
+ | | tting directives. I | be shown. |
+ | | f on a *nix system | |
+ | | with perl installed | |
+ | | , see "man perlpod" | |
+ | | . | |
+ +---------------------+---------------------+---------------------+
+
+
+
+
+
+
+=head3 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 C<<section> > element.
+
+
+
+
+
+=head3 Sections, the sequel
+
+Just some second section.
+
+
+
+=head4 Section 2.1
+
+Which contains a subsection (2.1).
+
+
+
+
+
+
+
+=head3 Showing preformatted source code
+
+Enough about these sections. Let's have a look at more interesting elements, C<<source> > for instance:
+
+
+ // This example is from the book _Java in a Nutshell_ by David Flanagan.
+ // Written by David Flanagan. Copyright (c) 1996 O'Reilly & 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);
+ }
+ }
+
+
+CDATA sections are used within C<<source> > elements so that you can write pointy brackets without needing to escape them with messy C<< > entities ...
+
+
+ <pointy>
+ easy
+ </pointy>
+
+
+
+Please take care to still use a sensible line-length within your source elements.
+
+
+
+
+
+=head3 Using tables
+
+And now for a table:
+
+ Table caption
+ +---------------------+---------------------+---------------------+
+ | heading cell 1 | heading cell 2 | heading cell 3 |
+ +---------------------+---------------------+---------------------+
+ | data cell | this data cell span | |
+ | | s two columns | |
+ +---------------------+---------------------+---------------------+
+ | Tables can be neste | | and can include mos |
+ | d: | | t other elements |
+ | | c | |
+ | | olumn 1 | such as lists |
+ | | c | |
+ | | olumn 2 | |
+ | | | |
+ | | | |
+ | | c | |
+ | | ell A | |
+ | | c | |
+ | | ell B | |
+ | | | |
+ | | | |
+ +---------------------+---------------------+---------------------+
+
+
+
+
+
+
+=head3 Using figures
+
+And a C<<figure> > to end all of this. Note that this can also be implemented with an C<<img> > element.
+
+[figure: The fine Forrest logo]
+
+
+
+
+
+=head2 DTD changes
+
+See the generated L<DTD documentation|dtd-docs> .
+
+
+
+=head3 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.
+
+
+
+
+
+=head3 Changes since document-v11
+
+doc-v12 enhances doc-v11 by relaxing various restrictions that were found to be unnecessary.
+
+
+
+
+=over 4
+
+
+
+=item *
+
+
+Links ((link|jump|fork) and inline elements (br|img|icon|acronym) are allowed inside title.
+
+
+=item *
+
+
+Paragraphs (p|source|note|warning|fixme), table and figure|anchor are allowed inside li.
+
+
+=item *
+
+
+Paragraphs (p|source|note|warning|fixme), lists (ol|ul|dl), table, figure|anchor are allowed inside definition lists (dd) and tables (td and dh).
+
+
+=item *
+
+
+Inline content (strong|em|code|sub|sup|br|img|icon|acronym|link|jump|fork) is allowed in strong and em.
+
+
+=back
+
+
+
+
+
+
+
+
Propchange: forrest/site/0.6/docs/document-v13.pod
------------------------------------------------------------------------------
svn:eol-style = native
Added: forrest/site/0.6/docs/document-v13.xml
URL: http://svn.apache.org/viewcvs/forrest/site/0.6/docs/document-v13.xml?view=auto&rev=160902
==============================================================================
--- forrest/site/0.6/docs/document-v13.xml (added)
+++ forrest/site/0.6/docs/document-v13.xml Mon Apr 11 08:11:56 2005
@@ -0,0 +1,373 @@
+<?xml version="1.0" encoding="ISO-8859-1"?><!--
+ 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 V1.3//EN" "http://forrest.apache.org/dtd/document-v13.dtd">
+<document>
+ <header>
+ <title>The Apache Forrest xdocs document-v1.3 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-v13.dtd</code>
+ </abstract>
+ </header>
+ <body>
+ <note>
+ This is a demonstration document using all possible elements in the
+ current Apache Forrest xdocs <code>document-v13.dtd</code>
+ (See the <link href="#changes">DTD changes</link> 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
+ <link href="site:dtd-docs">DTD reference documentation</link>.
+-->
+ <link href="dtd-docs.html">DTD documentation</link>.
+ </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><p></code>.</p>
+ <p xml:space="preserve">With the <code><p xml:space="preserve"></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><p class='quote'></code> 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.
+ </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><ul></code>):</p>
+ <ul>
+ <li>Here is a simple list item (<code><li></code>).</li>
+ <li>Have you seen the use of the <code><code></code> element in the
+ previous item?</li>
+ <li>Also, we have <code><sub></code> and <code><sup></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><em></code> <strong><code><strong></code></strong>
+ elements.</li>
+ <li>We can use
+ <icon height="22" width="26" src="images/icon.png" alt="feather"/>
+ <code><icon></code>s too.</li>
+ <li>Another possibility is the <code><img></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><link href="../faq.html"></code></dt>
+ <dd>Use this to
+ <link href="../faq.html" title="Example of a document via link">link</link>
+ to another document. As per normal, this will open the new document
+ in the same browser window.</dd>
+
+ <dt><code><link href="#section"></code></dt>
+ <dd>Use this to
+ <link href="#section" title="Example of a document via local anchor">link</link>
+ to the named anchor in the current document.
+ </dd>
+
+ <dt><code><link href="../faq.html#overview"></code></dt>
+ <dd>Use this to
+ <link href="../faq.html#overview" title="Example of a document via link and anchor">link</link>
+ to another document and go to the named anchor. This will open
+ the new document in the same browser window.
+ </dd>
+
+ <dt><code><jump href="../faq.html"></code></dt>
+ <dd>Use this to
+ <jump href="../faq.html" title="Example of a document via jump">jump</jump>
+ to another document and optionally go to a named
+ <jump href="../faq.html#overview" title="Example of a document via jump to anchor">anchor</jump>
+ 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
+ <code><a ... target="_top"></code>
+ </dd>
+
+ <dt><code><fork href="../faq.html"></code></dt>
+ <dd>Use this to
+ <fork href="../faq.html" title="Example of a document via fork">fork</fork>
+ your webbrowser to another document. This will open the document
+ in a new, unnamed browser window.
+ This is the equivalent of
+ <code><a ... target="_blank"></code>
+ </dd>
+ </dl></li>
+
+ <li>Oh, by the way, a definition list <code><dl></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 colspan="1" rowspan="1">Or even tables.. </td><td colspan="1" rowspan="1">
+ <table><tr><td colspan="1" rowspan="1">inside tables..</td></tr></table>
+ </td></tr>
+ <tr><td colspan="1" rowspan="1">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><fixme></code> element is used for stuff
+ which still needs work. Mind the <code>author</code> attribute!</fixme>
+ <note>Use the <code><note></code> element to draw attention to something, e.g. ...The <code><code></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><warning></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-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.</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
+ <disable-XXX-link> elements in the skinconf.xml</p>
+
+ <table>
+ <tr>
+ <th colspan="1" rowspan="1">Presentation Format</th>
+
+ <th colspan="1" rowspan="1">Description</th>
+
+ <th colspan="1" rowspan="1">skinconf.xml Element</th>
+ </tr>
+
+ <tr>
+ <td colspan="1" rowspan="1"><link href="document-v13.html">HTML</link></td>
+
+ <td colspan="1" rowspan="1">This document in HTML format. </td>
+
+ <td colspan="1" rowspan="1">Always generated by default. Cannot be turned off.</td>
+ </tr>
+
+ <tr>
+ <td colspan="1" rowspan="1"><link href="document-v13.xml">XML</link></td>
+
+ <td colspan="1" rowspan="1">This document in its raw XML format.</td>
+
+ <td colspan="1" rowspan="1"><disable-xml-link>. By default, set to true, meaning
+ that this link will not be shown.</td>
+ </tr>
+
+ <tr>
+ <td colspan="1" rowspan="1"><link href="document-v13.pdf">PDF</link></td>
+
+ <td colspan="1" rowspan="1">This document as Adobe PDF</td>
+
+ <td colspan="1" rowspan="1"><disable-pdf-link>. By default, set to false, meaning
+ that this link will be shown.</td>
+ </tr>
+
+ <tr>
+ <td colspan="1" rowspan="1">Text</td>
+
+ <td colspan="1" rowspan="1">This document as straight text.</td>
+
+ <td colspan="1" rowspan="1"><disable-txt-link>. By default, set to true, meaning
+ that this link will not be shown. NOT YET IMPLEMENTED.</td>
+ </tr>
+
+ <tr>
+ <td colspan="1" rowspan="1"><link href="document-v13.pod">POD</link></td>
+
+ <td colspan="1" rowspan="1">This document as Perl POD (Plain Old Documentation). Text with
+ minimal formatting directives. If on a *nix system with perl
+ installed, see "man perlpod".</td>
+
+ <td colspan="1" rowspan="1"><disable-pod-link>. 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. For some
+ strange historical reason, the section title is an attribute of the
+ <code><section></code> element.</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><source></code> for instance:</p>
+ <source xml:space="preserve"><![CDATA[
+// This example is from the book _Java in a Nutshell_ by David Flanagan.
+// Written by David Flanagan. Copyright (c) 1996 O'Reilly & 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><source></code> elements so that you can write pointy
+ brackets without needing to escape them with messy
+ <code>&lt;</code> entities ...
+ </p>
+ <source xml:space="preserve"><![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 colspan="1" rowspan="1">heading cell 1</th>
+ <th colspan="1" rowspan="1">heading cell 2</th>
+ <th colspan="1" rowspan="1">heading cell 3</th>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">data cell</td>
+ <td colspan="2" rowspan="1">this data cell spans two columns</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">
+ Tables can be nested:
+ </td>
+ <td colspan="1" rowspan="1">
+ <table>
+ <tr>
+ <th colspan="1" rowspan="1">column 1</th>
+ <th colspan="1" rowspan="1">column 2</th>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">cell A</td>
+ <td colspan="1" rowspan="1">cell B</td>
+ </tr>
+ </table>
+ </td>
+ <td colspan="1" rowspan="1">
+ <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><figure></code> to end all of this.
+ Note that this can also be implemented with an
+ <code><img></code> element.
+ </p>
+ <figure src="images/project-logo.png" alt="The fine Forrest logo" width="220" height="65"/>	
+ </section>
+ </section>
+
+ <section id="changes">
+ <title>DTD changes</title>
+ <p>See the generated
+<!-- FOR-321 workaround
+ <link href="site:dtd-docs">DTD reference documentation</link>.
+-->
+ <link href="dtd-docs.html">DTD documentation</link>.
+ </p>
+ <section id="changes-13">
+ <title>Changes since document-v12</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 since document-v11</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>
\ No newline at end of file
Propchange: forrest/site/0.6/docs/document-v13.xml
------------------------------------------------------------------------------
svn:eol-style = native