forrest-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cross...@apache.org
Subject svn commit: rev 21085 - forrest/site/dtd-test-2
Date Fri, 11 Jun 2004 09:17:12 GMT
Author: crossley
Date: Fri Jun 11 02:17:11 2004
New Revision: 21085

Added:
   forrest/site/dtd-test-2/faq.xml   (contents, props changed)
Log:
Add a test xml document with a broken PublicIdentifier.


Added: forrest/site/dtd-test-2/faq.xml
==============================================================================
--- (empty file)
+++ forrest/site/dtd-test-2/faq.xml	Fri Jun 11 02:17:11 2004
@@ -0,0 +1,63 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE faqs PUBLIC "-//APACHE//DTD FAQ V1.2 Broken PublicId//EN" "http://forrest.apache.org/dtd/faq-v12.dtd"
+>
+
+<faqs title="Frequently Asked Questions">
+  <part id="cer">
+    <title>Using Catalog Entity Resolver for local DTDs</title>
+    <faq id="catalog">
+      <question>
+        How does the DTD resolving work using the entity resolver?
+      </question>
+      <answer>
+        <p>
+          See
+          <link href="http://forrest.apache.org/catalog.html">documentation</link>
+          and configuration for your XML tools.
+        </p>
+      </answer>
+    </faq>
+
+    <faq id="catalog-less">
+      <question>
+        How does the DTD catalog-less resolving work?
+      </question>
+      <answer>
+        <p>
+          Using .htaccess and re-write rules to svn URLs.
+          See <link href="http://issues.cocoondev.org/jira/secure/ViewIssue.jspa?key=FOR-107">Issue
FOR-107</link>
+        </p>
+        <p>
+          Note the broken PublicIdentifier in this document's DOCTYPE declaration.
+          This means that the catalog entity resolver cannot find the DTD
+          locally and so the agent needs to go to the SystemIdentifier.
+        </p>
+        <p>
+          Try the following test and be horrified at the effect of dragging
+          DTDs and related bits-and-pieces across the network.
+        </p>
+      </answer>
+    </faq>
+
+    <faq id="test">
+      <question>
+        How to test it?
+      </question>
+      <answer>
+        <p>
+        Using your favourite XML editor, first
+        <link href="http://forrest.apache.org/catalog.html">configure</link>
+        the catalog entity resolver. Make sure it works for normal xml editing
+        of xdocs.
+        </p>
+        <p>
+         Now try to open this ./faq.xml which will force your editor
+         to get the current DTD from the network.
+        </p>
+        <p>
+         For a nice simple test do '<code>xmllint --noout --valid faq.xml</code>'
+        </p>
+      </answer>
+    </faq>
+  </part>
+</faqs>

Mime
View raw message