Centos 8 FPC 生成文档

折腾了好久,终于可以生成同 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 仓库