Skip to content

lachlanchen/LazyLearn

Repository files navigation

English · العربية · Español · Français · 日本語 · 한국어 · Tiếng Việt · 中文 (简体) · 中文(繁體) · Deutsch · Русский

LazyingArt logo

LazyLearn

Knowledge + skill, unrushed.

Site Python Status Repo Type Docs Languages

PocketPolyglot Maximum-Language Editions

PocketPolyglot/LinguaLeaf builds pocket-size interlinear readers with ruby, pinyin, grammar coloring, and maximum available language layers.

Preview Book Family Color PDF Black-white PDF
a-city-on-mars cover preview a-city-on-mars en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/a-city-on-mars/en-main-jp-zh/color/A City on Mars(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/a-city-on-mars/en-main-jp-zh/blackwhite/A City on Mars(日文・中文注・黑白)・最大語種・大字版.pdf)
a-game-of-thrones cover preview a-game-of-thrones en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/a-game-of-thrones/en-main-jp-zh/color/A Game of Thrones(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/a-game-of-thrones/en-main-jp-zh/blackwhite/A Game of Thrones(日文・中文注・黑白)・最大語種・大字版.pdf)
bhagavad-gita cover preview bhagavad-gita en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/bhagavad-gita/en-main-jp-zh/color/The Bhagavad Gita(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/bhagavad-gita/en-main-jp-zh/blackwhite/The Bhagavad Gita(日文・中文注・黑白)・最大語種・大字版.pdf)
bible cover preview bible en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/bible/en-main-jp-zh/color/The Holy Bible(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/bible/en-main-jp-zh/blackwhite/The Holy Bible(日文・中文注・黑白)・最大語種・大字版.pdf)
botchan cover preview botchan en-jp-zh color black-white
chuci cover preview chuci wenyan-en-jp-zh color black-white
chumon-no-ooi-ryoriten cover preview chumon-no-ooi-ryoriten jp-zh color black-white
fellowship-of-the-ring cover preview fellowship-of-the-ring en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/fellowship-of-the-ring/en-main-jp-zh/color/The Fellowship of the Ring(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/fellowship-of-the-ring/en-main-jp-zh/blackwhite/The Fellowship of the Ring(日文・中文注・黑白)・最大語種・大字版.pdf)
foguoji cover preview foguoji wenyan-en-jp-zh color black-white
genji-modern cover preview genji-modern en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/genji-modern/en-main-jp-zh/color/The Tale of Genji(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/genji-modern/en-main-jp-zh/blackwhite/The Tale of Genji(日文・中文注・黑白)・最大語種・大字版.pdf)
ginga-tetsudo cover preview ginga-tetsudo jp-zh color black-white
gone-with-the-wind cover preview gone-with-the-wind en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/gone-with-the-wind/en-main-jp-zh/color/Gone With the Wind(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/gone-with-the-wind/en-main-jp-zh/blackwhite/Gone With the Wind(日文・中文注・黑白)・最大語種・大字版.pdf)
guoyu cover preview guoyu wenyan-en-jp-zh color black-white
han-shu cover preview han-shu wenyan-en-jp-zh color black-white
harry-potter-1 cover preview harry-potter-1 en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/harry-potter-1/en-main-jp-zh/color/Harry Potter and the Sorcerer's Stone(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/harry-potter-1/en-main-jp-zh/blackwhite/Harry Potter and the Sorcerer's Stone(日文・中文注・黑白)・最大語種・大字版.pdf)
hou-han-shu-part-01 cover preview hou-han-shu-part-01 wenyan-en-jp-zh color black-white
hou-han-shu-part-02 cover preview hou-han-shu-part-02 wenyan-en-jp-zh color black-white
hou-han-shu-part-03 cover preview hou-han-shu-part-03 wenyan-en-jp-zh color black-white
i-am-a-cat cover preview i-am-a-cat en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/i-am-a-cat/en-main-jp-zh/color/I Am a Cat(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/i-am-a-cat/en-main-jp-zh/blackwhite/I Am a Cat(日文・中文注・黑白)・最大語種・大字版.pdf)
inugami-curse cover preview inugami-curse en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/inugami-curse/en-main-jp-zh/color/The Inugami Curse(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/inugami-curse/en-main-jp-zh/blackwhite/The Inugami Curse(日文・中文注・黑白)・最大語種・大字版.pdf)
izu-no-odori cover preview izu-no-odori en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/izu-no-odori/en-main-jp-zh/color/The Dancing Girl of Izu(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/izu-no-odori/en-main-jp-zh/blackwhite/The Dancing Girl of Izu(日文・中文注・黑白)・最大語種・大字版.pdf)
jane-eyre cover preview jane-eyre en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/jane-eyre/en-main-jp-zh/color/Jane Eyre(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/jane-eyre/en-main-jp-zh/blackwhite/Jane Eyre(日文・中文注・黑白)・最大語種・大字版.pdf)
japanese-history cover preview japanese-history en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/japanese-history/en-main-jp-zh/color/A Concise History of Japan(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/japanese-history/en-main-jp-zh/blackwhite/A Concise History of Japan(日文・中文注・黑白)・最大語種・大字版.pdf)
kinkakuji cover preview kinkakuji en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/kinkakuji/en-main-jp-zh/color/The Temple of the Golden Pavilion(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/kinkakuji/en-main-jp-zh/blackwhite/The Temple of the Golden Pavilion(日文・中文注・黑白)・最大語種・大字版.pdf)
kojiki cover preview kojiki jp-zh color black-white
kojiki-wenyan cover preview kojiki-wenyan wenyan-en-jp-zh color black-white
kokin-wakashu cover preview kokin-wakashu wayakana-en-jp-zh color black-white
kokoro cover preview kokoro en-jp-zh color black-white
les-miserables cover preview les-miserables en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/les-miserables/en-main-jp-zh/color/Les Misérables(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/les-miserables/en-main-jp-zh/blackwhite/Les Misérables(日文・中文注・黑白)・最大語種・大字版.pdf)
manyoshu cover preview manyoshu wayakana-en-jp-zh color black-white
martian-chronicles cover preview martian-chronicles en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/martian-chronicles/en-main-jp-zh/color/The Martian Chronicles(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/martian-chronicles/en-main-jp-zh/blackwhite/The Martian Chronicles(日文・中文注・黑白)・最大語種・大字版.pdf)
mudanting cover preview mudanting wenyan-en-jp-zh color black-white
nihon-shoki cover preview nihon-shoki wenyan-en-jp-zh color black-white
no-longer-human cover preview no-longer-human en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/no-longer-human/en-main-jp-zh/color/No Longer Human(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/no-longer-human/en-main-jp-zh/blackwhite/No Longer Human(日文・中文注・黑白)・最大語種・大字版.pdf)
notre-dame-de-paris cover preview notre-dame-de-paris en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/notre-dame-de-paris/en-main-jp-zh/color/Notre-Dame de Paris(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/notre-dame-de-paris/en-main-jp-zh/blackwhite/Notre-Dame de Paris(日文・中文注・黑白)・最大語種・大字版.pdf)
one-hundred-years-of-solitude cover preview one-hundred-years-of-solitude en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/one-hundred-years-of-solitude/en-main-jp-zh/color/One Hundred Years of Solitude(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/one-hundred-years-of-solitude/en-main-jp-zh/blackwhite/One Hundred Years of Solitude(日文・中文注・黑白)・最大語種・大字版.pdf)
platform-sutra cover preview platform-sutra wenyan-en-jp-zh color black-white
rashomon-stories cover preview rashomon-stories en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/rashomon-stories/en-main-jp-zh/color/Rashomon Stories(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/rashomon-stories/en-main-jp-zh/blackwhite/Rashomon Stories(日文・中文注・黑白)・最大語種・大字版.pdf)
red-mars cover preview red-mars en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/red-mars/en-main-jp-zh/color/Red Mars(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/red-mars/en-main-jp-zh/blackwhite/Red Mars(日文・中文注・黑白)・最大語種・大字版.pdf)
red-rising-1 cover preview red-rising-1 en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/red-rising-1/en-main-jp-zh/color/Red Rising(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/red-rising-1/en-main-jp-zh/blackwhite/Red Rising(日文・中文注・黑白)・最大語種・大字版.pdf)
red-rising-2 cover preview red-rising-2 en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/red-rising-2/en-main-jp-zh/color/Golden Son(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/red-rising-2/en-main-jp-zh/blackwhite/Golden Son(日文・中文注・黑白)・最大語種・大字版.pdf)
red-rising-3 cover preview red-rising-3 en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/red-rising-3/en-main-jp-zh/color/Morning Star(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/red-rising-3/en-main-jp-zh/blackwhite/Morning Star(日文・中文注・黑白)・最大語種・大字版.pdf)
sanguozhi cover preview sanguozhi wenyan-en-jp-zh color black-white
sanguozhi-pei-zhu cover preview sanguozhi-pei-zhu wenyan-en-jp-zh color black-white
shanhaijing cover preview shanhaijing wenyan-en-jp-zh color black-white
shiji-aginti cover preview shiji-aginti wenyan-jp-zh color black-white
shijing cover preview shijing wenyan-en-jp-zh color black-white
shishuo-xinyu cover preview shishuo-xinyu wenyan-en-jp-zh color black-white
shui-jing-zhu cover preview shui-jing-zhu wenyan-en-jp-zh color black-white
sichuan-folk-stories-vol1 cover preview sichuan-folk-stories-vol1 jp-zh color black-white
sishu-jizhu cover preview sishu-jizhu jp-zh color black-white
sishu-jizhu-aginti cover preview sishu-jizhu-aginti jp-zh color black-white
snow-country cover preview snow-country en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/snow-country/en-main-jp-zh/color/Snow Country(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/snow-country/en-main-jp-zh/blackwhite/Snow Country(日文・中文注・黑白)・最大語種・大字版.pdf)
spring-snow cover preview spring-snow en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/spring-snow/en-main-jp-zh/color/Spring Snow(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/spring-snow/en-main-jp-zh/blackwhite/Spring Snow(日文・中文注・黑白)・最大語種・大字版.pdf)
tangshi-sanbai cover preview tangshi-sanbai wenyan-en-jp-zh color black-white
the-count-of-monte-cristo cover preview the-count-of-monte-cristo en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/the-count-of-monte-cristo/en-main-jp-zh/color/The Count of Monte Cristo(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/the-count-of-monte-cristo/en-main-jp-zh/blackwhite/The Count of Monte Cristo(日文・中文注・黑白)・最大語種・大字版.pdf)
the-martian cover preview the-martian en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/the-martian/en-main-jp-zh/color/The Martian(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/the-martian/en-main-jp-zh/blackwhite/The Martian(日文・中文注・黑白)・最大語種・大字版.pdf)
the-old-capital cover preview the-old-capital en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/the-old-capital/en-main-jp-zh/color/The Old Capital(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/the-old-capital/en-main-jp-zh/blackwhite/The Old Capital(日文・中文注・黑白)・最大語種・大字版.pdf)
the-sirens-of-mars cover preview the-sirens-of-mars en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/the-sirens-of-mars/en-main-jp-zh/color/The Sirens of Mars(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/the-sirens-of-mars/en-main-jp-zh/blackwhite/The Sirens of Mars(日文・中文注・黑白)・最大語種・大字版.pdf)
the-two-towers cover preview the-two-towers en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/the-two-towers/en-main-jp-zh/color/The Two Towers(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/the-two-towers/en-main-jp-zh/blackwhite/The Two Towers(日文・中文注・黑白)・最大語種・大字版.pdf)
vimalakirti-sutra cover preview vimalakirti-sutra wenyan-en-jp-zh color black-white
woman-in-the-dunes cover preview woman-in-the-dunes en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/woman-in-the-dunes/en-main-jp-zh/color/The Woman in the Dunes(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/woman-in-the-dunes/en-main-jp-zh/blackwhite/The Woman in the Dunes(日文・中文注・黑白)・最大語種・大字版.pdf)
wuthering-heights cover preview wuthering-heights en-jp-zh [color](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/wuthering-heights/en-main-jp-zh/color/Wuthering Heights(日文・中文注)・最大語種・大字版.pdf) [black-white](https://github.com/lachlanchen/LinguaLeaf/blob/main/docs/pocketpolyglot/books/en-jp-zh/wuthering-heights/en-main-jp-zh/blackwhite/Wuthering Heights(日文・中文注・黑白)・最大語種・大字版.pdf)
xixiangji cover preview xixiangji wenyan-en-jp-zh color black-white
xu-xiake-youji cover preview xu-xiake-youji wenyan-en-jp-zh color black-white
yijing cover preview yijing wenyan-en-jp-zh color black-white
zhanguoce cover preview zhanguoce wenyan-en-jp-zh color black-white
zhuangzi cover preview zhuangzi wenyan-en-jp-zh color black-white
zizhi-tongjian-part-01 wenyan-en-jp-zh local only black-white
zizhi-tongjian-part-02 wenyan-en-jp-zh local only black-white
zizhi-tongjian-part-03 wenyan-en-jp-zh local only black-white
zizhi-tongjian-part-04 wenyan-en-jp-zh local only black-white
zizhi-tongjian-part-05 wenyan-en-jp-zh local only black-white
zizhi-tongjian-part-06 wenyan-en-jp-zh local only black-white
zuozhuan cover preview zuozhuan wenyan-en-jp-zh color black-white

PDF repository: lachlanchen/LinguaLeaf · Source repository: lachlanchen/PocketPolyglot

Featured Books

How to Speak and Write cover Justice with Michael Sandel cover Quantum Mechanics Theoretical Minimum cover
How to Speak and Write Justice with Michael Sandel Leonard Susskind Book Repo

How to Speak and Write is now the most prominent published book from this repo.

First-page cover preview. Available as a full-size multilingual edition and as English pocket editions in 1.0x and 1.2x.

Justice with Michael Sandel is also finished and published from the completed lecture pipeline.

First-page cover preview. Available as a full-size English edition and as English pocket editions in 1.0x and 1.2x.

Dedicated Physics Book Repo

There is also a separate repository dedicated to the Leonard Susskind lecture-note book collection.

  • Browse the repo: lachlanchen/leonardsusskind
  • Use that repo for the larger physics catalog, including classical mechanics, advanced quantum mechanics, particle physics, entanglement, and string theory

Book Layout

The book now has a strict split between source and publication:

Current behavior:

  • generated_course_notes/... keeps the editable source, cover assets, chapter structure, and translation source trees
  • how-to-speak-and-write/ keeps only the published PDFs:
    • English
    • Traditional Chinese
    • Japanese

Layout note:

📌 At a glance

Focus What this repo does
Workflow type Reproducible physics + chemistry learning workspace
Deliverables Scripts, notebooks, generated figures, and static docs
Collaboration model Root experiments + public site publishing
Translation coverage README mirror files in i18n/

This repository is the code + notebook half of LazyLearn: an intentionally slow, practical learning log for knowledge and skill building. The living notes, wins, and TODOs are published at learn.lazying.art (served from docs/ in this repo), while runnable artifacts stay here so experiments always have a reproducible home.

Overview 🧭

LazyLearn

  • Home base: learn.lazying.art - the public-facing site with weekly focuses, backlog, and highlights.
  • Source of truth: everything the site links to lives in examples/, comp_physics/, comp_physics_python/, multiwfn/, or figures/.
  • Update flow: ship code/notebooks first, regenerate plots if needed, and then add an entry to docs/ so the site reflects the latest work.

This repository is intentionally mixed-format, not a single packaged app. It combines executable scripts, notebooks, references, and a static docs site under one versioned workspace.

Features ✨

  • Quantum example scripts (QAOA + VQE) that run on commodity laptops.
  • Computational physics notebooks and helper solvers (e.g., Numerov-based workflows).
  • Chapter-by-chapter Python ports of textbook computational physics programs.
  • Multiwfn source/manual bundle for local quantum chemistry post-processing reference.
  • Versioned generated figures for reports/slides (figures/).
  • Built-in multilingual README set under i18n/.
  • Static microsite in docs/ (custom domain: learn.lazying.art).

Project structure 🗂️

What lives here

Path Purpose
examples/ Focused Python scripts (QAOA + VQE) that run with Qiskit or PennyLane.
comp_physics/ Computational physics notebooks, helper scripts like numerov.py, and supporting data/figures.
comp_physics_python/ Python ports of Jos Thijssen's Computational Physics, organized by chapter (see comp_physics_python/README.md).
multiwfn/ Multiwfn 3.8 developer source bundle plus manuals for local reference.
figures/ Static PNG/SVG outputs used in reports/slides and README.
figs/ Logo and banner assets.
docs/ LazyLearn microsite content (served by GitHub Pages or any static host).
i18n/ Localized README files.
generated_course_notes/ Canonical generated lecture-note source trees, chapter TeX, figures, compiled course artifacts, and book-source wrappers.
how-to-speak-and-write/ Publish-only shelf for the featured English, Traditional Chinese, and Japanese PDFs.

Representative layout:

LazyLearn/
|- README.md
|- docs/
|- i18n/
|- examples/
|- comp_physics/
|- comp_physics_python/
|- multiwfn/
|- figures/
|- figs/
|- Gaussian -> ../Gaussian/ (symlink)
|- ComputationalPhysics -> ../ComputationalPhysics/ (symlink)
|- leonardsusskind -> ../leonardsusskind/ (symlink)
`- the_theoretical_minimum -> ../the_theoretical_minimum/ (symlink)

Important

Several top-level entries are symlinks to directories outside this repository. Editing under those paths affects external targets.

Prerequisites 🧰

Requirement Notes
Python 3.x Required for root scripts and most notebook work.
pip (or Conda) Package/environment management.
Jupyter Lab/Notebook (optional) Needed for notebook workflows.
Gaussian 16 + GaussView (optional) Needed for Gaussian workflows.

Installation ⚙️

Minimal Python setup (root examples)

python -m venv .venv
source .venv/bin/activate
pip install --upgrade pip
pip install qiskit pennylane numpy matplotlib

✅ Quick setup checklist

Step Command Goal
1 python -m venv .venv Create an isolated environment
2 source .venv/bin/activate (or OS-equivalent) Avoid dependency conflicts
3 pip install --upgrade pip Ensure current package tooling
4 pip install qiskit pennylane numpy matplotlib Install the core experimental stack
5 Run one script in examples/ Validate installation end-to-end

Jupyter notebooks inside comp_physics/ use the same environment. Launch with:

jupyter lab
# or
jupyter notebook

Optional chapter-port dependencies (comp_physics_python/)

# conda activate quantum  # common local env name in subproject docs
pip install numpy scipy matplotlib

Usage 🚀

Example workflows

  • QAOA with Qiskit
python examples/qaoa_qiskit_maxcut.py

No Aer dependency; uses a pure statevector backend.

  • QAOA with PennyLane
python examples/qaoa_pennylane_maxcut.py

Uses default.qubit.

  • VQE for H2
python examples/pennylane_chemistry_h2_vqe.py

Reproduces figures/pennylane_h2_vqe_convergence.png.

All scripts log intermediate metrics so you can reuse plots or extend to new molecules/graphs.

Computational physics notebooks 📓

The comp_physics/ directory mirrors working notes:

  • comp_physics_textbook_code/ - reusable routines extracted from notebooks.
  • Standalone notebooks such as chapter1.ipynb, chapter2.ipynb, numerov.ipynb, and numpy_1ddft.ipynb.
  • Topic folders (bosonscattering/, lensless/, lightscattering/, etc.) with data and helpers per experiment.

If extra dependencies are needed, record them in comp_physics/environments.yaml.

Textbook code translations 📚

comp_physics_python/ is a growing Python translation of the classic Fortran programs from Computational Physics. Example chapter mapping:

  • ch4/: Hartree-Fock examples.
  • ch8/: molecular dynamics solvers.
  • ch10/: Monte Carlo samplers.

Refer to comp_physics_python/README.md for full chapter coverage and CLI commands.

Multiwfn references 🔬

multiwfn/ keeps Multiwfn_3.8_dev_src_Linux plus the PDF manual and quick-start guide. No compiled binaries are committed.

Figures 🖼️

Generated PNG/SVG assets live in figures/ so outputs are versioned alongside producing scripts/notebooks.

Configuration 🛠️

Python and notebooks

  • Root scripts assume the venv shown above.
  • Notebook environment details are distributed across project docs; no single lockfile currently exists at repo root.

Gaussian runner (symlinked path)

Gaussian/run_gaussian.sh supports:

Gaussian/run_gaussian.sh [--no-view] [--g16 <path_to_g16>] [--gview <path_to_gview.sh>] <input.com|input.gjf>

Behavior:

  • Writes <basename>.log next to input.
  • Uses GAUSS_SCRDIR if set, otherwise defaults to ~/gaussian/scr.
  • Detects %chk=... in input; if checkpoint exists, GaussView opens .chk, otherwise .log.
  • If available, prefers ~/gaussian/gv/gview_safe.sh, then gview.sh.

Recommended GaussView wrapper:

#!/usr/bin/env bash
set -euo pipefail
GV_SH="$HOME/gaussian/gv/gview.sh"
export QT_QPA_PLATFORM="${QT_QPA_PLATFORM:-xcb}"
export LIBGL_ALWAYS_SOFTWARE="${LIBGL_ALWAYS_SOFTWARE:-1}"
export __GLX_VENDOR_LIBRARY_NAME="${__GLX_VENDOR_LIBRARY_NAME:-mesa}"
exec "$GV_SH" "$@"

Development notes 🧪

🎬 Navigation map

Use this as a launchpad for daily work:

Area Start here
Quantum demos examples/
Physics notebooks comp_physics/
Textbook translations comp_physics_python/
Quantum chemistry tools multiwfn/
Published outputs docs/
Figures and illustrations figures/, figs/

Version control notes

  • Heavy paths are ignored via .gitignore, including books/, external symlink targets (Gaussian, ComputationalPhysics, leonardsusskind, the_theoretical_minimum), and local artifacts such as *.chk.
  • Keep contributions focused on tracked folders for lightweight clone/update workflows.
  • For website updates: edit docs/, preview locally, then push.

Local docs preview:

python -m http.server --directory docs

docs/CNAME is configured for learn.lazying.art.

Troubleshooting 🩺

  • Gaussian success criterion: Normal termination of Gaussian near the end of the .log.
  • If GaussView fails under Wayland/remote sessions, use gview_safe.sh and pass --gview explicitly.
  • If Gaussian scratch errors occur, verify free disk and permissions in GAUSS_SCRDIR.
  • If notebook dependencies drift, treat subproject READMEs as source-of-truth and capture missing packages in environment files before sharing.
  • comp_physics/environments.yaml appears to be a placeholder in the current repo state; rely on explicit install commands until it is corrected.

Roadmap 🛣️

  • Continue expanding comp_physics_python/ chapter coverage (transfer matrices, DMC/PIMC, FEM, and beyond).
  • Harmonize output/plot conventions across scripts and notebooks.
  • Add lightweight, repeatable validation checks for key examples.
  • Keep docs/ and multilingual READMEs aligned with new experiments.

Contribution 🤝

Issues and pull requests are welcome, especially for:

  • Numerical correctness checks and reproducibility improvements.
  • Better environment specifications for notebooks/scripts.
  • Additional textbook chapter ports and CLI refinements.
  • Documentation clarity across languages in i18n/.

Before submitting major content updates, keep generated figures in figures/ and ensure commands are runnable from repository root unless otherwise documented.

❤️ Support

Donate PayPal Stripe
Donate PayPal Stripe

License 📄

No root LICENSE file is currently present in this repository. Until a license is added, treat usage/redistribution rights as unspecified and request clarification from the maintainer before reusing substantial content.

About

LazyLearn—my intentionally slow learning log for physics, chemistry, biomedicine and finance.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors