vgritsenko 02/02/04 18:49:30
Modified: src/documentation/xdocs/userdocs/xsp book.xml index.xml
logicsheet.xml request.xml session.xml
Log:
xsp docs improvement
Revision Changes Path
1.2 +8 -5 xml-cocoon2/src/documentation/xdocs/userdocs/xsp/book.xml
Index: book.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/xsp/book.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- book.xml 3 Jan 2002 12:31:06 -0000 1.1
+++ book.xml 5 Feb 2002 02:49:29 -0000 1.2
@@ -11,14 +11,17 @@
</menu>
<menu label="XSP">
- <menu-item label="XSP" href="xsp.html"/>
+ <menu-item label="Overview" href="index.html"/>
+ <menu-item label="XSP Guide" href="logicsheet.html"/>
<menu-item label="XSP Internals" href="xsp-internals.html"/>
<menu-item label="XSP Logicsheets" href="logicsheet-concepts.html"/>
- <menu-item label="XSP Guide" href="logicsheet.html"/>
- <menu-item label="Session Logicsheet" href="session.html"/>
<menu-item label="Sessions" href="sessions.html"/>
- <menu-item label="Request Logicsheet" href="request.html"/>
- <menu-item label="ESQL Logicsheet" href="esql.html"/>
+ </menu>
+
+ <menu label="Logicsheets">
+ <menu-item label="Request" href="request.html"/>
+ <menu-item label="Session" href="session.html"/>
+ <menu-item label="ESQL" href="esql.html"/>
<menu-item label="Forms" href="logicsheet-forms.html"/>
</menu>
1.2 +16 -0 xml-cocoon2/src/documentation/xdocs/userdocs/xsp/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/xsp/index.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- index.xml 3 Jan 2002 12:31:06 -0000 1.1
+++ index.xml 5 Feb 2002 02:49:29 -0000 1.2
@@ -7,6 +7,7 @@
<subtitle>Overview</subtitle>
<authors>
<person name="Carsten Ziegeler" email="[EMAIL PROTECTED]"/>
+ <person name="Ricardo Rocha" email="[EMAIL PROTECTED]"/>
</authors>
</header>
@@ -21,6 +22,21 @@
</p>
</s1>
+
+ <s1 title="XSP learning map">
+ <p>As I find that there is enough information about XSP available (only
+ not together), I give you a list of pointers in the sequence you should read
+ them.</p>
+ <ol>
+ <li>Get Cocoon <link href="../../installing/index.html">up and
running</link>. Surf
+ to <code>[webhost]/cocoon/slides/slides?section=4</code> and following. This
+ gives you a first insight in the XSP ground idea.</li>
+ <li>Read the XSP Logicsheets page. This tells you how to use and make
+ your own XSP logicsheets and XSP pages.</li>
+ <li>If you're still hungry for more, read the XSP Internals page. This
+ describes how XSP's are handled internally by Cocoon.</li>
+ </ol>
+ </s1>
</body>
</document>
1.2 +43 -31 xml-cocoon2/src/documentation/xdocs/userdocs/xsp/logicsheet.xml
Index: logicsheet.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/xsp/logicsheet.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- logicsheet.xml 3 Jan 2002 12:31:06 -0000 1.1
+++ logicsheet.xml 5 Feb 2002 02:49:29 -0000 1.2
@@ -214,7 +214,7 @@
<source><![CDATA[
<?xml version="1.0"?>
-<?cocoon-process type="xsp"?>
+
<xsp:page
xmlns:greeting="http://duke.edu/tutorial/greeting";
xmlns:xsp="http://www.apache.org/1999/XSP/Core";
@@ -235,53 +235,66 @@
<s1 title="Using Logicsheets (Taglibs)">
<p>There are two ways to apply a logicsheet, once you have written it.
First, as in the previous examples, you can tell XSP explicitly what
- logicsheets to apply, using the <?xml-logicsheet?> processing instruction
- along with the usual <?cocoon-process?> instruction that tells
- Cocoon to use XSP:</p>
+ logicsheets to apply, using the <?xml-logicsheet?> processing instruction
+ right after xml header and before <xsp:page> tag:</p>
<source><![CDATA[
-<?cocoon-process type="xsp"?>
+<?xml version="1.0"?>
+
<?xml-logicsheet href="logicsheet.greeting.xsl"?>]]>
</source>
<p>There is another way to apply a logicsheet, which doesn't require a
processing instruction for each file that uses the logicsheet. The
- second way to use a logicsheet depends on whether you are using Cocoon 1
- or Cocoon 2.
- For Cocoon 1, a logicsheet's namespace may be declared in the
- cocoon.properties file. These declarations take the form</p>
-<source>processor.xsp.logicsheet.namespace-name.language = URL to file</source>
+ second way is to declare logicsheet in the cocoon.xconf file.
+ These declarations take the form</p>
+<source>
+<builtin-logicsheet>
+ <parameter name="prefix" value="<logicsheet's prefix>"/>
+ <parameter name="uri" value="<logicsheet's namespace URI>"/>
+ <parameter name="href" value="<URL to file>"/>
+</builtin-logicsheet>
+</source>
<p>Cocoon's pre-defined logicsheets are already declared in this file. For
- instance, the declaration of the request taglib is the following:</p>
+ instance, the declaration of the XSP request taglib is the following:</p>
<source>
-processor.xsp.logicsheet.request.java
- = resource://org/apache/cocoon/processor/xsp/library/java/request.xsl
+<builtin-logicsheet>
+ <parameter name="prefix" value="xsp-request"/>
+ <parameter name="uri" value="http://apache.org/xsp/request/2.0"/>
+ <parameter name="href"
+ value="resource://.../markup/xsp/java/request.xsl"/>
+</builtin-logicsheet>
</source>
- <p>This line associates the <strong>request:</strong> namespace with the
logicsheet
- named in the URL. This URL points to a file that is stored in the cocoon.jar.
- To use the request taglib, you must declare the request namespace in your XSP
- file:</p>
+ <p>This line associates the <strong>http://apache.org/xsp/request/2.0</strong>
+ namespace with the logicsheet named in the URL. This URL points to a file
+ that is stored in the cocoon.jar. To use the request taglib, you must
+ declare the request namespace in your XSP file:</p>
<source><![CDATA[
...
<xsp:page
- xmlns:xsp="http://www.apache.org/1999/XSP/Core";
- xmlns:request="http://www.apache.org/1999/XSP/Request";
+ xmlns:xsp="http://apache.org/xsp";
+ xmlns:xsp-request="http://apache.org/xsp/request/2.0";
>
...
]]></source>
- <p>Note that you should <strong>not</strong> try to apply the request taglib
- using the <?xml-logicsheet?> processing instruction, as this will result in
- the logicsheet being applied twice.</p>
-
- <p>You can add your own logicsheets to the cocoon.properties file using the same
- syntax. The only trick is constructing an appropriate URL. If we wanted to
declare
- our <strong>greeting:</strong> namespace and logicsheet from the Hello, World!
example
- above, and if the logicsheet were stored (on a UNIX filesystem) in the location
- /cocoon/logicsheets/logicsheet.greeting.xsl, we'd add this line to
cocoon.properties:</p>
+ <note>You should <strong>not</strong> try to apply the xsp-request
+ taglib using the <?xml-logicsheet?> processing instruction,
+ as this will result in the logicsheet being applied twice.</note>
+
+ <p>You can add your own logicsheets to the cocoon.xconf file using the same
+ syntax. The only trick is constructing an appropriate URL. If we wanted to
+ declare our <strong>greeting:</strong> namespace and logicsheet from the
+ Hello, World! example above, and if the logicsheet were stored (on a UNIX
+ filesystem) in the location /cocoon/logicsheets/logicsheet.greeting.xsl,
+ we'd add this line to cocoon.xconf:</p>
<source>
-processor.xsp.logicsheet.greeting.java
- = file:///cocoon/logicsheets/logicsheet.greeting.xsl
+<builtin-logicsheet>
+ <parameter name="prefix" value="greeting"/>
+ <parameter name="uri" value="http://duke.edu/tutorial/greeting"/>
+ <parameter name="href"
+ value="file:///cocoon/logicsheets/logicsheet.greeting.xsl"/>
+</builtin-logicsheet>
</source>
<p>There are some very important differences between using the
<?xml-logicsheet?>
@@ -296,7 +309,6 @@
<p>Whichever method you use, the most important thing to remember is that you must
declare, in your XSP program, the namespace for a logicsheet using the same URI as
in the logicsheet itself.</p>
-
</s1>
<s1 title="Logicsheet Development Tips">
1.2 +0 -2 xml-cocoon2/src/documentation/xdocs/userdocs/xsp/request.xml
Index: request.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/xsp/request.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- request.xml 3 Jan 2002 12:31:06 -0000 1.1
+++ request.xml 5 Feb 2002 02:49:29 -0000 1.2
@@ -64,8 +64,6 @@
<source><![CDATA[
<?xml version="1.0"?>
-<?cocoon-process type="xsp"?>
-
<xsp:page
xmlns:xsp="http://apache.org/xsp";
xmlns:xsp-request="http://apache.org/xsp/request/2.0";
1.3 +0 -30 xml-cocoon2/src/documentation/xdocs/userdocs/xsp/session.xml
Index: session.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/xsp/session.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- session.xml 22 Jan 2002 14:23:56 -0000 1.2
+++ session.xml 5 Feb 2002 02:49:29 -0000 1.3
@@ -78,8 +78,6 @@
<source><![CDATA[
<?xml version="1.0"?>
-<?cocoon-process type="xsp"?>
-
<xsp:page
xmlns:xsp="http://www.apache.org/1999/XSP/Core";
xmlns:session="http://apache.org/xsp/session/2.0";
@@ -310,34 +308,6 @@
<td>no</td>
<td>Set the minimum time, in seconds, that the server should
maintain the current session between client requests.</td>
-</tr>
-
-<tr>
-<td>session:get-value</td>
-<td>name</td>
-<td>yes</td>
-<td><strong>Deprecated.</strong> Use session:get-attribute instead.</td>
-</tr>
-
-<tr>
-<td>session:get-value-names</td>
-<td></td>
-<td>yes</td>
-<td><strong>Deprecated.</strong> Use session:get-attribute-names instead.</td>
-</tr>
-
-<tr>
-<td>session:put-value</td>
-<td>name</td>
-<td>no</td>
-<td><strong>Deprecated.</strong> Use session:set-attribute instead.</td>
-</tr>
-
-<tr>
-<td>session:remove-value</td>
-<td>name</td>
-<td>no</td>
-<td><strong>Deprecated.</strong> Use session:remove-attribute instead.</td>
</tr>
<tr>
----------------------------------------------------------------------
In case of troubles, e-mail: [EMAIL PROTECTED]
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
