You are viewing a plain text version of this content. The canonical link for it is here.
Posted to svn@forrest.apache.org by cr...@apache.org on 2004/09/03 07:05:50 UTC
svn commit: rev 37456 - in forrest/site: . docs
Author: crossley
Date: Thu Sep 2 22:05:50 2004
New Revision: 37456
Modified:
forrest/site/changes.html
forrest/site/changes.pdf
forrest/site/changes.rss
forrest/site/changes.xml
forrest/site/docs/document-v12.pdf
forrest/site/docs/document-v13.pdf
forrest/site/docs/linking.pdf
forrest/site/docs/primer.pdf
forrest/site/docs/skins.html
forrest/site/docs/skins.pdf
forrest/site/docs/upgrading_06.html
forrest/site/docs/upgrading_06.pdf
forrest/site/docs/wiki-sample.html
forrest/site/docs/wiki-sample.pdf
forrest/site/docs/your-project.pdf
forrest/site/forrest-issues.html
forrest/site/forrest-issues.pdf
Log:
Add link to more info about JSPWiki support.
Describe the old "forrest-site" skin.
Update open issues.
Modified: forrest/site/changes.html
==============================================================================
--- forrest/site/changes.html (original)
+++ forrest/site/changes.html Thu Sep 2 22:05:50 2004
@@ -494,9 +494,11 @@
(JJP) Fixes <a class="external" href="http://issues.cocoondev.org/browse/FOR-56">FOR-56</a>.</li>
<li>
<img class="icon" alt="remove" src="images/remove.jpg">
- Skins forrest-css, forrest-site and avalon-tigris deleted; krysalis-site
+ Skins forrest-css and avalon-tigris deleted; krysalis-site
renamed to "crust" and tigris-style renamed to "tigris". Aliases
set in place for backward-compatibility.
+ The old "forrest-site" skin is retained for a little while longer,
+ but is deprecated, so please move to one of the other skins.
See notes about <a href="docs/skins.html">Default skins</a>.
(DB) Fixes <a class="external" href="http://issues.cocoondev.org/browse/FOR-181">FOR-181</a>.</li>
<li>
@@ -1731,7 +1733,7 @@
<li>
<img class="icon" alt="fix" src="images/fix.jpg">
<span class="codefrag">forrest-site</span> skin is now HTML 4.0.1 compliant. The
- compliancy validator logo can be switched off with a
+ compliance validator logo can be switched off with a
<span class="codefrag">skinconf.xml</span> element.
(JT)</li>
<li>
Modified: forrest/site/changes.pdf
==============================================================================
Binary files. No diff available.
Modified: forrest/site/changes.rss
==============================================================================
--- forrest/site/changes.rss (original)
+++ forrest/site/changes.rss Thu Sep 2 22:05:50 2004
@@ -75,9 +75,11 @@
DB
:
- Skins forrest-css, forrest-site and avalon-tigris deleted; krysalis-site
+ Skins forrest-css and avalon-tigris deleted; krysalis-site
renamed to "crust" and tigris-style renamed to "tigris". Aliases
set in place for backward-compatibility.
+ The old "forrest-site" skin is retained for a little while longer,
+ but is deprecated, so please move to one of the other skins.
See notes about Default skins.
</description></item><item><title>core update</title><link>http://forrest.apache.org/changes.html</link><description>core update
by
Modified: forrest/site/changes.xml
==============================================================================
--- forrest/site/changes.xml (original)
+++ forrest/site/changes.xml Thu Sep 2 22:05:50 2004
@@ -160,9 +160,11 @@
<map:generator name="serverpages"
src="org.apache.cocoon.generation.ServerPagesGenerator"/>
(JJP) Fixes <link href="http://issues.cocoondev.org/browse/FOR-56">FOR-56</link>.</li><li><icon alt="remove" src="images/remove.jpg"/>
- Skins forrest-css, forrest-site and avalon-tigris deleted; krysalis-site
+ Skins forrest-css and avalon-tigris deleted; krysalis-site
renamed to "crust" and tigris-style renamed to "tigris". Aliases
set in place for backward-compatibility.
+ The old "forrest-site" skin is retained for a little while longer,
+ but is deprecated, so please move to one of the other skins.
See notes about <link href="site:skins">Default skins</link>.
(DB) Fixes <link href="http://issues.cocoondev.org/browse/FOR-181">FOR-181</link>.</li><li><icon alt="remove" src="images/remove.jpg"/>
Remove 'template' skin; better to base a new skin on an existing one.
@@ -878,7 +880,7 @@
<code>src/documentation/content/xdocs</code>.
(JT)</li><li><icon alt="fix" src="images/fix.jpg"/>
<code>forrest-site</code> skin is now HTML 4.0.1 compliant. The
- compliancy validator logo can be switched off with a
+ compliance validator logo can be switched off with a
<code>skinconf.xml</code> element.
(JT)</li><li><icon alt="fix" src="images/fix.jpg"/>
Indirectly referenced files in skins (e.g. images in
Modified: forrest/site/docs/document-v12.pdf
==============================================================================
Binary files. No diff available.
Modified: forrest/site/docs/document-v13.pdf
==============================================================================
Binary files. No diff available.
Modified: forrest/site/docs/linking.pdf
==============================================================================
Binary files. No diff available.
Modified: forrest/site/docs/primer.pdf
==============================================================================
Binary files. No diff available.
Modified: forrest/site/docs/skins.html
==============================================================================
--- forrest/site/docs/skins.html (original)
+++ forrest/site/docs/skins.html Thu Sep 2 22:05:50 2004
@@ -288,8 +288,14 @@
<a href="#pelt">pelt</a>
</li>
<li>
+<a href="#leather-dev">leather-dev</a>
+</li>
+<li>
<a href="#tigris">tigris</a>
</li>
+<li>
+<a href="#forrest-site">forrest-site</a>
+</li>
</ul>
</li>
</ul>
@@ -401,9 +407,28 @@
<p>
During its earlier development, this skin used to be called "css-style-dev".
</p>
+
+
+<a name="N10045"></a><a name="leather-dev"></a>
+<table width="100%" border="0" cellspacing="0" cellpadding="0" class="h4">
+<tbody>
+<tr>
+<td height="10" width="9"></td><td>
+<h4>leather-dev</h4>
+</td><td></td>
+</tr>
+<tr class="subheading">
+<td class="bottom-left"></td><td></td><td class="bottom-right"></td>
+</tr>
+</tbody>
+</table>
+<p>
+ This is the evolution of the "pelt" skin, to have naming
+ conventions for css elements. It is still in development.
+ </p>
-<a name="N10045"></a><a name="tigris"></a>
+<a name="N1004F"></a><a name="tigris"></a>
<table width="100%" border="0" cellspacing="0" cellpadding="0" class="h4">
<tbody>
<tr>
@@ -420,6 +445,26 @@
This skin is based on version 1.1 of the
<a class="external" href="http://style.tigris.org/">style.tigris.org</a> project.
(It deliberately contravenes our skin naming convention.)
+ </p>
+
+
+<a name="N1005D"></a><a name="forrest-site"></a>
+<table width="100%" border="0" cellspacing="0" cellpadding="0" class="h4">
+<tbody>
+<tr>
+<td height="10" width="9"></td><td>
+<h4>forrest-site</h4>
+</td><td></td>
+</tr>
+<tr class="subheading">
+<td class="bottom-left"></td><td></td><td class="bottom-right"></td>
+</tr>
+</tbody>
+</table>
+<p>
+ This is the old skin that we have been dragging around since early
+ days. It is retained for a little while longer, but is deprecated,
+ so please move to one of the other skins.
</p>
</div>
Modified: forrest/site/docs/skins.pdf
==============================================================================
Binary files. No diff available.
Modified: forrest/site/docs/upgrading_06.html
==============================================================================
--- forrest/site/docs/upgrading_06.html (original)
+++ forrest/site/docs/upgrading_06.html Thu Sep 2 22:05:50 2004
@@ -881,10 +881,6 @@
</tr>
<tr>
-<td colspan="1" rowspan="1">forrest-site</td><td colspan="1" rowspan="1">crust</td>
-</tr>
-
-<tr>
<td colspan="1" rowspan="1">forrest-css</td><td colspan="1" rowspan="1">crust</td>
</tr>
@@ -893,11 +889,14 @@
</tr>
</table>
+
+<p>The old "forrest-site" skin is retained for a little while longer,
+ but is deprecated, so please move to one of the other skins.</p>
</div>
-<a name="N1016F"></a><a name="wholesite"></a>
+<a name="N10168"></a><a name="wholesite"></a>
<table width="100%" border="0" cellspacing="0" cellpadding="0" class="h3">
<tbody>
<tr>
@@ -913,14 +912,15 @@
<div class="section">
-<p>Instead of using site.html/pdf to create an aggregate page of your entire site, use
- wholesite.html/pdf. The old names are still supported for backwards compatibility but
- they may not be in the future.</p>
+<p>Instead of using names "site.html/pdf" to create an aggregate page
+ of your entire site, use "wholesite.html/pdf". The old names are still
+ supported for backwards compatibility but they may not be in the
+ future.</p>
</div>
-<a name="N10179"></a><a name="To+be+continued..."></a>
+<a name="N10172"></a><a name="To+be+continued..."></a>
<table width="100%" border="0" cellspacing="0" cellpadding="0" class="h3">
<tbody>
<tr>
Modified: forrest/site/docs/upgrading_06.pdf
==============================================================================
Binary files. No diff available.
Modified: forrest/site/docs/wiki-sample.html
==============================================================================
--- forrest/site/docs/wiki-sample.html (original)
+++ forrest/site/docs/wiki-sample.html Thu Sep 2 22:05:50 2004
@@ -276,6 +276,9 @@
<a href="#Forrest%27s+JSPWiki+Support">Forrest's JSPWiki Support</a>
<ul class="minitoc">
<li>
+<a href="#Important+Note">Important Note</a>
+</li>
+<li>
<a href="#Quick+reference">Quick reference</a>
</li>
<li>
@@ -325,8 +328,22 @@
</tbody>
</table>
<div class="section">
-<p>Forrest now has partial support for documentation in JSPWiki format, thanks to the <a class="external" href="http://chaperon.sf.net/">Chaperon parser</a>. Wiki is a simple text format that can be learned in minutes. This page provides an overview of the syntax that Forrest supports, namely a subset of that used by the <a class="external" href="http://www.jspwiki.org/">JSPWiki</a>. </p>
-<a name="N10015"></a><a name="Quick+reference"></a>
+<p>Forrest now has partial support for documentation in JSPWiki format, thanks to the <a class="external" href="http://chaperon.sf.net/">Chaperon parser</a>. Wiki is a simple text format that can be learned in minutes. This page provides an overview of the syntax that Forrest supports, namely a subset of that used by the <a class="external" href="http://www.jspwiki.org/Wiki.jsp?page=TextFormattingRules">JSPWiki</a>. There is also a <a class="external" href="http://www.jspwiki.org/Wiki.jsp?page=ChaperonTestPage">ChaperonTestPage</a>which might provide some more hints (view its source). </p>
+<a name="N10019"></a><a name="Important+Note"></a>
+<table width="100%" border="0" cellspacing="0" cellpadding="0" class="h4">
+<tbody>
+<tr>
+<td height="10" width="9"></td><td>
+<h4>Important Note</h4>
+</td><td></td>
+</tr>
+<tr class="subheading">
+<td class="bottom-left"></td><td></td><td class="bottom-right"></td>
+</tr>
+</tbody>
+</table>
+<p>It is very easy to create broken documents by using this loose wiki syntax. Be sure to follow it explicitly. </p>
+<a name="N1001F"></a><a name="Quick+reference"></a>
<table width="100%" border="0" cellspacing="0" cellpadding="0" class="h4">
<tbody>
<tr>
@@ -367,7 +384,7 @@
# text = makes a numbered list item with 'text'
;term:ex = makes a definition for 'term' with the explanation 'ex'
</pre>
-<a name="N1001B"></a><a name="Writing+text"></a>
+<a name="N10025"></a><a name="Writing+text"></a>
<table width="100%" border="0" cellspacing="0" cellpadding="0" class="h4">
<tbody>
<tr>
@@ -380,8 +397,8 @@
</tr>
</tbody>
</table>
-<p>You don't need to know anything about the Wiki text formatting rules to use Wiki. Just write normal text, and then use an empty line to mark a paragraph. It's just like writing an email. </p>
-<a name="N10021"></a><a name="Hyperlinks%0A"></a>
+<p>You don't need to know anything about the Wiki text formatting rules to use Wiki. Just write normal text, and then use an empty line to mark a paragraph. It's just like writing an email. Add more fancy items as you become more comfortable. </p>
+<a name="N1002B"></a><a name="Hyperlinks%0A"></a>
<table width="100%" border="0" cellspacing="0" cellpadding="0" class="h4">
<tbody>
<tr>
@@ -399,7 +416,7 @@
<p>To add a new page you just create a link to it from somewhere else. After all, there isn't much point in having a page if you can't access it! You'll then see a small question mark after the page name when you return to that page. Then click on it and you have created a new page! </p>
<p>It's allowed to use almost any kind of characters inside a [[WikiName], as long as they are letters or numbers. </p>
<p>Note also that this Wiki can be configured to support standard CamelCase linking (if it's supported, the word CamelCase should be a link). It's off by default, but if your friendly administrator has turned it on, then well, CamelCase all you want =). </p>
-<a name="N10035"></a><a name="Adding+pictures"></a>
+<a name="N1003F"></a><a name="Adding+pictures"></a>
<table width="100%" border="0" cellspacing="0" cellpadding="0" class="h4">
<tbody>
<tr>
@@ -414,7 +431,7 @@
</table>
<p>For security reasons uploading images is not permitted, but you can embed any image in the wiki code by putting the image available somewhere on the web in one of the allowed formats, and then just linking to it. For example, this is an inlined PNG image: <img alt="http://forrest.apache.org/skin/images/built-with-forrest-button.png" src="http://forrest.apache.org/skin/images/built-with-forrest-button.png"></p>
<p>If you specify a link text ([[this one here|http://example.com/example.png]) it becomes the ALT text for those who either can't or don't want to view images. </p>
-<a name="N10040"></a><a name="Bulleted+lists%0A"></a>
+<a name="N1004A"></a><a name="Bulleted+lists%0A"></a>
<table width="100%" border="0" cellspacing="0" cellpadding="0" class="h4">
<tbody>
<tr>
@@ -444,7 +461,7 @@
<li>Three.One </li>
</ul>
</ul>
-<a name="N10054"></a><a name="Numbered+lists%0A"></a>
+<a name="N1005E"></a><a name="Numbered+lists%0A"></a>
<table width="100%" border="0" cellspacing="0" cellpadding="0" class="h4">
<tbody>
<tr>
@@ -480,7 +497,7 @@
<li>This is actually a multi-line item. We continue the second sentence on a line on a line of its own. We might as well do a third line while we're at it... Notice, however, as all these sentences get put inside a single item! </li>
<li>The third line is again a single-line item for your convinience. </li>
</ul>
-<a name="N10071"></a><a name="Definition+lists+and+comments"></a>
+<a name="N1007B"></a><a name="Definition+lists+and+comments"></a>
<table width="100%" border="0" cellspacing="0" cellpadding="0" class="h4">
<tbody>
<tr>
@@ -502,7 +519,7 @@
</pre>
<p>Which would be seen as ;: <em>Comment here.</em>
</p>
-<a name="N10089"></a><a name="Text+effects"></a>
+<a name="N10093"></a><a name="Text+effects"></a>
<table width="100%" border="0" cellspacing="0" cellpadding="0" class="h4">
<tbody>
<tr>
@@ -516,7 +533,7 @@
</tbody>
</table>
<p>You may use <strong>bold</strong> text or <em>italic</em> text, by using two underscores (_) and two single quotes ('), respectively. If you're on a Windows computer, make sure that you are using the correct quote sign, as there is one that looks the same, but really isn't. </p>
-<a name="N10095"></a><a name="Preformatted+text"></a>
+<a name="N1009F"></a><a name="Preformatted+text"></a>
<table width="100%" border="0" cellspacing="0" cellpadding="0" class="h4">
<tbody>
<tr>
@@ -530,7 +547,7 @@
</tbody>
</table>
<p>If you want to add preformatted text (like code) just use three consecutive braces ({) to open a block, and three consecutive braces (}) to close a block. Edit this page for an example. </p>
-<a name="N1009B"></a><a name="Tables"></a>
+<a name="N100A5"></a><a name="Tables"></a>
<table width="100%" border="0" cellspacing="0" cellpadding="0" class="h4">
<tbody>
<tr>
Modified: forrest/site/docs/wiki-sample.pdf
==============================================================================
Binary files. No diff available.
Modified: forrest/site/docs/your-project.pdf
==============================================================================
Binary files. No diff available.
Modified: forrest/site/forrest-issues.html
==============================================================================
--- forrest/site/forrest-issues.html (original)
+++ forrest/site/forrest-issues.html Thu Sep 2 22:05:50 2004
@@ -186,9 +186,6 @@
<a href="#%5BFOR-251%5D+start+script+for+UNIX+bin%2Fforrest+should+not+be+bash-specific">[FOR-251] start script for UNIX bin/forrest should not be bash-specific</a>
</li>
<li>
-<a href="#%5BFOR-247%5D+Tigris+*.css+need+cleanup+to+remove+our+local+changes">[FOR-247] Tigris *.css need cleanup to remove our local changes</a>
-</li>
-<li>
<a href="#%5BFOR-245%5D+changing+skins+and+going+out+in+the+public+view">[FOR-245] changing skins and going out in the public view</a>
</li>
<li>
@@ -276,28 +273,7 @@
<br>
As a workaround the script has been set to be /bin/bash</p>
</div>
-<a name="N1003B"></a><a name="%5BFOR-247%5D+Tigris+*.css+need+cleanup+to+remove+our+local+changes"></a>
-<table width="100%" border="0" cellspacing="0" cellpadding="0" class="h3">
-<tbody>
-<tr>
-<td height="10" width="9"></td><td>
-<h3>[FOR-247] Tigris *.css need cleanup to remove our local changes</h3>
-</td><td></td>
-</tr>
-<tr class="heading ">
-<td class="bottom-left"></td><td class="bottomborder"></td><td class="bottom-right"></td>
-</tr>
-</tbody>
-</table>
-<div class="section">
-<p>
-<a class="external" href="http://issues.cocoondev.org//browse/FOR-247">http://issues.cocoondev.org//browse/FOR-247</a>
-</p>
-<p>We have made some local changes to our copies of the tigris *.css which actually need to go into an over-riding css. Also remove our license notice which was added by accident.
-<br>
-<a href="http://marc.theaimsgroup.com/?l=forrest-dev&m=109169132601758">http://marc.theaimsgroup.com/?l=forrest-dev&m=109169132601758</a></p>
-</div>
-<a name="N10049"></a><a name="%5BFOR-245%5D+changing+skins+and+going+out+in+the+public+view"></a>
+<a name="N1003B"></a><a name="%5BFOR-245%5D+changing+skins+and+going+out+in+the+public+view"></a>
<table width="100%" border="0" cellspacing="0" cellpadding="0" class="h3">
<tbody>
<tr>
@@ -316,7 +292,7 @@
</p>
<p>It almost time to change the skin on our public Forrest website.</p>
</div>
-<a name="N10057"></a><a name="%5BFOR-224%5D+All+documentation+needs+review%2C+to+be+up-to-date+with+copyless+procedure"></a>
+<a name="N10049"></a><a name="%5BFOR-224%5D+All+documentation+needs+review%2C+to+be+up-to-date+with+copyless+procedure"></a>
<table width="100%" border="0" cellspacing="0" cellpadding="0" class="h3">
<tbody>
<tr>
@@ -335,7 +311,7 @@
</p>
<p>Since the change to copyless there is stacks of documentation that needs to be modified.</p>
</div>
-<a name="N10065"></a><a name="%5BFOR-223%5D+build+target+%22release-dist%22+still+refers+to+old+dist%2Fshbat%2F+stuff"></a>
+<a name="N10057"></a><a name="%5BFOR-223%5D+build+target+%22release-dist%22+still+refers+to+old+dist%2Fshbat%2F+stuff"></a>
<table width="100%" border="0" cellspacing="0" cellpadding="0" class="h3">
<tbody>
<tr>
@@ -354,7 +330,7 @@
</p>
<p>The "release-dist" target needs to be fixed and tested, since the changes for "copyless".</p>
</div>
-<a name="N10073"></a><a name="%5BFOR-202%5D+Custom+sitemap.xmap+causes+hang"></a>
+<a name="N10065"></a><a name="%5BFOR-202%5D+Custom+sitemap.xmap+causes+hang"></a>
<table width="100%" border="0" cellspacing="0" cellpadding="0" class="h3">
<tbody>
<tr>
@@ -375,7 +351,7 @@
<br>
</p>
</div>
-<a name="N10081"></a><a name="%5BFOR-198%5D+local+stylesheets+for+a+user+project+not+found"></a>
+<a name="N10073"></a><a name="%5BFOR-198%5D+local+stylesheets+for+a+user+project+not+found"></a>
<table width="100%" border="0" cellspacing="0" cellpadding="0" class="h3">
<tbody>
<tr>
@@ -394,7 +370,7 @@
</p>
<p>When a user project defines their own sitemap and stylesheets, then the sitemaps are over-ridden okay, but their local stylesheets are not found.</p>
</div>
-<a name="N1008F"></a><a name="%5BFOR-172%5D+Finish+off+copyless+behaviour"></a>
+<a name="N10081"></a><a name="%5BFOR-172%5D+Finish+off+copyless+behaviour"></a>
<table width="100%" border="0" cellspacing="0" cellpadding="0" class="h3">
<tbody>
<tr>
Modified: forrest/site/forrest-issues.pdf
==============================================================================
Binary files. No diff available.