Propchange: forrest/site/0.7/docs/document-v13.dtdx.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: forrest/site/0.7/docs/document-v13.dtdx.pdf
URL:
http://svn.apache.org/viewcvs/forrest/site/0.7/docs/document-v13.dtdx.pdf?view=auto&rev=160895
==============================================================================
Binary file - no diff available.
Propchange: forrest/site/0.7/docs/document-v13.dtdx.pdf
------------------------------------------------------------------------------
svn:mime-type = application/pdf
Added: forrest/site/0.7/docs/document-v13.html
URL:
http://svn.apache.org/viewcvs/forrest/site/0.7/docs/document-v13.html?view=auto&rev=160895
==============================================================================
--- forrest/site/0.7/docs/document-v13.html (added)
+++ forrest/site/0.7/docs/document-v13.html Mon Apr 11 07:58:59 2005
@@ -0,0 +1,817 @@
+<!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.7)</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">0.7 Docs</a>
+</li>
+<li>
+<a class="base-not-selected" href="../docs/howto/index.html">0.7 How-To</a>
+</li>
+</ul>
+<!--+
+ |end Tabs
+ +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+ |start Subtabs
+ +-->
+<div id="level2tabs">
+<a class="base-not-selected" href="..">Core</a> | <a class="base-not-selected"
href="..">ForrestBot</a> | <a class="base-not-selected" href="..">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_selected_1.1', '../skin/')"
id="menu_selected_1.1Title" class="menutitle" style="background-image:
url('../skin/images/chapter_open.gif');">Documentation</div>
+<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display:
block;">
+<div class="menuitem">
+<a title="" href="../docs/index.html">Overview</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/faq.html">FAQs</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/changes.html">Changes</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/todo.html">Todo</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/plugins/usingPlugins.html">Plugins</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/views.html">Views-dev</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.15', '../skin/')" id="menu_1.1.15Title"
class="menutitle">Advanced Topics</div>
+<div id="menu_1.1.15" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../docs/build.html">Building Forrest</a>
+</div>
+<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/plugins/pluginInfrastructure.html">Plugin
Infrastructure</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/cap.html">Sourcetype Action</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.1.16', '../skin/')" id="menu_1.1.16Title"
class="menutitle">Other versions</div>
+<div id="menu_1.1.16" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../docs.html">Overview</a>
+</div>
+<div class="menuitem">
+<a title="" href="http://forrest.apache.org/docs/../0.8/";>0.8-dev</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/index.html">0.7 (current)</a>
+</div>
+<div class="menuitem">
+<a title="" href="http://forrest.apache.org/docs/../0.6/";>0.6</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.1.17', '../skin/')" id="menu_1.1.17Title"
class="menutitle">Upgrading</div>
+<div id="menu_1.1.17" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="../docs/upgrading_07.html">Upgrading to 0.7</a>
+</div>
+<div class="menuitem">
+<a title="" href="../docs/upgrading_06.html">Upgrading to 0.6</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.1.18', '../skin/')" id="menu_1.1.18Title"
class="menutitle">SubProjects</div>
+<div id="menu_1.1.18" 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.1.19', '../skin/')"
id="menu_selected_1.1.19Title" class="menutitle" style="background-image:
url('../skin/images/chapter_open.gif');">Reference docs</div>
+<div id="menu_selected_1.1.19" class="selectedmenuitemgroup" style="display:
block;">
+<div onclick="SwitchMenu('menu_1.1.19.1', '../skin/')" id="menu_1.1.19.1Title"
class="menutitle">DTD documentation</div>
+<div id="menu_1.1.19.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.1.19.2', '../skin/')"
id="menu_selected_1.1.19.2Title" class="menutitle" style="background-image:
url('../skin/images/chapter_open.gif');">Doc samples</div>
+<div id="menu_selected_1.1.19.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>
+</div>
+<div onclick="SwitchMenu('menu_1.1.20', '../skin/')" id="menu_1.1.20Title"
class="menutitle">Older Docs</div>
+<div id="menu_1.1.20" 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>
+<div id="credit">
+<hr>
+ This is documentation for current release v0.7
+ (<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 current release v0.7
+ (<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-2005 The Apache Software Foundation.</div>
+<!--+
+ |end bottomstrip
+ +-->
+</div>
+</body>
+</html>
Propchange: forrest/site/0.7/docs/document-v13.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: forrest/site/0.7/docs/document-v13.pdf
URL:
http://svn.apache.org/viewcvs/forrest/site/0.7/docs/document-v13.pdf?view=auto&rev=160895
==============================================================================
Binary file - no diff available.
Propchange: forrest/site/0.7/docs/document-v13.pdf
------------------------------------------------------------------------------
svn:mime-type = application/pdf
Added: forrest/site/0.7/docs/document-v13.pod
URL:
http://svn.apache.org/viewcvs/forrest/site/0.7/docs/document-v13.pod?view=auto&rev=160895
==============================================================================
Binary file - no diff available.
Propchange: forrest/site/0.7/docs/document-v13.pod
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: forrest/site/0.7/docs/document-v13.xml
URL:
http://svn.apache.org/viewcvs/forrest/site/0.7/docs/document-v13.xml?view=auto&rev=160895
==============================================================================
--- forrest/site/0.7/docs/document-v13.xml (added)
+++ forrest/site/0.7/docs/document-v13.xml Mon Apr 11 07:58:59 2005
@@ -0,0 +1,374 @@
+<?xml version="1.0" encoding="ISO-8859-1"?><!--
+ Copyright 2002-2004 The Apache Software Foundation or its licensors,
+ as applicable.
+
+ 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.7/docs/document-v13.xml
------------------------------------------------------------------------------
svn:eol-style = native
