Commits

Anonymous committed 26203b6

Documentation updates.

Comments (0)

Files changed (2)

 http://www.docbook.org/[DocBook] documents (corresponding to the
 AsciiDoc 'article', 'book' and 'manpage' document types).
 
-DocBook documents are not designed to be viewed directly.  Most Linux
-distributions come with conversion tools (collectively called a
-toolchain) for <<X12,converting DocBook files>> to presentation
-formats such as Postscript, HTML, PDF, EPUB, DVI, PostScript, LaTeX,
-roff (the native man page format), HTMLHelp, JavaHelp and text.
+Most Linux distributions come with conversion tools (collectively
+called a toolchain) for <<X12,converting DocBook files>> to
+presentation formats such as Postscript, HTML, PDF, EPUB, DVI,
+PostScript, LaTeX, roff (the native man page format), HTMLHelp,
+JavaHelp and text.  There are also programs that allow you to view
+DocBook files directly, for example http://live.gnome.org/Yelp[Yelp]
+(the GNOME help viewer).
 
 [[X35]]
 XHTML Stylesheets
 commands to install, remove and list filter plugins.  Filter plugin
 commands and conventions are documented in the asciidoc(1) man page.
 You can find a list of filter plugins on the
-{website}filters[AsciiDoc website].
+{website}filters.html[AsciiDoc website].
 
 
 [[X12]]
 
   $ asciidoc -a data-uri -a icons -a toc -a max-width=55em article.txt
 
-You can view the HTML file here: {website}article-standalone.html
+You can view the HTML file here: {website}article-standalone.html[]
 
 Shipping stand-alone AsciiDoc source
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 == Are there any DocBook viewers?
 
 http://live.gnome.org/Yelp[Yelp], the GNOME help viewer, does a
-creditable job of displaying DocBook XML files directly. Just
-run it from the command-line, for example:
-
-  $ yelp file://home/srackham/tmp/book.xml
-
-Note that you have to supply the full path name in URI format, this
-shell script makes interactive use easier:
-
--------------------------------
-#!/bin/sh
-if [ -z "$1" ]; then
-    echo "usage: dbkview FILE"
-    exit 1
-fi
-yelp "file://$(pwd)/$1"
--------------------------------
-
-This tip was submitted by Lionel Orry.
+creditable job of displaying DocBook XML files directly.
 
 
 == Can you create ODF documents using AsciiDoc?