Propchange: forrest/site/0.7/docs/changes.xml ------------------------------------------------------------------------------ svn:eol-style = native
Added: forrest/site/0.7/docs/compliance.html URL: http://svn.apache.org/viewcvs/forrest/site/0.7/docs/compliance.html?view=auto&rev=160895 ============================================================================== --- forrest/site/0.7/docs/compliance.html (added) +++ forrest/site/0.7/docs/compliance.html Mon Apr 11 07:58:59 2005 @@ -0,0 +1,433 @@ +<!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>Standards Compliance (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="menupage"> +<div class="menupagetitle">Standards Compliance</div> +</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_1.1.19', '../skin/')" id="menu_1.1.19Title" class="menutitle">Reference docs</div> +<div id="menu_1.1.19" class="menuitemgroup"> +<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_1.1.19.2', '../skin/')" id="menu_1.1.19.2Title" class="menutitle">Doc samples</div> +<div id="menu_1.1.19.2" class="menuitemgroup"> +<div class="menuitem"> +<a title="" href="../docs/document-v13.html">document-v13</a> +</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="compliance.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>Standards Compliance</h1> +<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="#Introduction">Introduction</a> +</li> +<li> +<a href="#HTML">HTML</a> +</li> +<li> +<a href="#WAI">WAI</a> +</li> +<li> +<a href="#CSS">CSS</a> +</li> +</ul> +</div> + +<a name="N1000D"></a><a name="Introduction"></a> +<h2 class="underlined_10">Introduction</h2> +<div class="section"> +<p> + Forrest is still quite young, so there are known issues. + Standards compliance is a definite major goal. Please send patches + for the Forrest skin stylesheets to ensure such compliance. + </p> +</div> + + +<a name="N10019"></a><a name="HTML"></a> +<h2 class="underlined_10">HTML</h2> +<div class="section"> +<p> + Tested using the W3C HTML Validation Service + (<a href="http://validator.w3.org/">validator.w3.org</a>). The + index.html page of Forrest sites will have a link to this validator, + unless the user has turned this off. + </p> +<p> + The "<span class="codefrag">crust</span>" skin (current forrest-0.6-dev) + validates as HTML 4.0.1 + </p> +<p> + The "<span class="codefrag">tigris</span>" skin (current forrest-0.6-dev) + validates as HTML 4.0.1 + </p> +</div> + + +<a name="N10033"></a><a name="WAI"></a> +<h2 class="underlined_10">WAI</h2> +<div class="section"> +<p>See +<a href="http://www.w3.org/WAI/">Web Accessibility Initiative (WAI)</a> + +</p> +<p> + There are actually many accessibility issues with the heavy use of + tables and images. These skins are gradually being improved. +</p> +<p> +Bobby with WAI: +<a href="http://bobby.watchfire.com/">bobby.watchfire.com</a> + +</p> +<p>Issues ...</p> +<ol> + +<li> + Priority 1: alt text for images. + </li> + +<li>Priority 2: + <a href="http://bobby.watchfire.com/bobby/html/en/gls/g41.html">Explicitly + associate form controls and their labels with the LABEL element</a>. + Perhaps we could have a label hidden with CSS?</li> + +<li>FIXME: need to list other issues here, or attend to them.</li> + +</ol> +<div class="frame note"> +<div class="label">Note</div> +<div class="content">The forrest-site skin does not have any missing alts. Perhaps Bobby + does not like the trick with empty alt attributes. However, it only + complains about the two in the footer, and not about the other 40.</div> +</div> +<p> +Bobby with U.S. Section 508 Guidelines: +<a href="http://bobby.watchfire.com/">bobby.watchfire.com</a> + +</p> +<p>Issues ...</p> +<ol> + +<li>The same issues as above</li> + +</ol> +</div> + + +<a name="N10071"></a><a name="CSS"></a> +<h2 class="underlined_10">CSS</h2> +<div class="section"> +<p> +Jigsaw: +<a href="http://jigsaw.w3.org/css-validator/">jigsaw.w3.org</a> + +</p> +<p>Issues ...</p> +<ol> + +<li>CSS 2: No errors. Some warnings.</li> + +<li>CSS 1: Errors: hover class, @media-print. Some warnings.</li> + +<li>FIXME: need to list other issues here, or attend to them.</li> + +</ol> +</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/compliance.html ------------------------------------------------------------------------------ svn:eol-style = native Added: forrest/site/0.7/docs/compliance.pdf URL: http://svn.apache.org/viewcvs/forrest/site/0.7/docs/compliance.pdf?view=auto&rev=160895 ============================================================================== Binary file - no diff available. Propchange: forrest/site/0.7/docs/compliance.pdf ------------------------------------------------------------------------------ svn:mime-type = application/pdf Added: forrest/site/0.7/docs/document-v12.html URL: http://svn.apache.org/viewcvs/forrest/site/0.7/docs/document-v12.html?view=auto&rev=160895 ============================================================================== --- forrest/site/0.7/docs/document-v12.html (added) +++ forrest/site/0.7/docs/document-v12.html Mon Apr 11 07:58:59 2005 @@ -0,0 +1,636 @@ +<!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 document-v1.2 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_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">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_1.1.19', '../skin/')" id="menu_1.1.19Title" class="menutitle">Reference docs</div> +<div id="menu_1.1.19" class="menuitemgroup"> +<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_1.1.19.2', '../skin/')" id="menu_1.1.19.2Title" class="menutitle">Doc samples</div> +<div id="menu_1.1.19.2" class="menuitemgroup"> +<div class="menuitem"> +<a title="" href="../docs/document-v13.html">document-v13</a> +</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-v12.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 document-v1.2 DTD</h1> +<div class="abstract">A nonsense document using all possible elements in the current + document-v12.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="#Changes+since+document-v11">Changes since document-v11</a> +</li> +<li> +<a href="#Sample+Content">Sample Content</a> +<ul class="minitoc"> +<li> +<a href="#Using+sections">Using sections</a> +</li> +<li> +<a href="#Sections%2C+the+sequel">Sections, the sequel</a> +<ul class="minitoc"> +<li> +<a href="#Section+2.1">Section 2.1</a> +</li> +</ul> +</li> +<li> +<a href="#Showing+preformatted+source+code">Showing preformatted source code</a> +</li> +<li> +<a href="#table">Using tables</a> +</li> +<li> +<a href="#figure">Using figures</a> +</li> +</ul> +</li> +</ul> +</div> + +<div class="frame note"> +<div class="label">Note</div> +<div class="content">The document-v12 has been superceded by + <a href="../docs/document-v13.html">document-v13</a> + +</div> +</div> + +<a name="N1001D"></a><a name="Changes+since+document-v11"></a> +<h2 class="underlined_10">Changes since document-v11</h2> +<div class="section"> +<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> + +<a name="N10036"></a><a name="Sample+Content"></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 documentation</link>. +--> + <a href="dtd-docs.html">DTD documentation</a>. + </p> +<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>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="your-project.html"></span> +</dt> + +<dd>Use this to + <a href="your-project.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="your-project.html#images"></span> +</dt> + +<dd>Use this to + <a href="your-project.html#images" 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="your-project.html"></span> +</dt> + +<dd>Use this to + <a target="_top" href="your-project.html">jump</a> + to another document and optionally go to a named + <a target="_top" href="your-project.html#images">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="your-project.html"></span> +</dt> + +<dd>Use this to + <a target="_blank" href="your-project.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">inside lists</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="section"></a><a name="N1013D"></a><a name="Using+sections"></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="N1014A"></a><a name="Sections%2C+the+sequel"></a> +<h3 class="underlined_5">Sections, the sequel</h3> +<p>Just some second section.</p> +<a name="N10153"></a><a name="Section+2.1"></a> +<h4>Section 2.1</h4> +<p>Which contains a subsection (2.1).</p> +<a name="source"></a><a name="N10161"></a><a name="Showing+preformatted+source+code"></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>Please take care to still use a sensible line-length within your + source elements.</p> +<a name="N10175"></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</th> + <th colspan="1" rowspan="1">heading cell</th> + +</tr> + +<tr> + +<td colspan="1" rowspan="1">data cell</td> + <td colspan="1" rowspan="1">data cell</td> + +</tr> + +<tr> + +<td colspan="1" rowspan="1"> + Tables can be nested + </td> + <td colspan="1" rowspan="1"> + +<ul> +<li>and can include most other elements, like lists</li> +</ul> + +</td> + +</tr> + +</table> +<p>Not much of attributes with <span class="codefrag"><table></span>, if you ask me.</p> +<a name="second-figure-anchor"></a><a name="N101B9"></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> + +</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-v12.html ------------------------------------------------------------------------------ svn:eol-style = native Added: forrest/site/0.7/docs/document-v12.pdf URL: http://svn.apache.org/viewcvs/forrest/site/0.7/docs/document-v12.pdf?view=auto&rev=160895 ============================================================================== Binary file - no diff available. Propchange: forrest/site/0.7/docs/document-v12.pdf ------------------------------------------------------------------------------ svn:mime-type = application/pdf