wamblee.org Git - utils/blob

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!--
   3   Copyright 2002-2004 The Apache Software Foundation or its licensors,
   4   as applicable.
   5
   6   Licensed under the Apache License, Version 2.0 (the "License");
   7   you may not use this file except in compliance with the License.
   8   You may obtain a copy of the License at
   9
  10       http://www.apache.org/licenses/LICENSE-2.0
  11
  12   Unless required by applicable law or agreed to in writing, software
  13   distributed under the License is distributed on an "AS IS" BASIS,
  14   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  15   See the License for the specific language governing permissions and
  16   limitations under the License.
  17 -->
  18 <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
  19 <document>
  20   <header>
  21     <title>Custom Schema</title>
  22   </header>
  23   <body>
  24     <p>Forrest comes with a set of schemas for common documents, however, if you have existing documents
  25     that use a different schema you will want to tell Forrest how to work with them. The best way of doing
  26     this is to <a href="http://forrest.apache.org/0.7/docs/howto/howto-buildPlugin.html">build a plugin</a>
  27     so that you can easily reuse the functionality on different projects. Plugins also allow you to share
  28     this new functionality with other users, and to benefit from their contributions to your work.</p>
  29
  30     <p>If you don't want to build a plugin you can make Forrest process them within your project sitemap
  31     (but this won't really save you any work since the process is almost the same). This sample site has
  32     a demonstration of using a custom DTD. If you request <a href="custom.html">&lt;a href="custom.html"&gt;</a>
  33     you can see the results. Take a look at the project <code>sitemap.xmap</code> to see how it is done.</p>
  34
  35     <note>Adding custom schemas with a plugin has the added benefit of being able to add the schema
  36     definition to the catalog file rather than having to reference it directly from within the XML
  37     document.</note>
  38   </body>
  39 </document>