forrest-svn mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From rgard...@apache.org
Subject svn commit: r182948 - /forrest/trunk/main/fresh-site/src/documentation/content/xdocs/samples/customSchema.xml
Date Mon, 06 Jun 2005 20:57:03 GMT
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">&lt;a
href="custom.html"&gt;</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



Mime
View raw message