You are viewing a plain text version of this content. The canonical link for it is here.
Posted to svn@forrest.apache.org by cr...@apache.org on 2005/10/13 03:36:56 UTC
svn commit: r320607 - /forrest/site/docs_0_80/howto/howto-view-install.html
Author: crossley
Date: Wed Oct 12 18:36:54 2005
New Revision: 320607
URL: http://svn.apache.org/viewcvs?rev=320607&view=rev
Log:
Try to clarify the status of views development.
Modified:
forrest/site/docs_0_80/howto/howto-view-install.html
Modified: forrest/site/docs_0_80/howto/howto-view-install.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/howto/howto-view-install.html?rev=320607&r1=320606&r2=320607&view=diff
==============================================================================
--- forrest/site/docs_0_80/howto/howto-view-install.html (original)
+++ forrest/site/docs_0_80/howto/howto-view-install.html Wed Oct 12 18:36:54 2005
@@ -390,21 +390,30 @@
<div class="section">
<ul>
-<li>You need to use the trunk version of Forrest for using views because it is in an early stage</li>
+<li>Need the SVN trunk version of Forrest for using views because it is in an early stage.</li>
<li>Read <a href="../../docs_0_80/howto/howto-buildPlugin.html">How to Build a Plugin</a>
especially the section about using Forrest's own Ant.</li>
</ul>
+<div class="warning">
+<div class="label">Warning</div>
+<div class="content">
+Need a recent version of SVN trunk. If you had a working site using the old
+views development in trunk, and don't want to use the new views plugins,
+then use r292708 (see
+<a href="http://marc.theaimsgroup.com/?l=forrest-dev&m=112839617103846">mail</a>).
</div>
-<a name="N10035"></a><a name="Steps"></a>
+</div>
+</div>
+<a name="N1003C"></a><a name="Steps"></a>
<h2 class="underlined_10">Steps</h2>
<div class="section">
<p>
The process of setting up the plugin is quite heavy. We promise it will be easier in the future.
Some of the instructions need to be modified with your local settings.
</p>
-<a name="N1003D"></a><a name="localBuild"></a>
+<a name="N10044"></a><a name="localBuild"></a>
<h3 class="underlined_5">Build the internal.structurer and the output.themes plugins</h3>
<p>
The first step is to build and deploy the internal.structurer and the output.themes plugins. Change to a terminal window of your choice
@@ -423,12 +432,20 @@
Alternatively, run the script <span class="codefrag">etc/views.sh</span>
</p>
-<a name="N10051"></a><a name="jxpath"></a>
+<a name="N10058"></a><a name="jxpath"></a>
<h3 class="underlined_5">Upgrade the JXPath library</h3>
<p>
- Replace lib.core/commons-jxpath-20030909.jar with commons-jxpath-1.2.jar
+ Replace lib/core/commons-jxpath-20030909.jar with commons-jxpath-1.2.jar
</p>
-<a name="N1005B"></a><a name="newSeed"></a>
+<div class="note">
+<div class="label">Note</div>
+<div class="content">
+That will introduce Issue
+<a href="http://issues.apache.org/jira/browse/FOR-675">FOR-675</a>
+- please help to fix it.
+</div>
+</div>
+<a name="N10069"></a><a name="newSeed"></a>
<h3 class="underlined_5">Seed a new project</h3>
<p>
Go to the directory where you want to seed a new project and seed it.
@@ -437,17 +454,17 @@
cd ~/src/newSeed
forrest seed
</pre>
-<a name="N10069"></a><a name="forrestProperties"></a>
+<a name="N10077"></a><a name="forrestProperties"></a>
<h3 class="underlined_5">Modifying forrest.properties</h3>
<p>
- Now we have to tell forrest that we are planning to use the view plugins. We will do that
- by editing the forrest.properties to add the plugins:
+ Tell forrest that we are using the view plugins. Edit
+ forrest.properties to add the required plugins:
</p>
<pre class="code">
project.required.plugins=org.apache.forrest.plugin.output.themes,org.apache.forrest.plugin.internal.structurer
</pre>
<p>
- Now we have to change the project skin to leather-dev. The reason is that the plugins are still
+ Change the project skin to leather-dev. The reason is that the plugins are still
not independent from the "old fashion skins".
</p>
<div class="note">
@@ -459,7 +476,7 @@
<pre class="code">
project.skin=leather-dev
</pre>
-<a name="N10081"></a><a name="testing"></a>
+<a name="N1008F"></a><a name="testing"></a>
<h3 class="underlined_5">Test your new view based project</h3>
<p>
Now you have finished the preparation and the setup to finally do
@@ -469,7 +486,7 @@
</pre>
<p>Then point to <span class="codefrag">http://localhost:8888/</span> and you will see the default
views-based site.</p>
-<a name="N10095"></a><a name="availableContracts"></a>
+<a name="N100A3"></a><a name="availableContracts"></a>
<h3 class="underlined_5">Available contracts</h3>
<p>
To start working with views, you need to know which contracts you can use.
@@ -496,7 +513,7 @@
On this page you will find all contracts that you can use in your project.
</p>
</div>
-<a name="N100B7"></a><a name="Further Reading"></a>
+<a name="N100C5"></a><a name="Further Reading"></a>
<h2 class="underlined_10">Further Reading</h2>
<div class="section">
<p>
@@ -515,7 +532,7 @@
</ul>
</div>
-<a name="N100CE"></a><a name="Feedback"></a>
+<a name="N100DC"></a><a name="Feedback"></a>
<h2 class="underlined_10">Feedback</h2>
<div class="section">
<p>
Re: svn commit: r320607 -
/forrest/site/docs_0_80/howto/howto-view-install.html
Posted by Thorsten Scherler <th...@apache.org>.
El jue, 13-10-2005 a las 22:19 +1000, David Crossley escribió:
> Thorsten Scherler wrote:
> > I think we should *not* change this how to because it is for version v1
> > of views!
> >
> > We need to write slightly new ones for the new plugins. The themes and
> > structurer are pure dev stuff because they do no support linkrewriting
> > that is the reason we nailed views plugin (internal.view and
> > output.viewHelper) down to a certain version.
> >
> > I will revert the changes if nobody beats me to it. All occurrences of
> > "internal.structurer and the output.themes plugins" *have* to changed to
> > internal.view and output.viewHelper. The howto are for this version of
> > codename views!
>
> You do the other howtos and i will do
> the howto-view-install.html
ok.
I already copied the views howtos to structurer howtos.
Thanks for taking care of views v1.
salu2
--
thorsten
"Together we stand, divided we fall!"
Hey you (Pink Floyd)
Re: svn commit: r320607 - /forrest/site/docs_0_80/howto/howto-view-install.html
Posted by David Crossley <cr...@apache.org>.
Thorsten Scherler wrote:
> I think we should *not* change this how to because it is for version v1
> of views!
>
> We need to write slightly new ones for the new plugins. The themes and
> structurer are pure dev stuff because they do no support linkrewriting
> that is the reason we nailed views plugin (internal.view and
> output.viewHelper) down to a certain version.
>
> I will revert the changes if nobody beats me to it. All occurrences of
> "internal.structurer and the output.themes plugins" *have* to changed to
> internal.view and output.viewHelper. The howto are for this version of
> codename views!
You do the other howtos and i will do
the howto-view-install.html
-David
Re: svn commit: r320607 -
/forrest/site/docs_0_80/howto/howto-view-install.html
Posted by Thorsten Scherler <th...@apache.org>.
I think we should *not* change this how to because it is for version v1
of views!
We need to write slightly new ones for the new plugins. The themes and
structurer are pure dev stuff because they do no support linkrewriting
that is the reason we nailed views plugin (internal.view and
output.viewHelper) down to a certain version.
I will revert the changes if nobody beats me to it. All occurrences of
"internal.structurer and the output.themes plugins" *have* to changed to
internal.view and output.viewHelper. The howto are for this version of
codename views!
salu2
El jue, 13-10-2005 a las 01:36 +0000, crossley@apache.org escribió:
> Author: crossley
> Date: Wed Oct 12 18:36:54 2005
> New Revision: 320607
>
> URL: http://svn.apache.org/viewcvs?rev=320607&view=rev
> Log:
> Try to clarify the status of views development.
>
> Modified:
> forrest/site/docs_0_80/howto/howto-view-install.html
>
> Modified: forrest/site/docs_0_80/howto/howto-view-install.html
> URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/howto/howto-view-install.html?rev=320607&r1=320606&r2=320607&view=diff
> ==============================================================================
> --- forrest/site/docs_0_80/howto/howto-view-install.html (original)
> +++ forrest/site/docs_0_80/howto/howto-view-install.html Wed Oct 12 18:36:54 2005
> @@ -390,21 +390,30 @@
> <div class="section">
> <ul>
>
> -<li>You need to use the trunk version of Forrest for using views because it is in an early stage</li>
> +<li>Need the SVN trunk version of Forrest for using views because it is in an early stage.</li>
>
> <li>Read <a href="../../docs_0_80/howto/howto-buildPlugin.html">How to Build a Plugin</a>
> especially the section about using Forrest's own Ant.</li>
>
> </ul>
> +<div class="warning">
> +<div class="label">Warning</div>
> +<div class="content">
> +Need a recent version of SVN trunk. If you had a working site using the old
> +views development in trunk, and don't want to use the new views plugins,
> +then use r292708 (see
> +<a href="http://marc.theaimsgroup.com/?l=forrest-dev&m=112839617103846">mail</a>).
> </div>
> -<a name="N10035"></a><a name="Steps"></a>
> +</div>
> +</div>
> +<a name="N1003C"></a><a name="Steps"></a>
> <h2 class="underlined_10">Steps</h2>
> <div class="section">
> <p>
> The process of setting up the plugin is quite heavy. We promise it will be easier in the future.
> Some of the instructions need to be modified with your local settings.
> </p>
> -<a name="N1003D"></a><a name="localBuild"></a>
> +<a name="N10044"></a><a name="localBuild"></a>
> <h3 class="underlined_5">Build the internal.structurer and the output.themes plugins</h3>
> <p>
> The first step is to build and deploy the internal.structurer and the output.themes plugins. Change to a terminal window of your choice
> @@ -423,12 +432,20 @@
> Alternatively, run the script <span class="codefrag">etc/views.sh</span>
>
> </p>
> -<a name="N10051"></a><a name="jxpath"></a>
> +<a name="N10058"></a><a name="jxpath"></a>
> <h3 class="underlined_5">Upgrade the JXPath library</h3>
> <p>
> - Replace lib.core/commons-jxpath-20030909.jar with commons-jxpath-1.2.jar
> + Replace lib/core/commons-jxpath-20030909.jar with commons-jxpath-1.2.jar
> </p>
> -<a name="N1005B"></a><a name="newSeed"></a>
> +<div class="note">
> +<div class="label">Note</div>
> +<div class="content">
> +That will introduce Issue
> +<a href="http://issues.apache.org/jira/browse/FOR-675">FOR-675</a>
> +- please help to fix it.
> +</div>
> +</div>
> +<a name="N10069"></a><a name="newSeed"></a>
> <h3 class="underlined_5">Seed a new project</h3>
> <p>
> Go to the directory where you want to seed a new project and seed it.
> @@ -437,17 +454,17 @@
> cd ~/src/newSeed
> forrest seed
> </pre>
> -<a name="N10069"></a><a name="forrestProperties"></a>
> +<a name="N10077"></a><a name="forrestProperties"></a>
> <h3 class="underlined_5">Modifying forrest.properties</h3>
> <p>
> - Now we have to tell forrest that we are planning to use the view plugins. We will do that
> - by editing the forrest.properties to add the plugins:
> + Tell forrest that we are using the view plugins. Edit
> + forrest.properties to add the required plugins:
> </p>
> <pre class="code">
> project.required.plugins=org.apache.forrest.plugin.output.themes,org.apache.forrest.plugin.internal.structurer
> </pre>
> <p>
> - Now we have to change the project skin to leather-dev. The reason is that the plugins are still
> + Change the project skin to leather-dev. The reason is that the plugins are still
> not independent from the "old fashion skins".
> </p>
> <div class="note">
> @@ -459,7 +476,7 @@
> <pre class="code">
> project.skin=leather-dev
> </pre>
> -<a name="N10081"></a><a name="testing"></a>
> +<a name="N1008F"></a><a name="testing"></a>
> <h3 class="underlined_5">Test your new view based project</h3>
> <p>
> Now you have finished the preparation and the setup to finally do
> @@ -469,7 +486,7 @@
> </pre>
> <p>Then point to <span class="codefrag">http://localhost:8888/</span> and you will see the default
> views-based site.</p>
> -<a name="N10095"></a><a name="availableContracts"></a>
> +<a name="N100A3"></a><a name="availableContracts"></a>
> <h3 class="underlined_5">Available contracts</h3>
> <p>
> To start working with views, you need to know which contracts you can use.
> @@ -496,7 +513,7 @@
> On this page you will find all contracts that you can use in your project.
> </p>
> </div>
> -<a name="N100B7"></a><a name="Further Reading"></a>
> +<a name="N100C5"></a><a name="Further Reading"></a>
> <h2 class="underlined_10">Further Reading</h2>
> <div class="section">
> <p>
> @@ -515,7 +532,7 @@
>
> </ul>
> </div>
> -<a name="N100CE"></a><a name="Feedback"></a>
> +<a name="N100DC"></a><a name="Feedback"></a>
> <h2 class="underlined_10">Feedback</h2>
> <div class="section">
> <p>
>
>
--
thorsten
"Together we stand, divided we fall!"
Hey you (Pink Floyd)