crossley    01/10/31 20:16:05

  Modified:    documentation/xdocs/ctwig index.xml ctwig-basic01.xml
                        ctwig-basic02.xml ctwig-basic03.xml
                        ctwig-contributing.xml ctwig-gettingstarted.xml
                        ctwig-installing.xml ctwig-resources.xml
                        ctwig-transformations.xml ctwig-why.xml
  Log:
  Add Document Type Declaration
  Mend many XML validation errors
  
  Revision  Changes    Path
  1.3       +5 -7      xml-cocoon2/documentation/xdocs/ctwig/index.xml
  
  Index: index.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon2/documentation/xdocs/ctwig/index.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- index.xml 2001/10/23 07:06:54     1.2
  +++ index.xml 2001/11/01 04:16:04     1.3
  @@ -1,8 +1,6 @@
  -<?xml version="1.0"?>
  +<?xml version="1.0" encoding="UTF-8"?>
  +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" 
"dtd/document-v10.dtd">
   
  -<!--
  -<!DOCTYPE document SYSTEM "./dtd/document-v10.dtd">
  --->
   <document>
        <header>
                <title>cTwIG - Cocoon Two Idiots Guide</title>
  @@ -19,9 +17,9 @@
                        <p>One final point...  All the work I am doing is on Windows 
2000 boxes thus I cannot vouch for validity of my rantings on any Unix or other 
Windows (95, 98, NT4, ME etc) box.  Hopefully this will change over time but for the 
time being this will have to do.</p>
                        <p>I hope these pages can be of use!</p>
                        <p><link href="mailto:[EMAIL PROTECTED]";>Jeremy Aston</link></p>
  -             </s1>
                <s2 title="Disclaimer">
  -                     <p class="disclaimer">Disclaimer type thang...  I will always 
sincerely aim that all the information here is as accurate.  If I make an errors I 
promise to put them right as soon as I know about them, please help by <link 
href="ctwig-contributing.html">contributing</link> if and when you see anything that 
is wrong or misleading.  Please always check the official documentation and take that 
as the most accurate.  Please always ensure you have backups of critical files.  I 
cannot guarantee that none of the instructions on my pages could harm your system but 
all the information is there in good faith and will be changed if it is found to be 
wrong.  Please take your share of the responsibility and act professionally and with 
care.  Ta ever so!  Jez.</p>
  +                     <p>Disclaimer type thang...  I will always sincerely aim that 
all the information here is as accurate.  If I make an errors I promise to put them 
right as soon as I know about them, please help by <link 
href="ctwig-contributing.html">contributing</link> if and when you see anything that 
is wrong or misleading.  Please always check the official documentation and take that 
as the most accurate.  Please always ensure you have backups of critical files.  I 
cannot guarantee that none of the instructions on my pages could harm your system but 
all the information is there in good faith and will be changed if it is found to be 
wrong.  Please take your share of the responsibility and act professionally and with 
care.  Ta ever so!  Jez.</p>
                </s2>
  +             </s1>
        </body>
  -</document>
  \ No newline at end of file
  +</document>
  
  
  
  1.3       +11 -10    xml-cocoon2/documentation/xdocs/ctwig/ctwig-basic01.xml
  
  Index: ctwig-basic01.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon2/documentation/xdocs/ctwig/ctwig-basic01.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- ctwig-basic01.xml 2001/10/23 07:06:54     1.2
  +++ ctwig-basic01.xml 2001/11/01 04:16:04     1.3
  @@ -1,12 +1,12 @@
  -<?xml version="1.0"?>
  +<?xml version="1.0" encoding="UTF-8"?>
  +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" 
"dtd/document-v10.dtd">
   
  -<!--
  -<!DOCTYPE document SYSTEM "./dtd/document-v10.dtd">
  --->
  -<?xml-stylesheet href="document2html.xsl" type="text/xsl"?>
   <document>
        <header>
                <title>cTwIG - Cocoon Two Idiots Guide - Basic XML/XSL 
Transformation</title>
  +             <authors>
  +                     <person name="Jeremy Aston" email="[EMAIL PROTECTED]"/>
  +             </authors>
        </header>
   
        <body>
  @@ -50,7 +50,7 @@
       <map:serialize/> 
     </map:match>
                                ]]></source>
  -                             <p>What this construct does is to tell C2 to do 
