当AsciiDoc处理器自动生成节ID时,它会用下划线作为值的开头,并且每个单词之间使用连字符。这些字符可以通过`idprefix`和`idseparator`属性进行自定义。
更改ID前缀
默认情况下,AsciiDoc处理器在自动生成的节ID前会加上一个下划线(_
)。这个默认设置在使用交叉引用(无论是在同一个文件内还是链接到另一个文件的深层链接)引用ID时可能会造成问题。前导下划线可能会与段落中其他地方的下划线匹配,因此导致意外的文本格式化。一种解决办法是通过在ID前加上`{empty}`(例如,{empty}_section_title
)来打断匹配,或者使用属性来引用目标。相反,我们强烈建议您自定义ID前缀。
您可以通过设置`idprefix`属性并为其赋予新的值来更改这个前缀。`idprefix`的值必须以有效的ID起始字符开头,并且可以包含任意数量的额外有效ID字符。
:idprefix: id_
如果您想要移除前缀,请将属性设置为空值。
:idprefix:
Warning
|
如果你将`idprefix`设置为空,你可能会生成在DocBook输出中无效的ID(例如,以数字开头的ID)或与HTML输出中的内置ID相匹配的ID(例如,header )。在这种情况下,我们建议使用非空的`idprefix`值,或者给你的章节指定显式ID。
|
更改ID单词分隔符
默认的章节ID词分隔符是下划线(_
)。您可以通过`idseparator`属性更改分隔符。除非为空,`idseparator`的值必须是_恰好一个有效的ID字符_。
ID分隔符:-
如果您不想使用分隔符,请将属性值设置为空值。
:idseparator:
Note
|
当文档在GitHub上渲染时,idprefix`被设置为一个空值,并且`idseparator`被设置为 -`。这些设置用来确保GitHub生成的ID与Asciidoctor生成的ID相匹配。
|