[Cocoon Wiki] Updated: ServingStaticFiles

[do...@cocoon.apache.org]

   Date: 2005-01-16T02:15:17
   Editor: MarkLundquist
   Wiki: Cocoon Wiki
   Page: ServingStaticFiles
   URL: http://wiki.apache.org/cocoon/ServingStaticFiles

   add comment, fix broken link, satisfy a TODO :-)

Change Log:

------------------------------------------------------------------------------
@@ -8,25 +8,30 @@
 
 The simplest way to achieve this is to use a [:Reader] (usually the {{{ResourceReader}}}, which is the default). E.g:
 
-{{{
-<map:match pattern="**.jar">
-   <map:read src="jars/{1}.jar" mime-type="application/java-archive"/>
-</map:match>
-<map:match pattern="**.css">
-   <map:read src="style/{1}.css" mime-type="text/css"/>
-</map:match>
-<map:match pattern="**.gif">
-   <map:read src="images/{1}.gif" mime-type="image/gif"/>
-</map:match>
-<map:match pattern="static-**.html">
-   <map:read src="html/{1}.html" mime-type="text/html"/>
-</map:match>
+{{{
+<map:match pattern="**.jar">
+   <map:read src="jars/{1}.jar" mime-type="application/java-archive"/>
+</map:match>
+<map:match pattern="**.css">
+   <map:read src="style/{1}.css" mime-type="text/css"/>
+</map:match>
+<map:match pattern="**.gif">
+   <map:read src="images/{1}.gif" mime-type="image/gif"/>
+</map:match>
+<map:match pattern="static-**.html">
+   <map:read src="html/{1}.html" mime-type="text/html"/>
+</map:match>
 }}}
 
-TODO: it's more efficient to serve static files from Apache or elsewhere. Need to include examples of how to do this[[BR]]
+----
+''IMHO this is overengineered, because in order to serve static content directly from Apache (see below) the URI-to-filesystem mapping in the example above must also be implemented in the Apache configuration.  Cocoon already needs a separate rule for each (in order to specify the MIME type), but Apache doesn't, so it's a pain to have to add it just so that URIs don't have to start with "images/", etc.''  --[wiki:MarkLundquist ML]
+----
+
+It's more efficient to serve static files from Apache (see SimpleModProxy), but we still want our Cocoon app to have the ability to serve static content all by itself without Apache, for when we're developing in a non-server (desktop/laptop) environment.
+
 TODO: show how the expires parameter can help
 
 === Mime types ===
 As you can see the reader needs the mime type (Multipurpose Internet Mail Extensions):
- *  [http://www.nacs.uci.edu/indiv/ehood/MIME/MIME.html Content Types and Subtypes as a list] (link broken as of 5 Dec 2003)
+ *  [http://www.iana.org/assignments/media-types/ Content Types and Subtypes as a list] 
  *  [http://ftp.isi.edu/in-notes/iana/assignments/media-types/media-types General information]