Author: crossley
Date: Wed Apr 4 23:49:10 2007
New Revision: 525731
URL: http://svn.apache.org/viewvc?view=rev&rev=525731
Log:
Add notes about using a system-wide catalog to share DTDs between multiple
projects.
Modified:
forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml
forrest/trunk/site-author/content/xdocs/docs_0_80/validation.xml
forrest/trunk/site-author/content/xdocs/site.xml
forrest/trunk/site-author/status.xml
Modified: forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml
URL:
http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml?view=diff&rev=525731&r1=525730&r2=525731
==============================================================================
--- forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml (original)
+++ forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml Wed Apr 4
23:49:10 2007
@@ -822,10 +822,19 @@
</answer>
</faq>
<faq id="project-dtd">
- <question>How to configure the Catalog Entity Resolver to use my own
local DTDs?</question>
+ <question>How to configure the Catalog Entity Resolver to use my own
local project DTDs?</question>
<answer>
<p>
See <link href="site:your-project/new_dtd">Using Forrest</link> for
+ configuration guidance.
+ </p>
+ </answer>
+ </faq>
+ <faq id="local-catalog">
+ <question>We need an additional system-wide catalog to share DTDs
between projects</question>
+ <answer>
+ <p>
+ See <link href="site:your-project/catalog">Using Forrest</link> for
configuration guidance.
</p>
</answer>
Modified: forrest/trunk/site-author/content/xdocs/docs_0_80/validation.xml
URL:
http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/docs_0_80/validation.xml?view=diff&rev=525731&r1=525730&r2=525731
==============================================================================
--- forrest/trunk/site-author/content/xdocs/docs_0_80/validation.xml (original)
+++ forrest/trunk/site-author/content/xdocs/docs_0_80/validation.xml Wed Apr 4
23:49:10 2007
@@ -254,9 +254,16 @@
<p>
Forrest provides a standard catalog file at
<code>forrest/main/webapp/resources/schema/catalog.xcat</code>
- for the document
- types that Forrest provides. Projects can augment this with their
- own catalog file located in
+ for the document types that Forrest supplies.
+ </p>
+
+ <p>
+ An additional system-wide catalog can be configured for use by
multiple forrest-based projects.
+ See the "local-catalog" parameter in
<code>main/webapp/WEB-INF/xconf/forrest-core.xconf</code>
+ </p>
+
+ <p>
+ Projects can augment this with their own catalog file located in
<code>${project.schema-dir}/catalog.xcat</code> to use it you must
specify either the path (full or relative) to your
<code>catalog.xcat</code> in the
<code>CatalogManager.properties</code>
@@ -267,7 +274,7 @@
When Cocoon starts, it reads the
<code>CatalogManager.properties</code> file from your
<code>project.classes-dir</code>. This is usually
src/documentation/classes/
but you can change this in <code>forrest.properties</code>. When you
seed
- a new site using <code>forrest seed-site</code> a sample catalog file
+ a new site using <code>forrest seed</code> a sample catalog file
is placed in the site structure, you can use this as a template for
your
own files.
</p>
Modified: forrest/trunk/site-author/content/xdocs/site.xml
URL:
http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/site.xml?view=diff&rev=525731&r1=525730&r2=525731
==============================================================================
--- forrest/trunk/site-author/content/xdocs/site.xml (original)
+++ forrest/trunk/site-author/content/xdocs/site.xml Wed Apr 4 23:49:10 2007
@@ -370,6 +370,7 @@
<status-themes label="Dispatcher versus Skins"
href="status-themes.html"/>
<cap label="Sourcetype Action" href="cap.html"/>
<validation label="XML Validation" href="validation.html">
+ <catalog href="#catalog"/>
<debug-catalog href="#debug-catalog"/>
</validation>
</whitepapers>
Modified: forrest/trunk/site-author/status.xml
URL:
http://svn.apache.org/viewvc/forrest/trunk/site-author/status.xml?view=diff&rev=525731&r1=525730&r2=525731
==============================================================================
--- forrest/trunk/site-author/status.xml (original)
+++ forrest/trunk/site-author/status.xml Wed Apr 4 23:49:10 2007
@@ -148,6 +148,10 @@
and examples in the 'forrest seed-sample' site.
</action>
<action dev="DC" type="add" context="docs">
+ Added notes about <link
href="site:validation/catalog">configuring</link>
+ a system-wide XML Catalog Entity Resolver to share local DTDs between
multiple projects.
+ </action>
+ <action dev="DC" type="add" context="docs">
Added notes about <link
href="site:validation/debug-catalog">debugging</link>
the XML Catalog Entity Resolver for local DTDs.
</action>
