Mailing-List: contact cocoon-dev-help@xml.apache.org; run by ezmlm
Date: 14 Apr 2000 17:09:20 -0000
Message-ID: <20000414170920.9422.qmail@locus.apache.org>
From: stefano@locus.apache.org
To: xml-cocoon-cvs@apache.org
Subject: cvs commit: xml-cocoon/samples README

stefano     00/04/14 10:09:20

  Modified:    samples  README
  Log:
  no message
  
  Revision  Changes    Path
  1.5       +3 -47     xml-cocoon/samples/README
  
  Index: README
  ===================================================================
  RCS file: /home/cvs/xml-cocoon/samples/README,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- README	2000/03/25 12:47:40	1.4
  +++ README	2000/04/14 17:09:20	1.5
  @@ -6,50 +6,6 @@
   give you insights on Cocoon capabilities as well as real-life suggestions on
   how to XML-ize your web-serving environment.
   
  -      - hello ................. a simple hello world example
  -      - entities .............. shows XML external entities
  -      - import ................ shows XSLT imports
  -      - sites ................. some live Apache web sites XML-ized
  -      - fo .................... examples regarding XSL formatting objects
  -      - wap ................... how to turn your site wireless ready with WML
  -      - vml ................... how to turn your site voice ready with VoiceML
  -      - sql ................... how to XML-ize your rational data
  -      - dcp ................... how to add dynamic PI evaluation
  -      - xsp ................... examples to show XML compiled server pages
  -      - ldap .................. how to XML-ize your LDAP data
  -      - vrml .................. how to use Cocoon to generate VRML
  -      - rss ................... how to use RSS information in your site
  -      - fromServlet ........... how to call Cocoon from another servlet
  -
  -
  -Filenames
  ----------
  -
  -The XML world is a new one and there are not many "design patterns" that users
  -are used to as much as in other web realms. One of the most used file naming
  -pattern uses the "<name>.<extension>" notation. We find this highly insufficient
  -for the XML world where the ".xml" extention doesn't really mean anything since
  -it doesn't indicate _which DTD_ the xml file is using.
  -
  -The pattern used in Cocoon's examples follows these rules:
  -
  - <name>-<doctype>.xml ....................... for XML files
  - <name>-<from-doctype>-<to-doctype>.xsl ..... for XSLT transformation sheets
  - 
  -This allows you to understand without opening the file, if the stylesheet you
  -are using matches and the processing pipe thus created is significant. For
  -example, while the following is correct
  -
  -   correct-whatever.xml -> simple-whatever-somethingelse.xsl
  -   
  -since the file "correct" uses the "whatever" doctype and the stylesheet "simple" 
  -transforms "whatever" documents into "somethingelse" documents, this is not
  -
  -   wrong-whatever.xml -> simple-anything-somethingelse.xsl
  -   
  -since the file "wrong" is a document of type "whatever" and the stylesheet
  -"simple" doesn't know how to handle those documents but only "anything" 
  -documents.
  -
  -Note: the doctype is defined as the root element of the XML document which must
  -be unique as per XML specification.
  \ No newline at end of file
  +                                                   Enjoy.
  +                                                   
  +                                               The Cocoon Team.