something when it recieves a request for <b>ctwig/basic01-01.xml</b>.  The "something" 
that C2 will do is pass the <b>ctwig/basic01-01.xml</b> file through a "file" 
generator.  This basically parses the XML.  The result parsed stream then gets 
transformed using <b>ctwig/basic01-01.xsl</b> and rendered.</p>
  +                             <p>What this construct does is to tell C2 to do 
something when it recieves a request for 
<strong><code>ctwig/basic01-01.xml</code></strong>.  The "something" that C2 will do 
is pass the <strong><code>ctwig/basic01-01.xml</code></strong> file through a "file" 
generator.  This basically parses the XML.  The result parsed stream then gets 
transformed using <strong><code>ctwig/basic01-01.xsl</code></strong> and rendered.</p>
                                <p>Calling <fork 
href="http://localhost:8080/cocoon/ctwig/basic01-01.xml";>http://localhost:8080/cocoon/ctwig/basic01-01.xml</fork>
 will result in a simple HTML page being rendered.</p>
                        </s2>
                        <s2 title="Simple Wildcards in the Sitemap File">
  @@ -62,7 +62,7 @@
       <map:serialize/> 
     </map:match>
                                ]]></source>
  -                             <p>then C2 will substitutue the <b>{1}</b> meta-tag 
with the whatever is in the wildcard section of the request.  This means that is every 
XML file has a corresponding XSL file with the same filename (before the extension) 
then requesting the XML file will result in it being served.</p>
  +                             <p>then C2 will substitutue the 
<strong><code>{1}</code></strong> meta-tag with the whatever is in the wildcard 
section of the request.  This means that is every XML file has a corresponding XSL 
file with the same filename (before the extension) then requesting the XML file will 
result in it being served.</p>
                                <p>This also allows us to do a kind of request 
re-writing function.  Take the following sitemap construct:</p>
                                <source><![CDATA[
     <map:match pattern="ctwig/*.html"> 
  @@ -71,7 +71,7 @@
       <map:serialize/> 
     </map:match>
                                ]]></source>
  -                             <p>This allows us to request an HTML file from the 
ctwig folder.  What will actually happen though is that C2 willtake the wildcard 
portion and use that to look for XML and XSL files with the same filename and use them 
to generate the response stream contents.  For example; <fork 
href="http://localhost:8080/cocoon/ctwig/basic01-01.html";>http://localhost:8080/cocoon/ctwig/basic01-01.html</fork>
 will cause C2 to look for <b>ctwig/basic01-01.xml</b> and transform it with 
<b>ctwig/basic01-01.xsl</b> to produce the final page.</p>
  +                             <p>This allows us to request an HTML file from the 
ctwig folder.  What will actually happen though is that C2 willtake the wildcard 
portion and use that to look for XML and XSL files with the same filename and use them 
to generate the response stream contents.  For example; <fork 
href="http://localhost:8080/cocoon/ctwig/basic01-01.html";>http://localhost:8080/cocoon/ctwig/basic01-01.html</fork>
 will cause C2 to look for <strong><code>ctwig/basic01-01.xml</code></strong> and 
transform it with <strong><code>ctwig/basic01-01.xsl</code></strong> to produce the 
final page.</p>
                        </s2>
                        <s2 title="Using a Single XSL File">
                                <p>Consider a scenario where you have multiple XML 
files which are you wish to transform in a common fashion (for example into HTML).  If 
your XML has been designed well and follows a common DTD there is no reason why one 
XSL file can transform all the XML files.  Many of the C2 examples do this, using one, 
single, common XSL file for rendering all the examples to HTML and another for 
transforming them into a source code view.  This again is achieved using the sitemap 
file with a construct similar to the following:</p>
  @@ -82,8 +82,9 @@
       <map:serialize/> 
     </map:match>
                                ]]></source>
  -                             <p>Here, a request for an HTML page will look for a 
corresponding XML file and transform it using <b>ctwig/file2html.xsl</b>.  
<sub><em><b>TODO - PROVIDE AN EXAMPLE.</b></em></sub></p>
  +                             <p>Here, a request for an HTML page will look for a 
