21.1 HTML Translation

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…).