本地预览

发送 PR 后自动化工具会帮你进行检查，不需要本地运行。 如果需要大规模改动或较为频繁的翻译，可以搭建本地运行环境。

整个编译跑起来较为复杂，本文档尽量详细描述。也可以参考 Travis CI 来查看 CI 上的编译流程。

软件安装

本项目的编译过程涉及的外部工具包括：GNU utils, fpc, whatwg/wattsi、whatwg/html、whatwg-cn/html-build。 其中 whatwg/html 在同步最新英文版时会由 Makefile 获取，whatwg-cn/html-build 会在编译时下载也可以提前下载好（参考 Makefile）。

fpc

fpc（Free Pascal Compiler）是用来编译 wattsi 的，如果你不需要 wattsi（见下文）也不必安装 fpc。

• Linux: wattsi 要求 fpc 3.0.0 以上。当前 Ubuntu 的 APT 源可能版本不够新，可以来这里下载：https://www.freepascal.org/download.var 适用于你的平台的 fpc。
• Mac：更新 XCode 命令行工具，然后安装 fpc，fpcsrc，以及 lazarus。

wattsi

whatwg/wattsi 是用来编译 HTML 的工具，把一个标准文档编译成一个静态站点。 可以不安装它，后续脚本会直接访问 wattsi-server 只是比较慢。

GNU Utils

make、sed 等工具用于各个步骤的编译脚本中，如果你在 Linux 或 Mac 下这些软件多数是可用的，否则请自行安装 GNU Utils。

注意 MacOSX 下的 sed 默认为 BSD sed，对 sed -e 参数支持不完整，需要单独安装 GNU sed。

NPM

最后你需要一个 Node（它会帮你安装 npm），安装好之后在本项目根目录下执行：

npm install

翻译和预览

找一个比较稳定的（修改不那么频繁的）章节来开始翻译：

npm run findone

编译翻译后的文件：

npm run build

启动服务器：

npm start