如何移除XSL-FO中仅含页眉页脚的空页序列？

核心问题根源 #

你遇到的空页，是因为在横向模块结尾无条件生成了无内容的纵向页序列——当后续没有需要显示的纵向模块时，这个空页序列就会输出仅含页眉页脚的空白页。

可行解决方案 #

1. 动态判断，仅在需要时切换回纵向 #

不要在横向模块结尾强制切回纵向，而是通过XML的条件判断，检查后续是否存在需要展示的纵向模块。只有确认有后续纵向内容时，才生成切回纵向的逻辑。

示例XSL代码片段：

<!-- 横向模块的结尾部分 -->
<xsl:if test="following-sibling::module[@type='portrait' and @include='true']">
  <!-- 仅当后续有要显示的纵向模块时，才生成纵向页序列的切换 -->
  <fo:page-sequence master-reference="portrait-master">
    <fo:flow flow-name="xsl-region-body">
      <!-- 这里不需要填充内容，后续纵向模块会衔接在此页序列之后 -->
    </fo:flow>
  </fo:page-sequence>
</xsl:if>

2. 让模块自主管理页面方向（推荐） #

完全去掉手动切换页序列的逻辑，让每个模块根据自身类型直接指定对应的页序列主引用。XSL-FO处理器会自动处理页面方向的切换，且不会生成无内容的空页。

示例实现：

<!-- 遍历所有模块 -->
<xsl:for-each select="module">
  <xsl:if test="@include='true'">
    <!-- 根据模块类型选择对应的页模板 -->
    <fo:page-sequence master-reference="{@type='landscape' ? 'landscape-master' : 'portrait-master'}">
      <fo:flow flow-name="xsl-region-body">
        <!-- 渲染模块内容 -->
        <xsl:apply-templates select="."/>
      </fo:flow>
    </fo:page-sequence>
  </xsl:if>
</xsl:for-each>

这种方式彻底避免了多余的页序列，逻辑更清晰，也不会出现空页问题。

3. 配置页序列的强制生成属性 #

如果必须保留手动切换逻辑，可以给空的纵向页序列添加force-page-count="no-force"属性，告诉FO处理器：如果该页序列没有内容，就不要生成页面。

示例：

<fo:page-sequence master-reference="portrait-master" force-page-count="no-force">
  <fo:flow flow-name="xsl-region-body">
    <!-- 无内容 -->
  </fo:flow>
</fo:page-sequence>

注意：这个属性的兼容性取决于你使用的FO处理器（比如Apache FOP、RenderX XEP等），部分处理器可能对该属性的支持有限，优先推荐前两种方案。

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