Return-Path: 
 <forrest-cvs-return-1046-apmail-xml-forrest-dev-archive=xml.apache.org@xml.apache.org>
Delivered-To: apmail-xml-forrest-dev-archive@xml.apache.org
Received: (qmail 20600 invoked by uid 500); 5 Jul 2003 02:57:46 -0000
Mailing-List: contact forrest-cvs-help@xml.apache.org; run by ezmlm
Precedence: bulk
list-help: <mailto:forrest-cvs-help@xml.apache.org>
list-unsubscribe: <mailto:forrest-cvs-unsubscribe@xml.apache.org>
list-post: <mailto:forrest-cvs@xml.apache.org>
Reply-To: forrest-dev@xml.apache.org
Delivered-To: mailing list forrest-cvs@xml.apache.org
Received: (qmail 20589 invoked from network); 5 Jul 2003 02:57:46 -0000
Received: from icarus.apache.org (208.185.179.13)
  by daedalus.apache.org with SMTP; 5 Jul 2003 02:57:46 -0000
Received: (qmail 42115 invoked by uid 1389); 5 Jul 2003 02:57:47 -0000
Date: 5 Jul 2003 02:57:47 -0000
Message-ID: <20030705025747.42114.qmail@icarus.apache.org>
From: crossley@apache.org
To: xml-forrest-cvs@apache.org
Subject: cvs commit: xml-forrest/src/documentation/content/xdocs faq.xml
X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N

crossley    2003/07/04 19:57:47

  Modified:    src/documentation/content/xdocs faq.xml
  Log:
  Explain DocBook processing options.
  
  Revision  Changes    Path
  1.35      +39 -0     xml-forrest/src/documentation/content/xdocs/faq.xml
  
  Index: faq.xml
  ===================================================================
  RCS file: /home/cvs/xml-forrest/src/documentation/content/xdocs/faq.xml,v
  retrieving revision 1.34
  retrieving revision 1.35
  diff -u -r1.34 -r1.35
  --- faq.xml	30 May 2003 09:15:43 -0000	1.34
  +++ faq.xml	5 Jul 2003 02:57:47 -0000	1.35
  @@ -296,6 +296,45 @@
         </answer>
       </faq>
   
  +    <faq id="docbook">
  +      <question>
  +        How do i use DocBook as the xml documentation format?
  +      </question>
  +      <answer>
  +        <p>
  +         There are two ways. Forrest can transform the DocBook format into the
  +         Forrest "document" DTD on-the-fly and then render that as normal.
  +         The stylesheet that does this transformation still needs a little
  +         work but it handles most things.
  +        </p>
  +        <p>
  +         The other way is to use the DocBook stylesheets directly. The DocBook
  +         DTDs are shipped with Forrest and automatically handled. However, you
  +         will need to have the DocBook stylesheets on your system (they are
  +         too massive to ship with Forrest) and configure Forrest accordingly.
  +         You will need to create a "sitemap" as explained in
  +         <link href="site:your-project">Using Forrest</link>
  +         and add matches to handle your DocBook documents, e.g.
  +        </p>
  +        <source><![CDATA[
  +...
  +  <map:match pattern="**/resolver-*.html">
  +    <map:generate src="content/xdocs/{1}/resolver-{2}.xml"/>
  +    <map:transform
  +      src="file:///usr/share/sgml/docbook/xsl/xhtml/docbook.xsl"/>
  +    <map:serialize/>
  +  </map:match>
  +...
  +]]>
  +        </source>
  +        <p>
  +         You can also use a mixture of the two methods, some handled
  +         automatically by Forrest and some directly using DocBook stylesheets.
  +         You can also have a mixture of "document-v*" DTD and DocBook.
  +        </p>
  +      </answer>
  +    </faq>
  +
       <faq id="obsolete_docs">
         <question>
           Why am I a little confused by the Forrest documentation?