_{🌐 English · 中文}

RequieMa's Personal Website

"Thinking in feedback loops — shown through code that teaches."

Bilingual blog source (EN/中文) built with MkDocs Material, deployed via GitHub Actions.

Source for requiema.github.io — a personal site about cybernetics, control theory, and complexity science, written in Chinese and English.

Quick Start · What's Here · Repository Structure

---

Quick Start

git clone https://github.com/RequieMa/requiema.github.io
cd requiema.github.io
uv sync
uv run mkdocs serve    # → http://127.0.0.1:8000

Push to Master → GitHub Actions builds and deploys to GitHub Pages.

---

What's Here

Section	Content	Language
Blog	Essays, tutorials, release notes	EN + ZH
Landing	EN/ZH home pages with language switcher	EN + ZH
Notes	Reading notes, book summaries	EN + ZH

Syndication

Cross-post blog posts to external platforms from the CLI:

uv run python scripts/syndicate.py docs/blog/posts/en/my-post.md
uv run python scripts/syndicate.py --all

Tag a post with essay, tutorial, guide, howto, release, launch, book, or notes in frontmatter — the script reads scripts/syndicate.yml and generates platform-formatted Markdown in _syndication/. Chinese platforms get the zh/ sibling, English ones get en/.

Convention tags	Platforms
essay	zhihu, gongzhonghao, devto, substack
tutorial, guide, howto	juejin, devto
release, launch	devto, X
book, notes	yuque, devto

Install a post-commit hook for automatic reminders:

bash scripts/install-hook.sh

Reddit and Hacker News are intentionally excluded — always hand-craft those.

---

Repository Structure

requiema.github.io/
├── docs/
│   ├── blog/posts/en/       # English posts
│   ├── blog/posts/zh/       # Chinese posts
│   ├── en/                  # EN landing page
│   ├── zh/                  # Chinese landing
│   └── stylesheets/         # Custom CSS
├── scripts/
│   ├── syndicate.py         # Syndication CLI
│   ├── syndicate.yml        # Routing config (editable)
│   ├── post-commit          # Git hook
│   └── install-hook.sh      # Hook installer
├── tests/
│   └── test_syndicate.py    # 19 tests
├── mkdocs.yml               # MkDocs config
├── .github/workflows/       # CI → GitHub Pages
└── README.md

---

Connect

📧	Email	mazengou@gmail.com
🌐	Personal Site	requiema.github.io
📝	dev.to	dev.to/requiema
𝕏	X	x.com/mazengou
👾	Reddit	u/Leather_Rip7919
🔖	掘金	juejin.cn/user/76300220645242
📦	Gitee	gitee.com/requiema
📖	知乎	zhihu.com/people/consilivm
🎬	Bilibili	镇魂曲麦
📱	公众号	镇魂曲麦