Source code for httk.serve.web.renderers.markdown

"""Render Markdown source files and extract standalone widget paragraphs."""

from pathlib import Path

import markdown

from httk.serve.web.widgets.extraction import markdown_source

from ._frontmatter import split_front_matter
from .base import RenderResult




class MarkdownRenderer:
    """Render Markdown source files."""



    def render(self, source_path: Path) -> RenderResult:
        """Render one Markdown source file.

        :param source_path: Markdown source file to render.
        :return: Rendered HTML, metadata, and widget placements.
        """
        source = source_path.read_text(encoding="utf-8")
        metadata, body = split_front_matter(source)
        frontmatter_lines = len(source.splitlines()) - len(body.splitlines())
        widget_source, widgets = markdown_source(body, source_path, line_offset=frontmatter_lines)

        html = markdown.markdown(
            widget_source,
            output_format="html",
            extensions=["fenced_code", "codehilite", "tables"],
        )

        return RenderResult(html=html, metadata=dict(metadata), widgets=widgets)