You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@xerces.apache.org by ja...@apache.org on 2006/03/14 09:45:31 UTC
svn commit: r385760 [8/8] - in /xerces/xerces-p/trunk/docs/forrest-docs: ./
build/ build/site/ build/site/images/ build/site/samples/ build/site/skin/
build/site/skin/css/ build/site/skin/images/ build/site/skin/scripts/
build/site/skin/translations/ b...
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/domprint.xml
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/domprint.xml?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/domprint.xml (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/domprint.xml Tue Mar 14 00:45:06 2006
@@ -0,0 +1,177 @@
+<?xml version="1.0" standalone="no"?>
+<!--
+ * Copyright 1999-2005 The Apache Software Foundation.
+ *
+ * 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"
+[
+<!ENTITY % PROJECT-ENTITIES PUBLIC
+ "-//Xerces-P//Xerces-P ENTITIES V1.0//EN//XML"
+ "project-entities.ent">
+%PROJECT-ENTITIES;
+]>
+<document>
+ <header>
+ <title>&PROJECT_NAME; Sample: DOMPrint</title>
+ </header>
+ <body>
+
+
+<section>
+<title>Sample: DOMPrint</title>
+
+ <section>
+<title>DOMPrint</title>
+ <p>DOMPrint parses an XML file, constructs the DOM tree, and
+ invokes DOMWriter::writeNode() to serialize the resultant
+ DOM tree back to XML stream.
+ </p>
+
+ <section>
+<title>Running DOMPrint</title>
+
+ <p>The DOMPrint sample parses an XML file, using either a validating
+ or non-validating DOM parser configuration, builds a DOM tree,
+ and then invokes DOMWriter::writeNode() to serialize the
+ resultant DOM tree. To run DOMPrint, enter the following:</p>
+<source>perl DOMPrint.pl <XML file></source>
+ <p>The following parameters may be set from the command line </p>
+<source>
+Usage:
+ perl DOMPrint.pl [options] <XML file>
+
+This program invokes the DOM parser, and builds the DOM tree
+It then asks the DOMWriter to serialize the DOM tree.
+
+Options:
+ -e create entity reference nodes. Default is no expansion.
+ -v=xxx Validation scheme [always | never | auto*].
+ -n Enable namespace processing. Default is off.
+ -s Enable schema processing. Default is off.
+<!--
+ -f Enable full schema constraint checking. Defaults is off.
+ -wenc=XXX Use a particular encoding for output. Default is
+ the same encoding as the input XML file. UTF-8 if
+ input XML file has not XML declaration.
+ -wfile=xxx Write to a file instead of stdout.
+ -wscs=xxx Enable/Disable split-cdata-sections. Default on.
+ -wddc=xxx Enable/Disable discard-default-content. Default on.
+ -wflt=xxx Enable/Disable filtering. Default off.
+ -wfpp=xxx Enable/Disable format-pretty-print. Default off.
+ -wbom=xxx Enable/Disable write Byte-Order-Mark Default off.
+-->
+ -h Show this help
+ * = Default if not provided explicitly.
+
+The parser has intrinsic support for the following encodings:\n"
+ UTF-8, USASCII, ISO8859-1, UTF-16[BL]E, UCS-4[BL]E,\n"
+ WINDOWS-1252, IBM1140, IBM037, IBM1047.\n"
+</source>
+ <p><em>-v=always</em> will force validation<br/>
+ <em>-v=never</em> will not use any validation<br/>
+ <em>-v=auto</em> will validate if a DOCTYPE declaration or a schema declaration is present in the XML document</p>
+ <p>Here is a sample output from DOMPrint</p>
+<source>cd samples
+perl DOMPrint.pl -v=always personal.xml
+
+<?xml version="1.0" encoding="iso-8859-1"?>
+
+<!DOCTYPE personnel SYSTEM "personal.dtd">
+<!-- @version: -->
+<personnel>
+
+<person id="Big.Boss">
+ <name><family>Boss</family> <given>Big</given></name>
+ <email>chief@foo.com</email>
+ <link subordinates="one.worker two.worker three.worker
+ four.worker five.worker"></link>
+</person>
+
+<person id="one.worker">
+ <name><family>Worker</family> <given>One</given></name>
+ <email>one@foo.com</email>
+ <link manager="Big.Boss"></link>
+</person>
+
+<person id="two.worker">
+ <name><family>Worker</family> <given>Two</given></name>
+ <email>two@foo.com</email>
+ <link manager="Big.Boss"></link>
+</person>
+
+<person id="three.worker">
+ <name><family>Worker</family> <given>Three</given></name>
+ <email>three@foo.com</email>
+ <link manager="Big.Boss"></link>
+</person>
+
+<person id="four.worker">
+ <name><family>Worker</family> <given>Four</given></name>
+ <email>four@foo.com</email>
+ <link manager="Big.Boss"></link>
+</person>
+
+<person id="five.worker">
+ <name><family>Worker</family> <given>Five</given></name>
+ <email>five@foo.com</email>
+ <link manager="Big.Boss"></link>
+</person>
+
+</personnel></source>
+ <note> DOMPrint does not reproduce the original XML file. DOMPrint and
+ SAXPrint produce different results because of the way the two APIs store data
+ and capture events.</note>
+
+<!--
+ <p>Application needs to provide its own implementation of
+ DOMErrorHandler (in this sample, the DOMPrintErrorHandler),
+ if it would like to receive notification from the serializer
+ in the case any error occurs during the serialization.
+ </p>
+
+ <p>Application needs to provide its own implementation of
+ DOMWriterFilter (in this sample, the DOMPrintFilter),
+ if it would like to filter out certain part of the DOM
+ representation, but must be aware that thus may render the
+ resultant XML stream invalid.
+ </p>
+
+ <p>Application may choose any combination of characters as the
+ end of line sequence to be used in the resultant XML stream,
+ but must be aware that thus may render the resultant XML
+ stream ill formed.
+ </p>
+
+ <p>Application may choose a particular encoding name in which
+ the output XML stream would be, but must be aware that if
+ characters, unrepresentable in the encoding specified, appearing
+ in markups, may force the serializer to terminate serialization
+ prematurely, and thus no complete serialization would be done.
+ </p>
+
+ <p>Application shall query the serializer first, before set any
+ feature/mode(true, false), or be ready to catch exception if this
+ feature/mode is not supported by the serializer.
+ </p>
+
+ <p>Application needs to clean up the filter, error handler and
+ format target objects created for the serialization.
+ </p>
+-->
+ </section>
+ </section>
+</section>
+</body>
+</document>
\ No newline at end of file
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/enumval.xml
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/enumval.xml?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/enumval.xml (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/enumval.xml Tue Mar 14 00:45:06 2006
@@ -0,0 +1,73 @@
+<?xml version="1.0" standalone="no"?>
+<!--
+ * Copyright 1999-2005 The Apache Software Foundation.
+ *
+ * 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"
+[
+<!ENTITY % PROJECT-ENTITIES PUBLIC
+ "-//Xerces-P//Xerces-P ENTITIES V1.0//EN//XML"
+ "project-entities.ent">
+%PROJECT-ENTITIES;
+]>
+<document>
+ <header>
+ <title>&PROJECT_NAME; Sample: EnumVal</title>
+ </header>
+ <body>
+
+<section>
+<title>Sample: EnumVal</title>
+
+ <section>
+<title>EnumVal</title>
+ <p>EnumVal shows how to enumerate the markup decls in a DTD Grammar.</p>
+
+ <section>
+<title>Running EnumVal</title>
+ <p>This program parses the specified XML file, then shows how to
+ enumerate the contents of the DTD Grammar.</p>
+<source>
+Usage:
+ perl EnumVal.pl <XML file>
+
+This program parses the specified XML file, then shows how to
+enumerate the contents of the DTD Grammar. Essentially,
+shows how one can access the DTD information stored in internal
+data structures.
+</source>
+ <p>Here is a sample output from EnumVal</p>
+<source>cd samples
+perl EnumVal.pl personal.xml
+
+Element Name: personnel, Content Model: (person)+
+Element Name: person, Content Model: (name,email*,url*,link?)
+ attribute Name: id, Type: ID
+Element Name: name, Content Model: (#PCDATA|family|given)*
+Element Name: email, Content Model: (#PCDATA)
+Element Name: url, Content Model: EMPTY
+ attribute Name: href, Type: CDATA
+Element Name: link, Content Model: EMPTY
+ attribute Name: subordinates, Type: IDREF(S)
+ attribute Name: manager, Type: IDREF(S)
+Element Name: family, Content Model: (#PCDATA)
+Element Name: given, Content Model: (#PCDATA)
+personal.xml: duration: 0 wallclock secs ( 0.02 usr + 0.00 sys = 0.02 CPU)
+</source>
+ </section>
+ </section>
+</section>
+</body>
+</document>
\ No newline at end of file
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/index.xml
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/index.xml?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/index.xml (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/index.xml Tue Mar 14 00:45:06 2006
@@ -0,0 +1,57 @@
+<?xml version="1.0" standalone="no"?>
+<!--
+ 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"
+[
+<!ENTITY % PROJECT-ENTITIES PUBLIC
+ "-//Xerces-P//Xerces-P ENTITIES V1.0//EN//XML"
+ "project-entities.ent">
+%PROJECT-ENTITIES;
+]>
+
+<document>
+ <header>
+ <title>&PROJECT_NAME; sample applications</title>
+ </header>
+ <body>
+
+ <section>
+<title>Sample Code</title>
+ <p>&XERCES_P_NAME; comes with a number of sample applications:
+ </p>
+ <ul>
+ <li><a href="saxcount.html">SAXCount.pl</a>: Uses the SAX interface to
+ output a count of the number of elements in an XML document</li>
+ <li><a href="sax2count.html">SAX2Count.pl</a>: Uses the SAX2 interface
+ to output a count of the number of elements in an XML document</li>
+ <li><a href="domcount.html">DOMCount.pl</a>: Uses the DOM interface to
+ output a count of the number of elements in an XML document</li>
+ <li><a href="domprint.html">DOMPrint.pl</a>: Uses the DOM interface to
+ output a pretty-printed version of an XML file to STDOUT </li>
+ <li><a href="domcreate.html">DOMCreate.pl</a>: Creates a simple XML
+ document using the DOM interface and writes it to STDOUT</li>
+ <li><a href="dom2hash.html">DOM2hash.pl</a>: Uses the DOM interface to
+ convert the file to a simple hash of lists representation</li>
+ <li><a href="enumval.html">EnumVal.pl</a>: Parses and input XML document
+ and outputs the DTD information to STDOUT</li>
+ <li><a href="senumval.html">SEnumVal.pl</a>: Parses and input XML document
+ and outputs the XML Schema information to STDOUT</li>
+ </ul>
+ </section>
+</body>
+</document>
\ No newline at end of file
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/sax2count.xml
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/sax2count.xml?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/sax2count.xml (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/sax2count.xml Tue Mar 14 00:45:06 2006
@@ -0,0 +1,89 @@
+<?xml version="1.0" standalone="no"?>
+<!--
+ * Copyright 1999-2005 The Apache Software Foundation.
+ *
+ * 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"
+[
+<!ENTITY % PROJECT-ENTITIES PUBLIC
+ "-//Xerces-P//Xerces-P ENTITIES V1.0//EN//XML"
+ "project-entities.ent">
+%PROJECT-ENTITIES;
+]>
+<document>
+ <header>
+ <title>&PROJECT_NAME; Sample: SAX2Count</title>
+ </header>
+ <body>
+
+
+<section>
+<title>Sample: SAX2Count</title>
+
+ <section>
+<title>SAX2Count</title>
+ <p>SAX2Count is the simplest application that counts the elements and characters of
+ a given XML file using the (event based) SAX2 API.</p>
+
+ <section>
+<title>Running SAX2Count</title>
+
+ <p>The SAX2Count sample parses an XML file and prints out a count of the number of
+ elements in the file. To run SAX2Count, enter the following </p>
+ <source>perl SAX2Count.pl <XML File></source>
+ <p>The following parameters may be set from the command line </p>
+<source>
+Usage:
+ perl SAX2Count.pl [options] <XML file | List file>
+
+This program invokes the SAX2XMLReader, and then prints the
+number of elements, attributes, spaces and characters found
+in each XML file, using SAX2 API.
+
+Options:
+ -l Indicate the input file is a List File that has a list of xml files.
+ Default to off (Input file is an XML file).
+ -v=xxx Validation scheme [always | never | auto*].
+ -n Enable namespace processing. Defaults to off.
+ -s Ensable schema processing. Defaults to off.
+<!--
+ -f Enable full schema constraint checking processing. Defaults to off.
+ -locale=ll_CC specify the locale, default: en_US
+-->
+ -h Show this help.
+
+ * = Default if not provided explicitly.
+</source>
+ <p><em>-v=always</em> will force validation<br/>
+ <em>-v=never</em> will not use any validation<br/>
+ <em>-v=auto</em> will validate if a DOCTYPE declaration or a schema declaration is present in the XML document</p>
+ <p>Here is a sample output from SAX2Count</p>
+<source>cd samples
+perl SAX2Count.pl -v=always personal.xml
+personal.xml: 60 ms (37 elems, 12 attrs, 134 spaces, 134 chars)</source>
+ <p>Running SAX2Count with the validating parser gives a different result because
+ ignorable white-space is counted separately from regular characters.</p>
+<source>perl SAX2Count.pl -v=never personal.xml
+personal.xml: 10 ms (37 elems, 12 attrs, 0 spaces, 268 chars)</source>
+ <p>Note that the sum of spaces and characters in both versions is the same.</p>
+
+ <note>The time reported by the program may be different depending on your
+ machine processor.</note>
+ </section>
+
+ </section>
+</section>
+</body>
+</document>
\ No newline at end of file
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/saxcount.xml
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/saxcount.xml?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/saxcount.xml (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/saxcount.xml Tue Mar 14 00:45:06 2006
@@ -0,0 +1,89 @@
+<?xml version="1.0" standalone="no"?>
+<!--
+ * Copyright 1999-2005 The Apache Software Foundation.
+ *
+ * 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"
+[
+<!ENTITY % PROJECT-ENTITIES PUBLIC
+ "-//Xerces-P//Xerces-P ENTITIES V1.0//EN//XML"
+ "project-entities.ent">
+%PROJECT-ENTITIES;
+]>
+<document>
+ <header>
+ <title>&PROJECT_NAME; Sample: SAXCount</title>
+ </header>
+ <body>
+
+
+<section>
+<title>Sample: SAXCount</title>
+
+ <section>
+<title>SAXCount</title>
+ <p>SAXCount is the simplest application that counts the elements and characters of
+ a given XML file using the (event based) SAX API.</p>
+
+ <section>
+<title>Running SAXCount</title>
+
+ <p>The SAXCount sample parses an XML file and prints out a count of the number of
+ elements in the file. To run SAXCount, enter the following </p>
+<source>perl SAXCount.pl <XML File></source>
+ <p>The following parameters may be set from the command line </p>
+<source>
+Usage:
+ perl SAXCount.pl [options] <XML file | List file>
+
+This program invokes the SAX Parser, and then prints the
+number of elements, attributes, spaces and characters found
+in each XML file, using SAX API.
+
+Options:
+ -l Indicate the input file is a List File that has a list of xml files.
+ Default to off (Input file is an XML file).
+ -v=xxx Validation scheme [always | never | auto*].
+ -n Enable namespace processing. Defaults to off.
+ -s Enable schema processing. Defaults to off.
+<!--
+ -f Enable full schema constraint checking. Defaults to off.
+ -locale=ll_CC specify the locale, default: en_US
+-->
+ -h Show this help.
+
+ * = Default if not provided explicitly.
+</source>
+ <p><em>-v=always</em> will force validation<br/>
+ <em>-v=never</em> will not use any validation<br/>
+ <em>-v=auto</em> will validate if a DOCTYPE declaration or a schema declaration is present in the XML document</p>
+ <p>Here is a sample output from SAXCount</p>
+<source>cd samples
+perl SAXCount.pl -v=always personal.xml
+personal.xml: 60 ms (37 elems, 12 attrs, 134 spaces, 134 chars)</source>
+ <p>Running SAXCount with the validating parser gives a different result because
+ ignorable white-space is counted separately from regular characters.</p>
+<source>perl SAXCount.pl -v=never personal.xml
+personal.xml: 10 ms (37 elems, 12 attrs, 0 spaces, 268 chars)</source>
+ <p>Note that the sum of spaces and characters in both versions is the same.</p>
+
+ <note>The time reported by the program may be different depending on your
+ machine processor.</note>
+ </section>
+
+ </section>
+</section>
+</body>
+</document>
\ No newline at end of file
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/senumval.xml
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/senumval.xml?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/senumval.xml (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/senumval.xml Tue Mar 14 00:45:06 2006
@@ -0,0 +1,70 @@
+<?xml version="1.0" standalone="no"?>
+<!--
+ * Copyright 1999-2005 The Apache Software Foundation.
+ *
+ * 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"
+[
+<!ENTITY % PROJECT-ENTITIES PUBLIC
+ "-//Xerces-P//Xerces-P ENTITIES V1.0//EN//XML"
+ "project-entities.ent">
+%PROJECT-ENTITIES;
+]>
+<document>
+ <header>
+ <title>&PROJECT_NAME; Sample: SEnumVal</title>
+ </header>
+ <body>
+
+<section>
+<title>Sample: SEnumVal</title>
+
+ <section>
+<title>SEnumVal</title>
+ <p>SEnumVal shows how to enumerate the markup decls in a Schema Grammar.</p>
+
+ <section>
+<title>Running SEnumVal</title>
+ <p>This program parses the specified XML file, then shows how to
+ enumerate the contents of the Schema Grammar. </p>
+<source>
+Usage:
+ perl SEnumVal.pl <XML file>
+
+This program parses a file, then shows how to enumerate the
+contents of the Schema Grammar. Essentially, shows how one can
+access the Schema information stored in internal data structures.
+</source>
+ <p>Here is a sample output from SEnumVal</p>
+<source>cd samples
+perl SEnumVal.pl personal-schema.xml
+
+Found Grammar: XML::Xerces::SchemaGrammar=HASH(0x82e9aa8)
+Found Elements
+Element Name: personnel, Content Model: (person,)
+Element Name: person, Content Model: ((name,email,url),link)
+Element Name: name, Content Model: (family,given)
+Element Name: family, Content Model:
+Element Name: given, Content Model:
+Element Name: email, Content Model:
+Element Name: url, Content Model: EMPTY
+Element Name: link, Content Model: EMPTY
+personal-schema.xml: duration: 0 wallclock secs ( 0.00 usr + 0.00 sys = 0.00 CPU)
+ </source>
+ </section>
+ </section>
+</section>
+</body>
+</document>
\ No newline at end of file
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/validator-dom.xml
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/validator-dom.xml?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/validator-dom.xml (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/validator-dom.xml Tue Mar 14 00:45:06 2006
@@ -0,0 +1,77 @@
+<?xml version="1.0" standalone="no"?>
+<!--
+ * Copyright 1999-2005 The Apache Software Foundation.
+ *
+ * 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"
+[
+<!ENTITY % PROJECT-ENTITIES PUBLIC
+ "-//Xerces-P//Xerces-P ENTITIES V1.0//EN//XML"
+ "project-entities.ent">
+%PROJECT-ENTITIES;
+]>
+<document>
+ <header>
+ <title>&PROJECT_NAME; Sample: DOM Validator</title>
+ </header>
+ <body>
+
+
+<section>
+<title>Sample: DOM Validator</title>
+
+ <section>
+<title>DOM Validator</title>
+ <p>DOM Validator is a simple application that parses an XML input file using a DOM parser and reports validation errors to STDERR in the same format as onsgmls so that it can be used for example in Emacs locating the errors in the source file. </p>
+
+ <section>
+<title>Running DOM Validator</title>
+
+ <p>The DOM Validator sample parses an XML file and prints any errors to STDERR. To run DOM Validator, enter the following </p>
+<source>perl validator-dom.pl <XML File></source>
+ <p>The following parameters may be set from the command line </p>
+<source>
+Usage:
+ perl validator-dom.pl [options]
+
+This program invokes the DOM Parser, and then prints any errors to
+STDERR.
+
+ required flags:
+ --file=file_name : the XML file to parse
+
+ optional parameters:
+ --namespace : enable namespace checking
+ --schema : parse a W3C XML Schema file (forces --namespace)
+ --full_schema : do full schema checking (forces --namespace and --schema)
+ --help : print this message
+
+</source>
+
+ <p>Here is a sample output from DOM Validator</p>
+<source>cd samples
+perl validator-dom.pl --file=personal-invalid.xml
+validator-dom.pl:[/home/jasons/work/xml-xerces/samples/personal-invalid.xml]:19:8:E:Unknown element 'fool'
+validator-dom.pl:[/home/jasons/work/xml-xerces/samples/personal-invalid.xml]:19:12:E:Attribute 'id' is not declared for element 'fool'
+validator-dom.pl:[/home/jasons/work/xml-xerces/samples/personal-invalid.xml]:43:13:E:Element 'fool' is not valid for content model: '(person)+'
+validator-dom.pl:[/home/jasons/work/xml-xerces/samples/personal-invalid.xml]:43:13:E:ID attribute 'two.worker' was referenced but never declared
+
+</source>
+ </section>
+
+ </section>
+</section>
+</body>
+</document>
\ No newline at end of file
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/validator.xml
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/validator.xml?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/validator.xml (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/samples/validator.xml Tue Mar 14 00:45:06 2006
@@ -0,0 +1,77 @@
+<?xml version="1.0" standalone="no"?>
+<!--
+ * Copyright 1999-2005 The Apache Software Foundation.
+ *
+ * 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"
+[
+<!ENTITY % PROJECT-ENTITIES PUBLIC
+ "-//Xerces-P//Xerces-P ENTITIES V1.0//EN//XML"
+ "project-entities.ent">
+%PROJECT-ENTITIES;
+]>
+<document>
+ <header>
+ <title>&PROJECT_NAME; Sample: Validator</title>
+ </header>
+ <body>
+
+
+<section>
+<title>Sample: Validator</title>
+
+ <section>
+<title>Validator</title>
+ <p>Validator is a simple application that parses an XML input file and reports validation errors to STDERR in the same format as onsgmls so that it can be used for example in Emacs locating the errors in the source file. </p>
+
+ <section>
+<title>Running Validator</title>
+
+ <p>The Validator sample parses an XML file and prints any errors to STDERR. To run Validator, enter the following </p>
+<source>perl validator.pl <XML File></source>
+ <p>The following parameters may be set from the command line </p>
+<source>
+Usage:
+ perl validator.pl [options]
+
+This program invokes the SAX Parser, and then prints any errors to
+STDERR using SAX API.
+
+ required flags:
+ --file=file_name : the XML file to parse
+
+ optional parameters:
+ --namespace : enable namespace checking
+ --schema : parse a W3C XML Schema file (forces --namespace)
+ --full_schema : do full schema checking (forces --namespace and --schema)
+ --help : print this message
+
+</source>
+
+ <p>Here is a sample output from Validator</p>
+<source>cd samples
+perl validator.pl --file=personal-invalid.xml
+validator.pl:[/home/jasons/work/xml-xerces/samples/personal-invalid.xml]:19:8:E:Unknown element 'fool'
+validator.pl:[/home/jasons/work/xml-xerces/samples/personal-invalid.xml]:19:12:E:Attribute 'id' is not declared for element 'fool'
+validator.pl:[/home/jasons/work/xml-xerces/samples/personal-invalid.xml]:43:13:E:Element 'fool' is not valid for content model: '(person)+'
+validator.pl:[/home/jasons/work/xml-xerces/samples/personal-invalid.xml]:43:13:E:ID attribute 'two.worker' was referenced but never declared
+
+</source>
+ </section>
+
+ </section>
+</section>
+</body>
+</document>
\ No newline at end of file
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/site.xml
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/site.xml?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/site.xml (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/site.xml Tue Mar 14 00:45:06 2006
@@ -0,0 +1,73 @@
+<?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.
+-->
+
+<!--
+Forrest site.xml
+
+This file contains an outline of the site's information content. It is used to:
+- Generate the website menus (though these can be overridden - see docs)
+- Provide semantic, location-independent aliases for internal 'site:' URIs, eg
+<link href="site:changes"> links to changes.html (or ../changes.html if in
+ subdir).
+- Provide aliases for external URLs in the external-refs section. Eg, <link
+ href="ext:cocoon"> links to http://cocoon.apache.org/
+
+See http://forrest.apache.org/docs/linking.html for more info
+-->
+
+<site label="Xerces-P" href="" xmlns="http://apache.org/forrest/linkmap/1.0" tab="">
+ <!-- Note: No matter what you configure here, Forrest will always try to load
+ index.html when you request http://yourHost/.
+ 'How can I use a start-up-page other than index.html?' in the FAQs has more
+ information tells you how to change that.
+ -->
+ <about label="About">
+ <index label="Index" href="index.html" description="Welcome to Xerces-P"/>
+<!--
+ <download label="Download" href="mirrors.cgi"/>
+ <download_html href="mirrors.html"/>
+ -->
+ <downloading label="Downloading" href="download.html" description="How to obtain the code"/>
+ </about>
+
+ <samples label="Samples" tab="samples" href="samples/">
+ <index label="Index" href="index.html" description="Sample Applications"/>
+ <domcount label="DOMCount" href="domcount.html" description=""/>
+ <domcount label="DOMCreate" href="domcreate.html" description=""/>
+ <domcount label="DOMPrint" href="domprint.html" description=""/>
+ <domcount label="DOM2Hash" href="dom2hash.html" description=""/>
+ <domcount label="SAXCount" href="saxcount.html" description=""/>
+ <domcount label="SAX2Count" href="sax2count.html" description=""/>
+ <domcount label="EnumVal" href="enumval.html" description=""/>
+ <domcount label="SEnumVal" href="senumval.html" description=""/>
+ <domcount label="Validator" href="validator.html" description=""/>
+ <domcount label="DOM Validator" href="validator-dom.html" description=""/>
+ </samples>
+
+ <external-refs>
+ <forrest href="http://forrest.apache.org/">
+ <linking href="docs/linking.html"/>
+ <validation href="docs/validation.html"/>
+ <webapp href="docs/your-project.html#webapp"/>
+ <dtd-docs href="docs/dtd-docs.html"/>
+ </forrest>
+ <cocoon href="http://cocoon.apache.org/"/>
+ <xml.apache.org href="http://xml.apache.org/"/>
+ </external-refs>
+
+</site>
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/tabs.xml
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/tabs.xml?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/tabs.xml (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/content/xdocs/tabs.xml Tue Mar 14 00:45:06 2006
@@ -0,0 +1,38 @@
+<?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 tabs PUBLIC "-//APACHE//DTD Cocoon Documentation Tab V1.1//EN" "http://forrest.apache.org/dtd/tab-cocoon-v11.dtd">
+
+<tabs software="MyProj"
+ title="MyProj"
+ copyright="Foo"
+ xmlns:xlink="http://www.w3.org/1999/xlink">
+
+ <!-- The rules for tabs are:
+ @dir will always have '/@indexfile' added.
+ @indexfile gets appended to @dir if the tab is selected. Defaults to 'index.html'
+ @href is not modified unless it is root-relative and obviously specifies a
+ directory (ends in '/'), in which case /index.html will be added
+ If @id's are present, site.xml entries with a matching @tab will be in that tab.
+
+ Tabs can be embedded to a depth of two. The second level of tabs will only
+ be displayed when their parent tab is selected.
+ -->
+
+ <tab id="" label="Home" dir="" indexfile="index.html"/>
+ <tab id="samples" label="Samples" dir="samples" indexfile="index.html" />
+</tabs>
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/mirrors.cgi
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/mirrors.cgi?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/mirrors.cgi (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/mirrors.cgi Tue Mar 14 00:45:06 2006
@@ -0,0 +1,23 @@
+#!/bin/sh
+
+# 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.
+
+# Wrapper script around mirrors.cgi script
+# (we must change to that directory in order for python to pick up the
+# python includes correctly)
+# Copied from Stefan's http://www.apache.org/~bodewig/mirror.html
+cd /www/www.apache.org/dyn/mirrors
+/www/www.apache.org/dyn/mirrors/mirrors.cgi $*
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/resources/schema/catalog.xcat
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/resources/schema/catalog.xcat?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/resources/schema/catalog.xcat (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/resources/schema/catalog.xcat Tue Mar 14 00:45:06 2006
@@ -0,0 +1,31 @@
+<?xml version="1.0"?>
+<!--
+ 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 catalog PUBLIC "-//OASIS//DTD Entity Resolution XML Catalog V1.0//EN"
+"http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd">
+
+<!-- OASIS XML Catalog for Forrest Documents -->
+<catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog"
+ prefer="public">
+
+<!-- Download -->
+<public publicId="-//Acme//DTD Hello Document V1.0//EN"
+ uri="hello-v10.dtd"/>
+<public publicId="-//Xerces-P//Xerces-P ENTITIES V1.0//EN//XML"
+ uri="project-entities.ent"/>
+
+</catalog>
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/resources/schema/project-entities.ent
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/resources/schema/project-entities.ent?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/resources/schema/project-entities.ent (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/resources/schema/project-entities.ent Tue Mar 14 00:45:06 2006
@@ -0,0 +1,17 @@
+<?xml encoding='US-ASCII'?>
+
+<!ENTITY XERCES_C_VERSION "2.7.0">
+<!ENTITY XERCES_P_VERSION "&XERCES_C_VERSION;-0">
+<!ENTITY XERCES_P_NAME "XML::Xerces">
+<!ENTITY XERCES_C_NAME "Xerces-C">
+<!ENTITY XERCES_DOMAIN "xerces.apache.org">
+<!ENTITY XERCES_P_LIST "p-dev@&XERCES_DOMAIN;">
+
+<!ENTITY PROJECT_NAME "&XERCES_P_NAME;">
+<!ENTITY PROJECT_LIST "&XERCES_P_LIST;">
+<!ENTITY PROJECT_DESC "Perl Bindings for &XERCES_C_NAME;">
+<!ENTITY PROJECT_URL "http://&XERCES_DOMAIN;/">
+
+<!ENTITY GROUP_NAME "Xerces">
+<!ENTITY GROUP_DESC "Apache Xerces XML Parser">
+<!ENTITY GROUP_URL "http://&XERCES_DOMAIN;/">
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/sitemap.xmap
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/sitemap.xmap?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/sitemap.xmap (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/sitemap.xmap Tue Mar 14 00:45:06 2006
@@ -0,0 +1,72 @@
+<?xml version="1.0"?>
+<!--
+ Copyright 2002-2005 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.
+-->
+<map:sitemap xmlns:map="http://apache.org/cocoon/sitemap/1.0">
+
+ <map:components>
+ <map:actions>
+ <map:action logger="sitemap.action.sourcetype" name="sourcetype" src="org.apache.forrest.sourcetype.SourceTypeAction">
+ <sourcetype name="hello-v1.0">
+ <document-declaration public-id="-//Acme//DTD Hello Document V1.0//EN" />
+ </sourcetype>
+ </map:action>
+ </map:actions>
+
+ <map:selectors default="parameter">
+ <map:selector logger="sitemap.selector.parameter" name="parameter" src="org.apache.cocoon.selection.ParameterSelector" />
+ </map:selectors>
+ </map:components>
+
+ <map:resources>
+ <map:resource name="transform-to-document">
+ <map:act type="sourcetype" src="{src}">
+ <map:select type="parameter">
+ <map:parameter name="parameter-selector-test" value="{sourcetype}" />
+
+ <map:when test="hello-v1.0">
+ <map:generate src="{project:content.xdocs}{../../1}.xml" />
+ <map:transform src="{project:resources.stylesheets}/hello2document.xsl" />
+ <map:serialize type="xml-document"/>
+ </map:when>
+ </map:select>
+ </map:act>
+ </map:resource>
+ </map:resources>
+
+ <map:pipelines>
+ <map:pipeline>
+ <map:match pattern="old_site/*.html">
+ <map:select type="exists">
+ <map:when test="{project:content}{1}.html">
+ <map:read src="{project:content}{1}.html" mime-type="text/html"/>
+ <!--
+ Use this instead if you want JTidy to clean up your HTML
+ <map:generate type="html" src="{project:content}/{0}" />
+ <map:serialize type="html"/>
+ -->
+ </map:when>
+ </map:select>
+ </map:match>
+
+ <map:match pattern="**.xml">
+ <map:call resource="transform-to-document">
+ <map:parameter name="src" value="{project:content.xdocs}{1}.xml" />
+ </map:call>
+ </map:match>
+ </map:pipeline>
+ </map:pipelines>
+</map:sitemap>
Added: xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/skinconf.xml
URL: http://svn.apache.org/viewcvs/xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/skinconf.xml?rev=385760&view=auto
==============================================================================
--- xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/skinconf.xml (added)
+++ xerces/xerces-p/trunk/docs/forrest-docs/src/documentation/skinconf.xml Tue Mar 14 00:45:06 2006
@@ -0,0 +1,448 @@
+<?xml version="1.0"?>
+<!--
+ Copyright 2002-2005 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.
+-->
+
+<!--
+Skin configuration file. This file contains details of your project,
+which will be used to configure the chosen Forrest skin.
+-->
+
+<!DOCTYPE skinconfig PUBLIC "-//APACHE//DTD Skin Configuration V0.7-1//EN" "http://forrest.apache.org/dtd/skinconfig-v07-1.dtd"
+[
+<!ENTITY % PROJECT-ENTITIES PUBLIC
+ "-//Xerces-P//Xerces-P ENTITIES V1.0//EN//XML"
+ "project-entities.ent">
+%PROJECT-ENTITIES;
+]>
+
+<skinconfig>
+ <!-- To enable lucene search add provider="lucene" (default is google).
+ Add box-location="alt" to move the search box to an alternate location
+ (if the skin supports it) and box-location="all" to show it in all
+ available locations on the page. Remove the <search> element to show
+ no search box. @domain will enable sitesearch for the specific domain with google.
+ In other words google will search the @domain for the query string.
+ -->
+ <search name="&PROJECT_NAME;" domain="xerces.apache.org" provider="google"/>
+
+ <!-- Disable the print link? If enabled, invalid HTML 4.0.1 -->
+ <disable-print-link>true</disable-print-link>
+ <!-- Disable the PDF link? -->
+ <disable-pdf-link>false</disable-pdf-link>
+ <!-- Disable the POD link? -->
+ <disable-pod-link>true</disable-pod-link>
+ <!-- Disable the Text link? FIXME: NOT YET IMPLEMENETED. -->
+ <disable-txt-link>true</disable-txt-link>
+ <!-- Disable the xml source link? -->
+ <!-- The xml source link makes it possible to access the xml rendition
+ of the source frim the html page, and to have it generated statically.
+ This can be used to enable other sites and services to reuse the
+ xml format for their uses. Keep this disabled if you don't want other
+ sites to easily reuse your pages.-->
+ <disable-xml-link>true</disable-xml-link>
+
+ <!-- Disable navigation icons on all external links? -->
+ <disable-external-link-image>true</disable-external-link-image>
+
+ <!-- Disable w3c compliance links?
+ Use e.g. align="center" to move the compliance links logos to
+ an alternate location default is left.
+ (if the skin supports it) -->
+ <disable-compliance-links>false</disable-compliance-links>
+
+ <!-- Render mailto: links unrecognisable by spam harvesters? -->
+ <obfuscate-mail-links>true</obfuscate-mail-links>
+ <obfuscate-mail-value>.at.</obfuscate-mail-value>
+
+ <!-- Disable the javascript facility to change the font size -->
+ <disable-font-script>true</disable-font-script>
+
+ <!-- mandatory project logo
+ default skin: renders it at the top -->
+ <project-name>&PROJECT_NAME;</project-name>
+ <project-description>&PROJECT_DESC;</project-description>
+ <project-url>&PROJECT_URL;</project-url>
+ <project-logo>images/project.png</project-logo>
+ <!-- Alternative static image:
+ <project-logo>images/project-logo.gif</project-logo> -->
+
+ <!-- optional group logo
+ default skin: renders it at the top-left corner
+ <group-name>&GROUP_NAME;</group-name>
+ <group-description>&GROUP_DESC;</group-description>
+ <group-url>&GROUP_URL;</group-url>
+ <group-logo>images/group.png</group-logo> -->
+
+ <!-- Alternative static image:
+ <group-logo>images/group-logo.gif</group-logo> -->
+
+ <!-- optional host logo (e.g. sourceforge logo)
+ default skin: renders it at the bottom-left corner -->
+ <host-url></host-url>
+ <host-logo></host-logo>
+
+ <!-- relative url of a favicon file, normally favicon.ico -->
+ <favicon-url></favicon-url>
+
+ <!-- The following are used to construct a copyright statement -->
+ <year>2005</year>
+ <vendor>The Apache Software Foundation.</vendor>
+ <!-- The optional copyright-link URL will be used as a link in the
+ copyright statement -->
+ <copyright-link>http://www.apache.org/licenses/</copyright-link>
+
+ <!-- Some skins use this to form a 'breadcrumb trail' of links.
+ Use location="alt" to move the trail to an alternate location
+ (if the skin supports it).
+ Omit the location attribute to display the trail in the default location.
+ Use location="none" to not display the trail (if the skin supports it).
+ For some skins just set the attributes to blank.
+
+ NOTE: If a breadcrumb entry points at a local file the href must
+ be complete, that is it must point to the file itself, not to a
+ directory.
+ -->
+ <trail>
+ <link1 name="apache" href="http://www.apache.org/"/>
+ <link2 name="xerces" href="http://xerces.apache.org/"/>
+ <link3 name="xerces-p" href="http://xerces.apache.org/"/>
+ </trail>
+
+ <!-- Configure the TOC, i.e. the Table of Contents.
+ @max-depth
+ how many "section" levels need to be included in the
+ generated Table of Contents (TOC).
+ @min-sections
+ Minimum required to create a TOC.
+ @location ("page","menu","page,menu", "none")
+ Where to show the TOC.
+ -->
+ <toc max-depth="2" min-sections="1" location="page"/>
+
+ <!-- Heading types can be clean|underlined|boxed -->
+ <headings type="boxed"/>
+
+ <!-- The optional feedback element will be used to construct a
+ feedback link in the footer with the page pathname appended:
+ <a href="@href">{@to}</a>
+ -->
+ <feedback to="webmaster@xerces.apache.org"
+ href="mailto:webmaster@xerces.apache.org?subject=Feedback " >
+ Send feedback about the website to:
+ </feedback>
+
+ <!-- Optional message of the day (MOTD).
+ Note: This is only implemented in the pelt skin.
+ If the optional <motd> element is used, then messages will be appended
+ depending on the URI string pattern.
+ motd-option : Specifies a pattern to match and provides small text content.
+ motd-title : This text will be added in brackets after the <html><title>
+ motd-page : This text will be added in a panel on the face of the page,
+ with the "motd-page-url" being the hyperlink "More".
+ Values for the "location" attribute are:
+ page : on the face of the page, e.g. in the spare space of the toc
+ alt : at the bottom of the left-hand navigation panel
+ both : both
+ -->
+<!--
+ <motd>
+ <motd-option pattern="docs_0_80">
+ <motd-title>v0.8-dev</motd-title>
+ <motd-page location="both">
+ This is documentation for development version v0.8
+ </motd-page>
+ <motd-page-url>/versions/index.html</motd-page-url>
+ </motd-option>
+ <motd-option pattern="docs_0_70">
+ <motd-title>v0.7</motd-title>
+ <motd-page location="both">
+ This is documentation for current version v0.7
+ </motd-page>
+ <motd-page-url>/versions/index.html</motd-page-url>
+ </motd-option>
+ </motd>
+-->
+
+ <!--
+ extra-css - here you can define custom css-elements that are
+ A) overriding the fallback elements or
+ B) adding the css definition from new elements that you may have
+ used in your documentation.
+ -->
+ <extra-css>
+ <!--Example of reason B:
+ To define the css definition of a new element that you may have used
+ in the class attribute of a <p> node.
+ e.g. <p class="quote"/>
+ -->
+ p.quote {
+ margin-left: 2em;
+ padding: .5em;
+ background-color: #f0f0f0;
+ font-family: monospace;
+ }
+ <!--Example:
+ To override the colours of links only in the footer.
+ -->
+ #footer a { color: #0F3660; }
+ #footer a:visited { color: #009999; }
+ </extra-css>
+
+ <colors>
+ <!-- These values are used for the generated CSS files.
+ They essentially "override" the default colors defined in the chosen skin.
+ There are four duplicate "groups" of colors below, denoted by comments:
+ Color group: Forrest, Krysalis, Collabnet, and Lenya using Pelt.
+ They are provided for example only. To customize the colors of any skin,
+ uncomment one of these groups of color elements and change the values
+ of the particular color elements that you wish to change.
+ Note that by default, all color groups are commented-out which means that
+ the default colors provided by the skin are being used.
+ -->
+
+ <!-- Color group: Forrest: example colors similar to forrest.apache.org
+ Some of the element names are obscure, so comments are added to show how
+ the "pelt" skin uses them, other skins might use these elements in a different way.
+ Tip: temporarily change the value of an element to red (#ff0000) and see the effect.
+ pelt: breadtrail: the strip at the top of the page and the second strip under the tabs
+ pelt: header: top strip containing project and group logos
+ pelt: heading|subheading: section headings within the content
+ pelt: navstrip: the strip under the tabs which contains the published date
+ pelt: menu: the left-hand navigation panel
+ pelt: toolbox: the selected menu item
+ pelt: searchbox: the background of the searchbox
+ pelt: border: line border around selected menu item
+ pelt: body: any remaining parts, e.g. the bottom of the page
+ pelt: footer: the second from bottom strip containing credit logos and published date
+ pelt: feedback: the optional bottom strip containing feedback link
+ -->
+<!--
+ <color name="breadtrail" value="#cedfef" font="#0F3660" link="#0F3660" vlink="#0F3660" hlink="#000066"/>
+ <color name="header" value="#294563"/>
+ <color name="tab-selected" value="#4a6d8c" link="#0F3660" vlink="#0F3660" hlink="#000066"/>
+ <color name="tab-unselected" value="#b5c7e7" link="#0F3660" vlink="#0F3660" hlink="#000066"/>
+ <color name="subtab-selected" value="#4a6d8c" link="#0F3660" vlink="#0F3660" hlink="#000066"/>
+ <color name="subtab-unselected" value="#4a6d8c" link="#0F3660" vlink="#0F3660" hlink="#000066"/>
+ <color name="heading" value="#294563"/>
+ <color name="subheading" value="#4a6d8c"/>
+ <color name="published" value="#4C6C8F" font="#FFFFFF"/>
+ <color name="feedback" value="#4C6C8F" font="#FFFFFF" align="center"/>
+ <color name="navstrip" value="#4a6d8c" font="#ffffff" link="#0F3660" vlink="#0F3660" hlink="#000066"/>
+ <color name="menu" value="#4a6d8c" font="#cedfef" link="#ffffff" vlink="#ffffff" hlink="#ffcf00"/>
+ <color name="toolbox" value="#4a6d8c"/>
+ <color name="border" value="#294563"/>
+ <color name="dialog" value="#4a6d8c"/>
+ <color name="searchbox" value="#4a6d8c" font="#000000"/>
+ <color name="body" value="#ffffff" link="#0F3660" vlink="#009999" hlink="#000066"/>
+ <color name="table" value="#7099C5"/>
+ <color name="table-cell" value="#f0f0ff"/>
+ <color name="highlight" value="#ffff00"/>
+ <color name="fixme" value="#cc6600"/>
+ <color name="note" value="#006699"/>
+ <color name="warning" value="#990000"/>
+ <color name="code" value="#CFDCED"/>
+ <color name="footer" value="#cedfef"/>
+-->
+
+ <!-- Color group: Krysalis -->
+<!--
+ <color name="header" value="#FFFFFF"/>
+
+ <color name="tab-selected" value="#a5b6c6" link="#000000" vlink="#000000" hlink="#000000"/>
+ <color name="tab-unselected" value="#F7F7F7" link="#000000" vlink="#000000" hlink="#000000"/>
+ <color name="subtab-selected" value="#a5b6c6" link="#000000" vlink="#000000" hlink="#000000"/>
+ <color name="subtab-unselected" value="#a5b6c6" link="#000000" vlink="#000000" hlink="#000000"/>
+
+ <color name="heading" value="#a5b6c6"/>
+ <color name="subheading" value="#CFDCED"/>
+
+ <color name="navstrip" value="#CFDCED" font="#000000" link="#000000" vlink="#000000" hlink="#000000"/>
+ <color name="toolbox" value="#a5b6c6"/>
+ <color name="border" value="#a5b6c6"/>
+
+ <color name="menu" value="#F7F7F7" link="#000000" vlink="#000000" hlink="#000000"/>
+ <color name="dialog" value="#F7F7F7"/>
+
+ <color name="body" value="#ffffff" link="#0F3660" vlink="#009999" hlink="#000066"/>
+
+ <color name="table" value="#a5b6c6"/>
+ <color name="table-cell" value="#ffffff"/>
+ <color name="highlight" value="#ffff00"/>
+ <color name="fixme" value="#cc6600"/>
+ <color name="note" value="#006699"/>
+ <color name="warning" value="#990000"/>
+ <color name="code" value="#a5b6c6"/>
+
+ <color name="footer" value="#a5b6c6"/>
+-->
+
+ <!-- Color group: Collabnet -->
+<!--
+ <color name="header" value="#003366"/>
+
+ <color name="tab-selected" value="#dddddd" link="#555555" vlink="#555555" hlink="#555555"/>
+ <color name="tab-unselected" value="#999999" link="#ffffff" vlink="#ffffff" hlink="#ffffff"/>
+ <color name="subtab-selected" value="#cccccc" link="#000000" vlink="#000000" hlink="#000000"/>
+ <color name="subtab-unselected" value="#cccccc" link="#555555" vlink="#555555" hlink="#555555"/>
+
+ <color name="heading" value="#003366"/>
+ <color name="subheading" value="#888888"/>
+
+ <color name="navstrip" value="#dddddd" font="#555555"/>
+ <color name="toolbox" value="#dddddd" font="#555555"/>
+ <color name="border" value="#999999"/>
+
+ <color name="menu" value="#ffffff"/>
+ <color name="dialog" value="#eeeeee"/>
+
+ <color name="body" value="#ffffff"/>
+
+ <color name="table" value="#ccc"/>
+ <color name="table-cell" value="#ffffff"/>
+ <color name="highlight" value="#ffff00"/>
+ <color name="fixme" value="#cc6600"/>
+ <color name="note" value="#006699"/>
+ <color name="warning" value="#990000"/>
+ <color name="code" value="#003366"/>
+
+ <color name="footer" value="#ffffff"/>
+-->
+ <!-- Color group: Lenya using pelt-->
+<!--
+
+ <color name="header" value="#ffffff"/>
+
+ <color name="tab-selected" value="#E5E4D9" link="#000000" vlink="#000000" hlink="#000000"/>
+ <color name="tab-unselected" value="#F5F4E9" link="#000000" vlink="#000000" hlink="#000000"/>
+ <color name="subtab-selected" value="#000000" link="#000000" vlink="#000000" hlink="#000000"/>
+ <color name="subtab-unselected" value="#E5E4D9" link="#000000" vlink="#000000" hlink="#000000"/>
+
+ <color name="heading" value="#E5E4D9"/>
+ <color name="subheading" value="#000000"/>
+ <color name="published" value="#000000"/>
+ <color name="navstrip" value="#E5E4D9" font="#000000"/>
+ <color name="toolbox" value="#CFDCED" font="#000000"/>
+ <color name="border" value="#999999"/>
+
+ <color name="menu" value="#E5E4D9" font="#000000" link="#000000" vlink="#000000" hlink="#000000"/>
+ <color name="dialog" value="#CFDCED"/>
+ <color name="body" value="#ffffff" />
+
+ <color name="table" value="#ccc"/>
+ <color name="table-cell" value="#ffffff"/>
+ <color name="highlight" value="#ffff00"/>
+ <color name="fixme" value="#cc6600"/>
+ <color name="note" value="#006699"/>
+ <color name="warning" value="#990000"/>
+ <color name="code" value="#003366"/>
+
+ <color name="footer" value="#E5E4D9"/>
+-->
+ </colors>
+
+ <!-- Settings specific to PDF output. -->
+ <pdf>
+ <!--
+ Supported page sizes are a0, a1, a2, a3, a4, a5, executive,
+ folio, legal, ledger, letter, quarto, tabloid (default letter).
+ Supported page orientations are portrait, landscape (default
+ portrait).
+ Supported text alignments are left, right, justify (default left).
+ -->
+ <page size="letter" orientation="portrait" text-align="left"/>
+
+ <!--
+ Pattern of the page numbering in the footer - Default is "Page x".
+ first occurrence of '1' digit represents the current page number,
+ second occurrence of '1' digit represents the total page number,
+ anything else is considered as the static part of the numbering pattern.
+ Examples : x is the current page number, y the total page number.
+ <page-numbering-format>none</page-numbering-format> Do not displays the page numbering
+ <page-numbering-format>1</page-numbering-format> Displays "x"
+ <page-numbering-format>p1.</page-numbering-format> Displays "px."
+ <page-numbering-format>Page 1/1</page-numbering-format> Displays "Page x/y"
+ <page-numbering-format>(1-1)</page-numbering-format> Displays "(x-y)"
+ -->
+ <page-numbering-format>Page 1</page-numbering-format>
+
+ <!--
+ Margins can be specified for top, bottom, inner, and outer
+ edges. If double-sided="false", the inner edge is always left
+ and the outer is always right. If double-sided="true", the
+ inner edge will be left on odd pages, right on even pages,
+ the outer edge vice versa.
+ Specified below are the default settings.
+ -->
+ <margins double-sided="false">
+ <top>1in</top>
+ <bottom>1in</bottom>
+ <inner>1.25in</inner>
+ <outer>1in</outer>
+ </margins>
+
+ <!--
+ Print the URL text next to all links going outside the file
+ -->
+ <show-external-urls>false</show-external-urls>
+
+ <!--
+ Disable the copyright footer on each page of the PDF.
+ A footer is composed for each page. By default, a "credit" with role=pdf
+ will be used, as explained below. Otherwise a copyright statement
+ will be generated. This latter can be disabled.
+ -->
+ <disable-copyright-footer>false</disable-copyright-footer>
+ </pdf>
+
+ <!--
+ Credits are typically rendered as a set of small clickable
+ images in the page footer.
+
+ Use box-location="alt" to move the credits to an alternate location
+ (if the skin supports it).
+
+ For example, pelt skin:
+ - box-location="alt" will place the logo at the end of the
+ left-hand coloured menu panel.
+ - box-location="alt2" will place them underneath that panel
+ in the left-hand whitespace.
+ - Otherwise they are placed next to the compatibility icons
+ at the bottom of the screen.
+
+ Comment out the whole <credit>-element if you want no credits in the
+ web pages
+ -->
+ <credits>
+ <credit box-location="alt">
+ <name>Built with Apache Forrest</name>
+ <url>http://forrest.apache.org/</url>
+ <image>images/built-with-forrest-button.png</image>
+ <width>88</width>
+ <height>31</height>
+ </credit>
+ <!-- A credit with @role="pdf" will be used to compose a footer
+ for each page in the PDF, using either "name" or "url" or both.
+ -->
+ <!--
+ <credit role="pdf">
+ <name>Built with Apache Forrest</name>
+ <url>http://forrest.apache.org/</url>
+ </credit>
+ -->
+ </credits>
+
+</skinconfig>
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@xerces.apache.org
For additional commands, e-mail: commits-help@xerces.apache.org