]> granicus.if.org Git - docbook-dsssl/commitdiff
Convert XML doc to DB5.
authorBob Stayton <bobs@sagehill.net>
Fri, 21 Feb 2014 22:14:09 +0000 (22:14 +0000)
committerBob Stayton <bobs@sagehill.net>
Fri, 21 Feb 2014 22:14:09 +0000 (22:14 +0000)
xsl/webhelp/docsrc/readme.xml
xsl/webhelp/docsrc/xinclude-test.xml

index ea4896976a01dc147b1329d764e7c894ab8a4d38..ba965a0081142df0e811be4384259018781356e3 100644 (file)
@@ -1,25 +1,7 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
-"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
-<!ELEMENT xi:include (xi:fallback?) >
-<!ATTLIST xi:include
-    xmlns:xi   CDATA       #FIXED    "http://www.w3.org/2001/XInclude"
-    href       CDATA       #IMPLIED
-    parse      (xml|text)  "xml"
-    xpointer   CDATA       #IMPLIED
-    encoding   CDATA       #IMPLIED 
-    accept     CDATA       #IMPLIED
-    accept-language CDATA  #IMPLIED >
-
-<!ELEMENT xi:fallback ANY>
-<!ATTLIST xi:fallback
-    xmlns:xi   CDATA   #FIXED   "http://www.w3.org/2001/XInclude" >
-
-<!ENTITY % local.chapter.class "| xi:include">
-]>
-<book>
+<?xml version="1.0"?>
+<book xmlns="http://docbook.org/ns/docbook" version="5.0">
   <title>README: Web-based Help from DocBook XML</title>
-  <bookinfo>
+  <info>
     <legalnotice>
       <para>Permission is hereby granted, free of charge, to any person obtaining a copy of this
         software and associated documentation files (the <quote>Software</quote>), to deal in the
           <email>kasunbg AT gmail DOT com</email> and David Cramer,
           <email>david AT thingbag DOT net</email> and with
         contributions by Arun Bharadwaj and Visitha Baddegama. Please
-        direct support questions to the <ulink
-          url="http://wiki.docbook.org/DocBookDiscussion">DocBook-apps
-          mailing list</ulink>. </para>
+        direct support questions to the <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://wiki.docbook.org/DocBookDiscussion">DocBook-apps
+          mailing list</link>. </para>
       <para>This package also includes the following software written and copyrighted by others:<itemizedlist>
           <listitem>
             <para>Files in <filename class="directory">template/common/jquery</filename> are
-              copyrighted by <ulink url="http://jquery.com/">JQuery</ulink> under the MIT License.
+              copyrighted by <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://jquery.com/">JQuery</link> under the MIT License.
               The file <filename>jquery.cookie.js</filename> Copyright (c) 2006 Klaus Hartl under
               the MIT license.</para>
             <indexterm>
             </indexterm>
           </listitem>
           <listitem>
-            <para>Some files in the <filename class="directory"
-                >template/search</filename> and <filename
-                class="directory">indexer</filename> directories were
+            <para>Some files in the <filename class="directory">template/search</filename> and <filename class="directory">indexer</filename> directories were
               originally part of N. Quaine's htmlsearch DITA plugin.
-              The htmlsearch DITA plugin is available from the <ulink
-                url="http://tech.groups.yahoo.com/group/dita-users/files/Demos/"
-                >files page</ulink> of the DITA-users yahoogroup. The
+              The htmlsearch DITA plugin is available from the <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://tech.groups.yahoo.com/group/dita-users/files/Demos/">files page</link> of the DITA-users yahoogroup. The
               htmlsearch plugin was released under a BSD-style
               license. See <filename>indexer/license.txt</filename>
               for details. <indexterm>
               </indexterm></para>
           </listitem>
           <listitem>
-            <para>Stemmers from the <ulink
-                url="http://snowball.tartarus.org/texts/stemmersoverview.html">Snowball
-                project</ulink> released under a BSD license.</para>
+            <para>Stemmers from the <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://snowball.tartarus.org/texts/stemmersoverview.html">Snowball
+                project</link> released under a BSD license.</para>
           </listitem>
           <listitem>
