vern@2008-05-21:/bin% ls tags
hack and asciidoc

asciidoc pdf fop 中文

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

1. 根据 asciidoc 规则编写文档
/ 2. 由 asciidoc 生成
|/ 3. 由 xsltproc 生成
||/ 4. 由 fop 生成
|||/
*    foo.txt  asciidoc 源代码
 *   foo.xml  docbook 源代码
  *  <a href="http://foo.fo">foo.fo</a>   fo 源代码
   * foo.pdf  PDF 文档</tt></pre>

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

安装工具

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

简单配置

自行修改 /etc/asciidoc/docbook-xsl/fo.xsl 以便支持中文,这里之列出差异 ```diff 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 --> left/xsl:param

- + + + 12/xsl:param xsl:textpt/xsl:text ```

添加源代码高亮支持 % sudo cp /usr/share/doc/asciidoc/examples/so*/so*.conf /etc/asciidoc/filters/

准备 fop 可识别的字体配置文件 拷贝 simsun.ttf 和 simhei.ttf,这里假设拷贝到 /sun/backup/fonts 目录 % export FONTDIR=/sun/backup/fonts/ % cp simsun.ttf simhei.ttf $FONTDIR

在工作目录下创建字体模板,建议直接在用户家目录下创建 % cd % fop-ttfreader -ttcname "simsun" $FONTDIR/simsun.ttf ~/.fop.simsun % fop-ttfreader -ttcname "simhei" $FONTDIR/simhei.ttf ~/.fop.simhei

在工作目录下创建字体配置文件,建议直接在用户家目录下创建 % 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 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