小时百科模板使用说明

贡献者： addis

　　 本文仅供内部参考，请使用在线编辑器编辑百科（编辑器说明）。

1. 文件结构

　　 本文主要介绍如何使用 TeXlive（目前我们使用 2019 版）软件编写小时百科。假设你已经安装了软件，并且获得项目文件夹 PhysWiki。本文默认使用 TeXlive 自带的 TeXworks 编辑器。

　　 网站（wuli.wiki）上可以下载的 pdf 是由 main.tex 文件编译的，为确保软件安装成功，先打开 main.tex，选择 XeLaTeX 编译器，按绿色的箭头编译。编译完成后会出现 PhysWiki.pdf，就是网站上提供下载的 pdf。注意一次编译是不彻底的（公式引用等超链接会显示问号），需要编译两次。

　　 接下来可以了解一下文件结构，打开 main.tex 可以看到文件中只列出了所有文章的中文标题和英文 label（label 用于引用某篇文章或该文章中的公式图片等）。例如 \entry{牛顿运动定律、惯性系}{New3} 中，第一个大括号就是文章的标题，而 New3 就是该文章的 label。

　　 每篇文章的内容都单独放在 contents 文件夹中与 label 同名的 tex 文件中，例如打开 contents/New3.tex 就可以看到 “牛顿运动定律、惯性系” 的正文内容。注意 \entry{} 是一个自定义的命令（不是 LaTeX 本来就有的），它的定义可以在 others/format.tex 中找到。作用是创建一个 subsection 并将文章文件中的内容插入。小时百科中所有自定义的命令和使用的宏包都可以在 format.tex 中找到。

　　 main.tex 编译起来非常慢，而且直接在上面打草稿是不允许的。所以如果要新建或修改一篇文章，我们需要使用 Debug.tex。Debug.tex 的结构和用法与 main.tex 完全相同。唯一的不同是 Debug.tex 里面只有正在写作和正在修改的文章。我们规定 “创作中” 的文章不能出现在 main.tex 中（不能删除，只能移动到 main.tex 中），“修改中” 的文章必须出现在 main.tex 中（可以随意添加删除）。

　　 小时百科所用的所有自定义命令和编写规范可以在小时百科文章示例和小时百科编写规范中找到。要创建新文章，先在 “创作中” 部分写一个新的 entry 命令，再在菜单中新建 tex 文件，保存到 contents 文件夹中，首行注释中文标题（空格不需要反斜杠）。要修改一篇文章，既可以直接在文章文件中修改（适用于少量错误，例如个别符号打错，调整图片尺寸），也可以先把 entry 命令从 main.tex 中复制到 Debug.tex 的 “修改中” 部分再修改（速编速度快，适用于大幅度修改）。

2. 编译错误

• 预防错误的最好方法就是每隔一小段时间就编译一次，这样不看命令行也能知道是哪里导致的错误。
• 编译时出现的命令行会进一步提示错误信息，如错误的原因以及发生错误的行号，但不会提示是哪个文件。
• 当发生某些严重错误（例如少了一个大括号或美元符号）时再次编译，命令行会卡在 \begin{document} 上，这时再按编译会提示你删除所有临时文件，按确定，再次编译即可。如果还不行，就说明仍然有错误。