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
See Chunking into - multiple HTML files in Bob Stayton's DocBook XSL: The - Complete Guide for information on controlling output file - names and which files are chunked in DocBook.
When you perform a search, the results can include brief - summaries. These are populated in one of two ways:
By adding
role="summary"
to a -para
orphrase
in the -chapter
orsection
.By adding an
abstract
to the -chapterinfo
orsectioninfo
- element.
To customize the look and feel of the help, study the following - css files:
docs/common/css/positioning.css
: This - handles the Positioning of DIVs in appropriate positions. For - example, it causes theleftnavigation
div to appear - on the left, the header on top, and so on. Use this if you need to - change the relative positions or need to change the width/height - etc.docs/common/jquery/theme-redmond/jquery-ui-1.8.2.custom.css
: - This is the theming part which adds colors and stuff. This is a - default theme comes with jqueryui 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.docs/common/jquery/treeview/jquery.treeview.css
: - This styles the toc Tree. Generally, you don't have to edit this - file.
If you are serving a long document from an Apache web server, we
- recommend you make the following additions or changes to your
- httpd.conf
or .htaccess
- file. TODO: Explain what each thing
- does.
AddDefaultCharSet UTF-8 # - - # 480 weeks - <FilesMatch "\.(ico|pdf|flv|jpg|jpeg|png|gif|js|css|swf)$"> # - Header set Cache-Control "max-age=290304000, public" - </FilesMatch> - - # 2 DAYS - <FilesMatch "\.(xml|txt)$"> - Header set Cache-Control "max-age=172800, public, must-revalidate" - </FilesMatch> - - # 2 HOURS - <FilesMatch "\.(html|htm)$"> - Header set Cache-Control "max-age=7200, must-revalidate" - </FilesMatch> - - # compress text, html, javascript, css, xml: - AddOutputFilterByType DEFLATE text/plain # - AddOutputFilterByType DEFLATE text/html - AddOutputFilterByType DEFLATE text/xml - AddOutputFilterByType DEFLATE text/css - AddOutputFilterByType DEFLATE application/xml - AddOutputFilterByType DEFLATE application/xhtml+xml - AddOutputFilterByType DEFLATE application/rss+xml - AddOutputFilterByType DEFLATE application/javascript - AddOutputFilterByType DEFLATE application/x-javascript - - # Or, compress certain file types by extension: - <Files *.html> - SetOutputFilter DEFLATE - </Files> -
See Odd - characters in HTML output in Bob Stayton's book - DocBook XSL: The Complete Guide for more - information about this setting. | |
These lines and those that follow cause the browser to - cache various resources such as bitmaps and JavaScript files. - Note that caching JavaScript files could cause your users to - have stale search indexes if you update your document since the - search index is stored in JavaScript files. | |
These lines cause the the server to compress html, css, - and JavaScript files and the brower to uncompress them to - improve download performance. |