DocBook后端输出时如何为标题页添加Logo？

DocBook本身支持在标题页添加Logo，但你用的配置方式不对，以下是正确的实现方法：

• 原生DocBook文档配置
  直接在DocBook的<bookinfo>（书籍类型）或<articleinfo>（文章类型）节点中添加<mediaobject>标签插入Logo，示例代码：

  <bookinfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="images/titleimage.png" format="PNG"/>
      </imageobject>
    </mediaobject>
    <title>文档主标题</title>
    <subtitle>文档副标题</subtitle>
  </bookinfo>
  

• 若使用Asciidoctor生成DocBook
  你之前用的:title-logo-image不是正确属性，应该用:title-logo直接指定图片路径，示例配置：

  :title-logo: images/titleimage.png
  

  同时要确保Asciidoctor生成的DocBook包含Logo相关元素，并且对应的DocBook XSLT样式表启用了标题Logo渲染（可通过设置XSL参数title.logo="1"开启）。

• 额外检查项

  • 确认图片路径正确，需相对于DocBook输出文件的位置，或DocBook处理器能正确解析的路径
  • 若使用自定义XSLT样式表，需确保样式表中包含标题Logo的布局逻辑

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