corresponding XML file and transform it using 
<strong><code>ctwig/file2html.xsl</code></strong>.</p>
                        </s2>
  +  <note>TODO: PROVIDE AN EXAMPLE.</note>
                </s1>
        </body>
  -</document>
  \ No newline at end of file
  +</document>
  
  
  
  1.3       +6 -6      xml-cocoon2/documentation/xdocs/ctwig/ctwig-basic02.xml
  
  Index: ctwig-basic02.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon2/documentation/xdocs/ctwig/ctwig-basic02.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- ctwig-basic02.xml 2001/10/23 07:06:54     1.2
  +++ ctwig-basic02.xml 2001/11/01 04:16:04     1.3
  @@ -1,12 +1,12 @@
  -<?xml version="1.0"?>
  +<?xml version="1.0" encoding="UTF-8"?>
  +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" 
"dtd/document-v10.dtd">
   
  -<!--
  -<!DOCTYPE document SYSTEM "./dtd/document-v10.dtd">
  --->
  -<?xml-stylesheet href="document2html.xsl" type="text/xsl"?>
   <document>
        <header>
                <title>cTwIG - Cocoon Two Idiots Guide - Basic XSP Processing</title>
  +             <authors>
  +                     <person name="Jeremy Aston" email="[EMAIL PROTECTED]"/>
  +             </authors>
        </header>
   
        <body>
  @@ -48,4 +48,4 @@
                        </s2>
                </s1>
        </body>
  -</document>
  \ No newline at end of file
  +</document>
  
  
  
  1.3       +9 -9      xml-cocoon2/documentation/xdocs/ctwig/ctwig-basic03.xml
  
  Index: ctwig-basic03.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon2/documentation/xdocs/ctwig/ctwig-basic03.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- ctwig-basic03.xml 2001/10/23 07:06:54     1.2
  +++ ctwig-basic03.xml 2001/11/01 04:16:04     1.3
  @@ -1,12 +1,12 @@
  -<?xml version="1.0"?>
  +<?xml version="1.0" encoding="UTF-8"?>
  +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" 
"dtd/document-v10.dtd">
   
  -<!--
  -<!DOCTYPE document SYSTEM "./dtd/document-v10.dtd">
  --->
  -<?xml-stylesheet href="document2html.xsl" type="text/xsl"?>
   <document>
        <header>
                <title>cTwIG - Cocoon Two Idiots Guide - Basic XSP/Logicsheet 
Processing</title>
  +             <authors>
  +                     <person name="Jeremy Aston" email="[EMAIL PROTECTED]"/>
  +             </authors>
        </header>
   
        <body>
  @@ -63,8 +63,8 @@
   </xsl:template>
   
   </xsl:stylesheet>]]></source>
  -                             <p>You will note that the logicsheet has a reference 
to the ctwig namespace.  This <b>must</b> match the namespace used in the XSP page.  
The logicsheet uses a standard XSL template match to find the reference to 
"ctwig:greeting" and replace it with the logic.</p>
  -                             <em>Again, please note that this example uses 
"http://apache.org/xsp"; as the XSP namespace.  This is different to older C1 based 
examples and should be used instead.  If you do not then any logicsheet example 
definitely will not work.</em>
  +                             <p>You will note that the logicsheet has a reference 
to the ctwig namespace.  This <strong>must</strong> match the namespace used in the 
XSP page.  The logicsheet uses a standard XSL template match to find the reference to 
"ctwig:greeting" and replace it with the logic.</p>
  +                             <p><em>Again, please note that this example uses 
"http://apache.org/xsp"; as the XSP namespace.  This is different to older C1 based 
examples and should be used instead.  If you do not then any logicsheet example 
definitely will not work.</em></p>
                                <p>To make this work firstly make sure that 
