You are viewing a plain text version of this content. The canonical link for it is here.
Posted to site-svn@forrest.apache.org by cr...@apache.org on 2013/11/20 03:16:00 UTC
svn commit: r1543692 - in /forrest/site: css/ css/demo-js-css-1.css
docs_0_100/project-js-css.html dtdx/document-v13.pdf dtdx/document-v20.pdf
index.html
Author: crossley
Date: Wed Nov 20 02:16:00 2013
New Revision: 1543692
URL: http://svn.apache.org/r1543692
Log:
Publish from forrestbot
Added:
forrest/site/css/
forrest/site/css/demo-js-css-1.css (with props)
forrest/site/docs_0_100/project-js-css.html (with props)
Modified:
forrest/site/dtdx/document-v13.pdf
forrest/site/dtdx/document-v20.pdf
forrest/site/index.html
Added: forrest/site/css/demo-js-css-1.css
URL: http://svn.apache.org/viewvc/forrest/site/css/demo-js-css-1.css?rev=1543692&view=auto
==============================================================================
--- forrest/site/css/demo-js-css-1.css (added)
+++ forrest/site/css/demo-js-css-1.css Wed Nov 20 02:16:00 2013
@@ -0,0 +1,10 @@
+.demo-js-css {
+ padding: 0.3em;
+ background-color: lightgrey;
+ border-style: double;
+ border-width: 0.5em;
+}
+#demo-js-css-1 { border-color: red; }
+#demo-js-css-2 { border-color: blue; }
+#demo-js-css-3 { border-color: green; }
+#demo-js-css-1:after { content: "; from first CSS resources"; }
Propchange: forrest/site/css/demo-js-css-1.css
------------------------------------------------------------------------------
svn:eol-style = native
Added: forrest/site/docs_0_100/project-js-css.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_100/project-js-css.html?rev=1543692&view=auto
==============================================================================
--- forrest/site/docs_0_100/project-js-css.html (added)
+++ forrest/site/docs_0_100/project-js-css.html Wed Nov 20 02:16:00 2013
@@ -0,0 +1,507 @@
+<!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.10-dev">
+<meta name="Forrest-skin-name" content="pelt">
+<link href="../css/demo-js-css-1.css" rel="stylesheet" type="text/css">
+<link href="../skin/demo-js-css-2.css" rel="stylesheet" type="text/css">
+<script src="../scripts/demo-js-css-1.js" type="text/javascript"></script><script src="../skin/demo-js-css-3.js" type="text/javascript"></script><script src="../scripts/demo-js-css-2.js" type="text/javascript"></script>
+<title>Using extra project JavaScript and CSS resources (v0.10-dev)</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>
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">Apache Software Foundation</a> > <a href="http://forrest.apache.org/">Apache 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.png" 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');" size="25" name="q" id="query" type="text" value="Search the site with google">
+ <input name="Search" value="Search" type="submit">
+</form>
+</div>
+<!--+
+ |end search
+ +-->
+<!--+
+ |start Tabs
+ +-->
+<ul id="tabs">
+<li>
+<a class="unselected" href="../index.html">Welcome</a>
+</li>
+<li>
+<a class="unselected" href="../contrib.html">Developers</a>
+</li>
+<li class="current">
+<a class="selected" href="../versions/index.html">Versioned Docs</a>
+</li>
+<li>
+<a class="unselected" href="../pluginDocs/index.html">Plugins</a>
+</li>
+<li>
+<a class="unselected" href="../tools/index.html">Tools</a>
+</li>
+</ul>
+<!--+
+ |end Tabs
+ +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+ |start Subtabs
+ +-->
+<div id="level2tabs">
+<a class="unselected" href="../docs_0_90/index.html">0.90 (current)</a><a class="selected" href="../docs_0_100/index.html">0.100-dev (under development)</a><a class="unselected" href="../docs_0_80/index.html">0.80 (past)</a>
+</div>
+<!--+
+ |end Endtabs
+ +-->
+<script type="text/javascript"><!--
+document.write("Last 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');">0.100-dev</div>
+<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a href="../docs_0_100/index.html">Overview</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/your-project.html">Using Forrest</a>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.1.3', '../skin/')" id="menu_selected_1.1.3Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">How-To</div>
+<div id="menu_selected_1.1.3" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a href="../docs_0_100/howto/index.html">Overview</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.3.2', '../skin/')" id="menu_1.1.3.2Title" class="menutitle">Install Forrest</div>
+<div id="menu_1.1.3.2" class="menuitemgroup">
+<div class="menuitem">
+<a href="../docs_0_100/build.html" title="Build and install the current unreleased version">Building Forrest from Source</a>
+</div>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/upgrading_010.html">Upgrading to 0.10-dev</a>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.1.3.4', '../skin/')" id="menu_selected_1.1.3.4Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Customize Forrest</div>
+<div id="menu_selected_1.1.3.4" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a href="../docs_0_100/sitemap-explain.html">Sitemaps explained</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/howto-custom-html-source.html">Custom html source</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/project-sitemap.html">Project sitemap</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">Project JS and CSS</div>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/howto-editcss.html">Edit CSS (WYSIWYG)</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/howto-pdf-tab.html" title="Generate one pdf-document for all pages of a tab">Create tab PDF</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/howto-corner-images.html">CSS corner SVG</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.1.3.5', '../skin/')" id="menu_1.1.3.5Title" class="menutitle">Integrate Forrest with tools</div>
+<div id="menu_1.1.3.5" class="menuitemgroup">
+<div class="menuitem">
+<a href="../docs_0_100/howto/howto-forrest-from-maven.html">Maven Integration</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/catalog.html">Using DTD Catalogs</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.1.3.6', '../skin/')" id="menu_1.1.3.6Title" class="menutitle">Extend Forrest</div>
+<div id="menu_1.1.3.6" class="menuitemgroup">
+<div class="menuitem">
+<a href="../docs_0_100/howto/howto-buildPlugin.html">Build a Plugin</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/skin-package.html">Package new Skins</a>
+</div>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/howto-asf-mirror.html">Download mirror</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.3.8', '../skin/')" id="menu_1.1.3.8Title" class="menutitle">Adding Documentation</div>
+<div id="menu_1.1.3.8" class="menuitemgroup">
+<div class="menuitem">
+<a href="../howto-howto.html" title="Instructions for writing a new howto-document">Write a How-to</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.3.8.2', '../skin/')" id="menu_1.1.3.8.2Title" class="menutitle">Multipage HowTo</div>
+<div id="menu_1.1.3.8.2" class="menuitemgroup">
+<div class="menuitem">
+<a href="../docs_0_100/howto/multi/howto-multi.html">Introduction</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/multi/step1.html">Step 1</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/multi/step2.html">Step 2</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/multi/step3.html">Step 3</a>
+</div>
+</div>
+</div>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/faq.html">FAQs</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.5', '../skin/')" id="menu_1.1.5Title" class="menutitle">Background</div>
+<div id="menu_1.1.5" class="menuitemgroup">
+<div class="menuitem">
+<a href="../docs_0_100/linking.html">Menus and Linking</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/searching.html">Search Options in Forrest</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/locationmap.html">Locationmap</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/properties.html">Properties system</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/sitemap-ref.html">Sitemap Reference</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/skins.html" title="About default skins, their naming and features">Skins</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/status-themes.html">Dispatcher versus Skins</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/cap.html">Sourcetype Action</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/validation.html">XML validation and entity resolution</a>
+</div>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/changes.html">Changes</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/glossary.html">Glossary</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.8', '../skin/')" id="menu_1.1.8Title" class="menutitle">Reference docs</div>
+<div id="menu_1.1.8" class="menuitemgroup">
+<div onclick="SwitchMenu('menu_1.1.8.1', '../skin/')" id="menu_1.1.8.1Title" class="menutitle">DTD documentation</div>
+<div id="menu_1.1.8.1" class="menuitemgroup">
+<div class="menuitem">
+<a href="../dtdx/dtd-docs.html">Overview</a>
+</div>
+<div class="menuitem">
+<a href="../dtdx/document-v20.dtdx.html">document-v20</a>
+</div>
+<div class="menuitem">
+<a href="../dtdx/howto-v20.dtdx.html">howto-v20</a>
+</div>
+<div class="menuitem">
+<a href="../dtdx/faq-v20.dtdx.html">faq-v20</a>
+</div>
+<div class="menuitem">
+<a href="../dtdx/document-v13.dtdx.html">document-v13</a>
+</div>
+<div class="menuitem">
+<a href="../dtdx/howto-v13.dtdx.html">howto-v13</a>
+</div>
+<div class="menuitem">
+<a href="../dtdx/faq-v13.dtdx.html">faq-v13</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.1.8.2', '../skin/')" id="menu_1.1.8.2Title" class="menutitle">Doc samples</div>
+<div id="menu_1.1.8.2" class="menuitemgroup">
+<div class="menuitem">
+<a href="../dtdx/document-v13.html">document-v13</a>
+</div>
+<div class="menuitem">
+<a href="../dtdx/document-v20.html">document-v20</a>
+</div>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.1.9', '../skin/')" id="menu_1.1.9Title" class="menutitle">Older Docs</div>
+<div id="menu_1.1.9" class="menuitemgroup">
+<div class="menuitem">
+<a href="../docs_0_100/primer.html">Forrest Primer</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/libre-intro.html">Libre</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/dreams.html">Dream list</a>
+</div>
+<div class="menuitem">
+<a href="../docs_0_100/howto/cvs-ssh/howto-cvs-ssh.html">CVS over SSH</a>
+</div>
+</div>
+</div>
+<div id="credit">
+<hr>
+ This is documentation for development version v0.10-dev
+ (<a href="http://forrest.apache.org/versions/">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 id="credit2">
+<a href="http://www.apache.org/events/current-event.html"><img border="0" title="ApacheCon" alt="ApacheCon - logo" src="http://www.apache.org/events/current-event-125x125.png" style="width: 125px;height: 125px;"></a>
+</div>
+</div>
+<!--+
+ |end Menu
+ +-->
+<!--+
+ |start content
+ +-->
+<div id="content">
+<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>Using extra project JavaScript and CSS resources</h1>
+<div id="front-matter">
+<div id="motd-area">
+ This is documentation for development version v0.10-dev
+ (<a href="http://forrest.apache.org/versions/">More</a>)</div>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#intro">Introduction</a>
+</li>
+<li>
+<a href="#demo">Demonstration</a>
+</li>
+<li>
+<a href="#how">How</a>
+<ul class="minitoc">
+<li>
+<a href="#overview">Overview</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#examples">Examples</a>
+<ul class="minitoc">
+<li>
+<a href="#example-d3">D3.js Data Driven Documentation</a>
+</li>
+<li>
+<a href="#example-leaflet">Leaflet</a>
+</li>
+</ul>
+</li>
+</ul>
+</div>
+</div>
+
+<a name="intro"></a>
+<h2 class="underlined_10">Introduction</h2>
+<div class="section">
+<p>
+ There are various ways for your project to provide additional
+ JavaScript and Cascading Style Sheets.
+ The chosen <a href="../docs_0_100/your-project.html#skins">skin</a> already provides many.
+ Your project can supplement that, and provide additional capabilities
+ for your whole site or for specific pages.
+ </p>
+<p>
+ Note that the new Dispatcher capability provides its own more powerful techniques.
+ See <a href="../docs_0_100/status-themes.html">Status of Themes: Skins and Dispatcher</a>.
+ Still, some of the techniques described below are relevant.
+ </p>
+</div>
+
+<a name="demo"></a>
+<h2 class="underlined_10">Demonstration</h2>
+<div class="section">
+<a name="demo-js-css-1"></a>
+<p class="demo-js-css" id="demo-js-css-1">
+ Demonstration #1:<br>
+
+</p>
+<a name="demo-js-css-2"></a>
+<p class="demo-js-css" id="demo-js-css-2">
+ Demonstration #2:<br>
+
+</p>
+<a name="demo-js-css-3"></a>
+<p class="demo-js-css" id="demo-js-css-3">
+ Demonstration #3:<br>
+
+</p>
+</div>
+
+<a name="how"></a>
+<h2 class="underlined_10">How</h2>
+<div class="section">
+<a name="overview"></a>
+<h3 class="underlined_5">Overview</h3>
+<p>
+ The "link" and "script" elements can be added to the head section of
+ your source xml or source html documents.
+ The project sitemap can add a Transformer to inject additional
+ elements to the internal xml.
+ The "Content Aware Pipelines" can detect certain documents to apply such.
+ The sitemaps and locationmaps resolve the linked resources by searching
+ through a set of known locations in your project.
+ </p>
+<div class="fixme">
+<div class="label">Fixme (open)</div>
+<div class="content">
+ Add explanations of each.
+ </div>
+</div>
+<p>
+ ####
+ </p>
+</div>
+
+<a name="examples"></a>
+<h2 class="underlined_10">Examples</h2>
+<div class="section">
+<a name="example-d3"></a>
+<h3 class="underlined_5">D3.js Data Driven Documentation</h3>
+<p>
+ Hooking up
+ <a href="http://d3js.org/">D3.js</a> is very easy, as shown there.
+ After declaring the "script" element in the header of your source,
+ then add one of the example snippets to your project JS.
+ The "randomly color paragraphs" example is a quick test that you are
+ up and running.
+ </p>
+<p>
+ Obviously it is a very powerful combination to use D3 together with
+ Forrest's ability to gather, co-ordinate, and transform data.
+ </p>
+<a name="example-leaflet"></a>
+<h3 class="underlined_5">Leaflet</h3>
+<p>
+ Follow the excellent
+ <a href="http://bost.ocks.org/mike/leaflet/">example</a>
+ "using D3 to render GeoJSON shapes in conjunction with Leaflet".
+ </p>
+<p>
+ Forrest will automatically find the CSS and JS when you place them
+ in the corresponding "project resources" directories as explained above.
+ </p>
+<p>
+ In this case we need to help Forrest find the images that are used by
+ the Leaflet CSS. For example, it is looking for the resource
+ <span class="codefrag">css/images/zoom-in.png</span> (i.e. relative to its CSS file).
+ </p>
+<p>
+ However, the default machinery in Forrest for locating images does not
+ look in that location, even if you try to place them there.
+ </p>
+<p>
+ Add to your "project locationmap". This is consulted first in the
+ sequence of locationmaps, so you can cause Forrest to look for all
+ project image files in certain specific locations. If it does not
+ find them there, then it continues through the default locationmaps.
+ </p>
+<p>
+ So if you added your source images to a
+ <span class="codefrag">resources/images/leaflet/</span> sub-directory, then add the following to your "project locationmap":
+ </p>
+<pre class="code">
+<match pattern="project.images.**.*">
+ <location src="{properties:resources.images}leaflet/{1}.{2}" />
+</match>
+</pre>
+<p>
+ Note that each locationmap match can try multiple locations in sequence.
+ </p>
+<p>
+ This "project locationmap" technique is useful for utilising multiple
+ image/javascript/css libraries and keeping their resources separate.
+ </p>
+</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-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation. Licensed under Apache License 2.0</a>
+<br>
+ Apache Forrest, Forrest, Apache, the Apache feather logo, and the Apache Forrest
+ logos are trademarks of The Apache Software Foundation.
+ </div>
+<!--+
+ |end bottomstrip
+ +-->
+</div>
+</body>
+</html>
Propchange: forrest/site/docs_0_100/project-js-css.html
------------------------------------------------------------------------------
svn:eol-style = native
Modified: forrest/site/dtdx/document-v13.pdf
URL: http://svn.apache.org/viewvc/forrest/site/dtdx/document-v13.pdf?rev=1543692&r1=1543691&r2=1543692&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/dtdx/document-v20.pdf
URL: http://svn.apache.org/viewvc/forrest/site/dtdx/document-v20.pdf?rev=1543692&r1=1543691&r2=1543692&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/index.html
URL: http://svn.apache.org/viewvc/forrest/site/index.html?rev=1543692&r1=1543691&r2=1543692&view=diff
==============================================================================
--- forrest/site/index.html (original)
+++ forrest/site/index.html Wed Nov 20 02:16:00 2013
@@ -229,7 +229,7 @@ document.write("Last Published: " + docu
The Apache Forrest project uses the opensource
<a href="license.html">Apache License 2.0</a> and adheres to
<a href="guidelines.html#way">open development</a> ideals.
- We are part of the Apache Software Foundation (<a href="http://www.apache.org/">ASF</a>).
+ We are part of The Apache Software Foundation (<a href="http://www.apache.org/">ASF</a>).
</p>
<div class="note">