v1 framework

[casperdcl]

• readme: make readable on GitHub (split bits into a separate root: index.md) framework: various fixes #13
  • html: use dirhtml builder framework: various fixes #13
• tests: add linkchecks framework: various fixes #13
• html: fix comments integration framework: various fixes #13
• html: create remaining chapter stubs add all chapter stubs #14
• assets: use an external static image host to avoid bloating this repo: static.premai.io contrib & framework improvements #17
• credit GH contributors (avatars + links) contrib & framework improvements #17
• html: Bibliography borkes right navbar. Find a fix or report upstream issue? contrib & framework improvements #17
  • https://sourceforge.net/p/docutils/patches/195
  • bump docutils jupyter-book/jupyter-book#2048
• add PR review template & improve contrib guide contrib & framework improvements #17
• fix concurrent builds contrib & framework improvements #17
• fix build instructions fix: local build jupyter-book command in index #21
• misc minor improvements index: cite basic reading #23
• pdf: improve formatting
  • replace the existing page download (print to pdf) links with proper pdf add metadata & PDF download link #86
  • improve cover pages pdf: insert cover #65
  • fix cross-ref linking (e.g. links to chapters are not clickable) pdf: fix hyperref #79
  • substitute some unicode chars (e.g. 🟢, 🟡, 🔴, https://tex.stackexchange.com/questions/601479) pdf: fix hyperref #79
• html: improve style
  • style email modal #42
  • Better email modal + pretendard font + fix link utf8 char #84 Possible rendering issue for links (from mobile) #83 email: Enter to submit #77 css: custom style #70 Cannot place static html page in Sphinx template #63
• deploy: pick a new subdomain e.g. book.premai.io move site to book.premai.io/state-of-open-source-ai #24
  • update repo_url & references move site to book.premai.io/state-of-open-source-ai #24
  • plausible add plausible #25
• contrib list per-chapter contrib: per-chapter stats #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) framework: misc updates #41
• open links in new tab contrib, framework: misc improvements #55 <- open links in new tab #50
  • Open external URLs in new tab jupyter-book/jupyter-book#1070
  • https://stackoverflow.com/questions/25583581/add-open-in-new-tab-links-in-sphinx-restructuredtext
  • HTML Help external links open in viewer 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 add DOI, add PR & cron CI, update badges #92
  • fix utterances comments: Sign in not working #81
  • tag v1
• add https://ogp.me metadata add metadata & PDF download link #86
• add to https://github.com/executablebooks/meta/blob/main/docs/gallery.yml gallery: add The State of Open Source AI 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 CI: split build/check #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)?