Documents contain a lot of structure — for example, "Nota" is a reference to a term defined in the preceding paragraph. Nota enables authors to represent that structure, which allows the reading medium (the browser) to understand that structure, which in turn empowers readers to use that structure. Try clicking on any "Nota" reference to see this idea in action. (Then try double-clicking!)
Then you can build a single Nota document by running these shell commands:
You can interactively edit a Nota file by running the Nota editor, like so:
Nota is a new and evolving technology. The architecture and API are continually changing. Tooling will have bugs and missing features. Documentation will be incomplete or incorrect. Right now, I am seeking early adopters that want to help make Nota the document language of the future.
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 can be dynamically formatted: resized for phones, translated into other languages, colors changed for color-blindness. Web pages can be dynamically interactive: text prompted for more context, diagrams shifted for a new perspective, annotations added for posterity. Web pages are undeniably the future of digital documents.
But currently, that dynamism is only accessible to professional web developers. Existing document tools like LaTeX, Pandoc, Markdown, and Scribble can (for the most part) only generate static web pages. Nota's goal is to bridge that gap by providing authors with a document language that has a low floor, a high ceiling, and a smooth ramp up.
Part of this design is identifying components that are easy to use for authors and have high impact for the reader. For instance, the
@Ref components in the example above require a small amount of document annotation on the author's part. Then the Nota runtime can provide features like presenting a reference's definition in context via tooltip. Future Nota versions could include more advanced features like
find all references to this definition.
For more on this design philosophy, you can read my original paper "A New Medium for Communicating Research on Programming Languages".