xreflabel

BoostBookというよりDocBookの話なんですが、

<section id="bbv2.targets.common">
  <title>共通構文</title>
</section>

という要素に<xref linkend="bbv2.targets.common"/>でクロスリンクを張ると、リンク元のテキストが「共通構文項」のようになってカッコ悪く、結局<link>を使ったりしていました。


ドキュメントをよく読んだら、xreflabelという属性があることに気が付きました。

<section id="bbv2.targets.common" xreflabel="共通構文">
  <title>共通構文</title>
</section>

これで余分な「項」が取れました。