-            <para>Code from the <ulink url="http://lucene.apache.org/">Apache Lucene</ulink> search
+            <para>Code from the <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://lucene.apache.org/">Apache Lucene</link> search
               engine provides support for tokenizing Chinese, Japanese, and Korean content released
               under the Apache 2.0 license. </para>
           </listitem>
          <listitem>
             <para>Code that provides weighted search results and some
-              other improvements was graciously donated by <ulink
-                url="http://www.oxygenxml.com">SyncRO Soft
-                Ltd.</ulink>, the publishers of the oXygen XML
+              other improvements was graciously donated by <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.oxygenxml.com">SyncRO Soft
+                Ltd.</link>, the publishers of the oXygen XML
               Editor.</para>
           </listitem>
           <listitem>
-            <para><ulink url="http://ccil.org/~cowan/XML/tagsoup/"
-                >TagSoup</ulink>, released under the Apache 2.0
+            <para><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://ccil.org/~cowan/XML/tagsoup/">TagSoup</link>, released under the Apache 2.0
               license, makes it possible to index html instead of just
               xhtml output. </para>
           </listitem>
           <listitem>
-            <para>Cosmetic improvements provided by <ulink
-                url="http://docs.openstack.org"
-              >OpenStack</ulink>.</para>
+            <para>Cosmetic improvements provided by <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://docs.openstack.org">OpenStack</link>.</para>
           </listitem>
-        </itemizedlist> Webhelp for DocBook was first developed as a <ulink
-          url="http://code.google.com/soc/">Google Summer of Code</ulink> project. </para>
+        </itemizedlist> Webhelp for DocBook was first developed as a <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://code.google.com/soc/">Google Summer of Code</link> project. </para>
     </legalnotice>
     <copyright>
       <year>2008-2012</year>
       <holder>Kasun Gajasinghe</holder>
       <holder>David Cramer</holder>
     </copyright>
-    <author>
-      <firstname>David</firstname>
-      <surname>Cramer</surname>
-      <email>david AT thingbag DOT net</email>
-    </author>
-    <author>
-      <firstname>Kasun</firstname>
-      <surname>Gajasinghe</surname>
-      <email>kasunbg AT gmail DOT com</email>
-    </author>
+    <author><personname><firstname>David</firstname><surname>Cramer</surname></personname><email>david AT thingbag DOT net</email></author>
+    <author><personname><firstname>Kasun</firstname><surname>Gajasinghe</surname></personname><email>kasunbg AT gmail DOT com</email></author>
     <pubdate>January 2012</pubdate>
-  </bookinfo>
+  </info>
   <chapter>
-    <chapterinfo>
+    <title>Introduction</title><info>
       <abstract>
         <!-- This becomes the brief description that appears in search results UNLESS there's a para or phrase with role="summary". If there is, then the role="summary" text wins. -->
         <para>Overview of the package.</para>
       </abstract>
-    </chapterinfo>
-    <title>Introduction</title>
+    </info>
+    
     <para>A common requirement for technical publications groups is to produce a Web-based help
       format that includes a table of contents pane, a search feature, and an index similar to what
       you get from the Microsoft HTML Help (.chm) format or Eclipse help. If the content is help for
                 search-result.</para>
             </listitem>
             <listitem>
-              <para>Search results can include brief descriptions of the target.<indexterm
-                class="singular">
+              <para>Search results can include brief descriptions of the target.<indexterm class="singular">
                 <primary>search</primary>
                 <secondary>description</secondary>
               </indexterm></para>
             format into your own build system. Alternatively, you can
             use the build scripts as a template for creating your own
             script. You can also generate webhelp from DocBook using
-            the <ulink
-              url="http://docbkx-tools.sourceforge.net/docbkx-samples/manual.html"
-              >Docbkx Maven plugin</ulink>.</para>
+            the <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://docbkx-tools.sourceforge.net/docbkx-samples/manual.html">Docbkx Maven plugin</link>.</para>
         </listitem>
       </itemizedlist></para>
   </chapter>
         <command>xsltproc</command> and <command>java</command>
       available in your <envar>PATH</envar>.</para>
     <section>
-      <sectioninfo>
+      <title>Generating webhelp output using the Ant build.xml
+        file</title><info>
         <abstract>
           <para>Installation instructions</para>
         </abstract>
