Live data from Hacker News

Nota is a language for writing documents, like academic papers and blog posts

nota-lang.org

61–70 of 217 posts

Re: Nota is a language for writing documents, like academic papers and blog posts

#61

Hi, Nota creator here. A high-level comment: After developing the initial prototype you see in the webpage, I've since gone back to the drawing board. I'm working on developing a firmer foundation for issues like: - How do you interleave content and computation? See: https://arxiv.org/abs/2310.04368 - How do different syntaxes make different document tasks easy, hard, or impossible? See: https://github.com/cognitive-…

Looks amazing that typst!!

Re: Nota is a language for writing documents, like academic papers and blog posts

#62
post #57

Hi, Nota creator here. A high-level comment: After developing the initial prototype you see in the webpage, I've since gone back to the drawing board. I'm working on developing a firmer foundation for issues like: - How do you interleave content and computation? See: https://arxiv.org/abs/2310.04368 - How do different syntaxes make different document tasks easy, hard, or impossible? See: https://github.com/cognitive-…

Just my two cents - Not sure the language you choose matters as much as making the API usable by a wide audience. Sure if performance is a real issue then rust makes more sense than JS but I’m not sure that’s going to be hugely meaningful in most use cases. I’ve never been a fan of Latex despite writing some mammoth documents over the years. Latex always felt like a beast for academics not for business. Yet there’s o…

Surprised more legal docs aren’t tracked like git, with pull requests

Re: Nota is a language for writing documents, like academic papers and blog posts

#63

I was just thinking about what the easiest way would be to create a blog with mostly static content but with room for interactive graphs or arbitrary customization if i want it. Is this a good option? Another option I saw was Quarto [1]. Maybe even a simple static site blog like Jekyll can be used as well where i just edit the output HTML as needed? What do you all recommend? [1] https://quarto.org/

I use XHTML, mixed with a little custom XML, and processing with XSLT to produce final XHTML [1]: all of HTML is usable that way, the generation process is customizable, the dependencies are relatively easily manageable, the involved formats are standardized.

[1] https://git.uberspace.net/homepage/

Re: Nota is a language for writing documents, like academic papers and blog posts

#64

Hi, Nota creator here. A high-level comment: After developing the initial prototype you see in the webpage, I've since gone back to the drawing board. I'm working on developing a firmer foundation for issues like: - How do you interleave content and computation? See: https://arxiv.org/abs/2310.04368 - How do different syntaxes make different document tasks easy, hard, or impossible? See: https://github.com/cognitive-…

Can I make a simple point?

As an academic, 99% of my time is spent doing two things:

1. Writing statistical computations using a language like R or python.

2. Writing English text.

The most important thing about a document language is that it should prioritize those things. For example, here's why Rmarkdown/Quarto is better than TeX. A TeX document starts:

    \documentclass[12pt,a4paper]{article}
    \usepackage{amsmath}
    \usepackage{amsthm}
    \usepackage{geometry}
    \usepackage{enumitem}
    \setitemize{noitemsep}
    \usepackage{tabularx}
    \usepackage{setspace}
    \newcolumntype{x}{>{\centering\arraybackslash}X}

    \newtheorem{theo}{Theorem}
    \newtheorem{prop}[theo]{Proposition}
    \newtheorem{lemma}{Lemma}

    \usepackage{fontspec,xunicode}
    \defaultfontfeatures{Mapping=tex-text}
    \setsansfont{TeX Gyre Heros}
A quarto document starts:

    ---
    title: "Natural selection in the Health and Retirement Study"
    author: "XXX"
    abstract: |
      I investigate natural selection on polygenic scores
      in the contemporary US, using the Health and Retirement       
      Study. Results
      partially support the economic theory of fertility as
      an explanation for natural selection: among both white 
      and black respondents,
      scores which correlate negatively (positively) with education are
      selected for (against). Selection coefficients are
      larger among low-income
      and unmarried parents, but not among younger parents or those with less 
      education. I also estimate effect sizes corrected for noise in the 
      polygenic scores. 
    date: "September 2023"
