Live data from Hacker News

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

nota-lang.org

101–110 of 217 posts

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

#101
post #92
post #83

Earlier quoted context omitted.

I understand your frustration. Maybe it helps to know where this problem comes from. TeX is extremely powerful and lets you create arbitrary documents. This is the first time I heard of quarto, but apparently it makes a lot of choices for you that you understandably don't really care about. Instead of developing quarto, one could have simply written a LaTeX class that defines a function like so: \newcommand{\image}[2…

> Instead of developing quarto, one could have simply written a LaTeX class that defines a function like so: If it's so simple, why isn't there QuarTeX that does all of that and removes the extreme verbosity barrier?

Because doing something like this is opinionated. The LaTeX developers try to do the opposite: they want to provide packages that cover as many usecases as possible.

And users of LaTeX are probably not knowledgeable enough or too busy to publish their opinionated subset of LaTeX as a class. I don't know for sure. There is no central body that has an interest in removing barriers, so you might as well ask me or yourself why I or you haven't published anything.

I developed something similar to this at my company, because we write lots of LaTeX documents and need shortcuts like this not only for brevity but also so that we achieve some consistency across the entire team. It's only for internal use though and thus not public.

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

#102
Give me an inverted IPython and I'll be happy. By inverted I mean: I write code and from time to time I want to document it with rich information (plots, equations, a bit more structured text). So I would love to have powerful comments in my regular code. I'm not much interested in bits of code in a single document.

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

#103
post #102

Give me an inverted IPython and I'll be happy. By inverted I mean: I write code and from time to time I want to document it with rich information (plots, equations, a bit more structured text). So I would love to have powerful comments in my regular code. I'm not much interested in bits of code in a single document.

a version of this idea in clojure in which a clojure namespace is rendered as an html page with notbook like primitives

https://github.clerk.garden/nextjournal/clerk-demo/commit/8a...

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

#104

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-…

Rust makes tremendous sense for this and I really like your borrowing syntax in Nota. Keep it up. This reminds me of MDX, another project I find inspiring and use a lot

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

#105
> The goal of Nota is to bring documents into the 21st century.

I think the modern approach might be to recognize that all readers are different, and that they would use an LLM to transform the document into the form that is suitable for a particular reader.

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

#106
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…

Makes me wonder if Nota did work with Rust, then we could move the dependencies into a cargo.toml file and compile our documents. That would enable declarative macros for document generation at compile time as well as interactive rust code inside your document at reading time. Plus you could refer to the dependencies by their package name like amsmath::line or something

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

#107
post #39

Why do we need a language that creates a text page by compiling to JS? the same set of goals are handled by AsciiDoc. Real publishers (eg Oreilly) use AsciiDoc as their input format to create books and websites.

asciidoc is my favourite too, thanks to Asciidoctor. I agree, asciidoc hits the sweet spots as a format. Been frustrated by the tooling lately though. I can see the huge effort put into Asciidoctor, and am thankful for it, but there are still big downsides i.e. no semantic html 5 output, difficult (or at least more difficult than necessary) integration with image generators, heavyweight (only ruby dependency on my entire machine). I imagine this just needs more time and resources put to it, as all these issues (except the ruby one) are open on GitHub.

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

#108
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…

It is needed. I hate reading pdfs on my 24" or 32" monitor. I hate reading them on my Phone. The main thing that my father complained about when switching from Blackberry to iPhone, was missing PDF reflow feature. Basically the only screen where I find pdfs comfortable to read, is on the 12.9" iPad, and only if the author has the same font-size preferences as me.

That is the main flaw of the PDF file format. It is by design.

If we want documents that work well on all screens, then we use EPUB.

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

#109
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…

And I don't agree with you.

Every time I can choose between PDF and EPUB, I choose EPUB.

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

#110
post #84

> 2. Why Nota? > Existing document tools like LaTeX, Pandoc, Markdown, and Scribble can (for the most part) only generate static web pages. I feel like Nota is underselling itself here, or at least not properly arguing for why a new language was created. If LaTeX were a perfectly fine document language, then surely we could extend e.g. Pandoc to provide these dynamic features when rendering LaTeX to a web page. But i…

I am not really sure about their description. Scribble is structured text that can be converted to whatever you want.

You could write scribble renderer that renders the document as a server that serves the document in parts over Ajax.

Post reply on HN