frank890417 / taiwan-md

🇹🇼 Taiwan.md > **The world's first AI-native open knowledge base about Taiwan.** > 全世界第一個 AI-native 的台灣開源知識庫。 🌐 Live Site · 📖 English · 🕸️ Knowledge Graph · 📚 Resources · 🤝 Contribute --- Why Taiwan.md? Taiwan produces **90% of the world's most advanced chips**, yet most people can't name three things about it beyond bubble tea. Taiwan.md is an open-source, curated, AI-friendly knowledge base that helps the world — and AI — truly understand Taiwan. Not a Wikipedia clone. Not a tourism guide. A **curated literary exhibition** of what makes Taiwan extraordinary. **🖊️ Written in Traditional Chinese by default** — the world's oldest writing system still in daily use, and Taiwan is its last major home. English version available → --- ✨ Features • 📖 **660+ curated articles** across 12 categories (321 zh-TW + 339 en) • 🌐 **Bilingual** — 繁體中文 (SSOT) + English (97%+ i18n coverage) • 🤖 **AI-native** — , , structured Markdown SSOT • 🕸️ **Interactive knowledge graph** — D3.js force simulation with zoom, drag, cross-category bridges • 🌳 **Resource mindmap** — D3.js bidirectional tidy tree with 146+ official Taiwan websites • 🎭 **Curated, not encyclopedic** — every page answers "why this matters" • 📐 **Three-layer depth** — 30-sec overview → 5-min read → full article • 🎨 **Literary curatorial style** — Noto Serif TC, essay-driven, inspired by 報導者 • 🔍 **SEO optimized** — JSON-LD structured data, Open Graph, Twitter Cards, RSS feeds • 💾 **Wikimedia Commons** — CC-licensed images with local caching • 📝 **Zero-code contribution** — forms, AI prompts, or email • 🔓 **CC BY-SA 4.0** — free to cite, remix, share • 📚 **Source-cited** — every article includes references and data attribution --- 📊 Stats | Metric | Count | | ------------------------ | ----- | | 📄 Total pages built | 660+ | | 🇹🇼 Chinese articles | 419 | | 🇺🇸 English articles | 411 | | 📂 Categories | 12 | | 🏛️ Hub pages | 12 | | 🕸️ Knowledge graph nodes | 220+ | | 🔗 Resource websites | 146+ | | 👥 Contributors | 23 | --- 🗂️ 12 Categories | | Category | Articles | Highlights | | --- | ----------------------------------------------- | -------- | -------------------------------------------------- | | 📜 | 歷史 History | 19 | 史前→荷西→清治→日治→戒嚴→民主化、白色恐怖、二二八 | | 🗺️ | 地理 Geography | 17 | 五大山脈、板塊運動、氣候帶、離島、海岸地形 | | 🎭 | 文化 Culture | 25 | 閩南客家原住民外省新住民、花布、16族文化地圖 | | 🧋 | 美食 Food | 26 | 珍珠奶茶、牛肉麵、夜市、滷肉飯、鹹酥雞、眷村菜 | | 🎨 | 藝術 Art | 25 | 當代藝術、新媒體藝術、電影、漫畫、原住民當代藝術 | | 🎵 | 音樂 Music | 20 | 金曲獎、獨立音樂、聲音地景、客語歌謠、電子音樂 | | 💻 | 科技 Technology | 21 | 台積電矽盾、g0v 公民科技、半導體、資安 | | 🌿 | 自然 Nature | 22 | 特有種、國家公園、高山冰河孑遺、海洋珊瑚礁 | | 👤 | 人物 People | 105 | 李安、張忠謀、鄧麗君、唐鳳、侯孝賢、林懷民... | | 🏛️ | 社會 Society | 20 | 民主制度、人權與性別平等、外交、環境正義 | | 💰 | 經濟 Economy | 17 | 經濟奇蹟、夜市經濟學、電商、半導體供應鏈 | | 🏙️ | 生活 Lifestyle | 16 | 便利商店、健保、交通、溫泉、KTV、咖啡文化 | --- 🤝 How to Contribute 🤖 AI 輔助貢獻（最簡單） 把以下文字貼給你的 AI（ChatGPT / Claude / Gemini），它會引導你完成： **寫文章：** > 請閱讀 https://raw.githubusercontent.com/frank890417/taiwan-md/main/CONTRIBUTE_PROMPT.md ，然後引導我為 Taiwan.md 撰寫一篇台灣主題文章。 **翻譯：** > 請閱讀 https://raw.githubusercontent.com/frank890417/taiwan-md/main/TRANSLATE_PROMPT.md ，然後協助我翻譯一篇 Taiwan.md 的文章。 All paths, from zero-code to full PR: | Path | For whom | | ------------------ | -------------------------------------------- | | 🤖 **Ask your AI** | Paste our prompt to ChatGPT/Claude/Gemini | | 🟢 **Fill a form** | Anyone — just write what you know | | 📧 **Email us** | Send articles/photos to cheyu.wu@monoame.com | | 🔴 **Fork & PR** | Developers — edit directly | 👉 **taiwan.md/contribute** --- 🖊️ Writing Style & Terminology We maintain a **TERMINOLOGY.md** to ensure consistent, respectful language across all articles. Key principles: | Guideline | Rule | Example | |-----------|------|---------| | 🇹🇼 **National identity** | Use 「台灣」directly; avoid 「台灣地區」「寶島」「本島」 | ✅ 台灣是⋯ ❌ 台灣地區是⋯ | | 🏝️ **Literary variation** | 「這座島嶼」OK for prose style & avoiding repetition | ✅ 台灣森林是這座島嶼最珍貴的⋯ | | 👵 **台文正字** | Use 「阿媽」(a-má) not 「阿嬤」 | 台文正字，非國語系統用字 | | 🗣️ **Language naming** | Use 「台語」not 「閩南語」(per 國家語言發展法) | 語言學語境可用「台語（閩南語）」 | > **Contributors**: Please read TERMINOLOGY.md and EDITORIAL.md before writing or reviewing articles. 📐 Editorial Standards We maintain an **EDITORIAL.md** — our writing methodology and quality standard. It covers: • **Research workflow**: define questions → cross-reference 2+ sources → verify data • **Article structure**: 30-sec overview → narrative-driven body → challenges → references • **Tone**: specific over vague, stories over bullet lists, honesty over cheerleading • **AI quality control**: scans all articles for hollow AI patterns (empty modifiers, missing sources, bullet-list padding) • **Checklist**: 10-point quality gate before every publish --- 🏗️ Architecture **Tech:** Astro v5 · GitHub Pages · marked.js · D3.js · Google Fonts (Noto Serif TC) **SSOT:** All content lives in . Website is a projection. **SEO:** JSON-LD · Open Graph · Twitter Cards · RSS · Canonical URLs · **i18n:** zh-TW (default SSOT) + en (100% coverage) **Quality:** All articles require source citations **with clickable URLs** — no plain-text references. AI-assisted content undergoes fact-checking before merge. See EDITORIAL.md and CONTRIBUTING.md. --- 🔐 Protico Community Chat Disclosure Selected pages on the public site currently embed a sponsor-provided Protico community chat / lobby widget: • • • • This note is here so contributors know what the embed is for, what client-side context it may use, and when it loads. | Data / behavior | Why it exists | | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Persistent anonymous UUID and related us…