You see the difference in emphasis.

Re: Nota is a language for writing documents, like academic papers and blog posts

#65
post #26

Earlier quoted context omitted.

> I actually don't agree with this. I think _not_ having "essential dynamism" where it's not needed is actually a feature, not a bug. I couldn't agree more. Dynamism is great for web _apps_, but it's the last thing I want in a document

OK but then what is the thing in the middle, between documents and applications? There are fantastic, beautiful interactive experiences (for lack of a better word) that are obviously not documents (they can't be represented on paper, there is code running) but they're not really applications, either (they are fully offline, self-contained, state that's only evident on the page). But they are, universally: dynamic. Ex…

Some of these interactive simulations for learning are called “Explorable Explanations” [1], coined in 2011 by Bret Victor, the author of your second link (worrydream.com), which also talks about “Explorable Explanations”.

For more examples, see [2].

Very much agree that this is what explanations and presentations should be in the modern age. I think a documentation language (what Nota and Typst aim to be) is still needed in this age of Large Language Models, when the ideas are more complex than those expressible by natural languages.

[1]: https://en.wikipedia.org/wiki/Explorable_explanation

[2]: https://explorabl.es/

Re: Nota is a language for writing documents, like academic papers and blog posts

#66

Hi, Nota creator here. A high-level comment: After developing the initial prototype you see in the webpage, I've since gone back to the drawing board. I'm working on developing a firmer foundation for issues like: - How do you interleave content and computation? See: https://arxiv.org/abs/2310.04368 - How do different syntaxes make different document tasks easy, hard, or impossible? See: https://github.com/cognitive-…

Looks amazing that typst!!

What are the similarities and differences between it and quarto?

Re: Nota is a language for writing documents, like academic papers and blog posts

#68
post #4

> There are two main mediums for digital documents: PDFs and web pages. PDFs were designed to mirror physical documents, so they impose the real-world constraints of paper: page breaks, fixed width, and immutable styling. Web pages, by contrast, provides an essential dynamism. Web pages are undeniably the future of digital documents. I actually don't agree with this. I think _not_ having "essential dynamism" where it…

> Web pages are undeniably the future of digital documents.

It used to be. But not anymore. Web browser + js are too bloat for any serious documentation usage.

Re: Nota is a language for writing documents, like academic papers and blog posts

#69
post #57

Earlier quoted context omitted.

Just my two cents - Not sure the language you choose matters as much as making the API usable by a wide audience. Sure if performance is a real issue then rust makes more sense than JS but I’m not sure that’s going to be hugely meaningful in most use cases. I’ve never been a fan of Latex despite writing some mammoth documents over the years. Latex always felt like a beast for academics not for business. Yet there’s o…

Surprised more legal docs aren’t tracked like git, with pull requests

Cause git ain’t user friendly enough for lawyers and they use word not a plain text editor which doesnt make it easy to see the diffs. But yes ;)

Re: Nota is a language for writing documents, like academic papers and blog posts

#70
post #64

Hi, Nota creator here. A high-level comment: After developing the initial prototype you see in the webpage, I've since gone back to the drawing board. I'm working on developing a firmer foundation for issues like: - How do you interleave content and computation? See: https://arxiv.org/abs/2310.04368 - How do different syntaxes make different document tasks easy, hard, or impossible? See: https://github.com/cognitive-…

Can I make a simple point? As an academic, 99% of my time is spent doing two things: 1. Writing statistical computations using a language like R or python. 2. Writing English text. The most important thing about a document language is that it should prioritize those things. For example, here's why Rmarkdown/Quarto is better than TeX. A TeX document starts: \documentclass[12pt,a4paper]{article} \usepackage{amsmath} \u…

I don't get the problem. If 99% of your documents need the same packages and formatting, then all you need to do in LaTeX is create a template (eg via Yasnippet in Emacs) or dump it all in a LaTeX class file and then import it in your frontmatter, and Bob's your uncle. There are many frustrating things about LaTeX but I don't see how this is one of them.
Post reply on HN