-      </sectioninfo>
-      <title>Generating webhelp output using the Ant build.xml
-        file</title>
+      </info>
+      
       <procedure>
         <title>To install the package</title>
         <note>
               <filename>Makefile.sample</filename> you must have
               <command>xsltproc</command> and <command>java</command>
             available in your <envar>PATH</envar>. You can also use
-            the <ulink
-              url="http://docbkx-tools.sourceforge.net/docbkx-samples/manual.html"
-              >Docbkx Maven plugin</ulink> to generate webhelp.</para>
+            the <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://docbkx-tools.sourceforge.net/docbkx-samples/manual.html">Docbkx Maven plugin</link> to generate webhelp.</para>
         </note>
-        <step>
-          <para>If necessary, install <ulink url="http://www.java.com/en/download/manual.jsp">Java
-              1.6</ulink> or higher.</para>
-          <substeps>
-            <step>
+        <step performance="required">
+          <para>If necessary, install <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.java.com/en/download/manual.jsp">Java
+              1.6</link> or higher.</para>
+          <substeps performance="required">
+            <step performance="required">
               <para>Confirm that Java is installed and in your <envar>PATH</envar> by typing the
                 following at a command prompt: <programlisting>java -version</programlisting></para>
               <note>
             </step>
           </substeps>
         </step>
-        <step>
-          <para>If necessary, install <ulink url="http://ant.apache.org/bindownload.cgi">Apache
-              Ant</ulink> 1.8.0 or higher. See <ulink
-              url="http://ant.apache.org/manual/install.html">Ant installation instructions</ulink>.</para>
-          <substeps>
-            <step>
+        <step performance="required">
+          <para>If necessary, install <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://ant.apache.org/bindownload.cgi">Apache
+              Ant</link> 1.8.0 or higher. See <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://ant.apache.org/manual/install.html">Ant installation instructions</link>.</para>
+          <substeps performance="required">
+            <step performance="required">
               <para>Unzip the Ant binary distribution to a convenient location on your system. For
                 example: <filename>c:\Program Files</filename>.</para>
             </step>
-            <step>
+            <step performance="required">
               <para>Set the environment variable <envar>ANT_HOME</envar> to the top-level Ant
                 directory. For example: <filename>c:\Program Files\apache-ant-1.8.0</filename>. <tip>
-                  <para>See <ulink url="http://support.microsoft.com/kb/310519">How To Manage
-                      Environment Variables in Windows XP</ulink> for information on setting
+                  <para>See <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://support.microsoft.com/kb/310519">How To Manage
+                      Environment Variables in Windows XP</link> for information on setting
                     environment variables.</para>
                 </tip></para>
             </step>
-            <step>
+            <step performance="required">
               <para>Add the Ant <filename>bin</filename> directory to your <envar>PATH</envar>. For
                 example: <filename>c:\Program Files\apache-ant-1.8.0\bin</filename></para>
             </step>
-            <step>
+            <step performance="required">
               <para>Confirm that Ant is installed by typing the following at a command prompt:
                 <programlisting>ant -version</programlisting></para>
               <note>
             </step>
           </substeps>
         </step>
-        <step>
-          <para>Download <ulink url="http://prdownloads.sourceforge.net/saxon/saxon6-5-5.zip">Saxon
-              6.5.x</ulink> and unzip the distribution to a convenient location on your file system.
-            You will use the path to <filename>saxon.jar</filename> in <xref
-              linkend="edit-build-properties"/> below.<note>
+        <step performance="required">
+          <para>Download <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://prdownloads.sourceforge.net/saxon/saxon6-5-5.zip">Saxon
+              6.5.x</link> and unzip the distribution to a convenient location on your file system.
+            You will use the path to <filename>saxon.jar</filename> in <xref linkend="edit-build-properties"/> below.<note>
               <para>The <filename>build.xml</filename> has only been tested with Saxon 6.5, though
                 it could be adapted to work with other XSLT processors. However, when you generate
                 output, the Saxon jar must <emphasis role="bold">not</emphasis> be in your
                   <envar>CLASSPATH</envar>.</para>
             </note></para>
         </step>
