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 | 025404d7e35690fb26b0c13b9a044fa44f87f141 (patch) | |
tree | 5deeff48cd0c2e8c82c37990079efc184ec09fa6 | |
parent | 3d6f9176a673bb7f2d62d6729759e83fee6eab4a (diff) | |
download | asciidoc-025404d7e35690fb26b0c13b9a044fa44f87f141.tar.gz |
Added an FAQ.
-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"?> +++++ +--------------------------------------------------------------- + + |