iterate / mikrobloggeriet

0 stars 0 forks source link

Opsjon: støtte inline-matematikk med Pandoc og Katex. #52

Open teodorlu opened 7 months ago

teodorlu commented 7 months ago

Brukerbehov

Eksempel fra https://mikrobloggeriet.no/luke/luke-3/ av @finninde:

image

Han skriver matte -- men får dessverre ikke formater matematikken pent.

Kontekst: matematikk med Pandoc og KaTeX

Pandoc har allerede støtte for rendering av matematikk i HTML: https://pandoc.org/chunkedhtml-demo/3.6-math-rendering-in-html.html

Men det funker ikke ut av boksen. Vi bruker ikke Pandoc til å lage fulle HTML-sider, vi skriver blant annet vår egen header.

Jeg tror likevel vi kan bruke pandoc med --katex, og manuelt lage en HTML-header med det vi trenger av javascript og css for å få KaTeX til å funke: https://katex.org/docs/browser

Løsningsforslag

Start med det som funker rett i Pandoc:

$ cat doc.md                                    
# Finn

$$
R_m = 2 \cdot 10^{-4}
$$
$ pandoc doc.md -o doc.html --standalone --katex
[WARNING] This document format requires a nonempty <title> element.
  Defaulting to 'doc' as the title.
  To specify a title, use 'title' in metadata or --metadata title="...".

som lager dette dokumentet:

image

så:

  1. Se akkurat hva slags HTML som lages, både i <body> og i <head>
  2. Jobbe steg-for-steg mot å lage samme HTML fra mikrobloggeriet