# Writing and Illustration Guidelines

Section from the Chinese-language The Ultimate Train Fan Encyclopedia: 《超级火车迷百科全书》写作与绘图约定.

## Metadata

- HTML: https://glenzli.com/en/dr-stochastic-parrot/super-train-encyclopedia/style-guide/
- Markdown: https://glenzli.com/en/dr-stochastic-parrot/super-train-encyclopedia/style-guide.md
- Collection: Dr. Stochastic Parrot
- Language: en
- Published: 2026-07-19
- Status: published
- Tags: ai-generated, stochastic-parrot, children, science, trains, visual-encyclopedia

## Content

这套书写给 **4 岁左右的孩子**，也写给坐在旁边朗读的大人。它不是考试课本，而是一趟可以随时上车、随时下车的火车旅行。

## 我们怎样说话？

- 从孩子会问的问题开始，例如“火车为什么不会迷路？”
- 一句话只说一件事；正文每句尽量不超过 24 个汉字。
- 先用能看见、能听见的现象，再说必要的名称。
- 拟声词可以帮助理解，但不把每种火车都写成同一种声音。
- 不说“很简单”“你当然知道”，也不要求孩子背型号、年代或数字。
- 遇到例外，使用“常常”“有些”“不一定”，不把常见情况说成绝对规律。

## 每个小问题怎样排？

原理章节统一使用下面的节奏：

1. 一个问句标题。
2. 一幅原创示意图，配清楚的替代文字。
3. 三至五句适合朗读的短句。
4. 一段可跳过的“给大人再讲一点”，说明机制、条件和例外。
5. 一个不用靠近轨道的“安全观察”。

儿童正文先满足孩子的好奇心。更精确的术语可在第一次出现时顺手解释，但一节一般不超过三个新词。成人层可以更精确，却仍用完整短句，并明确示意图省略了什么、哪些说法只适用于常见设计。

车型卡继续使用连续三位编号；本版为 001—160，新增卡片从 161 继续。每张卡保留一幅主图、“出生卡”、适合朗读的短正文、“找找看”、“给大人”小字和图片署名链接。

## 车型卡住在哪一章？

- 每张车型卡只保留一个正文归属，优先按照孩子能观察的工作或运行办法选择。
- 国家、铁路公司、动力来源和旅行路线可以交叉重叠，放进专题索引，不复制整张车卡。
- 日本专题、地点索引和今后的公司专题都是“另一扇入口”，不是另一套正文。
- 移动车卡时保留三位编号、图片文件名与图片署名锚点；新增卡才使用新的编号。
- 同步更新两份图片元数据中的 `chapter`、首页入口、专题索引与验证器，并确认一张卡没有住进两个章节。
- 章节较长时，按孩子能说出来的本领分成“小站”，每站约 3—5 张；一次只读一站也应当完整。

## 图要长什么样？

- 一张图只讲一个主要动作。
- 线条粗、轮廓清楚，在手机小屏幕上也能看懂。
- 运动方向同时使用箭头或形状，不只依靠颜色。
- 颜色保持明亮、柔和，并让深色轮廓提供足够对比。
- 图内尽量不放文字；解释放在图下正文里。
- 每幅 SVG 都要有 `title` 和 `desc`，方便屏幕阅读器说明图意。
- 原理图不是工程图，不用它判断真实距离、速度、尺寸或施工方式。

## 怎样写得准确又不吓人？

- 把“车轮内侧的轮缘”写成偶尔帮助限位，不说它一直夹着铁轨。
- 把“再生制动”写成有条件地回收能量，不说每次刹车都能全部变回电。
- 把“磁悬浮”写成一大类技术，不暗示所有磁悬浮列车原理完全相同。
- 把信号写成铁路安全系统的一部分，不鼓励孩子凭灯色猜列车会不会开。
- 区分“看起来悬空”和“使用磁力悬浮”：悬挂式单轨通常是轮子在上方轨道里滚动。
- 把轮缘写成偏移过大时的限位帮手；日常导向还来自轮轨踏面轮廓和滚动半径差。
- 把自动空气制动的“失压施加”限定为经典系统原理，不说任何故障都一定能安全停车。
- 把流线形写成车头、车身、车底和线路环境共同参与的设计，不说鼻子越长就一定越快。

## 安全观察的底线

安全观察只能在这些地方进行：站台安全线以内、封闭车厢内、合法观景区、铁路博物馆展区，或由大人选择的公开视频和图片。

永远不建议孩子进入轨道、跨越护栏、触摸供电设备、把手脚伸出车外，或为了拍照靠近正在运行的车辆。看到掉进轨道的物品，要找工作人员，不能自己捡。

## 给协作者的快速检查

提交新章节前，请逐项确认：

- 标题真的是孩子可能问的问题吗？
- 每节有没有且只有一幅主图？
- 正文是不是三至五句短句？
- 有没有把“常见”误写成“永远”？
- 不看颜色，箭头和轮廓仍能说明动作吗？
- 安全观察能否在不靠近设备的地方完成？
- 文件名、图片路径和替代文字是否清楚？
- 新车型卡是否同步更新目录、事实来源、图片目标、图片署名和验证器？