Documentation Generation with Sphinx

[mardiros]

I've made some work to build a documentation from my JinjaX libraries.

Maybe it could be interesting than some part of the code be in the JinjaX library directly.

I override some JinjaX classes to get component inspectable and build an autodoc plugin for sphinx.

Here is the code I write to get my component inspectable, and it produce docstrings

https://github.com/mardiros/fastlife/blob/main/src/fastlife/templating/renderer/jinjax.py

.. jinjax:component:: A(href: str,  hx_target: str = '#maincontent',  hx_select: str | None = None)

    Create html `<a>` node with htmx support by default.
    The `hx-get` parameter is set with the href directly unless the
    `disabled-htmx` attribute has been set.

    :param href: target link
    :param hx_target:
    :param hx_select:

Here is the code that read that documentation to produce html documentation using sphinx

https://github.com/mardiros/fastlife/blob/main/docs/source/jinjax_doc.py

Here is how it is rendered:

https://mardiros.github.io/fastlife/components/A.html

Could I made a contribution to get some code directly in JinjaX ?