Skip to content
三三 edited this page May 11, 2018 · 6 revisions

发送 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
Clone this wiki locally