4 ms·

I guess latex is still unbeatable for writing complex math expressions. These days, when I don't need that, I'm happy with AsciiDoc.

by anta40 3y ago

acidburnNSA 3y ago
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.
chaxor 3y ago
Typst. Typst is better IMO
- jamiedumont 3y ago
  As a certified grumpy old developer I spent years writing off the "X but in Rust" projects, but I have to confess that a lot of good things with meaningful improvements have come from the rewrite-everything-in-Rust movement. I've not used Typst and not authored much LaTeX (but worked on a project with a group of scientists who used nothing but LaTeX) and can see obvious advantages to Typst. Same with many, many other Rust libraries.
  - kuschkufan 3y ago
    So funny to me that people assume, oh it's written in Rust, so it must be a rewrite of something else just so they can use Rust. They never imagine that people choose Rust for something they want to implement anyway and not just to replicate something existing, that they do not want to use since it's not implemented in Rust????
    - jamiedumont 3y ago
      Oh I know there's loads of original Rust work, but you have to acknowledge that the "X, but in Rust" trope exists.
      - reaperman 3y ago
        Yep even as a big fan of it...it's definitely a trope. And one that's very easy to either dismiss or make fun of. It would be a bit strange for fans to feel defensiveness or denial over that.
  - avgcorrection 3y ago
    jamiedumont let out a rambonctious laugh to himself. - Ah, you got me good you meddling kids! jamiedumont was talking to himself again. hackerbod slowly leaned over and squinted at the screen. - Uh Typst? - Yeah! It’s a typesetting markup language. It’s supposed to be better than things like latex. - Ok. What’s so funny about it? - Oh hehe, it’s written in—guess what? - I dunno? - Rust! jamiedumont started giggling but hackerbod remained neutrally unamused. - Oh come on! Rewrite in Rust? Language zealots? Young adults who can’t program without some Ruby syntax sprinkled in? - So this “typt” thing— - Typst. - Right, Typst, this typesetting thing was created to promote Rust in some way? - Oh I don’t think so. - It doesn’t mention Rust on the homepage or something? You know, Written in Rust? - Nope. Not to my recollection. - So is it a rewrite of something else in— - Nope. - So then what does that have to do with— - Ah, but you’re missing the bigger picture, hackerbod. - Ok. - Year after year of this eye-rolling promotion and nagging, blah blah blah memory unsafety is bad, blah blah this is why we used angle brackets for generics, and these sly bastards went and pulled off the most epic Trojan Horse that I’ve ever seen been— - And what’s that? - They made an actually useful language! hackerbod had to scoot back as jamiedumont fell off his swivel chair because he was laughing so hard. hackerbod scratched his head. jamiedumont finally recovered from the ab-induced euphoria. - Ah hackerbod, I hate to admit it but they got me good! Those cursed language zealots got one over on me!
bobbylarrybobby 3y ago
Asciidoc supports math blocks, and there's an extension to render them at compile time

I guess latex is still unbeatable for writing complex math expressions. These days, when I don't need that, I'm happy with AsciiDoc.

by anta40 3y ago

I guess latex is still unbeatable for writing complex math expressions. These days, when I don't need that, I'm happy with AsciiDoc.

acidburnNSA 3y ago

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.

chaxor 3y ago

Typst. Typst is better IMO

jamiedumont 3y ago
As a certified grumpy old developer I spent years writing off the "X but in Rust" projects, but I have to confess that a lot of good things with meaningful improvements have come from the rewrite-everything-in-Rust movement. I've not used Typst and not authored much LaTeX (but worked on a project with a group of scientists who used nothing but LaTeX) and can see obvious advantages to Typst. Same with many, many other Rust libraries.
- kuschkufan 3y ago
  So funny to me that people assume, oh it's written in Rust, so it must be a rewrite of something else just so they can use Rust. They never imagine that people choose Rust for something they want to implement anyway and not just to replicate something existing, that they do not want to use since it's not implemented in Rust????
  - jamiedumont 3y ago
    Oh I know there's loads of original Rust work, but you have to acknowledge that the "X, but in Rust" trope exists.
    - reaperman 3y ago
      Yep even as a big fan of it...it's definitely a trope. And one that's very easy to either dismiss or make fun of. It would be a bit strange for fans to feel defensiveness or denial over that.
- avgcorrection 3y ago
  jamiedumont let out a rambonctious laugh to himself. - Ah, you got me good you meddling kids! jamiedumont was talking to himself again. hackerbod slowly leaned over and squinted at the screen. - Uh Typst? - Yeah! It’s a typesetting markup language. It’s supposed to be better than things like latex. - Ok. What’s so funny about it? - Oh hehe, it’s written in—guess what? - I dunno? - Rust! jamiedumont started giggling but hackerbod remained neutrally unamused. - Oh come on! Rewrite in Rust? Language zealots? Young adults who can’t program without some Ruby syntax sprinkled in? - So this “typt” thing— - Typst. - Right, Typst, this typesetting thing was created to promote Rust in some way? - Oh I don’t think so. - It doesn’t mention Rust on the homepage or something? You know, Written in Rust? - Nope. Not to my recollection. - So is it a rewrite of something else in— - Nope. - So then what does that have to do with— - Ah, but you’re missing the bigger picture, hackerbod. - Ok. - Year after year of this eye-rolling promotion and nagging, blah blah blah memory unsafety is bad, blah blah this is why we used angle brackets for generics, and these sly bastards went and pulled off the most epic Trojan Horse that I’ve ever seen been— - And what’s that? - They made an actually useful language! hackerbod had to scoot back as jamiedumont fell off his swivel chair because he was laughing so hard. hackerbod scratched his head. jamiedumont finally recovered from the ab-induced euphoria. - Ah hackerbod, I hate to admit it but they got me good! Those cursed language zealots got one over on me!

bobbylarrybobby 3y ago

Asciidoc supports math blocks, and there's an extension to render them at compile time