This repository publishes the Generative AI: Old and New notes at https://generativeai-old-and-new.github.io/. It is maintained by Runlong Liao liaorlmn@gmail.com and uses Quartz as the site generator for math-intensive notes, lecture notes, and technical blogs.
npm install
npm run devUseful checks:
npm test
npm run check
npx quartz buildQuartz's upstream documentation is still available in docs/ and can be previewed with:
npm run dev:docs- Obsidian-style callouts are available for theorem-like writing, including
example,proof,remark,theorem,definition,lemma,proposition, andcorollary. - Numbered theorem-like callouts can be labelled with Pandoc-style ids, for example
> [!theorem|Change of Variables] {#thm:change-vars}. Reference them in prose with@thm:change-vars; unresolved references render visibly and print a build warning. - Numbered callouts use module-aware numbering when the page slug starts with a number, for example
modules/01-probability-basicsrendersTheorem 1.1andExample 1.1. Pages without a numeric slug use page-local numbering such asTheorem 1. - Markdown images with real captions are normalized into numbered figures. Add labels with
and reference them with@fig:example. Placeholder alt text likeimagestays unnumbered. - Math is rendered with MathJax and configured for AMS-style equation tags.
- D3-style interactive figures can be inserted with
<figure data-interactive-figure="...">. New figures should be exported fromquartz/components/scripts/interactive-figures/index.ts, use an.interactive-figure-plotelement for resize observation, and keep figure-specific styles inquartz/styles/notes/figures/.
The published site URL is:
https://generativeai-old-and-new.github.io/
Quartz uses this as configuration.baseUrl: "generativeai-old-and-new.github.io", without https:// and without a trailing slash.
- RSS and sitemap are enabled for this domain.
Plugin.CustomOgImages()is still disabled until generated OG images can use local fonts.- Configure analytics only if the published site should track visits.