You are viewing a plain text version of this content. The canonical link for it is here.
Posted to svn@forrest.apache.org by rg...@apache.org on 2005/06/06 22:57:03 UTC
svn commit: r182948 -
/forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples/customSchema.xml
Author: rgardler
Date: Mon Jun 6 13:57:01 2005
New Revision: 182948
URL: http://svn.apache.org/viewcvs?rev=182948&view=rev
Log:
brief description of adding custom XML files
Added:
forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples/customSchema.xml (with props)
Added: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples/customSchema.xml
URL: http://svn.apache.org/viewcvs/forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples/customSchema.xml?rev=182948&view=auto
==============================================================================
--- forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples/customSchema.xml (added)
+++ forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples/customSchema.xml Mon Jun 6 13:57:01 2005
@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Copyright 2002-2004 The Apache Software Foundation or its licensors,
+ as applicable.
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
+<document>
+ <header>
+ <title>Custom Schema</title>
+ </header>
+ <body>
+ <p>Forrest comes with a set of schemas for common documents, however, if you have existing documents
+ that use a different schema you will want to tell Forrest how to work with them. The best way of doing
+ this is to <a href="http://forrest.apache.org/0.7/docs/howto/howto-buildPlugin.html">build a plugin</a>
+ so that you can easily reuse the functionality on different projects. Plugins also allow you to share
+ this new functionality with other users, and to benefit from their contributions to your work.</p>
+
+ <p>If you don't want to build a plugin you can make Forrest process them within your project sitemap
+ (but this won't really save you any work since the process is almost the same). This sample site has
+ a demonstration of using a custom DTD. If you request <a href="custom.html"><a href="custom.html"></a>
+ you can see the results. Take a look at the project <code>sitemap.xmap</code> to see how it is done.</p>
+
+ <note>Adding custom schemas with a plugin has the added benefit of being able to add the schema
+ definition to the catalog file rather than having to reference it directly from within the XML
+ document.</note>
+ </body>
+</document>
Propchange: forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples/customSchema.xml
------------------------------------------------------------------------------
svn:eol-style = native