-        <step>
-          <para>Download <ulink
-              url="https://xerces.apache.org/xerces2-j/">Xerces2
-              Java</ulink> and extract it to a convenient location on
+        <step performance="required">
+          <para>Download <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://xerces.apache.org/xerces2-j/">Xerces2
+              Java</link> and extract it to a convenient location on
             your file system. You will need the
               <filename>xercesImpl.jar</filename> and
               <filename>xml-apis.jar</filename> from this distribution
             in in <xref linkend="edit-build-properties"/>. </para>
         </step>
-        <step id="edit-build-properties">
+        <step xml:id="edit-build-properties" performance="required">
           <para>In a text editor, edit the
               <filename>build.properties</filename> file in the
             webhelp directory and make the changes indicated by the comments.<important>
                   <code>xslt-processor-classpath</code>,
                   <code>xercesImpl.jar</code>, and
                   <code>xml-apis.jar</code>.</para>
-            </important>See the DocBook <ulink
-              url="../../../doc/html/webhelp.html">reference
-              documentation</ulink> for detailed information about the
+            </important>See the DocBook <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../../doc/html/webhelp.html">reference
+              documentation</link> for detailed information about the
             available webhelp and other parameters. Note that not all
             DocBook parameters are passed in to the xsls by the
               <filename>build.xml</filename> by default. You may need
@@ -399,22 +353,20 @@ enable.stemming=true
 admon.graphics=0
 suppress.footer.navigation=0</programlisting></para>
         </step>
-        <step>
+        <step performance="required">
           <para>Test the package by running the command <code>ant
               webhelp -Doutput-dir=test-ouput</code> at the command
             line in the webhelp directory. It should generate a copy
-            of this documentation in the <filename class="directory"
-              >doc</filename> directory. Type <code>start
+            of this documentation in the <filename class="directory">doc</filename> directory. Type <code>start
               test-output\index.html</code> to open the output in a
             browser. Once you have confirmed that the process worked,
-            you can delete the <filename class="directory"
-              >test-output</filename> directory. </para>
+            you can delete the <filename class="directory">test-output</filename> directory. </para>
         </step>
-        <step>
+        <step performance="required">
           <para>To process your own document, simply refer to this package from another
               <filename>build.xml</filename> in arbitrary location on your system:</para>
-          <substeps>
-            <step>
+          <substeps performance="required">
+            <step performance="required">
               <para>Create a new <filename>build.xml</filename> file that defines the name of your
                 source file, the desired output directory, and imports the
                   <filename>build.xml</filename> from this package. For example:
@@ -425,7 +377,7 @@ suppress.footer.navigation=0</programlisting></para>
   &lt;import file="<replaceable>path-to/docbook-webhelp/</replaceable>build.xml"/&gt;
 &lt;/project&gt;</programlisting></para>
             </step>
-            <step>
+            <step performance="required">
               <para>From the directory containing your newly created <filename>build.xml</filename>
                 file, type <code>ant webhelp</code> to build your document.</para>
             </step>
@@ -437,22 +389,21 @@ suppress.footer.navigation=0</programlisting></para>
       <title>Using and customizing the output</title>
       <para>To deep link to a topic inside the help set, simply link directly to the page. This help
         system uses no frameset, so nothing further is necessary. <tip>
-          <para>See <ulink url="http://www.sagehill.net/docbookxsl/Chunking.html">Chunking into
-              multiple HTML files</ulink> in Bob Stayton's <ulink
-              url="http://www.sagehill.net/docbookxsl/index.html">DocBook XSL: The Complete
-              Guide</ulink> for information on controlling output file names and which files are
+          <para>See <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.sagehill.net/docbookxsl/Chunking.html">Chunking into
+              multiple HTML files</link> in Bob Stayton's <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.sagehill.net/docbookxsl/index.html">DocBook XSL: The Complete
+              Guide</link> for information on controlling output file names and which files are
             chunked in DocBook.</para>
         </tip></para>
       <para>When you perform a search, the results can include brief summaries. These are populated
         in one of two ways:<itemizedlist>
           <listitem>
-            <para>By adding <sgmltag>role="summary"</sgmltag> to a <sgmltag>para</sgmltag> or
-                <sgmltag>phrase</sgmltag> in the <sgmltag>chapter</sgmltag> or
-                <sgmltag>section</sgmltag>.</para>
+            <para>By adding <tag>role="summary"</tag> to a <tag>para</tag> or
+                <tag>phrase</tag> in the <tag>chapter</tag> or
+                <tag>section</tag>.</para>
           </listitem>
           <listitem>