basic3-01.xml in the {TOMCAT_HOME}\webapps\cocoon\ctwig\xsp folder.  This will allow 
it to be captured by the same sitemap command that is used in the previous examples.  
Secondly, make sure that the ctwig logicsheet (ctwig.xsl) is in 
{TOMCAT_HOME}/webapps/cocoon/WEB-INF/classes/com/pigbite/logicsheets folder.  The 
final thing to do is to add a reference to the logicsheet source in to C2 so it knows 
where to go and find it.  This is done by adding the following construct to 
{TOMCAT_HOME}\webapps\cocoon\cocoon.xconf:</p>
                                <source><![CDATA[
     <builtin-logicsheet>
  @@ -79,10 +79,10 @@
      name="href"
      
value="file:///{TOMCAT_HOME}/webapps/cocoon/ctwig/logicsheet/ctwig.xsl">]]></source>
                                <p>Obviously replace {TOMCAT_HOME} with whatever the 
actual path is on your machine (e.g. d:\java\tomcat).  Note the use of three forward 
slashes after the "file:".  This is so that it properly refers to the root, you still 
have to include the drive letter however.</p>
  -                             <p>Again, the URI parameter <b>must</b> be the same as 
the namespace declarations for everything to get properly resolved.</p>
  +                             <p>Again, the URI parameter <strong>must</strong> be 
the same as the namespace declarations for everything to get properly resolved.</p>
                                <p>To test this code call <fork 
href="http://localhost:8080/cocoon/ctwig/xsp/basic03-01.xml";>http://localhost:8080/cocoon/ctwig/xsp/basic03-01.xml</fork></p>
   
                        </s2>
                </s1>
        </body>
  -</document>
  \ No newline at end of file
  +</document>
  
  
  
  1.3       +8 -8      xml-cocoon2/documentation/xdocs/ctwig/ctwig-contributing.xml
  
  Index: ctwig-contributing.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon2/documentation/xdocs/ctwig/ctwig-contributing.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- ctwig-contributing.xml    2001/10/23 07:06:54     1.2
  +++ ctwig-contributing.xml    2001/11/01 04:16:04     1.3
  @@ -1,20 +1,20 @@
  -<?xml version="1.0"?>
  +<?xml version="1.0" encoding="UTF-8"?>
  +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" 
"dtd/document-v10.dtd">
   
  -<!--
  -<!DOCTYPE document SYSTEM "./dtd/document-v10.dtd">
  --->
  -<?xml-stylesheet href="document2html.xsl" type="text/xsl"?>
   <document>
        <header>
                <title>cTwIG - Cocoon Two Idiots Guide - Contributing</title>
  +             <authors>
  +                     <person name="Jeremy Aston" email="[EMAIL PROTECTED]"/>
  +             </authors>
        </header>
   
        <body>
                <s1 title="Contributing">
  -                     <p>I am more than happy to recieve amendments, improvements 
and so on to these pages.  I want the information to be as up to date and as accurate 
as possible so please do not hesitate to let me know if you find anything wrong.  I 
would also be really pleased to receive submissions of more tutorial documentation for 
C2.  I hope that sections will develop for areas such as the sitemap, configuration 
tutorials, development techniques and so on which will require reasonable effort to 
develop however I think it would also be good to take up the suggestion of a FAQ based 
on some of the common questions that come up on the list.  I will start this off over 
the next couple of days and try and add to it as quickly as possible.</p>
  -                     <p>I have written these pages in the xdocs format, thus it 
would be really useful if any contributions are in that format.  If you want to see 
examples of the markup required please check the files in the C2 xdocs folder that 
comes as part of the distribution.  The DTD is in xdocs/dtd/document-v10.dtd.  I am 
more than happy to take contributions in email, MS Word, PDF, TXT etc however any 
conversion may delay the publishing process.</p>
  +                     <p>I am more than happy to recieve amendments, improvements 
and so on to these pages.  I want the information to be as up to date and as accurate 
as possible so please do not hesitate to let me know if you find anything wrong.  I 
would also be really pleased to receive submissions of more tutorial documentation for 
C2.  I hope that sections will develop for areas such as the sitemap, configuration 
tutorials, development techniques and so on which will require reasonable effort to 
develop however I think it would also be good to take up the suggestion of a FAQ based 
on some of the common questions that come up on the list.  I will start this off soon 
and try and add to it as quickly as possible.</p>
  +                     <p>I have written these pages in the xdocs format, thus it 
