如何用AntennaHouse Formatter v73将DITA-OT PDF2输出转为全灰度？

可行性结论 #

完全可行，推荐两种无需逐个元素修改的全局处理方案：AntennaHouse Formatter原生全局灰度转换（效率最高）或PDF后处理（兼容性好），均可通过自定义DITA-OT插件添加开关参数实现一键切换。

方案一：利用AntennaHouse Formatter原生灰度转换（推荐） #

AntennaHouse Formatter v73支持通过ah-color-profile属性全局将所有内容（文本、背景、图片）转换为灰度，无需单独处理每个元素。

实现步骤 #

1. 创建自定义DITA-OT插件
   在插件的plugin.xml中声明依赖和扩展点：

   <plugin id="com.yourorg.grayscale.pdf">
     <require plugin="org.dita.pdf2"/>
     <feature extension="dita.conductor.param" value="params.xml"/>
     <feature extension="dita.xsl.xslfo" value="xsl/grayscale-fo.xsl"/>
   </plugin>
   

2. 添加灰度开关参数
   在params.xml中定义布尔型参数，用户可通过-Dpdf.grayscale=true触发灰度模式：

   <params>
     <param name="pdf.grayscale" type="boolean" default="false" desc="Enable grayscale PDF generation"/>
   </params>
   

3. 注入灰度转换配置
   在grayscale-fo.xsl中扩展FO生成逻辑，根据参数值为全局页面添加灰度配置：

   <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
                   xmlns:fo="http://www.w3.org/1999/XSL/Format"
                   version="2.0">
     <!-- 为根页面序列注入灰度配置 -->
     <xsl:template match="fo:root">
       <xsl:copy>
         <xsl:if test="$pdf.grayscale = 'true'">
           <xsl:attribute name="ah-color-profile">grayscale</xsl:attribute>
         </xsl:if>
         <xsl:apply-templates select="@*|node()"/>
       </xsl:copy>
     </xsl:template>
   </xsl:stylesheet>
   

   也可通过自定义CSS实现，在插件的CSS文件中添加条件样式：

   <xsl:if test="$pdf.grayscale = 'true'">
     <![CDATA[
       @page {
         ah-color-profile: grayscale;
       }
     ]]>
   </xsl:if>
   

方案二：PDF后处理（基于Ghostscript） #

如果不想修改FO/CSS配置，可在DITA-OT生成彩色PDF后，用Ghostscript批量转换为灰度。

实现步骤 #

1. 添加后处理Ant任务
   在插件的build.xml中定义执行Ghostscript的任务，通过参数控制是否执行：

   <project name="grayscale-postprocess" default="grayscale">
     <target name="grayscale" if="pdf.grayscale">
       <exec executable="gs" failonerror="true">
         <arg value="-sDEVICE=pdfwrite"/>
         <arg value="-sOutputFile=${output.dir}/${output.base}.pdf"/>
         <arg value="-sColorConversionStrategy=Gray"/>
         <arg value="-dProcessColorModel=/DeviceGray"/>
         <arg value="-dNOPAUSE"/>
         <arg value="-dBATCH"/>
         <arg value="${output.dir}/${output.base}_temp.pdf"/>
       </exec>
       <!-- 删除临时彩色PDF -->
       <delete file="${output.dir}/${output.base}_temp.pdf"/>
     </target>
   </project>
   

2. 关联DITA-OT构建流程
   在plugin.xml中扩展PDF2的后处理步骤：

   <feature extension="dita.conductor.target.relative" file="build.xml"/>
   <feature extension="org.dita.pdf2.postprocess" value="grayscale-postprocess.grayscale"/>
   

3. 注意事项

   • 需确保环境中已安装Ghostscript，且gs命令可被DITA-OT调用。
   • 生成时先输出临时彩色PDF，转换后替换为灰度版本。

方案对比 #

内容的提问来源于stack exchange，提问作者Davide