内容编写指引
内容编写指引
本页讨论的是「怎样把一篇物理内容写成适合学习的页面」．Markdown 语法、排版、LaTeX 和文件存储规则仍以 格式手册 为准；本页更关心的是叙事、结构、例题和读者体验．
目标读者
Physics Learning Wiki 当前优先服务两类读者：
- 第一次系统接触该主题的本科生．
- 已有零散基础、但缺少整体框架的自学者．
因此，一篇页面首先要能帮助读者建立主线，而不是优先追求炫技、信息密度或「把所有细节一次讲完」．
总原则
- 先回答「为什么要学这个」，再给定义、定律和公式．
- 每一页都要告诉读者：本页在解决什么问题、依赖什么先修、读完后应该去哪里．
- 先建立物理图像，再补数学表达；先给主线，再放补充．
- 例题服务于概念，不要让大量运算把主线淹没．
- 如果一段内容只适合已经学过该主题的人，应明确标成「进阶补充」，不要塞进主线正文．
关于 ??? note、??? warning、???+ note 等信息框应该装什么内容，见 信息框与补充内容规范．
推荐页面骨架
一篇面向学习者的正文页，通常应包含以下八个部分：
- 本页要解决什么问题．
- 现象、疑问或反例引入．
- 核心对象与基本定义．
- 模型、定律、公式或推导．
- 典型例题．
- 常见误区与边界条件．
- 与前后章节的连接．
- 参考资料与延伸阅读．
并非每一页都要机械地写出八个二级标题，但读者应该能够在阅读中明确感受到这八类信息．
Why 推进写法
对于初学者，最容易失去兴趣的时刻往往不是「公式很难」，而是「不知道这里为什么突然要定义一个新量」．因此，建议在页面开头明确回答以下问题：
- 眼前的现象或困难是什么．
- 旧工具为什么不够用．
- 这页引入的新概念到底解决了什么问题．
- 学完这页后，读者应该能判断什么、解释什么、计算什么．
一个常见的四步写法是：
- 从一个真实现象、典型题目或常见困惑切入．
- 指出直觉解释或旧概念的局限．
- 引入本页的新概念、新模型或新定律．
- 给出「学完本页你应该得到什么能力」的说明．
例题应该怎么写
例题不是为了展示作者会算，而是为了帮助读者学会建模和判断．建议每道例题至少回答下面六个问题：
- 这道题为什么放在这里．
- 它训练的核心能力是什么．
- 题目中的系统、对象和假设是什么．
- 解题时为什么选用这组物理量、方程或守恒律．
- 结果的物理意义是什么．
- 初学者最容易错在哪里．
例题推荐模板
可以参考下面的顺序组织例题：
- 题目背景：只保留理解问题所需的条件．
- 设定与假设：说明研究对象、理想化条件、符号和正负号约定．
- 建模：指出使用哪条定律、哪种守恒关系或哪种近似．
- 推导：展示关键步骤，不要无说明地大跳步．
- 结果解释：解释结果为什么合理，必要时讨论极限情形．
- 易错点：指出最常见的概念混淆、符号错误或适用条件误用．
如果题目来自教材、竞赛或公开题库，请尽量注明来源；如果题目过长，应当在不改变物理本质的前提下进行必要压缩．
常见写作问题
- 只有定义和公式，没有问题意识，读者不知道这一页为什么存在．
- 只讲推导，不讲物理图像，读者会算但不会解释．
- 例题步骤过于简略，关键假设和变量定义缺失．
- 把进阶细节和主线正文混在一起，初学者第一遍就被淹没．
- 章节之间没有连接，读者学完一页不知道下一步该看什么．
发布前自检
在提交页面前，建议至少检查下面几件事：
- 一个第一次接触该主题的读者，能否从前两段看出这页的目的．
- 每个新符号是否在首次出现时被定义．
- 是否明确说明了公式或模型的适用条件．
- 是否至少有一个能体现核心思想的例题或例子．
- 是否提示了常见误区、反例或失效条件．
- 是否给出了前置页面和后续页面的连接．
- 是否区分了主线正文与补充内容．
章节补充说明
总规范之外，各学科还应该有自己的章节级说明，用来规定叙事重点、常见误区和例题风格．目前已经开始建设的示例是：
后续实验物理、计算物理与工具，以及更细分的学科子模块也应逐步补齐各自的章节说明．
本页面最近更新：2026/7/3 22:14:58，更新历史
发现错误？想一起完善？ 在 GitHub 上编辑此页！
本页面贡献者：Leafuke, Physics Learning Wiki
本页面的全部内容在 CC BY-SA 4.0 和 SATA 协议之条款下提供，附加条款亦可能应用