would be really useful if any contributions are in that format (see <link 
href="http://xml.apache.org/cocoon2/contrib.html";>Contributing</link> for explanation 
of the diff format and CVS).  If you want to see examples of the markup required 
please check the files in the C2 xdocs folder that comes as part of the distribution.  
The DTD is in xdocs/dtd/document-v10.dtd.  I am more than happy to take contributions 
in email, MS Word, PDF, TXT etc however any conversion may delay the publishing 
process.</p>
                        <p>Please email <link 
href="mailto:[EMAIL PROTECTED]";>[EMAIL PROTECTED]</link> with your comments, ideas and 
submissions.</p>
                        <p>Many thanks - Jez</p>
                </s1>
        </body>
  -</document>
  \ No newline at end of file
  +</document>
  
  
  
  1.3       +7 -7      xml-cocoon2/documentation/xdocs/ctwig/ctwig-gettingstarted.xml
  
  Index: ctwig-gettingstarted.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon2/documentation/xdocs/ctwig/ctwig-gettingstarted.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- ctwig-gettingstarted.xml  2001/10/23 07:06:54     1.2
  +++ ctwig-gettingstarted.xml  2001/11/01 04:16:04     1.3
  @@ -1,12 +1,12 @@
  -<?xml version="1.0"?>
  +<?xml version="1.0" encoding="UTF-8"?>
  +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" 
"dtd/document-v10.dtd">
   
  -<!--
  -<!DOCTYPE document SYSTEM "./dtd/document-v10.dtd">
  --->
  -<?xml-stylesheet href="document2html.xsl" type="text/xsl"?>
   <document>
        <header>
                <title>cTwIG - Cocoon Two Idiots Guide - Getting Started</title>
  +             <authors>
  +                     <person name="Jeremy Aston" email="[EMAIL PROTECTED]"/>
  +             </authors>
        </header>
   
        <body>
  @@ -24,7 +24,7 @@
                        </s2>
   
                        <s2 title="Where do I get it from?">
  -                             <p>Go to <fork 
href="http://xml.apache.org/cocoon2";>http://www.apache.org/cocoon2</fork> and download 
it from there.  The latest distribution for Windows machines is 
  +                             <p>Go to <fork 
href="http://xml.apache.org/cocoon2/";>http://www.apache.org/cocoon2/</fork> and 
download it from there.  The latest distribution for any operating system
                                <fork 
href="http://xml.apache.org/cocoon2/dist/Cocoon-2.0rc1a.zip";>Cocoon 2 Release 
Candidate 1a</fork>.  This file contains the Cocoon code, samples, documentation and 
the Java libraries that enable the Cocoon to work such as Xerces and Xalan.</p>
                        </s2>
   
  @@ -47,4 +47,4 @@
                        </s2>
                </s1>
        </body>
  -</document>
  \ No newline at end of file
  +</document>
  
  
  
  1.3       +12 -16    xml-cocoon2/documentation/xdocs/ctwig/ctwig-installing.xml
  
  Index: ctwig-installing.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon2/documentation/xdocs/ctwig/ctwig-installing.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- ctwig-installing.xml      2001/10/23 07:06:54     1.2
  +++ ctwig-installing.xml      2001/11/01 04:16:04     1.3
  @@ -1,12 +1,12 @@
  -<?xml version="1.0"?>
  +<?xml version="1.0" encoding="UTF-8"?>
  +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" 
"dtd/document-v10.dtd">
   
  -<!--
  -<!DOCTYPE document SYSTEM "./dtd/document-v10.dtd">
  --->
  -<?xml-stylesheet href="document2html.xsl" type="text/xsl"?>
   <document>
        <header>
                <title>cTwIG - Cocoon Two Idiots Guide - Installing</title>
  +             <authors>
  +                     <person name="Jeremy Aston" email="[EMAIL PROTECTED]"/>
  +             </authors>
        </header>
   
        <body>
  @@ -15,26 +15,22 @@
                                <p>Installing C2 is not a complete nightmare.  I found 
that following the instructions in the documentation worked just fine.  The only issue 
here is that by following the instructions you end up with a WAR file and this is no 
good for development because you cannot add your own code or make changes to existing 
files without repackaging it all up.</p>
                                <p>To get around these problems you need to install it 
