PostgreSQL离线手册发布步骤

下面以PostgreSQL 11.2为例，介绍PostgreSQL离线版中文手册的编译步骤，本步骤只适用于PG11以上版本。

1. 环境准备

准备一个ubuntu环境(以下基于Ubuntu 18.04.3)，并安装编译文档需要的软件

sudo apt install gcc make libreadline-dev zlib1g-dev
sudo apt install docbook-xml docbook-xsl fop libxml2-utils xsltproc
sudo apt install dbtoepub

2. 准备源码

下载PostgreSQL中文手册Github仓库

git clone https://github.com/postgres-cn/pgdoc-cn.git

下载对应版本的PostgreSQL源码并解压

wget https://ftp.postgresql.org/pub/source/v11.2/postgresql-11.2.tar.gz
tar xzf postgresql-11.2.tar.gz

拷贝github中的sgml文件到PostgreSQL源码中的对应位置

cp -rf pgdoc-cn/postgresql/doc/src/sgml postgresql-11.2/doc/src/

更新文档修改日期

cd postgresql-11.2
echo sed -e 's/\$\{updatedate\}/'`date +%Y-%m-%d`'/' -i doc/src/sgml/pgdoccn-notes.sgml|sh

3. 编译HTML手册

./configure
cd doc/src/sgml
make html
mv html PostgreSQL11.2-CN-HTML-v1.0
tar cfz PostgreSQL11.2-CN-HTML-v1.0.tar.gz PostgreSQL11.2-CN-HTML-v1.0

4. 编译PDF手册

make postgres-A4.fo
sed -e 's/font-family="/font-family="SimSun,/g' -i postgres-A4.fo
cp ../../../../pgdoc-cn/tools/fo2pdf/{fopcfg.xml,simsun.ttc,simsun.xml} ./
ADDITIONAL_OPTIONS="-Xms1600m" fop -fo postgres-A4.fo -pdf postgres-A4.pdf -c fopcfg.xml
mv postgres-A4.pdf PostgreSQL11.2-CN-v1.0.pdf

5. 编译EPUB手册

make epub
mv postgres.epub PostgreSQL11.2-CN-v1.0.epub