-<?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
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:
<import file="<replaceable>path-to/docbook-webhelp/</replaceable>build.xml"/>
</project></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>
<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>
<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>
<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
- <FilesMatch "\.(ico|pdf|flv|jpg|jpeg|png|gif|js|css|swf)$"> # <co id="CachingSettings"/>
+ <FilesMatch "\.(ico|pdf|flv|jpg|jpeg|png|gif|js|css|swf)$"> # <co xml:id="CachingSettings"/>
Header set Cache-Control "max-age=290304000, public"
</FilesMatch>
</FilesMatch>
# 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
</Files>
</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>
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>
</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>
</para>
<example>
<title>Example code for adding images. Note down the relative path used</title>
- <programlisting><figure>
- <title>Sample</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="<emphasis role="bold">images/sample.jpg</emphasis>" format="JPG"/>
- </imageobject>
- </mediaobject>
-</figure></programlisting>
+ <programlisting><figure>
+ <title>Sample</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="<emphasis role="bold">images/sample.jpg</emphasis>" format="JPG"/>
+ </imageobject>
+ </mediaobject>
+</figure></programlisting>
</example>
</listitem>
<listitem>
</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><ul> <li></code> tags). When page loads in the browser, we apply
+ <code><ul> <li></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({
<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:
</section>
</chapter>
<chapter>
- <chapterinfo>
+ <title>FAQ</title><info>
<abstract>
<para>Frequently Asked Questions</para>
</abstract>
- </chapterinfo>
- <title>FAQ</title>
+ </info>
+
<qandaset>
<qandaentry>
<question>
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>
<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>
<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>