as an unpacked application and get your servlet engine to recognise it as such.</p>
                                <p>Please note the assumptions about platform, user 
knowledge and existing applications in the <link href="ctwig-why.html">Why?</link> 
section and also note thatw herever {TOMCAT_HOME}, {COCOON_HOME} or {APACHE_HOME} 
appears it should be replaced with the path it is installed into on your machine (e.g. 
d:\java\cocoon\2.02rc1a for {COCOON_HOME}).</p>
  -                             <p><strong>I'm really sorry, but at the moment these 
examples relate to C2rc1a, Tomcat 3.2.3 and Apache 1.3.19 on Windows 2000.  I would 
like to do TC4/Unix notes but do not have the time at the momement.  If you can help 
then please <link href="ctwig-contributing.html">contribute</link>.</strong></p>
  +                             <p><strong>I'm really sorry, but at the moment these 
examples relate to C2rc1a, Tomcat 3.2.3 and Apache 1.3.19 on Windows 2000.</strong> It 
is probably all the same for any operating system (remember, that is the promise of 
Java and XML). I would like to do TC4/Unix notes but do not have the time at the 
momement.  If you can help then please <link 
href="ctwig-contributing.html">contribute</link>.</p>
                        </s2>
                        <s2 title="Download Cocoon 2">
  -                             <p>The latest distribution for Windows machines is 
<fork href="http://xml.apache.org/cocoon2/dist/Cocoon-2.0rc1a.zip";>Cocoon 2 release 
candidate 1a</fork>.  This file contains the Cocoon code, samples, documentation and 
the Java libraries that enable the Cocoon to work such as Xerces and Xalan.  The file 
is in ZIP format.  When you have downloaded it then extract it to somewhere.  This 
path becomes your {COCOON_HOME}.</p>
  +                             <p>The latest distribution for any operating system is 
<fork href="http://xml.apache.org/cocoon2/dist/Cocoon-2.0rc1a.zip";>Cocoon 2 release 
candidate 1a</fork>.  This file contains the Cocoon code, samples, documentation and 
the Java libraries that enable the Cocoon to work such as Xerces and Xalan.  The file 
is in ZIP format.  When you have downloaded it then extract it to somewhere.  This 
path becomes your {COCOON_HOME}.</p>
                        </s2>
                        <s2 title="Basic Configuration">
                                <p>Follow the instructions on building C2 as per the 
installation guide that comes with C2.  It can also be found <fork 
href="http://xml.apache.org/cocoon2/install.html";>here</fork> as well.  Obviously 
since you have got the ZIP distribution you do not have to do the CVS bit thus you can 
start at the Building Apache Cocoon 2 section.  Do each of the following steps:</p>
                                <ul>
                                        <li>Set JAVA_HOME</li>
                                        <li>Create the WAR using
  -                                             <source><![CDATA[
  -  .\build.bat -Dinclude.webapp.libs=yes webapp
  -                                             ]]></source>
  -                                             <p>What this does is to create the web 
application and packaged cocoon.war under the {COCOON_HOME}/build/cocoon folder.</p>
  +                                             <code>.\build.bat 
-Dinclude.webapp.libs=yes webapp</code>
  +                                             What this does is to create the web 
application and packaged cocoon.war under the {COCOON_HOME}/build/cocoon folder.
                                        </li>
                                        <li>Optionally make the SQL examples work out 
of the box.  If you perform this step using
  -                                             <source><![CDATA[
  -  .\build.bat -Dinclude.webapp.libs=yes 
  -        -Dinstall.war={{TOMCAT_HOME}\webapps} install]]></source>
  -                                             <p>then it will basically copy the 
cocoon.war file across to the Tomcat webapps folder ready for immediate use.</p>
  +                                             <code>.\build.bat 
-Dinclude.webapp.libs=yes -Dinstall.war={{TOMCAT_HOME}\webapps} install</code>
  +                                             then it will basically copy the 