-            <para>By adding an <sgmltag>abstract</sgmltag> to the <sgmltag>chapterinfo</sgmltag> or
-                <sgmltag>sectioninfo</sgmltag> element.</para>
+            <para>By adding an <tag>abstract</tag> to the <tag>chapterinfo</tag> or
+                <tag>sectioninfo</tag> element.</para>
           </listitem>
         </itemizedlist></para>
       <para>To customize the look and feel of the help, study the following css files:<itemizedlist>
@@ -466,7 +417,7 @@ suppress.footer.navigation=0</programlisting></para>
           <listitem>
             <para><filename>docs/common/jquery/theme-redmond/jquery-ui-1.8.2.custom.css</filename>:
               This is the theming part which adds colors and stuff. This is a default theme comes
-              with <ulink url="http://jqueryui.com/download">jqueryui</ulink> unchanged. You can get
+              with <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://jqueryui.com/download">jqueryui</link> unchanged. You can get
               any theme based your interest from this. (Themes are on right navigation bar.) Then
               replace the css theme folder (theme-redmond) with it, and change the xsl to point to
               the new css.</para>
@@ -481,10 +432,10 @@ suppress.footer.navigation=0</programlisting></para>
         <para>If you are serving a long document from an Apache web
           server, we recommend you make the following additions or
           changes to your <filename>httpd.conf</filename> or
-            <filename>.htaccess</filename> file. <programlisting>AddDefaultCharSet UTF-8 # <co id="AddDefaultCharSet"/>
+            <filename>.htaccess</filename> file. <programlisting>AddDefaultCharSet UTF-8 # <co xml:id="AddDefaultCharSet"/>
   
       # 480 weeks
-      &lt;FilesMatch "\.(ico|pdf|flv|jpg|jpeg|png|gif|js|css|swf)$"&gt; # <co id="CachingSettings"/>
+      &lt;FilesMatch "\.(ico|pdf|flv|jpg|jpeg|png|gif|js|css|swf)$"&gt; # <co xml:id="CachingSettings"/>
       Header set Cache-Control "max-age=290304000, public"
       &lt;/FilesMatch&gt;
       
@@ -499,7 +450,7 @@ suppress.footer.navigation=0</programlisting></para>
       &lt;/FilesMatch&gt;
       
       # compress text, html, javascript, css, xml:
-      AddOutputFilterByType DEFLATE text/plain # <co id="CompressSetting"/>
+      AddOutputFilterByType DEFLATE text/plain # <co xml:id="CompressSetting"/>
       AddOutputFilterByType DEFLATE text/html
       AddOutputFilterByType DEFLATE text/xml
       AddOutputFilterByType DEFLATE text/css
@@ -515,9 +466,7 @@ suppress.footer.navigation=0</programlisting></para>
       &lt;/Files&gt;
       </programlisting><calloutlist>
             <callout arearefs="AddDefaultCharSet">
-              <para>See <ulink
-                  url="http://www.sagehill.net/docbookxsl/SpecialChars.html"
-                  >Odd characters in HTML output</ulink> in Bob
+              <para>See <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.sagehill.net/docbookxsl/SpecialChars.html">Odd characters in HTML output</link> in Bob
                 Stayton's book <citetitle>DocBook XSL: The Complete
                   Guide</citetitle> for more information about this
                 setting.</para>
@@ -624,9 +573,8 @@ suppress.footer.navigation=0</programlisting></para>
         supports stemming for English and German. In addition, Java stemmers are included for the
         following languages. Therefore, to support these languages, you only need to implement the
         stemmer in JavaScript and add it to the template. If you do undertake this task, please
-        consider contributing the JavaScript version back to this project and to <ulink
-          url="http://snowball.tartarus.org/texts/stemmersoverview.html">Martin Porter's
-          project</ulink>.<itemizedlist>
+        consider contributing the JavaScript version back to this project and to <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://snowball.tartarus.org/texts/stemmersoverview.html">Martin Porter's
+          project</link>.<itemizedlist>
           <listitem>
             <para>Danish</para>
           </listitem>
