Skip to content

README.en.md

Latest commit

 

History

History
188 lines (135 loc) · 5.59 KB

README.en.md

File metadata and controls

188 lines (135 loc) · 5.59 KB
Raw

English Grammar Mindmaps

Interactive mindmaps covering all 40 lectures from A New English Grammar Coursebook by Zhang Zhenbang.

中文版 | English Version

Highlights

  • 📚 40 lectures — Complete coverage of English grammar from morphemes to discourse
  • 🧠 Interactive mindmaps — Built with markmap, supporting zoom, collapse/expand, and search
  • 🌐 Pure static HTML — Open in any browser, no installation required
  • 📖 Bilingual terminology — Each grammar term includes both English and Chinese explanations
  • 🚀 GitHub Pages ready — Browse online without downloading

Quick Start

Option 1: Browse Online (Recommended)

Visit the GitHub Pages demo to browse all mindmaps directly.

Option 2: Use Locally

  1. Clone the repository:

    git clone https://github.com/DavidHinton-xcpc/english-grammar-mindmaps.git
cd english-grammar-mindmaps

  2. Open the directory page in your browser:

    # macOS
open index.html

# Linux
xdg-open index.html

# Windows
start index.html

  3. Or start a local server (recommended for relative paths):

    python3 -m http.server 8080

    Then visit http://localhost:8080

Option 3: Open Individual Files

Navigate to the html/ directory and double-click any .html file to view it in your browser.

Interaction

Action Description
🖱️ Mouse wheel Zoom in/out
👆 Click node Collapse/expand subtree
✋ Drag canvas Pan the view
🔍 Search box Filter nodes by keyword

Project Structure

english-grammar-mindmaps/
├── README.md                 # Chinese documentation
├── README.en.md              # English documentation (this file)
├── LICENSE                   # CC BY-NC-SA 4.0 license
├── DISCLAIMER.md             # Disclaimer
├── .gitignore
├── index.html                # GitHub Pages directory page
├── html/                     # 40 mindmap HTML files
│   ├── 第1讲 语法层次.html
│   ├── 第2讲 分句结构和基本句型.html
│   ├── ...
│   └── 第40讲 从句到篇.html
├── src/                      # Enhanced Markdown source files
│   ├── 第1讲 语法层次.md
│   ├── ...
│   └── 第40讲 从句到篇.md
├── scripts/                  # Generation scripts
│   ├── gen_mindmap_enhanced.py
│   ├── remove_exercises.py
│   ├── check_truncation.py
│   └── batch_enhance.py
└── docs/                     # Documentation

Lecture Index

# Topic # Topic
1 Grammatical Hierarchy 21 Infinitive (II)
2 Clause Structure 22 -ING Participle
3 Clause Elements 23 -ED Participle
4 Subject-Verb Agreement (I) 24 Adjectives
5 Subject-Verb Agreement (II) 25 Adverbs
6 Nouns & Noun Phrases 26 Comparatives
7 Number & Genitive 27 Prepositions
8 Determiners (I) 28 Sentence Types
9 Articles 29 Existential Sentences
10 Pronouns (I) 30 IT-Clauses & Negation
11 Pronouns (II) 31 Coordination
12 Verbs & Verb Phrases 32 Subordination
13 Tense & Aspect (I) 33 Conditional Sentences
14 Tense & Aspect (II) 34 Relative Clauses
15 Future Time 35 Direct & Indirect Speech
16 Passive Voice 36 Modification
17 Subjunctive Mood 37 Substitution
18 Modality (I) 38 Ellipsis
19 Modality (II) 39 Emphasis
20 Infinitive (I) 40 From Sentence to Text

Tech Stack

Component Version Description
d3 7 SVG rendering engine
markmap-lib 0.15.4 Markdown to tree structure conversion
markmap-view 0.15.4 Mindmap rendering

Uses pinned CDN versions for reliability.

Data Source

The mindmap content is based on the following textbook:

Zhang Zhenbang. A New English Grammar Coursebook (6th Edition). Shanghai Foreign Language Education Press.

Content has been enhanced with AI-assisted processing (terminology definitions, structural adjustments) and is not a direct copy of the original work.

License

This project is licensed under CC BY-NC-SA 4.0 (Attribution-NonCommercial-ShareAlike).

  • ✅ Share and copy this work
  • ✅ Adapt this work
  • ❌ No commercial use
  • 📝 Must credit the original author and source
  • 🔄 Derivative works must use the same license

See LICENSE and DISCLAIMER.md for details.

Disclaimer

This project is for educational reference only. Content is organized based on published works and does not constitute a copy or substitute for the original work. If the copyright holder believes this project infringes on their rights, please contact the author and we will promptly remove the relevant content.

See DISCLAIMER.md for details.

Acknowledgments

  • Professor Zhang Zhenbang and A New English Grammar Coursebook
  • markmap open-source project
  • d3.js data visualization library

Contributing

Issues and Pull Requests are welcome!

If you find errors or have suggestions:

  1. Open an Issue describing the problem
  2. Or submit a PR with the fix

Made with ❤️ for English learners