三种贡献方式

1. 报告错误 / 提建议

发现内容错误、链接失效、术语翻译不当——请在 GitHub 提 Issue：

https://github.com/zizai-astrology/zizai-wiki/issues

报告时请附：词条 URL、问题位置（章节标题）、建议的修改。

2. 直接提 PR（推荐）

每个词条页面右上角有 “在 GitHub 上编辑此页” 链接，点进去直接修改并提 PR。流程：

1. Fork 本仓库
2. 修改对应的 .md / .mdx 文件
3. 提交 PR，描述清楚改了什么、为什么改
4. 维护者 review 后合并

3. 新增词条

用脚本快速创建骨架

bash scripts/create-entry.sh <type> <slug> "<title>"

参数：

• type：concept / person / technique / text / chart / book / path
• slug：URL 友好的英文小写文件名（用连字符分隔）
• title：完整词条标题，如 "必然尊贵 (Essential Dignity)"

例如：

bash scripts/create-entry.sh concept essential-dignity "必然尊贵 (Essential Dignity)"

会在 src/content/docs/concepts/essential-dignity.md 生成骨架文件。

手动创建

复制对应目录下的 _template.md，重命名为你的 slug，按模板填内容。

内容规范

1. 必须有出处。所有论断都应能追溯到一手文献（原典）或可信的二手文献（学者著作）。
2. 术语第一次出现附原文：中文术语 + 圆括号内附希腊语 / 拉丁语 / 阿拉伯语 / 英语原词。
3. 不夹带个人立场。如果不同学者有分歧，列出分歧、注明各方立场，不私自下判断。
4. 不抄袭。可以引用 Brennan、George、Hand 等学者的观点，但要标注；不要大段照搬原文。
5. 正文用衬线（中文 Noto Serif SC、拉丁文 EB Garamond），代码块用等宽字体。已通过全局 CSS 配置好，正常写 Markdown 即可。
6. 每篇词条末尾必须有”参考文献”，使用作者-年份制（不需要严格 Chicago 或 APA，但要包含作者、年份、书名、出版社、页码或章节）。

文件命名规范

• slug 必须是英文小写 + 连字符：vettius-valens、zodiacal-releasing
• 不要用驼峰、空格、中文
• 概念类用单数英文（lot，不是 lots），但已建立的复数文件可不改

frontmatter 字段

---
title: "中文名 (English Name)"
description: "一句话定义"
sidebar:
  badge:
    text: "希腊化"          # 传统标签
    variant: "note"          # note / tip / caution / danger / success
lastUpdated: 2026-01-01
---

Review 标准

PR 合并需要至少满足：

1. 内容标注了来源
2. 没有明显事实错误
3. 链接 / 锚点正常
4. Markdown 渲染正常（用 npm run build 本地构建一遍确认无报错）
5. 与已存在的词条交叉链接

协议

提交内容即同意以 CC BY-NC-SA 4.0 协议发布。