@@ -676,8 +624,7 @@ suppress.footer.navigation=0</programlisting></para>
           </listitem>
           <listitem>
             <para>Then refer to those images from your docbook document.</para>
-            <para>Following image is from <emphasis role="bold"
-                >webhelp/docsrs/images/sample.jpg</emphasis>. The docbook code is shown
+            <para>Following image is from <emphasis role="bold">webhelp/docsrs/images/sample.jpg</emphasis>. The docbook code is shown
               below.</para>
             <para>
               <figure>
@@ -691,14 +638,14 @@ suppress.footer.navigation=0</programlisting></para>
             </para>
             <example>
               <title>Example code for adding images. Note down the relative path used</title>
-              <programlisting>&lt;figure>
-  &lt;title>Sample&lt;/title>
-  &lt;mediaobject>
-    &lt;imageobject>
-      &lt;imagedata fileref="<emphasis role="bold">images/sample.jpg</emphasis>" format="JPG"/>
-    &lt;/imageobject>
-  &lt;/mediaobject>
-&lt;/figure></programlisting>
+              <programlisting>&lt;figure&gt;
+  &lt;title&gt;Sample&lt;/title&gt;
+  &lt;mediaobject&gt;
+    &lt;imageobject&gt;
+      &lt;imagedata fileref="<emphasis role="bold">images/sample.jpg</emphasis>" format="JPG"/&gt;
+    &lt;/imageobject&gt;
+  &lt;/mediaobject&gt;
+&lt;/figure&gt;</programlisting>
             </example>
           </listitem>
         <listitem>
