折腾了好久,终于可以生成同 FPC 官方一样的文档了。
0、安装 LaTeX
文档使用 LaTeX 编写,因此,你需要先安装它,参见 centos8 安装 LaTeX。
1、克隆源码
留意,二者必须在同一目录,且目录名分别为:fpcsrc、fpcdocs。
克隆 FPC 源
git clone git@gitlab.com:freepascal.org/fpc/source.git fpcsrc # 或 git clone https://gitlab.com/freepascal.org/fpc/source.git fpcsrc
克隆 FPC 文档
git clone git@gitlab.com:freepascal.org/fpc/documentation.git fpcdocs # 或 git clone https://gitlab.com/freepascal.org/fpc/documentation.git fpcdocs
目录结构类似(且fpcsrc、fpcdocs 在同一级):
/FPC/fpcsrc/compiler
/rtl
/packages
/fpcdocs
建立 fpcdocs/dist/html/user.chk 的空文件(必须,否则生成时报错)
2、确定当前语言环境
为,en_US.UTF-8
# 执行 echo $LANG # 如果不是,请重新设置 LANG='en_US.UTF-8'
3、生成 html 文档
建立 fpcdocs/dist/html/user.chk 的空文件(必须,否则生成时报错)
make html # 或 html pdf # 查看帮助 make help
注意:第一次生成会很慢。
另外,文档部分使用了 LyX 等等工具,后续再展开细说。
相关:
FPC 仓库