cocoon.war file across to the Tomcat webapps folder ready for immediate use.
                                        </li>
                                        <li>Add any additional components (I like FOP 
for example)</li>
                                </ul>
  @@ -72,4 +68,4 @@
                        </s2>
                </s1>
        </body>
  -</document>
  \ No newline at end of file
  +</document>
  
  
  
  1.3       +10 -10    xml-cocoon2/documentation/xdocs/ctwig/ctwig-resources.xml
  
  Index: ctwig-resources.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon2/documentation/xdocs/ctwig/ctwig-resources.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- ctwig-resources.xml       2001/10/23 07:06:54     1.2
  +++ ctwig-resources.xml       2001/11/01 04:16:04     1.3
  @@ -1,20 +1,20 @@
  -<?xml version="1.0"?>
  +<?xml version="1.0" encoding="UTF-8"?>
  +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" 
"dtd/document-v10.dtd">
   
  -<!--
  -<!DOCTYPE document SYSTEM "./dtd/document-v10.dtd">
  --->
  -<?xml-stylesheet href="document2html.xsl" type="text/xsl"?>
   <document>
        <header>
                <title>cTwIG - Cocoon Two Idiots Guide - Resources</title>
  +             <authors>
  +                     <person name="Jeremy Aston" email="[EMAIL PROTECTED]"/>
  +             </authors>
        </header>
   
        <body>
                <s1 title="Resources">
                        <s2 title="Apache Cocoon 2 Web Site">
  -                             <p>The main place is <a 
href="http://xml.apache.org/cocoon2/index.html";>here</a>!!</p>
  -                             <p>Granted, the C2 documentation is still in Alpha, 
but there is alot there and it goes into alot more detail than here.  Read it and 
digest it.  I am certainly doing that as I go along and quite quickly understanding 
more of the architecture and concepts.  I will seek to distill the main points into 
this site, but the main place is still the supplied documentation.</p>
  -                             <p>You will also find the documentation in your C2 
installation under {COCCON_HOME}/docs/index.html.</p>
  +                             <p>The main place is <link 
href="http://xml.apache.org/cocoon2/";><code>http://xml.apache.org/cocoon2/</code></link></p>
  +                             <p>The C2 documentation is still (and always will be) 
under development. There is a lot of useful information there and it goes into a lot 
more detail than here.  Read it and digest it.  I am certainly doing that as I go 
along and quite quickly understanding more of the architecture and concepts.  I will 
seek to distill the main points into this site, but the main place is still the 
supplied documentation.</p>
  +                             <p>You will also find the documentation in your C2 
installation under {COCCON_HOME}/docs/</p>
                        </s2>
                        <s2 title="Apache Cocoon Users Mail List">
                                <p><link 
href="mailto:[EMAIL PROTECTED]";>Subscribe</link> to the Cocoon 
users mail list!  This is a great resource for asking and answwering questions.  For 
more details, and pointers to other related lists, see the <fork 
href="http://xml.apache.org/cocoon2/mail-lists.html";>documentation</fork>.</p>
  @@ -22,7 +22,7 @@
                        </s2>
                        <s2 title="Other Pages">
                                <ul>
  -                                     <li>David Parry has put together a really good 
<fork href="http://www.suranyami.com/XSPtutorial/index.html";>XSP Tutorial</fork> which 
is C1.8 based but has all the basic principles you need for C2.</li>
  +                                     <li>David Parry has put together a really good 
<fork href="http://www.suranyami.com/XSPtutorial/";>XSP Tutorial</fork> which is C1.8 
based but has all the basic principles you need for C2.</li>
                                        <li>Michael Bierenfeld directed me to a 
cocoon-users <fork 
href="http://mailman.real-time.com/pipermail/cocoon-users/2001-June/016150.html";>posting</fork>
 that has an example taglib (logicsheet) download.  Thanks to Gary Clark for the 
posting and example.</li>
                                        <li><link 
href="mailto:[EMAIL PROTECTED]";>Cyril Cambien</link> has developed more examples at 
his <fork href="http://chello.sourceforge.net/";>CHello!</fork> (Cocoon Hello!) 
site.</li>
                                        <li><link 