@@ -732,28 +679,25 @@ input-images-dirs=images/**,figures/**,graphics/**</programlisting></para>
           </listitem>
           <listitem>
             <para>Content: This includes the content of the documentation. The processing of this
-              part is done by <ulink
-                url="http://docbook.sourceforge.net/release/xsl/current/xhtml/chunk.xsl"> DocBook
-                XSL Chunking customization</ulink>. Few further css-styling applied from
+              part is done by <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://docbook.sourceforge.net/release/xsl/current/xhtml/chunk.xsl"> DocBook
+                XSL Chunking customization</link>. Few further css-styling applied from
                 <filename>positioning.css</filename>. </para>
           </listitem>
           <listitem>
             <para>Left Navigation: This includes the table of contents and search tab. This is
-              customized using <ulink url="http://jqueryui.com/">jquery-ui</ulink> styling.</para>
+              customized using <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://jqueryui.com/">jquery-ui</link> styling.</para>
             <itemizedlist>
               <listitem>
                 <para>Tabbed Navigation: The navigation pane is organized in to two tabs. Contents
-                  tab, and Search tab. Tabbed output is achieved using <ulink
-                    url="http://docs.jquery.com/UI/Tabs">JQuery Tabs plugin</ulink>. </para>
+                  tab, and Search tab. Tabbed output is achieved using <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://docs.jquery.com/UI/Tabs">JQuery Tabs plugin</link>. </para>
               </listitem>
               <listitem>
                 <para>Table of Contents (TOC) tree: When building the chunked html from the docbook
                   file, Table of Contents is generated as an Unordered List (a list made from
-                    <code>&lt;ul> &lt;li></code> tags). When page loads in the browser, we apply
+                    <code>&lt;ul&gt; &lt;li&gt;</code> tags). When page loads in the browser, we apply
                   styling to it to achieve the nice look that you see. Styling for TOC tree is done
-                  by a JQuery UI plugin called <ulink
-                    url="http://bassistance.de/jquery-plugins/jquery-plugin-treeview/">
-                    TreeView</ulink>. We can generate the tree easily by following javascript code:
+                  by a JQuery UI plugin called <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://bassistance.de/jquery-plugins/jquery-plugin-treeview/">
+                    TreeView</link>. We can generate the tree easily by following javascript code:
                   <programlisting>
 //Generate the tree
 $("#tree").treeview({
@@ -862,14 +806,12 @@ persist: "cookie"
               <para>You'll need two versions of the stemmer; One written in JavaScript, and another
                 in Java. But fortunately, Snowball contains Java stemmers for number of popular
                 languages, and are already included with the package. You can see the full list in
-                  <ulink url="ch02s04.html">Adding support for other (non-CJKV) languages</ulink>.
+                  <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="ch02s04.html">Adding support for other (non-CJKV) languages</link>.
                 If your language is listed there, Then you have to find javascript version of the
-                stemmer. Generally, new stemmers are getting added in to <ulink
-                  url="http://snowball.tartarus.org/otherlangs/index.html">Snowball Stemmers in
-                  other languages</ulink> location. If javascript stemmer for your language is
+                stemmer. Generally, new stemmers are getting added in to <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://snowball.tartarus.org/otherlangs/index.html">Snowball Stemmers in
+                  other languages</link> location. If javascript stemmer for your language is
                 available, then download it. Else, you can write a new stemmer in JavaScript using
-                SnowBall algorithm fairly easily. Algorithms are at <ulink
-                  url="http://snowball.tartarus.org/">Snowball</ulink>. </para>
+                SnowBall algorithm fairly easily. Algorithms are at <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://snowball.tartarus.org/">Snowball</link>. </para>
             </listitem>
             <listitem>
               <para>Then, name the JS stemmer exactly like this:
@@ -956,12 +898,12 @@ private String[] supportedLanguages= {"en", "de", "fr", "cn", "ja", "ko", <empha
     </section>
   </chapter>
   <chapter>
-    <chapterinfo>
+    <title>FAQ</title><info>
       <abstract>
         <para>Frequently Asked Questions</para>
       </abstract>
-    </chapterinfo>
-    <title>FAQ</title>
+    </info>
+    
     <qandaset>
       <qandaentry>
         <question>
@@ -979,8 +921,7 @@ private String[] supportedLanguages= {"en", "de", "fr", "cn", "ja", "ko", <empha
             WebHelp?</para>
         </question>
         <answer>
-          <para>There are four production deployments provided in <ulink
-              url="http://wiki.docbook.org/WebHelp">WebHelp wiki</ulink> currently.</para>
+          <para>There are four production deployments provided in <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://wiki.docbook.org/WebHelp">WebHelp wiki</link> currently.</para>
         </answer>
       </qandaentry>
       <qandaentry>
@@ -1015,9 +956,7 @@ xml-apis.jar=/usr/share/java/xml-apis.jar</programlisting></para>
           <para>I need more information about webhelp-indexer. Where can I find it?</para>
         </question>
         <answer>
-          <para>The DocBook Webhelp Indexer is based on the HTMLSearch plugin for DITA. See <ulink
-              url="http://www.helpml.com:8088/help/index.jsp?topic=/org.sample.help.doc/htmlsearch/DHSC_BestPractices_htmlsearch.html"
-              >HTMLSearch documentation </ulink> for more information.</para>
+          <para>The DocBook Webhelp Indexer is based on the HTMLSearch plugin for DITA. See <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.helpml.com:8088/help/index.jsp?topic=/org.sample.help.doc/htmlsearch/DHSC_BestPractices_htmlsearch.html">HTMLSearch documentation </link> for more information.</para>
         </answer>
       </qandaentry>
     </qandaset>
@@ -1025,6 +964,6 @@ xml-apis.jar=/usr/share/java/xml-apis.jar</programlisting></para>
       <primary>FAQ</primary>
     </indexterm>
   </chapter>
-  <xi:include href="xinclude-test.xml"  xmlns:xi="http://www.w3.org/2001/XInclude"/>
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="xinclude-test.xml" parse="xml"/>
   <index/>
 </book>
index 77ef4f88ee5e3e9e03cd557c39a1be0549488c1e..e8a64f03d8914511ab236d5b6fa8771ccd905039 100644 (file)
@@ -1,6 +1,5 @@
-<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
-"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
-  <chapter>
+<?xml version="1.0"?>
+<chapter xmlns="http://docbook.org/ns/docbook" version="5.0">
     <title>Test section</title>
     <section>
       <title>Some search words for testing</title>
@@ -10,4 +9,4 @@
       <title>Some search words for testing (inflected)</title>
       <para>arsenal, arsenic, buys, says, varies, tries, skies, nuclei, days, keys, currencies, build.xml</para>
     </section>    
-  </chapter>
\ No newline at end of file
+  </chapter>