贡献者: addis
本文主要介绍如何使用 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 的 “修改中” 部分再修改(速编速度快,适用于大幅度修改)。
\begin{document}
上,这时再按编译会提示你删除所有临时文件,按确定,再次编译即可。如果还不行,就说明仍然有错误。