You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
32 lines
1.2 KiB
32 lines
1.2 KiB
4 years ago
|
////
|
||
|
|
== XHTML
|
||
|
|
This document is included in convert-documents and the user-manual.
|
||
|
|
////
|
||
|
|
|
||
|
|
To convert AsciiDoc to XHTML, set the backend to `xhtml5`.
|
||
|
|
|
||
|
|
.Produce XHTML using the built-in HTML converter
|
||
|
|
[source,console]
|
||
|
|
----
|
||
|
|
asciidoctor -b xhtml5 document.adoc
|
||
|
|
----
|
||
|
|
|
||
|
|
To produce XHTML instead of HTML when using converter templates, set the `htmlsyntax` attribute to `xml` in addition to the backend option:
|
||
|
|
|
||
|
|
.Produce XHTML using custom templates
|
||
|
|
[source,console]
|
||
|
|
----
|
||
|
|
asciidoctor -T /path/to/templates -b slides -a htmlsyntax=xml document.adoc
|
||
|
|
----
|
||
|
|
|
||
|
|
.Black Box Decoded: XHTML and htmlsyntax
|
||
|
|
****
|
||
|
|
XHTML output is a special mode of the built-in HTML5 converter.
|
||
|
|
It is activated by prefixing the backend value with `x` (e.g., `xhtml` or `xhtml5`).
|
||
|
|
This hint implicitly assigns the `htmlsyntax` attribute to the value `xml`, which normally has the value `html`.
|
||
|
|
|
||
|
|
For all other converters, the `htmlsyntax` attribute is not set explicitly.
|
||
|
|
If you want a converter template that's written in Slim or Haml to output XHTML instead of the default HTML, you simply need to set the `htmlsyntax` attribute to `xml` explicitly.
|
||
|
|
Asciidoctor will pass on this preference to the Slim or Haml template engine by setting the `:format` option to `:html5`.
|
||
|
|
****
|