Asciidoc生成PDF时长章节页眉标题与公司logo重叠，如何设置短标题？

你当前使用的asciidoctorj-pdf-plugin 1.6.0版本原生支持短章节标题特性，无需升级依赖，按以下两步配置即可：

1. 修改adoc文档的章节定义 #

在长标题的章节标记后添加short属性，填入你想要在页眉展示的短标题内容，示例如下：

= Lorem ipsum dolor sit amet
:doctype: book
:encoding: utf-8
:lang: en
:toc: macro
:toclevels: 2
:numbered:

toc::[]

== [short=简化章节标题] Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.

2. 调整theme.yml的页眉配置 #

将页眉中使用的{chapter-title}变量替换为{chapter-short-title}，配置如下：

recto:
    left:
        content: '{document-title}'
    right:
        content: image:logo.png[width=200]
verso:
    left:
        content: '{chapter-short-title}'
    right:
        content: $header-recto-right-content

如果某章节没有配置short属性，插件会自动使用完整章节标题作为兜底，不会出现渲染异常。 #

可选补充方案（无需单独定义短标题） #

如果不想手动给每个长章节配置短标题，也可以在theme.yml中添加页眉文本截断规则，超出长度自动显示省略号，配置示例：

header:
  truncate: ellipsis
  max-width: 300 # 可根据实际页眉可用宽度调整数值
recto:
    left:
        content: '{document-title}'
    right:
        content: image:logo.png[width=200]
verso:
    left:
        content: '{chapter-title}'
    right:
        content: $header-recto-right-content

内容的提问来源于stack exchange，提问作者The 5th column mouse