4 ms·

Sphinx/reStructuredText supports math in LaTeX input format [1], so you can still go nuts with complex math expressions while still benefitting from the relativ

Sphinx/reStructuredText supports math in LaTeX input format [1], so you can still go nuts with complex math expressions while still benefitting from the relative simplicity. [1] https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#math https://www.sphinx-doc.org/en/master/usage/restructuredtext/... Looks like AsciiDoc supports similar latex math blocks [2]. Are there reasons you can't stick with that when doing math? [2] https://docs.asciidoctor.org/asciidoc/latest/stem/#block https://docs.asciidoctor.org/asciidoc/latest/stem/#block

anta40 3y ago
For example: writing complicated expression invovling calculus/matrix. That's not something I need everyday, though.
- acidburnNSA 3y ago
  I have documented at least 10 x 10 matrices with rst math directives and found it to be pretty convenient. I don't understand what the benefit of pure latex is in this context.
  - westurner 3y ago
    pandas.DataFrame().to_latex() [1] and tabulate [2] support latex table output. [1] https://pandas.pydata.org/docs/reference/api/pandas.DataFrame.to_latex.html https://pandas.pydata.org/docs/reference/api/pandas.DataFram... [2] https://github.com/astanin/python-tabulate/blob/master/tabulate/__init__.py#L608 https://github.com/astanin/python-tabulate/blob/master/tabul...
westurner 3y ago
Sphinx supports ReStructuredText and Markdown. MyST-Markdown supports MathJaX and Sphinx roles and directives. https://myst-parser.readthedocs.io/en/latest/ https://myst-parser.readthedocs.io/en/latest/ jupyter-book supports ReStructuredText, Jupyter Notebooks, and MyST-Markdown documents: You can build Sphinx and Jupyter-Book projects with the ReadTheDocs container, which already has LaTeX installed: https://github.com/executablebooks/jupyter-book/issues/991 https://github.com/executablebooks/jupyter-book/issues/991 myst-templates/plain_latex_book: https://github.com/myst-templates/plain_latex_book/blob/main/template.tex https://github.com/myst-templates/plain_latex_book/blob/main... GitHub supports AsciiDoc in repos and maybe also wikis? Is there a way to execute code in code blocks in AsciiDoc, and include the output? latex2sympy requires ANTLR.

anta40 3y ago

For example: writing complicated expression invovling calculus/matrix. That's not something I need everyday, though.

acidburnNSA 3y ago
I have documented at least 10 x 10 matrices with rst math directives and found it to be pretty convenient. I don't understand what the benefit of pure latex is in this context.
- westurner 3y ago
  pandas.DataFrame().to_latex() [1] and tabulate [2] support latex table output. [1] https://pandas.pydata.org/docs/reference/api/pandas.DataFrame.to_latex.html https://pandas.pydata.org/docs/reference/api/pandas.DataFram... [2] https://github.com/astanin/python-tabulate/blob/master/tabulate/__init__.py#L608 https://github.com/astanin/python-tabulate/blob/master/tabul...

westurner 3y ago

Sphinx supports ReStructuredText and Markdown. MyST-Markdown supports MathJaX and Sphinx roles and directives. https://myst-parser.readthedocs.io/en/latest/ https://myst-parser.readthedocs.io/en/latest/ jupyter-book supports ReStructuredText, Jupyter Notebooks, and MyST-Markdown documents: You can build Sphinx and Jupyter-Book projects with the ReadTheDocs container, which already has LaTeX installed: https://github.com/executablebooks/jupyter-book/issues/991 https://github.com/executablebooks/jupyter-book/issues/991 myst-templates/plain_latex_book: https://github.com/myst-templates/plain_latex_book/blob/main/template.tex https://github.com/myst-templates/plain_latex_book/blob/main... GitHub supports AsciiDoc in repos and maybe also wikis? Is there a way to execute code in code blocks in AsciiDoc, and include the output? latex2sympy requires ANTLR.