Hi all !

Attached a patch to use the extended entity-sets in the (translated) xml-docs. With this it will be possible to use  , ä, and so on without first defining them in the dtd.

Some comments:

- build/build.xml: new xmlcatalog-type to define the local copies of the
the official entity-sets; this prevents us from fetching them from the net
on every single build-process. Added references to this catalog in every
build-relevant task (validate, transform).


- style/common.dtd: added entity-definitions for the public entity-sets.

- upgrading.xml.de: added some newly usable entities to demonstrate the
  the functionality.

For the correct local validation-/transformation-process you will need to get the following files and put them into the style-directory:

http://www.w3.org/TR/xhtml1/DTD/xhtml-lat1.ent
http://www.w3.org/TR/xhtml1/DTD/xhtml-special.ent
http://www.w3.org/TR/xhtml1/DTD/xhtml-symbol.ent

The whole build and validation process works fine, just test and report please.

> My only concern here is that we want to continue being able to use
> MSIE/Mozilla to transform the docs.  If we do this, aren't we going to
> be requiring the use of Ant?

Unfortunately Mozilla (0.9 to 1.1b Mac/Linux/PC, same codebase) doesn't parse the new entity-references and therefore responds with an error, when viewing a document which includes a corresponding entity :-(

In MSIE 6.0 also everything is working fine. Well, this seems to be a bug in Mozilla.

IMO it would be great to use this, because it would help to contribute more easily. But the fact that Mozilla is unable to use this methods correctly, makes me a bit unhappy. Personally I don't use Mozilla very much for 'live' transforming, but I guess some of you love it :-)

Since I'm a bit unfamiliar with the current browser behaviours regarding to XML, I would appreciate some opinions on this topic.

up to now I'm more or less +-0 tending to +1 :-) but perhaps someone can bring in some new aspects on this.

Erik

diff -ur -x CVS httpd-docs-2.0/manual/build/build.xml 
tmp/manual-entities/build/build.xml
--- httpd-docs-2.0/manual/build/build.xml       Wed Aug 21 21:13:18 2002
+++ tmp/manual-entities/build/build.xml Wed Aug 21 23:10:06 2002
@@ -34,6 +34,18 @@
         <patternset refid="ja.jis-allxml" />
     </patternset>
 
+    <!-- Defines the local copies for the used DTDs and entity sets: -->
+    <!-- this prevents us from fetching them from the net on every -->
+    <!-- single build process (see corresponding targets)-->
+    <xmlcatalog id="catalog">
+        <entity publicId="-//W3C//ENTITIES Latin 1 for XHTML//EN"
+                location="../style/xhtml-lat1.ent"/>
+        <entity publicId="-//W3C//ENTITIES Special for XHTML//EN"
+                location="../style/xhtml-special.ent"/>
+        <entity publicId="-//W3C//ENTITIES Symbols for XHTML//EN"
+                location="../style/xhtml-symbol.ent"/>
+    </xmlcatalog>
+
     <!-- This target is for output of HTML pages via XSLT -->
     <!-- Requires JAXP/1.1 (all three JARs) or Xerces+Xalan -->
     <target name="xslt"
@@ -67,6 +79,7 @@
         <style basedir="../"
                destdir="../"
                style="../style/manual.en.xsl">
+            <xmlcatalog refid="catalog" />
             <mapper type="glob" from="*.xml" to="*.html.en" />
             <param name="relative-path" expression="." />
             <patternset refid="en-allxml" />
@@ -76,6 +89,7 @@
         <style basedir="../"
                destdir="../"
                style="../style/manual.ja.xsl">
+            <xmlcatalog refid="catalog" />
             <mapper type="glob" from="*.xml.ja" to="*.html.ja.jis" />
             <param name="relative-path" expression="." />
             <patternset refid="ja.jis-allxml" />
@@ -85,6 +99,7 @@
         <style basedir="../"
                destdir="../"
                style="../style/manual.de.xsl">
+            <xmlcatalog refid="catalog" />
             <mapper type="glob" from="*.xml.de" to="*.html.de" />
             <param name="relative-path" expression="." />
             <patternset refid="de-allxml" />
@@ -96,6 +111,7 @@
     <target name="validate"
             description="Validate the XML source files">
         <xmlvalidate lenient="false" failonerror="false" warn="true">
+            <xmlcatalog refid="catalog" />
             <fileset dir="../">
                 <patternset refid="allxml" />
             </fileset>
diff -ur -x CVS httpd-docs-2.0/manual/style/common.dtd 
tmp/manual-entities/style/common.dtd
--- httpd-docs-2.0/manual/style/common.dtd      Wed Aug 21 21:13:09 2002
+++ tmp/manual-entities/style/common.dtd        Wed Aug 21 23:10:33 2002
@@ -1,6 +1,21 @@
 <?xml version='1.0' encoding='UTF-8' ?>
 
-<!ENTITY nbsp "&#160;">
+<!-- Definitions for the XHTML Entity sets to extended the
+     usable character entities (e.g. for using &nbsp;) -->
+
+<!ENTITY % HTMLlat1 PUBLIC
+    "-//W3C//ENTITIES Latin 1 for XHTML//EN"
+    "http://www.w3.org/TR/xhtml1/DTD/xhtml-lat1.ent";>
+<!ENTITY % HTMLspecial PUBLIC
+    "-//W3C//ENTITIES Special for XHTML//EN"
+    "http://www.w3.org/TR/xhtml1/DTD/xhtml-special.ent";>
+<!ENTITY % HTMLsymbol PUBLIC
+    "-//W3C//ENTITIES Symbols for XHTML//EN"
+    "http://www.w3.org/TR/xhtml1/DTD/xhtml-symbol.ent";>
+
+%HTMLlat1;
+%HTMLspecial;
+%HTMLsymbol;
 
 <!ENTITY % inlinetags "em | strong | code | a | br | directive | module">
 
@@ -102,4 +117,4 @@
   height      CDATA   #IMPLIED
   width       CDATA   #IMPLIED >
 
-<!ELEMENT blockquote %BlockOrInline;>
\ No newline at end of file
+<!ELEMENT blockquote %BlockOrInline;>
diff -ur -x CVS httpd-docs-2.0/manual/upgrading.xml.de 
tmp/manual-entities/upgrading.xml.de
--- httpd-docs-2.0/manual/upgrading.xml.de      Sun Aug 18 01:54:25 2002
+++ tmp/manual-entities/upgrading.xml.de        Wed Aug 21 23:11:00 2002
@@ -7,8 +7,8 @@
 <title>Upgrade von 1.3 auf 2.0</title>
 
 <summary>
-    <p>Dieses Dokument dient der Unterst&#252;tzung beim Upgrade. Es
-    enth&#228;lt die entscheidenden Informationen f&#252;r bisherige
+    <p>Dieses Dokument dient der Unterst&uuml;tzung beim Upgrade. Es
+    enth&auml;lt die entscheidenden Informationen f&uuml;r bisherige
     Apache-Nutzer. Diese sind als kurze Anmerkungen
     gedacht. Weitere Informationen finden Sie entweder unter
     <a href="new_features_2_0.html">Neue Funktionen</a> oder in
@@ -16,7 +16,7 @@
 </summary>
 
   <section id="compile-time">
-    <title>&#196;nderungen der Konfiguration bei der Kompilierung</title>
+    <title>&Auml;nderungen der Konfiguration bei der Kompilierung</title>
 
     <ul>
       <li>Der Apache benutzt jetzt ein <code>autoconf</code>- und

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to