href="mailto:[EMAIL PROTECTED]";>Lajos Moczar</link> has developed some more advanced 
hints and tips at his <fork 
href="http://www.galatea.com/flashguides/cocoon-tips-2.xml";>flashguides</fork> 
site.</li>
  @@ -33,4 +33,4 @@
                        </s2>
                </s1>
        </body>
  -</document>
  \ No newline at end of file
  +</document>
  
  
  
  1.3       +7 -7      xml-cocoon2/documentation/xdocs/ctwig/ctwig-transformations.xml
  
  Index: ctwig-transformations.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon2/documentation/xdocs/ctwig/ctwig-transformations.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- ctwig-transformations.xml 2001/10/23 07:06:54     1.2
  +++ ctwig-transformations.xml 2001/11/01 04:16:04     1.3
  @@ -1,12 +1,12 @@
  -<?xml version="1.0"?>
  +<?xml version="1.0" encoding="UTF-8"?>
  +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" 
"dtd/document-v10.dtd">
   
  -<!--
  -<!DOCTYPE document SYSTEM "./dtd/document-v10.dtd">
  --->
  -<?xml-stylesheet href="document2html.xsl" type="text/xsl"?>
   <document>
        <header>
                <title>cTwIG - Cocoon Two Idiots Guide - Transformations</title>
  +             <authors>
  +                     <person name="Jeremy Aston" email="[EMAIL PROTECTED]"/>
  +             </authors>
        </header>
   
        <body>
  @@ -19,7 +19,7 @@
                        </s2>
                        <s2 title="The Building Blocks">
                                <p>The links below will take you to examples of using 
C2 to serve XML that increase in complexity and demonstrate some of the techniques 
that I am using.  If you know better ways of doing these things or can add something 
new please <link href="ctwig-contributing.html">contribute</link> and I will make the 
examples better.  One final point - these pages are being served from simple free web 
space.  C2 is not running behind this so I cannot provide working results of my 
examples on this site.  You will have to create the files and get them to work 
yourself for the time being.</p>
  -                             <p><em>Please note that, unless otherwise indicated, 
all my examples assume that the files are in a folder called <b>ctwig</b> underneath 
{TOMCAT_HOME}/webapps/cocoon.</em></p>
  +                             <p><em>Please note that, unless otherwise indicated, 
all my examples assume that the files are in a folder called</em> 
<strong><code>ctwig</code></strong> <em>underneath</em> 
<code>{TOMCAT_HOME}/webapps/cocoon/</code></p>
                                <ul>
                                        <li><link href="ctwig-basic01.html">Basic 
XML/XSL Transformation (Ref: BASIC01)</link></li>
                                        <li><link href="ctwig-basic02.html">Basic XSP 
Processing (Ref: BASIC02)</link></li>
  @@ -29,4 +29,4 @@
                        </s2>
                </s1>
        </body>
  -</document>
  \ No newline at end of file
  +</document>
  
  
  
  1.3       +6 -6      xml-cocoon2/documentation/xdocs/ctwig/ctwig-why.xml
  
  Index: ctwig-why.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon2/documentation/xdocs/ctwig/ctwig-why.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- ctwig-why.xml     2001/10/23 07:06:54     1.2
  +++ ctwig-why.xml     2001/11/01 04:16:04     1.3
  @@ -1,12 +1,12 @@
  -<?xml version="1.0"?>
  +<?xml version="1.0" encoding="UTF-8"?>
  +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" 
"dtd/document-v10.dtd">
   
  -<!--
  -<!DOCTYPE document SYSTEM "./dtd/document-v10.dtd">
  --->
  -<?xml-stylesheet href="document2html.xsl" type="text/xsl"?>
   <document>
        <header>
                <title>cTwIG - Cocoon Two Idiots Guide - Why?</title>
  +             <authors>
  +                     <person name="Jeremy Aston" email="[EMAIL PROTECTED]"/>
  +             </authors>
        </header>
   
        <body>
  @@ -19,4 +19,4 @@
                        <p>I am now trying to build some prototype code and realising 
that sharing my experiences might help others.  At worst it'll be how not to do it!</p>
                </s1>
        </body>
  -</document>
  \ No newline at end of file
  +</document>
  
  
  

----------------------------------------------------------------------
In case of troubles, e-mail:     [EMAIL PROTECTED]
To unsubscribe, e-mail:          [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to