Skip to content

Latest commit

 

History

295 Commits

Folders and files

Repository files navigation

English | 中文

logo

Hello Economics · An Economics Knowledge Base

topic docs license


These are my working notes on economics, organized around three recurring questions:

  1. Why did a theory emerge — what problem was it meant to solve at the time?
  2. How did it develop — who revised it, and what new questions did that leave open?
  3. 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.

Contents

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

Repository Structure

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)

Local Development

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/.

Topic Entry Points

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).

Public Materials

License

This work is licensed under the Creative Commons Attribution 4.0 International (CC BY 4.0) license.