The HTML generated by texi2any
generates standard HTML
output. The output is intentionally quite plain for maximum portability
and accessibility.
You can customize the output via CSS (see HTML CSS) or other means (see Customization Variables). If you cannot accomplish a reasonable customization, feel free to report that.
Navigation bar: By default, a navigation bar is inserted at the
start of each node, analogous to Info output. If the
‘--no-headers’ option is used, the navigation bar is only
inserted at the beginning of split files. Header <link>
elements
in split output support Info-like navigation with browsers which implement
this feature.
Raw HTML: texi2any
will include segments of Texinfo
source between @ifhtml
and @end ifhtml
in the HTML
output (but not any of the other conditionals, by default). Source
between @html
and @end html
is passed without change
to the output (i.e., suppressing the normal escaping of input
‘<’, ‘>’ and ‘&’ characters which have special
significance in HTML). See Conditional Commands.
Standards: It is intentionally not our goal, and not even always possible, to pass through every conceivable validation test without any diagnostics. Different validation tests have different goals, often about pedantic enforcement of some standard or another. Our overriding goal is to help users, not blindly comply with standards.
Please report output from an
error-free run of texi2any
which has practical browser
or EPUB reader portability problems as a bug (see Reporting Bugs).
In practice, the HTML produced by texi2any
is slowly adjusted
over time towards the latest HTML standard, while also trying to keep
compatibility with earlier produced HTML. We use transitional markup
and try to be slow enough to give time for the diverse HTML readers
to adjust (and for standards to reincorporate useful features that were
dropped…).