We want to generate HTML pages from the notebooks that will be hosted in this repository. Three options for doing so:
myst-nb (Sphinx ecosystem, Python-based): this is what almost all ComPWA repos use so far. Highly flexible and works well with generating an API for a Python library, which you may want to do for this repo at some stage. Disadvantage: not so user friendly.
Quarto: see e.g. RUB-EP1/amplitude-serialization#25. Very user friendly, also works well with text-based notebooks (.qmd) with good VSCode support. Everything is configured through a _quarto.yml though, which doesn't leave much control.
MyST Markdown (mystmd, JS-based): similar to Quarto, but using the same Markdown flavour as myst-nb.
We want to generate HTML pages from the notebooks that will be hosted in this repository. Three options for doing so:
myst-nb
(Sphinx ecosystem, Python-based): this is what almost all ComPWA repos use so far. Highly flexible and works well with generating an API for a Python library, which you may want to do for this repo at some stage. Disadvantage: not so user friendly..qmd
) with good VSCode support. Everything is configured through a_quarto.yml
though, which doesn't leave much control.mystmd
, JS-based): similar to Quarto, but using the same Markdown flavour asmyst-nb
.