These are my working notes on economics, organized around three recurring questions:
- Why did a theory emerge — what problem was it meant to solve at the time?
- How did it develop — who revised it, and what new questions did that leave open?
- How has it been tested — where do real-world data and later research stand?
Knowledge notes: docs/knowledge.md — the textbook references used for each topic collection, the classics timeline, and the site's dating conventions.
The VitePress site currently includes:
- Six topic collections: Western Economics, Money and Banking, Public Finance, International Economics, Socialist Economic Theory, and Mathematical Foundations (tab switching)
- Theory timeline: the emergence and development of economic theories from the 16th century to the present
- Notable economists: influence networks of economists — who proposed what, whom they influenced, and by whom they were influenced
- Glossary: a dictionary of technical terms, with search and catalog browsing
- Classics: a bookshelf of classic works in economics, browsable by publication year and school of thought
| Path | Contents |
|---|---|
docs/ |
The VitePress site: topic articles and overview pages across six collections (docs/western/ docs/math/ etc.), the timeline / notable economists / glossary / classics pages, theme data, and Vue components |
scripts/ |
Gate scripts (broken-link, LaTeX, typography, navigation coverage, and rendered-formula checks), build-glossary term generation, and one-time migration/rewrite tools |
tests/ |
Black-box tests for data and gates (node --test) plus component mounting (vitest) |
经济学-术语.md 经济学-名人.md |
Root-level source material: glossary entries and the economists skeleton (entry backlinks are written as docs/-relative paths, for the generation chain to consume) |
pnpm install
pnpm dev # local preview
pnpm glossary # regenerate glossary data after editing 经济学-术语.md
pnpm test # node --test (data/gate black-box) + vitest (theme component mounting)
pnpm build # build (includes broken-link check)Gate scripts: pnpm check:links (internal links), pnpm check:latex (formula syntax), pnpm check:typography (layout rules), pnpm check:sidebar (navigation coverage). CI regenerates the glossary, runs the tests and all four gates, then builds and deploys.
Component testing stack: Vitest + @vue/test-utils + happy-dom, reusing the site's single Vite toolchain to compile .vue SFCs (vitest.config.ts, including the vitepress client alias); test cases live in tests/vue/.
The topic and chapter navigation is generated from courses.ts and rendered in the site's sidebar. Keep that file as the navigation source of truth; do not maintain a second chapter list here. Topic overviews and supplementary notes are linked from the corresponding sidebar groups. Topic overviews are also available directly: Mathematical Foundations, Western Economics (theory timeline), Money and Banking (history), Public Finance (history), International Economics (history), and Socialist Economic Theory (history).
- Unified Economics Glossary
- Notable Economists
- Overview of Western Economics Formulas
- Evolution of Macroeconomic Models
This work is licensed under the Creative Commons Attribution 4.0 International (CC BY 4.0) license.