HTML generator

A complete HTML page can be generated, with register details as well as textual description of the different register modes. This is done by using the HtmlPageGenerator class e.g. like this:

Python code that parses the example TOML file and generates the HTML code we need.

import sys
from pathlib import Path

from hdl_registers.generator.html.constant_table import HtmlConstantTableGenerator
from hdl_registers.generator.html.page import HtmlPageGenerator
from hdl_registers.generator.html.register_table import HtmlRegisterTableGenerator
from hdl_registers.parser.toml import from_toml

THIS_DIR = Path(__file__).parent


def main(output_folder: Path) -> None:
    """
    Create register HTML artifacts from the TOML example file.
    """
    register_list = from_toml(
        name="example",
        toml_file=THIS_DIR.parent.parent / "user_guide" / "toml" / "toml_format.toml",
    )

    HtmlPageGenerator(register_list=register_list, output_folder=output_folder).create()
    HtmlRegisterTableGenerator(register_list=register_list, output_folder=output_folder).create()
    HtmlConstantTableGenerator(register_list=register_list, output_folder=output_folder).create()


if __name__ == "__main__":
    main(output_folder=Path(sys.argv[1]))

A HTML page generated from the TOML format example can be viewed here: example_regs.html

Note

Any reStructuredText (RST) code in description fields will be converted to HTML. See the HTML file above for an example of this.

Tables only

Optionally, only the tables with register and constant descriptions can be generated to HTML, using the HtmlRegisterTableGenerator and HtmlConstantTableGenerator classes. These can be included in a separate documentation flow.

Generated HTML file here: example_register_table.html

Generated HTML file here: example_constant_table.html