diff options
author | Stuart Rackham <srackham@methods.co.nz> | 2012-12-31 12:43:15 +1300 |
---|---|---|
committer | Stuart Rackham <srackham@methods.co.nz> | 2012-12-31 12:43:15 +1300 |
commit | 5966d642451a5233e5440ec2c250e681adab2bbb (patch) | |
tree | 5deeff48cd0c2e8c82c37990079efc184ec09fa6 /doc/faq.txt | |
parent | 3f562b6c28c40bbbd9c4142828a6fce851f96040 (diff) | |
download | asciidoc-git-5966d642451a5233e5440ec2c250e681adab2bbb.tar.gz |
Added an FAQ.
Diffstat (limited to 'doc/faq.txt')
-rw-r--r-- | doc/faq.txt | 16 |
1 files changed, 16 insertions, 0 deletions
diff --git a/doc/faq.txt b/doc/faq.txt index 0e3cccf..642691e 100644 --- a/doc/faq.txt +++ b/doc/faq.txt @@ -1365,3 +1365,19 @@ http://redcloth.org/textile[textile], http://www.w3.org/TR/html40/[HTML], http://www.docbook.org/[DocBook], or http://www.latex-project.org/[LaTeX] to AsciiDoc. + +== How can I insert raw HTML in a document processed by a2x? +`a2x` generates HTML via DocBook (DocBook XSL Stylesheets) so if you +use a passthrough block it must contain DocBook (not HTML). +Fortunately DocBook XSL Stylesheets has a +http://www.sagehill.net/docbookxsl/InsertExtHtml.html[dbhtml-include +processing instruction] which will inlcude a file containing raw HTML +into the generated HTML output. For example: + +--------------------------------------------------------------- +++++ +<?dbhtml-include href="snippet.html"?> +++++ +--------------------------------------------------------------- + + |