public inbox archive for pandoc-discuss@googlegroups.com
 help / color / mirror / Atom feed
From: Gwern Branwen <gwern-v26ZT+9V8bxeoWH0uzbU5w@public.gmane.org>
To: pandoc-discuss <pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org>
Subject: Advanced equation typesetting, "Nota" Re: Colored equations? (particularly compiling to HTML)
Date: Thu, 18 Nov 2021 18:33:39 -0500	[thread overview]
Message-ID: <CAMwO0gy8VefAFb2SuddrH97W9ChR4wiDdxSAvLogG23R268QMQ@mail.gmail.com> (raw)
In-Reply-To: <CAMwO0gx3i0E-C4c35sX+Xcwwu+t5+TrRcOnQ3OSnNqsx6eYMFw-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org>

Will Crichton has a demo of an advanced equation system he calls
"Nota" https://willcrichton.net/nota/ It is currently Tex/HTML-centric
https://github.com/willcrichton/nota but he has some prototype code
for Markdown version
https://github.com/willcrichton/nota/tree/master/packages/nota-markdown
and so what his system does might be of interest.

> "A New Medium for Communicating Research on Programming Languages", Will Crichton
>
> Papers about programming languages involve complex notations, systems, and proofs. Static PDFs offer little support in understanding such concepts. I describe Nota, a framework for academic papers that uses the browser's interactive capabilities to support comprehension in context. Nota uses hover effects, tooltips, expandable sections, toggleable explanations, and other interactions to help readers understand a language's syntax and semantics. I demonstrate the use of Nota by rewriting a PL paper using its primitives, and also by writing this paper in Nota.

Nota supports most of the usual typography and conveniences like SVG
or margin notes, but the important part is the syntax highlighting for
math.

The basic idea is to annotate equation elements with popup
capabilities, pointing to their definition in the body text. Any
variable 't' can be linked to its definition in the text as being "the
time variable" etc. The definitions themselves may use defined
elements, and can be popped up again, and so on. Because the equations
are parsed into the elements instead of being opaque TeX expressions
or PNG raster images, they can be colored for syntax highlighting of
English vs math: hover over a purple-underlined variable $\pi~mut~$
and and the purple-underlined phrase ' of what the reference
points-to.' is highlighted. (He could color the whole text but that
can lead to issues with readability.)

For kicks, it can run sandboxed code server-side so you can edit Rust
code inside the page, and run it to see the results.

Pretty neat, and worth a look.

--
gwern

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/CAMwO0gy8VefAFb2SuddrH97W9ChR4wiDdxSAvLogG23R268QMQ%40mail.gmail.com.


      parent reply	other threads:[~2021-11-18 23:33 UTC|newest]

Thread overview: 5+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-03-19  3:27 Gwern Branwen
     [not found] ` <CAMwO0gyY9o7hurpkaWaOQws5xNN1gV9kjHV9RsEp3h_K8fDWJg-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org>
2020-09-06  3:16   ` Gwern Branwen
     [not found]     ` <CAMwO0gzotcqk5J0uHvp3YZqmfhmistbkbv7Mv-QLq5vqdbD7LQ-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org>
2020-09-07 18:04       ` John MacFarlane
     [not found]         ` <m28sdlv4ys.fsf-jF64zX8BO08an7k8zZ43ob9bIa4KchGshsV+eolpW18@public.gmane.org>
2020-09-07 23:48           ` Gwern Branwen
     [not found]             ` <CAMwO0gx3i0E-C4c35sX+Xcwwu+t5+TrRcOnQ3OSnNqsx6eYMFw-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org>
2021-11-18 23:33               ` Gwern Branwen [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=CAMwO0gy8VefAFb2SuddrH97W9ChR4wiDdxSAvLogG23R268QMQ@mail.gmail.com \
    --to=gwern-v26zt+9v8bxeowh0uzbu5w@public.gmane.org \
    --cc=pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).