Asciidoc2Pdf

通过 fop，将由 Asciidoc 生成的 Docbook 文件转换成 Pdf 文档。支持中文(必须是 ttf 字体)。

 1. 根据 asciidoc 规则编写文档
/ 2. 由 asciidoc 生成
|/ 3. 由 xsltproc 生成
||/ 4. 由 fop 生成
|||/
*    foo.txt  asciidoc 源代码
 *   foo.xml  docbook 源代码
  *  foo.fo   fo 源代码
   * foo.pdf  PDF 文档

经过配置，以上 4 步可由一个命令完成。

安装工具

% sudo apt-get install asciidoc fop xsltproc sun-java5-jre source-highlight docbook-xsl libxext6

简单配置

• 自行修改 /etc/asciidoc/docbook-xsl/fo.xsl 以便支持中文，这里之列出差异

  diff --git a/docbook-xsl/fo.xsl b/docbook-xsl/fo.xsl
  index 37e1de4..f99fc3e 100644
  --- a/docbook-xsl/fo.xsl
  +++ b/docbook-xsl/fo.xsl
   @@ -25,7 +25,9 @@
   <!-- justify, left or right -->
   <xsl:param name="alignment">left</xsl:param>
  
  -<xsl:param name="body.font.family" select="'serif'"/>
  +<xsl:param name="sans.font.family" select="'SimSun'"/>
  +<xsl:param name="title.font.family" select="'SimHei'"/>
  +<xsl:param name="body.font.family" select="'SimSun'"/>
   <xsl:param name="body.font.master">12</xsl:param>
   <xsl:param name="body.font.size">
     <xsl:value-of select="$body.font.master"/><xsl:text>pt</xsl:text>
  

• 添加源代码高亮支持

  % sudo cp /usr/share/doc/asciidoc/examples/so*/so*.conf /etc/asciidoc/filters/

• 准备 fop 可识别的字体配置文件

  1. 拷贝 simsun.ttf 和 simhei.ttf，这里假设拷贝到 /sun/backup/fonts 目录

     % export FONTDIR=/sun/backup/fonts/
     % cp simsun.ttf simhei.ttf $FONTDIR

  2. 在工作目录下创建字体模板，建议直接在用户家目录下创建

     % cd
     % fop-ttfreader -ttcname "simsun" $FONTDIR/simsun.ttf ~/.fop.simsun
     % fop-ttfreader -ttcname "simhei" $FONTDIR/simhei.ttf ~/.fop.simhei

  3. 在工作目录下创建字体配置文件，建议直接在用户家目录下创建

     % vi ~/.fop.conf

     <?xml version="1.0"?>
     <fop version="1.0">
     <base>.</base>
       <renderers>
        <renderer mime="application/pdf">
           <filterList>
              <value>flate</value>
         </filterList>
          <fonts>
            <font metrics-file="/sun/home/.fop.simsun" kerning="yes" embed-file='/sun/backup/fonts/simsun.ttf'>
              <font-triplet name="SimSun" style="normal" weight="normal"/>
              <font-triplet name="SimSun" style="italic" weight="normal"/>
            </font>
             <font metrics-file="/sun/home/.fop.simhei" kerning="yes" embed-file='/sun/backup/fonts/simhei.ttf'>
              <font-triplet name="SimHei" style="normal" weight="normal"/>
              <font-triplet name="SimHei" style="italic" weight="normal"/>
              <font-triplet name="SimHei" style="normal" weight="bold"/>
              <font-triplet name="SimHei" style="italic" weight="bold"/>
             </font>
          </fonts>
        </renderer>
     </renderers>
     </fop>

Warning

上面 metrics-file 和 embed-file 随后的路径必须是绝对路径 (在这里 ~/ 不被认为是 绝对路径)。我的用户家目录是 /sun/home，你的可能是 /home/YOUR。请自行更正。

• 自行编辑 /usr/bin/a2x 脚本简化 PDF 生成步骤，这里只列出差异

  diff --git a/a2x b/a2x
  index 5ea63cb..77e7176 100755
  --- a/a2x
  +++ b/a2x
  @@ -487,7 +487,7 @@ function to_pdf()
        to_docbook
       execute_command_2 "xsltproc $XSLTPROC_OPTS --nonet \
           \"$xsl\" \"$xml\" >\"$fo\""
  -    execute_command_2 "fop \"$fo\" \"$pdf\""
  +    execute_command_2 "fop -c ~/.fop.conf \"$fo\" \"$pdf\""
   }
  
   function to_text()
  

测试试用

下载 本页的 asciidoc 代码，生成 PDF 文档:

% a2x -f pdf index.txt