| 1 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|---|
| 2 | <html xmlns="http://www.w3.org/1999/xhtml"><head>
|
|---|
| 3 | <meta http-equiv="X-UA-Compatible" content="IE=edge"></meta>
|
|---|
| 4 | <meta http-equiv="Content-Type" content="text/html; charset=utf-8"></meta>
|
|---|
| 5 | <title>README: Web-based Help from DocBook XML - </title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"></meta><link rel="home" href="index.html" title="README: Web-based Help from DocBook XML"></link><link rel="next" href="ch01.html" title="Introduction"></link><meta name="Section-title" content="README: Web-based Help from DocBook XML"></meta><script type="text/javascript">
|
|---|
| 6 | //The id for tree cookie
|
|---|
| 7 | var treeCookieId = "treeview-1102";
|
|---|
| 8 | var language = "en";
|
|---|
| 9 | var w = new Object();
|
|---|
| 10 | //Localization
|
|---|
| 11 | txt_filesfound = 'Results';
|
|---|
| 12 | txt_enter_at_least_1_char = "You must enter at least one character.";
|
|---|
| 13 | txt_browser_not_supported = "JavaScript is disabled on your browser. Please enable JavaScript to enjoy all the features of this site.";
|
|---|
| 14 | txt_please_wait = "Please wait. Search in progress...";
|
|---|
| 15 | txt_results_for = "Results for: ";
|
|---|
| 16 | </script><link rel="shortcut icon" href="favicon.ico" type="image/x-icon"></link><link rel="stylesheet" type="text/css" href="common/css/positioning.css"></link><link rel="stylesheet" type="text/css" href="common/jquery/theme-redmond/jquery-ui-1.8.2.custom.css"></link><link rel="stylesheet" type="text/css" href="common/jquery/treeview/jquery.treeview.css"></link><style type="text/css">
|
|---|
| 17 |
|
|---|
| 18 | #noscript{
|
|---|
| 19 | font-weight:bold;
|
|---|
| 20 | background-color: #55AA55;
|
|---|
| 21 | font-weight: bold;
|
|---|
| 22 | height: 25spx;
|
|---|
| 23 | z-index: 3000;
|
|---|
| 24 | top:0px;
|
|---|
| 25 | width:100%;
|
|---|
| 26 | position: relative;
|
|---|
| 27 | border-bottom: solid 5px black;
|
|---|
| 28 | text-align:center;
|
|---|
| 29 | color: white;
|
|---|
| 30 | }
|
|---|
| 31 |
|
|---|
| 32 | input {
|
|---|
| 33 | margin-bottom: 5px;
|
|---|
| 34 | margin-top: 2px;
|
|---|
| 35 | }
|
|---|
| 36 | .folder {
|
|---|
| 37 | display: block;
|
|---|
| 38 | height: 22px;
|
|---|
| 39 | padding-left: 20px;
|
|---|
| 40 | background: transparent url(common/jquery/treeview/images/folder.gif) 0 0px no-repeat;
|
|---|
| 41 | }
|
|---|
| 42 | span.contentsTab {
|
|---|
| 43 | padding-left: 20px;
|
|---|
| 44 | background: url(common/images/toc-icon.png) no-repeat 0 center;
|
|---|
| 45 | }
|
|---|
| 46 | span.searchTab {
|
|---|
| 47 | padding-left: 20px;
|
|---|
| 48 | background: url(common/images/search-icon.png) no-repeat 0 center;
|
|---|
| 49 | }
|
|---|
| 50 |
|
|---|
| 51 | /* Overide jquery treeview's defaults for ul. */
|
|---|
| 52 | .treeview ul {
|
|---|
| 53 | background-color: transparent;
|
|---|
| 54 | margin-top: 4px;
|
|---|
| 55 | }
|
|---|
| 56 | #webhelp-currentid {
|
|---|
| 57 | background-color: #D8D8D8 !important;
|
|---|
| 58 | }
|
|---|
| 59 | .treeview .hover { color: black; }
|
|---|
| 60 | .filetree li span a { text-decoration: none; font-size: 12px; color: #517291; }
|
|---|
| 61 |
|
|---|
| 62 | /* Override jquery-ui's default css customizations. These are supposed to take precedence over those.*/
|
|---|
| 63 | .ui-widget-content {
|
|---|
| 64 | border: 0px;
|
|---|
| 65 | background: none;
|
|---|
| 66 | color: none;
|
|---|
| 67 | }
|
|---|
| 68 | .ui-widget-header {
|
|---|
| 69 | color: #e9e8e9;
|
|---|
| 70 | border-left: 1px solid #e5e5e5;
|
|---|
| 71 | border-right: 1px solid #e5e5e5;
|
|---|
| 72 | border-bottom: 1px solid #bbc4c5;
|
|---|
| 73 | border-top: 4px solid #e5e5e5;
|
|---|
| 74 | border: medium none;
|
|---|
| 75 | background: #F4F4F4; /* old browsers */
|
|---|
| 76 | background: -moz-linear-gradient(top, #F4F4F4 0%, #E6E4E5 100%); /* firefox */
|
|---|
| 77 | background: -webkit-gradient(linear, left top, left bottom, color-stop(0%,#F4F4F4), color-stop(100%,#E6E4E5)); /* webkit */
|
|---|
| 78 | font-weight: none;
|
|---|
| 79 | }
|
|---|
| 80 | .ui-widget-header a { color: none; }
|
|---|
| 81 | .ui-state-default, .ui-widget-content .ui-state-default, .ui-widget-header .ui-state-default {
|
|---|
| 82 | border: none; background: none; font-weight: none; color: none; }
|
|---|
| 83 | .ui-state-default a, .ui-state-default a:link, .ui-state-default a:visited { color: black; text-decoration: none; }
|
|---|
| 84 | .ui-state-hover, .ui-widget-content .ui-state-hover, .ui-widget-header .ui-state-hover, .ui-state-focus, .ui-widget-content .ui-state-focus, .ui-widget-header .ui-state-focus { border: none; background: none; font-weight: none; color: none; }
|
|---|
| 85 |
|
|---|
| 86 | .ui-state-active, .ui-widget-content .ui-state-active, .ui-widget-header .ui-state-active { border: none; background: none; font-weight: none; color: none; }
|
|---|
| 87 | .ui-state-active a, .ui-state-active a:link, .ui-state-active a:visited {
|
|---|
| 88 | color: black; text-decoration: none;
|
|---|
| 89 | background: #C6C6C6; /* old browsers */
|
|---|
| 90 | background: -moz-linear-gradient(top, #C6C6C6 0%, #D8D8D8 100%); /* firefox */
|
|---|
| 91 | background: -webkit-gradient(linear, left top, left bottom, color-stop(0%,#C6C6C6), color-stop(100%,#D8D8D8)); /* webkit */
|
|---|
| 92 | -webkit-border-radius:15px; -moz-border-radius:10px;
|
|---|
| 93 | border: 1px solid #f1f1f1;
|
|---|
| 94 | }
|
|---|
| 95 | .ui-corner-all { border-radius: 0 0 0 0; }
|
|---|
| 96 |
|
|---|
| 97 | .ui-tabs { padding: .2em;}
|
|---|
| 98 | .ui-tabs .ui-tabs-nav li { top: 0px; margin: -2px 0 1px; text-transform: uppercase; font-size: 10.5px;}
|
|---|
| 99 | .ui-tabs .ui-tabs-nav li a { padding: .25em 2em .25em 1em; margin: .5em; text-shadow: 0 1px 0 rgba(255,255,255,.5); }
|
|---|
| 100 | /**
|
|---|
| 101 | * Basic Layout Theme
|
|---|
| 102 | *
|
|---|
| 103 | * This theme uses the default layout class-names for all classes
|
|---|
| 104 | * Add any 'custom class-names', from options: paneClass, resizerClass, togglerClass
|
|---|
| 105 | */
|
|---|
| 106 |
|
|---|
| 107 | .ui-layout-pane { /* all 'panes' */
|
|---|
| 108 | background: #FFF;
|
|---|
| 109 | border: 1px solid #BBB;
|
|---|
| 110 | padding: 05x;
|
|---|
| 111 | overflow: auto;
|
|---|
| 112 | }
|
|---|
| 113 |
|
|---|
| 114 | .ui-layout-resizer { /* all 'resizer-bars' */
|
|---|
| 115 | background: #DDD;
|
|---|
| 116 | top:100px
|
|---|
| 117 | }
|
|---|
| 118 |
|
|---|
| 119 | .ui-layout-toggler { /* all 'toggler-buttons' */
|
|---|
| 120 | background: #AAA;
|
|---|
| 121 | }
|
|---|
| 122 |
|
|---|
| 123 | </style><!--[if IE]>
|
|---|
| 124 | <link rel="stylesheet" type="text/css" href="../common/css/ie.css"/>
|
|---|
| 125 | <![endif]--><script type="text/javascript" src="common/browserDetect.js"></script><script type="text/javascript" src="common/jquery/jquery-1.7.2.min.js"></script><script type="text/javascript" src="common/jquery/jquery.ui.all.js"></script><script type="text/javascript" src="common/jquery/jquery.cookie.js"></script><script type="text/javascript" src="common/jquery/treeview/jquery.treeview.min.js"></script><script type="text/javascript" src="common/jquery/layout/jquery.layout.js"></script><script type="text/javascript" src="search/l10n.js"></script><script type="text/javascript" src="search/htmlFileInfoList.js"></script><script type="text/javascript" src="search/nwSearchFnt.js"></script><script type="text/javascript" src="search/stemmers/en_stemmer.js"><!--//make this scalable to other languages as well.--></script><script type="text/javascript" src="search/index-1.js"></script><script type="text/javascript" src="search/index-2.js"></script><script type="text/javascript" src="search/index-3.js"></script></head><body><noscript><div id="noscript">JavaScript is disabled on your browser. Please enable JavaScript to enjoy all the features of this site.</div></noscript><div id="header"><a href="index.html"><img style="margin-right: 2px; height: 59px; padding-right: 25px; padding-top: 8px" align="right" src="common/images/logo.png" alt=" Documentation"></img></a><h1>README: Web-based Help from DocBook XML<br></br> </h1><div id="navheader"><table class="navLinks"><tr><td><a id="showHideButton" href="#" onclick="myLayout.toggle('west')" class="pointLeft" tabindex="5" title="Hide TOC tree">Sidebar
|
|---|
| 126 | </a></td><td>
|
|---|
| 127 | |
|
|---|
| 128 | <a accesskey="n" class="navLinkNext" tabindex="5" href="ch01.html">Next</a></td></tr></table></div></div><div id="content"><div class="book"><div xmlns="" class="titlepage">
|
|---|
| 129 | <div>
|
|---|
| 130 | <div><h1 xmlns="http://www.w3.org/1999/xhtml" class="title"><a id="idm11949456"></a>README: Web-based Help from DocBook XML</h1></div>
|
|---|
| 131 | <div><div xmlns="http://www.w3.org/1999/xhtml" class="author"><h3 class="author"><span class="firstname">David</span> <span class="surname">Cramer</span></h3><code class="email"><<a class="email" href="mailto:david AT thingbag DOT net">david AT thingbag DOT net</a>></code></div></div>
|
|---|
| 132 | <div><div xmlns="http://www.w3.org/1999/xhtml" class="author"><h3 class="author"><span class="firstname">Kasun</span> <span class="surname">Gajasinghe</span></h3><code class="email"><<a class="email" href="mailto:kasunbg AT gmail DOT com">kasunbg AT gmail DOT com</a>></code></div></div>
|
|---|
| 133 | <div><p xmlns="http://www.w3.org/1999/xhtml" class="copyright">Copyright © 2008-2012 Kasun Gajasinghe, David Cramer</p></div>
|
|---|
| 134 | <div><div xmlns="http://www.w3.org/1999/xhtml" class="legalnotice"><a id="idp256"></a><p>Permission is hereby granted, free of charge, to any person obtaining a copy of this
|
|---|
| 135 | software and associated documentation files (the <span class="quote">“<span class="quote">Software</span>”</span>), to deal in the
|
|---|
| 136 | Software without restriction, including without limitation the rights to use, copy, modify,
|
|---|
| 137 | merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit
|
|---|
| 138 | persons to whom the Software is furnished to do so, subject to the following conditions: </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>The above copyright notice and this permission notice shall be included in all
|
|---|
| 139 | copies or substantial portions of the Software.</p></li><li class="listitem"><p>Except as contained in this notice, the names of individuals credited with
|
|---|
| 140 | contribution to this software shall not be used in advertising or otherwise to promote
|
|---|
| 141 | the sale, use or other dealings in this Software without prior written authorization
|
|---|
| 142 | from the individuals in question.</p></li><li class="listitem"><p>Any stylesheet derived from this Software that is publicly distributed will be
|
|---|
| 143 | identified with a different name and the version strings in any derived Software will
|
|---|
| 144 | be changed so that no possibility of confusion between the derived package and this
|
|---|
| 145 | Software will exist.</p></li></ul></div><p><strong>Warranty: </strong>THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
|
|---|
| 146 | INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
|
|---|
| 147 | PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL DAVID CRAMER, KASUN GAJASINGHE, OR ANY
|
|---|
| 148 | OTHER CONTRIBUTOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
|
|---|
| 149 | ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
|
|---|
| 150 | SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.</p><p>This package is maintained by Kasun Gajasinghe,
|
|---|
| 151 | <code class="email"><<a class="email" href="mailto:kasunbg AT gmail DOT com">kasunbg AT gmail DOT com</a>></code> and David Cramer,
|
|---|
| 152 | <code class="email"><<a class="email" href="mailto:david AT thingbag DOT net">david AT thingbag DOT net</a>></code> and with
|
|---|
| 153 | contributions by Arun Bharadwaj and Visitha Baddegama. Please
|
|---|
| 154 | direct support questions to the <a class="ulink" href="http://wiki.docbook.org/DocBookDiscussion" target="_top">DocBook-apps
|
|---|
| 155 | mailing list</a>. </p><p>This package also includes the following software written and copyrighted by others:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Files in <code class="filename">template/common/jquery</code> are
|
|---|
| 156 | copyrighted by <a class="ulink" href="http://jquery.com/" target="_top">JQuery</a> under the MIT License.
|
|---|
| 157 | The file <code class="filename">jquery.cookie.js</code> Copyright (c) 2006 Klaus Hartl under
|
|---|
| 158 | the MIT license.</p><a id="idp54848" class="indexterm"></a></li><li class="listitem"><p>Some files in the <code class="filename">template/search</code> and <code class="filename">indexer</code> directories were
|
|---|
| 159 | originally part of N. Quaine's htmlsearch DITA plugin.
|
|---|
| 160 | The htmlsearch DITA plugin is available from the <a class="ulink" href="http://tech.groups.yahoo.com/group/dita-users/files/Demos/" target="_top">files page</a> of the DITA-users yahoogroup. The
|
|---|
| 161 | htmlsearch plugin was released under a BSD-style
|
|---|
| 162 | license. See <code class="filename">indexer/license.txt</code>
|
|---|
| 163 | for details. <a id="idp59632" class="indexterm"></a>
|
|---|
| 164 | <a id="idp7584" class="indexterm"></a></p></li><li class="listitem"><p>Stemmers from the <a class="ulink" href="http://snowball.tartarus.org/texts/stemmersoverview.html" target="_top">Snowball
|
|---|
| 165 | project</a> released under a BSD license.</p></li><li class="listitem"><p>Code from the <a class="ulink" href="http://lucene.apache.org/" target="_top">Apache Lucene</a> search
|
|---|
| 166 | engine provides support for tokenizing Chinese, Japanese, and Korean content released
|
|---|
| 167 | under the Apache 2.0 license. </p></li><li class="listitem"><p>Code that provides weighted search results and some
|
|---|
| 168 | other improvements was graciously donated by <a class="ulink" href="http://www.oxygenxml.com" target="_top">SyncRO Soft
|
|---|
| 169 | Ltd.</a>, the publishers of the oXygen XML
|
|---|
| 170 | Editor.</p></li><li class="listitem"><p><a class="ulink" href="http://ccil.org/~cowan/XML/tagsoup/" target="_top">TagSoup</a>, released under the Apache 2.0
|
|---|
| 171 | license, makes it possible to index html instead of just
|
|---|
| 172 | xhtml output. </p></li><li class="listitem"><p>Cosmetic improvements provided by <a class="ulink" href="http://docs.openstack.org" target="_top">OpenStack</a>.</p></li></ul></div><p> Webhelp for DocBook was first developed as a <a class="ulink" href="http://code.google.com/soc/" target="_top">Google Summer of Code</a> project. </p></div></div>
|
|---|
| 173 | <div><p xmlns="http://www.w3.org/1999/xhtml" class="pubdate">January 2012</p></div>
|
|---|
| 174 | </div>
|
|---|
| 175 | <hr>
|
|---|
| 176 | </div>
|
|---|
| 177 | <div class="list-of-figures"><p><strong>List of Figures</strong></p><dl><dt>1. <a href="ch02s05.html#idp258048">Sample Image</a></dt></dl></div><div class="list-of-examples"><p><strong>List of Examples</strong></p><dl><dt>1. <a href="ch02s05.html#idp260752">Example code for adding images. Note down the relative path used</a></dt><dt>2. <a href="ch03s02s01.html#idp320496">Add new language to supportedLanguages array</a></dt><dt>3. <a href="ch03s02s01.html#idp327120">Initialize correct stemmer based on the
|
|---|
| 178 | <code class="code">webhelp.indexer.language</code> specified</a></dt></dl></div></div><script type="text/javascript" src="common/main.js"></script><script type="text/javascript" src="common/splitterInit.js"></script><div class="navfooter"><hr></hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch01.html">Next</a></td></tr></table></div></div><div id="sidebar"><div id="leftnavigation" style="padding-top:3px;"><div id="tabs"><ul><li><a href="#treeDiv" style="outline:0;" tabindex="1"><span class="contentsTab">Contents</span></a></li><li><a href="#searchDiv" style="outline:0;" tabindex="1" onclick="doSearch()"><span class="searchTab">Search</span></a></li></ul><div id="treeDiv"><img src="common/images/loading.gif" alt="loading table of contents..." id="tocLoading" style="display:block;"></img><div id="ulTreeDiv" style="display:none"><ul id="tree" class="filetree"><li><span class="file"><a href="ch01.html" tabindex="1">Introduction</a></span></li><li><span class="file"><a href="ch02.html" tabindex="1">Using the package</a></span><ul><li><span class="file"><a href="ch02s01.html" tabindex="1">Generating webhelp output using the Ant build.xml
|
|---|
| 179 | file</a></span></li><li><span class="file"><a href="ch02s02.html" tabindex="1">Using and customizing the output</a></span><ul><li><span class="file"><a href="ch02s02s01.html" tabindex="1">Recommended Apache configurations</a></span></li></ul></li><li><span class="file"><a href="ch02s03.html" tabindex="1">Search indexing</a></span></li><li><span class="file"><a href="ch02s04.html" tabindex="1">Adding support for other (non-CJKV) languages</a></span></li><li><span class="file"><a href="ch02s05.html" tabindex="1">Adding images</a></span></li></ul></li><li><span class="file"><a href="ch03.html" tabindex="1">Developer Docs</a></span><ul><li><span class="file"><a href="ch03s01.html" tabindex="1">Design</a></span></li><li><span class="file"><a href="ch03s02.html" tabindex="1">Search</a></span><ul><li><span class="file"><a href="ch03s02s01.html" tabindex="1">New Stemmers</a></span></li></ul></li></ul></li><li><span class="file"><a href="ch04.html" tabindex="1">FAQ</a></span></li><li><span class="file"><a href="ch05.html" tabindex="1">Test section</a></span><ul><li><span class="file"><a href="ch05s01.html" tabindex="1">Some search words for testing</a></span></li><li><span class="file"><a href="ch05s02.html" tabindex="1">Some search words for testing (inflected)</a></span></li></ul></li><li><span class="file"><a href="ix01.html" tabindex="1">Index</a></span></li></ul></div></div><div id="searchDiv"><div id="search"><form onsubmit="Verifie(searchForm);return false" name="searchForm" class="searchForm"><div><input id="textToSearch" name="textToSearch" type="search" placeholder="Search" class="searchText" tabindex="1"></input> <input onclick="Verifie(searchForm)" type="button" class="searchButton" value="Go" id="doSearch" tabindex="1"></input></div></form></div><div id="searchResults"><center></center></div><p class="searchHighlight"><a href="#" onclick="toggleHighlight()">Search Highlighter (On/Off)</a></p></div></div></div></div></body></html>
|
|---|
