v1 framework

[casperdcl]

• readme: make readable on GitHub (split bits into a separate root: index.md) #13
  • html: use dirhtml builder #13
• tests: add linkchecks #13
• html: fix comments integration #13
• html: create remaining chapter stubs #14
• assets: use an external static image host to avoid bloating this repo: static.premai.io #17
• credit GH contributors (avatars + links) #17
• html: Bibliography borkes right navbar. Find a fix or report upstream issue? #17
  • https://sourceforge.net/p/docutils/patches/195
  • executablebooks/jupyter-book#2048
• add PR review template & improve contrib guide #17
• fix concurrent builds #17
• fix build instructions #21
• misc minor improvements #23
• pdf: improve formatting
  • replace the existing page download (print to pdf) links with proper pdf #86
  • improve cover pages #65
  • fix cross-ref linking (e.g. links to chapters are not clickable) #79
  • substitute some unicode chars (e.g. 🟢, 🟡, 🔴, https://tex.stackexchange.com/questions/601479) #79
• html: improve style
  • #42
  • #84 #83 #77 #70 #63
• deploy: pick a new subdomain e.g. book.premai.io #24
  • update repo_url & references #24
  • plausible #25
• contrib list per-chapter #36
  • https://github.com/casperdcl/git-fame#codeowners
  • https://stackoverflow.com/questions/44888187/get-github-username-through-primary-email
• contrib: Zenodo integration config (CITATION.cff/.zenodo.json) #41
• open links in new tab #55 <- #50
  • executablebooks/jupyter-book#1070
  • https://stackoverflow.com/questions/25583581/add-open-in-new-tab-links-in-sphinx-restructuredtext
  • sphinx-doc/sphinx#2550
• convert links to references where appropriate (e.g. arxiv)
• make repo public
  • enables features like utteranc.es comments, CI status badges, dependabot, external PRs, GH contributor lists, Zenodo DOIs, etc.
  • fix Zenodo #92
  • fix utterances #81
  • tag v1
• add https://ogp.me metadata #86
• add to https://github.com/executablebooks/meta/blob/main/docs/gallery.yml executablebooks/meta#1090

Follow-up to #11

v1.1

• rename repo?
• fix all TODO notes
• fix all {{ wip_chapter }}/% TODO/Work in Progress notes
• CI: speed up builds
  • maybe parallel linkcheck + html + pdf #69
  • smaller pdf docker container? (easier since https://github.com/xu-cheng/latex-action/releases/tag/3.0.0) (alternatively, use different/quicker pdf action?)
  • add minimal pdf LaTeX to DevContainer (and use https://github.com/devcontainers/ci)?