crossley 02/05/01 21:54:56
Modified: src/documentation/xdocs faq.xml
src/documentation/xdocs/userdocs/concepts sitemap.xml
src/documentation/xdocs/userdocs/generators
file-generator.xml
Log:
Added explanation and clarification of file:// URLs.
Obtained from: J.Pietschmann
Revision Changes Path
1.9 +27 -8 xml-cocoon2/src/documentation/xdocs/faq.xml
Index: faq.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/faq.xml,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- faq.xml 30 Apr 2002 07:47:36 -0000 1.8
+++ faq.xml 2 May 2002 04:54:56 -0000 1.9
@@ -147,7 +147,7 @@
Cocoon uses an initial parameter in the "web.xml" file to automatically load
classes on startup. This way, the class is loaded only once and the server's
time is spent doing more productive things. Make sure the following entry
- is in your "web.xml" file:
+ is in your "web.xml" file.
</p>
<source><![CDATA[
@@ -484,9 +484,10 @@
</map:pipeline>
]]></source>
- <p>The "file:" type of source forces Cocoon to search the sub-sitemap under
- the specified directory (which happens to be "c:\foo", since this is a
- Windows system).
+ <p>The "file:" type of source instructs Cocoon to search the sub-sitemap
+ under the specified directory (which happens to be "c:\foo", since this
+ is a Windows system). See explanation of
+ <link href="userdocs/concepts/sitemap.html#file-url">file: URLs</link>
</p>
<p>Now, you just need to copy everything which was under the
webapps/cocoon/foo directory to the /foo directory, and it should work
@@ -568,7 +569,7 @@
<source><![CDATA[
<map:pipeline>
<map:match pattern="Foo/**">
- <map:mount uri-prefix="Fru" src="/www/Foo/"
+ <map:mount uri-prefix="Fru" src="file:///www/Foo/"
check-reload="yes" reload-method="synchron"/>
</map:match>
</map:pipeline>
@@ -578,9 +579,6 @@
Here, <code>/www/Foo</code> is a some directory on the local file system where
the
xml, xsp, .., files of the application Foo live.
</p>
- <note>
- The src attribute may have to include "file://"
- </note>
</answer>
</faq>
<faq>
@@ -789,6 +787,27 @@
Contribution page. It also explains how to get branches other than the
current HEAD branch.
</p>
+ </answer>
+</faq>
+
+<faq>
+ <question>
+ What is the syntax for absolute filesystem pathnames.
+ </question>
+ <answer>
+ <p>
+ In your sitemaps you may need to refer to some resource that is outside
+ the webapp context (e.g. UNIX /foo/bar/this.xsl
+ e.g. Windows C:\foo\bar\this.xsl). You need to use the file: convention.
+ </p>
+ <ul>
+ <li>UNIX ... <code>file:///foo/bar/this.xsl</code></li>
+ <li>Windows ... <code>file:///C:/foo/bar/this.xsl</code></li>
+ </ul>
+ <p>
+ See further explanation of
+ <link href="userdocs/concepts/sitemap.html#file-url">file: URLs</link>
+ </p>
</answer>
</faq>
1.4 +27 -1
xml-cocoon2/src/documentation/xdocs/userdocs/concepts/sitemap.xml
Index: sitemap.xml
===================================================================
RCS file:
/home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/concepts/sitemap.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- sitemap.xml 23 Feb 2002 16:47:39 -0000 1.3
+++ sitemap.xml 2 May 2002 04:54:56 -0000 1.4
@@ -620,7 +620,7 @@
coming from a jar via http connection.
</li>
<li>
- Use <code>file://foo/bar</code> to merge in xml content from the filesystem.
+ Use <code>file:///foo/bar</code> to merge in xml content from the filesystem.
</li>
<li>
Use <code>xmldb:<your driver here>://your.xmldb.host/db/foo/bar</code>
to merge in xml content from a XML:DB compliant database.
@@ -920,6 +920,32 @@
</p>
</s3>
</s2>
+ </s1>
+
+ <anchor id="file-url"/>
+ <s1 title="File: URLs">
+ <p>
+ In your sitemaps you may need to refer to some resource that is outside
+ the webapp context (e.g. UNIX /foo/bar/this.xsl
+ e.g. Windows C:\foo\bar\this.xsl). You need to use the file: convention
+ with the following syntax for absolute filesystem pathnames.
+ </p>
+
+ <ul>
+ <li>UNIX ... <code>file:///foo/bar/this.xsl</code></li>
+ <li>Windows ... <code>file:///C:/foo/bar/this.xsl</code></li>
+ </ul>
+
+ <p>
+ Everything starting with a URI scheme identifer like "file:"
+ or "http:" is an absolute URI. An absolute file URL is
+ <code>file://some.host/some/path/to/file.ext</code>
+ </p>
+
+ <p>
+ The host can be omitted, defaulting to localhost, so you can write
+ <code>file:///some/path/to/file.ext</code>
+ </p>
</s1>
<s1 title="Protocols">
1.2 +4 -0
xml-cocoon2/src/documentation/xdocs/userdocs/generators/file-generator.xml
Index: file-generator.xml
===================================================================
RCS file:
/home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/generators/file-generator.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- file-generator.xml 3 Jan 2002 12:31:04 -0000 1.1
+++ file-generator.xml 2 May 2002 04:54:56 -0000 1.2
@@ -29,6 +29,10 @@
<!-- The type attribute can be omitted as it is the default generator. -->
]]>
</source>
+ <p>
+ You can use an absolute filesystem pathname. See explanation of
+ <link href="../concepts/sitemap.html#file-url">file: URLs</link>
+ </p>
</s1>
</body>
</document>
----------------------------------------------------------------------
In case of troubles, e-mail: [EMAIL PROTECTED]
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
