`` tags into
```` tags that wrap the complete Agda code
block below
- generating files with extension as-is (i.e. `.lagda.md` becomes
`.md`, `.lagda.rst` becomes `.rst`)
- for reStructuredText, a ``.. raw:: html`` will be inserted
before every code blocks
This will affect all the files involved in one compilation, making
pure Agda code files rendered without HTML footer/header as well.
To use ``code`` with literate Agda files and ``all`` with pure Agda
files, use ``--html-highlight=auto``, which means auto-detection.
Options
-------
:option:`--html`
Generate HTML files with highlighted source code.
.. option:: --html-dir={DIR}
Set directory in which HTML files are placed to ``DIR``
(default: ``html``).
.. option:: --html-highlight=[code,all,auto]
.. versionadded:: 2.6.0
Whether to highlight non-Agda code as comments in generated HTML
files (default: ``all``).
.. option:: --css={URL}
Set URL of the CSS_ file used by the HTML files to ``URL``
(can be relative).
.. option:: --highlight-occurrences
.. versionadded:: 2.6.2
When :ref:`generating HTML `,
place the :file:`highlight-hover.js` script
in the output directory (see :option:`--html-dir`).
In the presence of the script,
hovering over an identifier in the rendering of the HTML
will highlight all occurrences of the same identifier on the page.
.. _CSS: https://www.w3.org/Style/CSS/