DITA-OT输出PDF的样式设计

Fo:block 带有的start-indent会传递到其下级标签中去。

把任务步骤写到表格中的方法:

任务步骤task/steps放在表格里

关于dita-ot 用fop不出索引的说明

  1. 基本原因是fop不支持索引元素,所以它出来的fo文件里根本就没有indexterm,只是加了个inline
  2. fop目前最新的1.1也不支持这个功能
  3. fop曾经支持过,采用猜测页码的方法来做,index.xsl等文件都在,另有一个index-fop.xsl,这个文件的作用是取消fop的索引功能,如果强行打开,则会出错而不能生成pdf
  4. 目前只能采用xep/ah等其他fop来制作index
  5. ditac项目可以出index,但它的模板定制又是另外的工作

DITA-OT1.8\plugins\org.dita.pdf2\cfg\common\index\zh_CN.xml 此文件中有关于索引的本地化内容,主要是索引项目分类

封面背面的版权页因为采用直接在封面上分页的方法,所以还是用了body的属性,哪怕是作为notice.dita存在,其header/footer都用body的

采用XEP作fop输出了pdf,可以制作出索引了。

DITA-OT采用XEP的方法

RenderX XEP 个人版的下载地址: http://www.renderx.com/download/personal.html

DITA-OT1.8\local.properties 这个文件里似乎没有用:

<property name="xep.dir" value="C:/Users/s21917/XEP" />
<property name="pdf.formatter" value="xep" />

后来这两行写到了 build.xml里面,就可以了,放在最上面:

  <property file="${basedir}/local.properties"></property>
  <property name="xep.dir" value="C:/Users/s21917/XEP" />
<property name="pdf.formatter" value="xep" />

写完后要在dita目录下运行一下:

Run startcmd.bat and then run the integrator from the command window it starts:
ant -f integrator.xml

使用xep的命令如下:

DITA-OT1.8>ant -f mybuild.xml -Dpdf.formatter=xep

注意:

  1. 使用XEP作fop不影响原来对dita-ot作的定制,全部效果都在。
  2. 但是原来对fop做的字体等设置就无效了,需要再次设定xep的字体。
  3. 设定xep的字体可以使用xep assistantXEP\x4u.bat,是个java程序
  4. XEP\fonts目录下有xep自带的字体,没有中文
  5. xep assistant程序中有对字体的设置,加上simsun.ttc就可以了. XEP/xep.xml文件中就是这个配置。
  6. XEP的doc目录下有文档
  7. XEP可以出索引,样子还行。
  8. XEP使用的各种距离似乎要大一些,尤其是目录,图片似乎又要小一些

DITAC

另有一个dita--pdf的项目,即xmlmind dita converter,可以出很不错的index: http://www.xmlmind.com/ditac/_distrib/doc/manual/howItWorks.html#howItWorks

Ditac的下载: http://www.xmlmind.com/ditac/download.shtml

Ditac的使用

  1. 下载,解压,到一个目录
  2. 运行目录中的bat文件,设定一些环境变量
  3. 直接从命令行运行:
    $ ditac -fop /opt/fop/fop out/manual.pdf manual.ditamap
     or:
     $ ditac -xep /opt/xep/xep out/manual.pdf manual.ditamap
     or:
     $ ditac -ahf "C:\AHFv6\AHFCmd.exe" out/manual.pdf manual.ditamap
    
  4. 样式也不好看
  5. 可以出index