summaryrefslogtreecommitdiff
path: root/doc/faq.txt
diff options
context:
space:
mode:
authorStuart Rackham <srackham@methods.co.nz>2010-08-07 08:35:07 +1200
committerStuart Rackham <srackham@methods.co.nz>2010-08-07 08:35:07 +1200
commit2c342e435985099b5c43978196bcbc97063186d7 (patch)
tree3cd58c28da8a0f3577dedb24b25993bce521ac9f /doc/faq.txt
parente833a967d4c49888632f841c66f6a3fcb182716c (diff)
downloadasciidoc-git-2c342e435985099b5c43978196bcbc97063186d7.tar.gz
FAQ and documentation updates.
Diffstat (limited to 'doc/faq.txt')
-rw-r--r--doc/faq.txt11
1 files changed, 11 insertions, 0 deletions
diff --git a/doc/faq.txt b/doc/faq.txt
index 9f1ea0c..c81061a 100644
--- a/doc/faq.txt
+++ b/doc/faq.txt
@@ -9,6 +9,17 @@ AsciiDoc Frequently Asked Questions
newer FAQs may apply to the trunk and not the current release.
======
+== How can I customize the appearance of XHTML and EPUB documents generated by a2x?
+By default, 'a2x' includes your distribution's
+`stylesheets/docbook-xsl.css` CSS file in 'xhtml' and 'epub' outputs.
+Use the `--stylesheet` and `-r, --resource-dir` command-line options
+to specify an alternative stylesheet. The following example
+recursively searches the `resources` directory for `book-style.css`
+and includes it in the output `doc/book.epub` 'EPUB' file:
+
+ a2x -f epub -d book -r resources --stylesheet book-style.css doc/book.txt
+
+
== DocBook has many elements for document meta-data -- how can I use them from AsciiDoc?
If the 'docinfo' attribute is defined then AsciiDoc looks for a file
named like the source file but ending in `-docinfo.xml` and includes