You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@forrest.apache.org by je...@apache.org on 2003/01/06 08:17:03 UTC
cvs commit: xml-forrest/src/documentation/content/xdocs site.xml validation.xml your-project.xml
jefft 2003/01/05 23:17:03
Modified: src/documentation/content/xdocs Tag: LINKMAP_BRANCH site.xml
validation.xml your-project.xml
Log:
More use of ext:
Revision Changes Path
No revision
No revision
1.2.2.8 +17 -2 xml-forrest/src/documentation/content/xdocs/Attic/site.xml
Index: site.xml
===================================================================
RCS file: /home/cvs/xml-forrest/src/documentation/content/xdocs/Attic/site.xml,v
retrieving revision 1.2.2.7
retrieving revision 1.2.2.8
diff -u -r1.2.2.7 -r1.2.2.8
--- site.xml 6 Jan 2003 06:41:00 -0000 1.2.2.7
+++ site.xml 6 Jan 2003 07:17:03 -0000 1.2.2.8
@@ -27,8 +27,12 @@
</primer>
<forrest-contract label="Our Contract" href="forrest-contract.html"/>
<forrestbot label="The Forrestbot" href="forrestbot.html"/>
- <your-project label="Using Forrest" href="your-project.html"/>
+ <your-project label="Using Forrest" href="your-project.html">
+ <new_content_type href="#adding_new_content_type"/>
+
+ </your-project>
<validation label="XML Validation" href="validation.html"/>
+ <validation label="Linking" href="linking.html"/>
<compliance label="Standards Compliance" href="compliance.html"/>
<libre-intro label="Libre" href="libre-intro.html"/>
<dtd-docs label="DTD documentation" href="dtd-docs.html"/>
@@ -70,6 +74,8 @@
<cocoon href="cocoon/">
<ml href="mail-lists.html"/>
<actions href="userdocs/concepts/actions.html"/>
+ <catalogs href="userdocs/concepts/catalog.html"/>
+ <sitemap href="userdocs/concepts/sitemap.html"/>
</cocoon>
<forrest href="forrest/"/>
<xindice href="xindice/"/>
@@ -77,7 +83,16 @@
</xml.apache.org>
<mail-archive href="http://marc.theaimsgroup.com"/>
<xpath-tut href="http://www.w3schools.com/xpath/"/>
- <jxpath href="http://jakarta.apache.org/commons/jxpath"/>
+ <jakarta href="http://jakarta.apache.org/">
+ <jxpath href="commons/jxpath"/>
+ <anakia href="velocity/anakia.html"/>
+ <tomcat href="tomcat/">
+ <r3.3.1 href="builds/jakarta-tomcat/release/v3.3.1/bin/"/>
+ </tomcat>
+ </jakarta>
+
+ <catalog_spec href="http://www.oasis-open.org/committees/entity/background/9401.html"/>
+ <catalog_intro href="http://www.arbortext.com/Think_Tank/XML_Resources/Issue_Three/issue_three.html"/>
</external-refs>
1.14.2.1 +9 -12 xml-forrest/src/documentation/content/xdocs/validation.xml
Index: validation.xml
===================================================================
RCS file: /home/cvs/xml-forrest/src/documentation/content/xdocs/validation.xml,v
retrieving revision 1.14
retrieving revision 1.14.2.1
diff -u -r1.14 -r1.14.2.1
--- validation.xml 21 Nov 2002 04:48:06 -0000 1.14
+++ validation.xml 6 Jan 2003 07:17:03 -0000 1.14.2.1
@@ -1,10 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN"
"document-v11.dtd" [
-<!ENTITY catalog_spec
-'http://www.oasis-open.org/committees/entity/background/9401.html'>
-<!ENTITY catalog_intro
-'http://www.arbortext.com/Think_Tank/XML_Resources/Issue_Three/issue_three.html'>
+
]>
<document>
@@ -109,12 +106,12 @@
<section>
<title>Validating new XML types</title>
<p>
- Forrest provides a <link href="&catalog_spec;">SGML Catalog</link>
- [<link href="&catalog_intro;">tutorial</link>],
+ Forrest provides a <link href="ext:catalog_spec">SGML Catalog</link>
+ [<link href="ext:catalog_intro">tutorial</link>],
<code>xml-forrest/src/resources/schema/catalog</code>, as a means of
associating public identifiers (<code>-//APACHE//DTD Documentation
V1.1//EN</code> above) with DTDs.
- If you <link href="your-project.html#adding_new_content_type">add a new content type</link>, you
+ If you <link href="site:new_content_type">add a new content type</link>, you
should add the DTD to <code>${project.schema-dir}/dtd/</code> and add
an entry to the <code>${project.schema-dir}/catalog</code> file. This
section describes the details of this process.
@@ -126,7 +123,7 @@
The main Forrest DTDs are designed to be modular and extensible, so
it is fairly easy to create a new document type that is a superset
of one from Forrest. This is what we'll demonstrate here, using our
- earlier <link href="your-project.html#adding_new_content_type">download format</link>
+ earlier <link href="site:new_content_type">download format</link>
as an example. Our download format adds a group of new elements to
the standard 'documentv11' format. Our new elements are described
by the following DTD:
@@ -274,9 +271,9 @@
on a mapping from the public ID to a stable DTD location, via a
Catalog file.</p>
<note>
- See <link href="&catalog_intro;">this article</link> for a good
+ See <link href="ext:catalog_intro">this article</link> for a good
introduction to catalogs and the Cocoon documentation
- <link href="http://xml.apache.org/cocoon/userdocs/concepts/catalog.html">Entity resolution with catalogs</link>.
+ <link href="ext:cocoon/catalogs">Entity resolution with catalogs</link>.
</note>
<p>
Forrest provides a standard catalog file at
@@ -300,7 +297,7 @@
PUBLIC "-//Acme//DTD Download Documentation V1.0//EN" "dtd/download-v11.dtd"
</source>
<p>
- The format is described in <link href="&catalog_spec;">the
+ The format is described in <link href="ext:catalog_spec">the
spec</link>, and is fairly simple. Lines beginning with
<code>PUBLIC</code> map a public identifier to a DTD (relative to the
catalog file).
1.18.2.2 +8 -9 xml-forrest/src/documentation/content/xdocs/your-project.xml
Index: your-project.xml
===================================================================
RCS file: /home/cvs/xml-forrest/src/documentation/content/xdocs/your-project.xml,v
retrieving revision 1.18.2.1
retrieving revision 1.18.2.2
diff -u -r1.18.2.1 -r1.18.2.2
--- your-project.xml 5 Jan 2003 16:17:07 -0000 1.18.2.1
+++ your-project.xml 6 Jan 2003 07:17:03 -0000 1.18.2.2
@@ -430,8 +430,7 @@
<p>
The Cocoon sitemap is a set of rules for generating content (HTML, PDFs etc)
from XML sources. Forrest has a default sitemap, which is adequate for
- everyday sites (like the <link href="http://xml.apache.org/forrest">Forrest
- site</link> itself).
+ everyday sites (like the <link href="ext:forrest">Forrest site</link> itself).
</p>
<p>
Sometimes, one needs to go beyond the default set of rules. This is where
@@ -458,7 +457,7 @@
</p>
<p>
The sitemap syntax is described in the <link
- href="http://xml.apache.org/cocoon/userdocs/concepts/sitemap.html">Cocoon
+ href="ext:cocoon/sitemap">Cocoon
sitemap docs</link>. The Forrest sitemap is fairly complicated, and
partially described in <link href="primer.html#sitemap">The Forrest
Primer</link>. Be aware that order matters; your sitemap additions should
@@ -468,7 +467,7 @@
<section id="adding_new_content_type">
<title>Example: Adding a new content type</title>
<note>This section will eventually be simplified by <link
- href="cap.html">Content Aware Pipelines (CAPs)</link>.</note>
+ href="site:cap">Content Aware Pipelines (CAPs)</link>.</note>
<p>
Say that <code>download.xml</code> lists downloads for a certain package. It would be
best to represent download information in a custom XML format:
@@ -794,7 +793,7 @@
<title>Forrest webapps: developing docs faster</title>
<p>
In comparison to simpler tools like <link
- href="http://jakarta.apache.org/velocity/anakia.html">Anakia</link>,
+ href="ext:anakia">Anakia</link>,
Cocoon's command-line mode (and hence Forrest) is painfully slow. As the
<link href="site:dreams">dream list</link> notes, Forrest was originally
intended to be used for dynamic sites, and the Cocoon crawler used only to
@@ -806,10 +805,10 @@
<title>Installing a servlet engine</title>
<p>
To run a "live" forrest, you'll need a servlet container, like <link
- href="http://jakarta.apache.org/tomcat">Jakarta Tomcat</link>. The
+ href="ext:tomcat">Jakarta Tomcat</link>. The
best choice is currently <link
- href="http://jakarta.apache.org/builds/jakarta-tomcat/release/v3.3.1/bin/">Tomcat
- 3.3.1</link>, which has been fairly well tested with Forrest,
+ href="ext:tomcat/r3.3.1">Tomcat 3.3.1</link>, which has been
+ fairly well tested with Forrest,
restarts much faster than 4.x, and handles context reloads well.
</p>
</section>