Source code for pyexlatex.logic.output.api.builders.htlatex

import pathlib
from typing import Sequence

from pyexlatex.logic.output.api.builders.base import BaseBuilder


class HTLatexBuilder(BaseBuilder):
    """A simple htlatex-based builder for LaTeX files to generate HTML from LaTeX.

    Builds LaTeX files by copying them to a temporary directly and running
    ``htlatex`` until the associated ``.aux`` file stops changing.

    :param executable: The path to the ``htlatex`` binary (will looked up on
                    ``$PATH``).
    :param max_runs: An integer providing an upper limit on the amount of times
                     ``htlatex`` can be rerun before an exception is thrown.
    """
    output_extension = 'html'
    default_executable = 'make4ht'
    pre_file_output_args: Sequence[str] = ('--lua', '--shell-escape', '--utf8')
    post_file_output_args: Sequence[str] = tuple()

    def _pre_compile(self, temp_dir: str, base_file_name: str):
        config_contents = """
settings_add{ tex4ht_sty_par =  "html,css-in" }
Make:htlatex()
Make:htlatex()
Make:htlatex()
        """.strip()
        out_path = pathlib.Path(temp_dir) / f'{base_file_name}.mk4'
        out_path.write_text(config_contents)