如何在DITA-OT 4.x中无需插件修改隐藏短文档的目录与封面

以下是几个无需修改或创建插件、仅针对个别交付物生效的简化方案：

方案1：DITA Map + 自定义CSS控制 #

1. 在需要隐藏封面/目录的目标DITA Map的<map>标签上添加自定义outputclass：

   <map outputclass="no-front-matter" title="短指南标题">
     <!-- 地图内容 -->
   </map>
   

2. 创建一个自定义CSS文件（比如hide-front-matter.css），添加如下规则：

   /* 匹配带no-front-matter属性的地图，隐藏封面 */
   *[outputclass="no-front-matter"] *[class~="front-page/front-page"] {
       display: none !important;
   }
   /* 匹配带no-front-matter属性的地图，隐藏目录 */
   *[outputclass="no-front-matter"] *[class~="toc/toc"] {
       display: none !important;
   }
   

3. 转换时通过--css参数指定该CSS，仅对当前文档生效：

   dita -f pdf2 -i your-short-guide.ditamap -o output-dir --css hide-front-matter.css
   

方案2：直接使用pdf2内置转换参数 #

DITA-OT 4.x的pdf2插件自带可直接控制的参数，无需额外文件：

• 隐藏封面：添加参数--pdf2.hide.front.cover=true
• 隐藏目录：添加参数--pdf2.toc=none

在命令行中使用示例：

dita -f pdf2 -i your-short-guide.ditamap -o output-dir --pdf2.hide.front.cover=true --pdf2.toc=none

如果用Oxygen XML Editor，可针对该短文档创建专属转换场景，在场景的「参数」面板中添加这两个参数，生成时选择该场景即可，不会影响其他文档的转换配置。

方案3：Oxygen场景局部配置（仅适用于Oxygen用户） #

如果用Oxygen管理文档：

1. 复制默认的pdf2转换场景，命名为「短指南无封面目录」
2. 在场景的「CSS」选项卡中，添加自定义CSS（方案1中的hide-front-matter.css）
3. 或者在「参数」选项卡中直接设置pdf2.hide.front.cover为true、pdf2.toc为none
4. 生成该短文档时，选择这个专属场景执行转换即可。

注意事项 #

• 确保自定义CSS的优先级足够（用!important或更精确的选择器），避免被默认样式覆盖
• 所有方案均仅针对指定的DITA Map生效，不会影响其他文档的转换输出

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