resolves #858 add support for formal xref text (PR #2220)

- store referenceable nodes under refs key in document catalog
- when registering a ref, store entry in both refs table and deprecated ids table
- update tests to use consolidated register method
- add xreftext method to AbstractBlock, Section, and Inline to produce formatted text for xref
- add API docs to the xreftext methods
- format xref text according to xrefstyle attribute, if set (full, short, or basic)
- move reftext? and reftext methods down to AbstractBlock and Inline; contextualize
- apply reftext substitutions (specialchars, quotes, replacements) to value returned by reftext method
- drop support for reftext document attribute
- don't catalog inline anchor if reftext containing attribute reference resolves to empty string
- use reftext method instead of text method for :ref in DocBook converter
- add feature tests for explicit reftext
- add feature tests for generated reftext using xrefstyle
- introduce language attributes for chapter, section, and appendix reference signifier
  * name attributes chapter-refsig, section-refsig, and appendix-refsig, respectively
- enable chapter-label attribute in translations file; map to chapter-refsig attribute to it
- map appendix-refsig attribute to value of appendix-caption attribute in translations file
- add placeholders in translations file for chapter-refsig where missing and section-refsig
- handle refsig document attribute values consistently (only use if attribute is non-nil)
- update link and xref tests to populate refs key in document catalog
- encode double quote and strip XML tags in value of xreflabel attribute in DocBook converter
- don't store return value of target in inline_anchor method of HTML converter

1 files changed, 107 insertions, 30 deletions

diff --git a/data/locale/attributes.adoc b/data/locale/attributes.adoc
index 029df599..09e8d045 100644
--- a/data/locale/attributes.adoc
+++ b/data/locale/attributes.adoc
@@ -2,14 +2,17 @@
 // See http://asciidoctor.org/docs/user-manual/#customizing-labels to learn how to use it.
 //
 // NOTE: Please use a line comment in front of the listing-caption and preface-title entries.
-// These attributes are optional and not set by default.
+// These attributes should not be set by default.
 //
 // IMPORTANT: Do not add any blank lines.
 //
 // Arabic translation, courtesy of Aboullaite Mohammed <aboullaite.mohammed@gmail.com>
 ifeval::["{lang}" == "ar"]
 :appendix-caption: ملحق
+:appendix-refsig: {appendix-caption}
 :caution-caption: تنبيه
+//:chapter-label: ???
+//:chapter-refsig: {chapter-label}
 :example-caption: مثال
 :figure-caption: الشكل
 :important-caption: مهم
@@ -18,6 +21,7 @@ ifeval::["{lang}" == "ar"]
 :manname-title: اسم
 :note-caption: ملاحظة
 //:preface-title: تمهيد
+//:section-refsig: ???
 :table-caption: جدول
 :tip-caption: تلميح
 :toc-title: فهرس
@@ -25,11 +29,13 @@ ifeval::["{lang}" == "ar"]
 :version-label: نسخة
 :warning-caption: تحذير
 endif::[]
-//
 // Bulgarian translation, courtesy of Ivan St. Ivanov <ivan.st.ivanov@gmail.com>
 ifeval::["{lang}" == "bg"]
 :appendix-caption: Приложение
+:appendix-refsig: {appendix-caption}
 :caution-caption: Внимание
+//:chapter-label: ???
+//:chapter-refsig: {chapter-label}
 :example-caption: Пример
 :figure-caption: Фигура
 :important-caption: Важно
@@ -38,6 +44,7 @@ ifeval::["{lang}" == "bg"]
 :manname-title: ИМЕ
 :note-caption: Забележка
 //:preface-title: Предговор
+//:section-refsig: ???
 :table-caption: Таблица
 :tip-caption: Подсказка
 :toc-title: Съдържание
@@ -45,11 +52,13 @@ ifeval::["{lang}" == "bg"]
 :version-label: Версия
 :warning-caption: Внимание
 endif::[]
-//
 // Catalan translation, courtesy of Abel Salgado Romero <abelromero@gmail.com> and Alex Soto
 ifeval::["{lang}" == "ca"]
 :appendix-caption: Apendix
+:appendix-refsig: {appendix-caption}
 :caution-caption: Atenció
+//:chapter-label: ???
+//:chapter-refsig: {chapter-label}
 :example-caption: Exemple
 :figure-caption: Figura
 :important-caption: Important
@@ -58,6 +67,7 @@ ifeval::["{lang}" == "ca"]
 :manname-title: NOM
 :note-caption: Nota
 //:preface-title: Prefaci
+//:section-refsig: ???
 :table-caption: Taula
 :tip-caption: Suggeriment
 :toc-title: Índex
@@ -65,11 +75,13 @@ ifeval::["{lang}" == "ca"]
 :version-label: Versió
 :warning-caption: Advertència
 endif::[]
-//
 // Danish translation, courtesy of Max Rydahl Andersen <manderse@redhat.com>
 ifeval::["{lang}" == "da"]
 :appendix-caption: Appendix
+:appendix-refsig: {appendix-caption}
 :caution-caption: Forsigtig
+//:chapter-label: ???
+//:chapter-refsig: {chapter-label}
 :example-caption: Eksempel
 :figure-caption: Figur
 :important-caption: Vigtig
@@ -78,6 +90,7 @@ ifeval::["{lang}" == "da"]
 :manname-title: NAVN
 :note-caption: Notat
 //:preface-title:
+//:section-refsig: ???
 :table-caption: Tabel
 :tip-caption: Tips
 :toc-title: Indholdsfortegnelse
@@ -85,12 +98,13 @@ ifeval::["{lang}" == "da"]
 :version-label: Version
 :warning-caption: Advarsel
 endif::[]
-//
 // German translation, courtesy of Florian Wilhelm
 ifeval::["{lang}" == "de"]
 :appendix-caption: Anhang
+:appendix-refsig: {appendix-caption}
 :caution-caption: Achtung
 :chapter-label: Kapitel
+:chapter-refsig: {chapter-label}
 :example-caption: Beispiel
 :figure-caption: Abbildung
 :important-caption: Wichtig
@@ -99,6 +113,7 @@ ifeval::["{lang}" == "de"]
 :manname-title: BEZEICHNUNG
 :note-caption: Anmerkung
 //:preface-title: Vorwort
+//:section-refsig: ???
 :table-caption: Tabelle
 :tip-caption: Hinweis
 :toc-title: Inhalt
@@ -106,11 +121,13 @@ ifeval::["{lang}" == "de"]
 :version-label: Version
 :warning-caption: Warnung
 endif::[]
-//
 // Spanish translation, courtesy of Eddú Meléndez <eddu.melendez@gmail.com>
 ifeval::["{lang}" == "es"]
 :appendix-caption: Apéndice
+:appendix-refsig: {appendix-caption}
 :caution-caption: Precaución
+//:chapter-label: ???
+//:chapter-refsig: {chapter-label}
 :example-caption: Ejemplo
 :figure-caption: Figura
 :important-caption: Importante
@@ -119,6 +136,7 @@ ifeval::["{lang}" == "es"]
 :manname-title: NOMBRE
 :note-caption: Nota
 //:preface-title: Prefacio
+//:section-refsig: ???
 :table-caption: Tabla
 :tip-caption: Sugerencia
 :toc-title: Tabla de Contenido
@@ -126,11 +144,13 @@ ifeval::["{lang}" == "es"]
 :version-label: Versión
 :warning-caption: Aviso
 endif::[]
-//
 // Persian (Farsi) translation, courtesy of Shahryar Eivazzadeh <shahryareiv@gmail.com>
 ifeval::["{lang}" == "fa"]
 :appendix-caption: پیوست
+:appendix-refsig: {appendix-caption}
 :caution-caption: گوشزد
+//:chapter-label: ???
+//:chapter-refsig: {chapter-label}
 :example-caption: نمونه
 :figure-caption: نمودار
 :important-caption: مهم
@@ -139,6 +159,7 @@ ifeval::["{lang}" == "fa"]
 :manname-title: نام
 :note-caption: یادداشت
 //:preface-title: پیشگفتار
+//:section-refsig: ???
 :table-caption: جدول
 :tip-caption: نکته
 :toc-title: فهرست مطالب
@@ -146,11 +167,13 @@ ifeval::["{lang}" == "fa"]
 :version-label: نگارش
 :warning-caption: هشدار
 endif::[]
-//
 // Finnish translation by Tero Hänninen
 ifeval::["{lang}" == "fi"]
 :appendix-caption: Liitteet
+:appendix-refsig: {appendix-caption}
 :caution-caption: Huom
+//:chapter-label: ???
+//:chapter-refsig: {chapter-label}
 :example-caption: Esimerkki
 :figure-caption: Kuvio
 :important-caption: Tärkeää
@@ -159,6 +182,7 @@ ifeval::["{lang}" == "fi"]
 :manname-title: NIMI
 :note-caption: Huomio
 //:preface-title: Esipuhe
+//:section-refsig: ???
 :table-caption: Taulukko
 :tip-caption: Vinkki
 :toc-title: Sisällysluettelo
@@ -166,11 +190,13 @@ ifeval::["{lang}" == "fi"]
 :version-label: Versio
 :warning-caption: Varoitus
 endif::[]
-//
 // French translation, courtesy of Nicolas Comet <nicolas.comet@gmail.com>
 ifeval::["{lang}" == "fr"]
 :appendix-caption: Appendice
+:appendix-refsig: {appendix-caption}
 :caution-caption: Avertissement
+//:chapter-label: ???
+//:chapter-refsig: {chapter-label}
 :example-caption: Exemple
 :figure-caption: Figure
 :important-caption: Important
@@ -179,6 +205,7 @@ ifeval::["{lang}" == "fr"]
 :manname-title: NOM
 :note-caption: Note
 //:preface-title: Préface
+//:section-refsig: ???
 :table-caption: Tableau
 :tip-caption: Astuce
 :toc-title: Table des matières
@@ -186,11 +213,13 @@ ifeval::["{lang}" == "fr"]
 :version-label: Version
 :warning-caption: Attention
 endif::[]
-//
 // Hungarian translation, courtesy of István Pató <istvan.pato@gmail.com>
 ifeval::["{lang}" == "hu"]
 :appendix-caption: függelék
+:appendix-refsig: {appendix-caption}
 :caution-caption: Figyelmeztetés
+//:chapter-label: ???
+//:chapter-refsig: {chapter-label}
 :example-caption: Példa
 :figure-caption: Ábra
 :important-caption: Fontos
@@ -199,6 +228,7 @@ ifeval::["{lang}" == "hu"]
 :manname-title: NÉV
 :note-caption: Megjegyzés
 //:preface-title: Előszó
+//:section-refsig: ???
 :table-caption: Táblázat
 :tip-caption: Tipp
 :toc-title: Tartalomjegyzék
@@ -206,12 +236,13 @@ ifeval::["{lang}" == "hu"]
 :version-label: Verzió
 :warning-caption: Figyelem
 endif::[]
-//
 // Bahasa Indonesia, courtesy of Triyan W. Nugroho <triyan.wn@gmail.com>
 ifeval::["{lang}" == "id"]
 :appendix-caption: Lampiran
+:appendix-refsig: {appendix-caption}
 :caution-caption: Perhatian
 :chapter-label: Bab
+:chapter-refsig: {chapter-label}
 :example-caption: Contoh
 :figure-caption: Gambar
 :important-caption: Penting
@@ -220,6 +251,7 @@ ifeval::["{lang}" == "id"]
 :manname-title: NAMA
 :note-caption: Catatan
 //:preface-title:
+//:section-refsig: ???
 :table-caption: Tabel
 :tip-caption: Tips
 :toc-title: Daftar Isi
@@ -227,12 +259,13 @@ ifeval::["{lang}" == "id"]
 :version-label: Versi
 :warning-caption: Peringatan
 endif::[]
-//
 // Italian translation, courtesy of Marco Ciampa <ciampix@libero.it>
 ifeval::["{lang}" == "it"]
 :appendix-caption: Appendice
+:appendix-refsig: {appendix-caption}
 :caution-caption: Attenzione
 :chapter-label: Capitolo
+:chapter-refsig: {chapter-label}
 :example-caption: Esempio
 :figure-caption: Figura
 :important-caption: Importante
@@ -241,6 +274,7 @@ ifeval::["{lang}" == "it"]
 :manname-title: NOME
 :note-caption: Nota
 //:preface-title: Prefazione
+//:section-refsig: ???
 :table-caption: Tabella
 :tip-caption: Suggerimento
 :toc-title: Indice
@@ -248,11 +282,13 @@ ifeval::["{lang}" == "it"]
 :version-label: Versione
 :warning-caption: Attenzione
 endif::[]
-//
 // Japanese translation, courtesy of Takayuki Konishi <seannos.takayuki@gmail.com>
 ifeval::["{lang}" == "ja"]
 :appendix-caption: 付録
+:appendix-refsig: {appendix-caption}
 :caution-caption: 注意
+//:chapter-label: ???
+//:chapter-refsig: {chapter-label}
 :example-caption: 例
 :figure-caption: 図
 :important-caption: 重要
@@ -261,6 +297,7 @@ ifeval::["{lang}" == "ja"]
 :manname-title: 名前
 :note-caption: 注記
 //:preface-title: まえがき
+//:section-refsig: ???
 :table-caption: 表
 :tip-caption: ヒント
 :toc-title: 目次
@@ -268,11 +305,13 @@ ifeval::["{lang}" == "ja"]
 :version-label: バージョン
 :warning-caption: 警告
 endif::[]
-//
 // Korean translation, courtesy of Sungsik Nam <jmyl@me.com>
 ifeval::["{lang}" == "kr"]
 :appendix-caption: 부록
+:appendix-refsig: {appendix-caption}
 :caution-caption: 주의
+//:chapter-label: ???
+//:chapter-refsig: {chapter-label}
 :example-caption: 예시
 :figure-caption: 그림
 :important-caption: 중요
@@ -281,6 +320,7 @@ ifeval::["{lang}" == "kr"]
 :manname-title: 이름
 :note-caption: 노트
 //:preface-title: 머리말
+//:section-refsig: ???
 :table-caption: 표
 :tip-caption: 힌트
 :toc-title: 차례
@@ -288,11 +328,13 @@ ifeval::["{lang}" == "kr"]
 :version-label: 버전
 :warning-caption: 경고
 endif::[]
-//
 // Dutch translation, courtesy of Roel Van Steenberghe <roel.vansteenberghe@gmail.com>
 ifeval::["{lang}" == "nl"]
 :appendix-caption: Bijlage
+:appendix-refsig: {appendix-caption}
 :caution-caption: Opgelet
+//:chapter-label: ???
+//:chapter-refsig: {chapter-label}
 :example-caption: Voorbeeld
 :figure-caption: Figuur
 :important-caption: Belangrijk
@@ -301,6 +343,7 @@ ifeval::["{lang}" == "nl"]
 :manname-title: NAAM
 :note-caption: Noot
 //:preface-title: Inleiding
+//:section-refsig: ???
 :table-caption: Tabel
 :tip-caption: Tip
 :toc-title: Ínhoudsopgave
@@ -308,12 +351,13 @@ ifeval::["{lang}" == "nl"]
 :version-label: Versie
 :warning-caption: Waarschuwing
 endif::[]
-//
 // Norwegian Bokmål, courtesy of Aslak Knutsen <aslak@4fs.no>, with updates from Karl Ove Hufthammer <karl@huftis.org>
 ifeval::["{lang}" == "nb"]
 :appendix-caption: Vedlegg
+:appendix-refsig: {appendix-caption}
 :caution-caption: OBS
 :chapter-label: Kapittel
+:chapter-refsig: {chapter-label}
 :example-caption: Eksempel
 :figure-caption: Figur
 :important-caption: Viktig
@@ -322,6 +366,7 @@ ifeval::["{lang}" == "nb"]
 :manname-title: NAVN
 :note-caption: Merk
 //:preface-title: Forord
+//:section-refsig: ???
 :table-caption: Tabell
 :tip-caption: Tips
 :toc-title: Innhold
@@ -329,12 +374,13 @@ ifeval::["{lang}" == "nb"]
 :version-label: Versjon
 :warning-caption: Advarsel
 endif::[]
-//
 // Norwegian Nynorsk, courtesy of Karl Ove Hufthammer <karl@huftis.org>
 ifeval::["{lang}" == "nn"]
 :appendix-caption: Vedlegg
+:appendix-refsig: {appendix-caption}
 :caution-caption: OBS
 :chapter-label: Kapittel
+:chapter-refsig: {chapter-label}
 :example-caption: Eksempel
 :figure-caption: Figur
 :important-caption: Viktig
@@ -343,6 +389,7 @@ ifeval::["{lang}" == "nn"]
 :manname-title: NAMN
 :note-caption: Merk
 //:preface-title: Forord
+//:section-refsig: ???
 :table-caption: Tabell
 :tip-caption: Tips
 :toc-title: Innhald
@@ -350,12 +397,13 @@ ifeval::["{lang}" == "nn"]
 :version-label: Versjon
 :warning-caption: Åtvaring
 endif::[]
-//
 // Polish translation, courtesy of Łukasz Dziedziul <l.dziedziul@gmail.com>
 ifeval::["{lang}" == "pl"]
 :appendix-caption: Dodatek
+:appendix-refsig: {appendix-caption}
 :caution-caption: Uwaga
 :chapter-label: Rozdział
+:chapter-refsig: {chapter-label}
 :example-caption: Przykład
 :figure-caption: Rysunek
 :important-caption: Ważne
@@ -364,6 +412,7 @@ ifeval::["{lang}" == "pl"]
 :manname-title: NAZWA
 :note-caption: Notka
 //:preface-title:
+//:section-refsig: ???
 :table-caption: Tabela
 :tip-caption: Sugestia
 :toc-title: Spis treści
@@ -371,11 +420,13 @@ ifeval::["{lang}" == "pl"]
 :version-label: Wersja
 :warning-caption: Ostrzeżenie
 endif::[]
-//
 // Portuguese translation, courtesy of Roberto Cortez <radcortez@yahoo.com>
 ifeval::["{lang}" == "pt"]
 :appendix-caption: Apêndice
+:appendix-refsig: {appendix-caption}
 :caution-caption: Atenção
+//:chapter-label: ???
+//:chapter-refsig: {chapter-label}
 :example-caption: Exemplo
 :figure-caption: Figura
 :important-caption: Importante
@@ -384,6 +435,7 @@ ifeval::["{lang}" == "pt"]
 :manname-title: NOME
 :note-caption: Nota
 //:preface-title: Prefácio
+//:section-refsig: ???
 :table-caption: Tabela
 :tip-caption: Sugestão
 :toc-title: Índice
@@ -391,11 +443,13 @@ ifeval::["{lang}" == "pt"]
 :version-label: Versão
 :warning-caption: Aviso
 endif::[]
-//
 // Brazilian Portuguese translation, courtesy of Rafael Pestano <rmpestano@gmail.com>
 ifeval::["{lang}" == "pt_BR"]
 :appendix-caption: Apêndice
+:appendix-refsig: {appendix-caption}
 :caution-caption: Cuidado
+//:chapter-label: ???
+//:chapter-refsig: {chapter-label}
 :example-caption: Exemplo
 :figure-caption: Figura
 :important-caption: Importante
@@ -404,6 +458,7 @@ ifeval::["{lang}" == "pt_BR"]
 :manname-title: NOME
 :note-caption: Nota
 //:preface-title: Prefácio
+//:section-refsig: ???
 :table-caption: Tabela
 :tip-caption: Dica
 :toc-title: Índice
@@ -411,11 +466,13 @@ ifeval::["{lang}" == "pt_BR"]
 :version-label: Versão
 :warning-caption: Aviso
 endif::[]
-//
 // Romanian translation, courtesy of Vitalie Lazu <vitalie.lazu@gmail.com>
 ifeval::["{lang}" == "ro"]
 :appendix-caption: Apendix
+:appendix-refsig: {appendix-caption}
 :caution-caption: Precauție
+//:chapter-label: ???
+//:chapter-refsig: {chapter-label}
 :example-caption: Exemplu
 :figure-caption: Figură
 :important-caption: Important
@@ -424,6 +481,7 @@ ifeval::["{lang}" == "ro"]
 :manname-title: NUME
 :note-caption: Notă
 //:preface-title: Prefață
+//:section-refsig: ???
 :table-caption: Tabela
 :tip-caption: Sfat
 :toc-title: Cuprins
@@ -431,11 +489,13 @@ ifeval::["{lang}" == "ro"]
 :version-label: Versiunea
 :warning-caption: Atenție
 endif::[]
-//
 // Russian translation, courtesy of Alexander Zobkov <alexander.zobkov@gmail.com>
 ifeval::["{lang}" == "ru"]
 :appendix-caption: Приложение
+:appendix-refsig: {appendix-caption}
 :caution-caption: Внимание
+//:chapter-label: ???
+//:chapter-refsig: {chapter-label}
 :example-caption: Пример
 :figure-caption: Рисунок
 :important-caption: Важно
@@ -444,6 +504,7 @@ ifeval::["{lang}" == "ru"]
 :manname-title: НАЗВАНИЕ
 :note-caption: Примечание
 //:preface-title: Предисловие
+//:section-refsig: ???
 :table-caption: Таблица
 :tip-caption: Подсказка
 :toc-title: Содержание
@@ -451,12 +512,13 @@ ifeval::["{lang}" == "ru"]
 :version-label: Версия
 :warning-caption: Предупреждение
 endif::[]
-//
 // Serbian Cyrillic translation, courtesy of Bojan Stipic <bojan-7@live.com>
 ifeval::["{lang}" == "sr"]
 :appendix-caption: Додатак
+:appendix-refsig: {appendix-caption}
 :caution-caption: Опрез
-//:chapter-label: Поглавље
+:chapter-label: Поглавље
+:chapter-refsig: {chapter-label}
 :example-caption: Пример
 :figure-caption: Слика
 :important-caption: Важно
@@ -465,6 +527,7 @@ ifeval::["{lang}" == "sr"]
 :manname-title: НАЗИВ
 :note-caption: Белешка
 //:preface-title: Предговор
+//:section-refsig: ???
 :table-caption: Табела
 :tip-caption: Савет
 :toc-title: Садржај
@@ -472,12 +535,13 @@ ifeval::["{lang}" == "sr"]
 :version-label: Верзија
 :warning-caption: Упозорење
 endif::[]
-//
 // Serbian Latin translation, courtesy of Bojan Stipic <bojan-7@live.com>
 ifeval::["{lang}" == "sr_Latn"]
 :appendix-caption: Dodatak
+:appendix-refsig: {appendix-caption}
 :caution-caption: Oprez
-//:chapter-label: Poglavlje
+:chapter-label: Poglavlje
+:chapter-refsig: {chapter-label}
 :example-caption: Primer
 :figure-caption: Slika
 :important-caption: Važno
@@ -486,6 +550,7 @@ ifeval::["{lang}" == "sr_Latn"]
 :manname-title: NAZIV
 :note-caption: Beleška
 //:preface-title: Predgovor
+//:section-refsig: ???
 :table-caption: Tabela
 :tip-caption: Savet
 :toc-title: Sadržaj
@@ -493,11 +558,13 @@ ifeval::["{lang}" == "sr_Latn"]
 :version-label: Verzija
 :warning-caption: Upozorenje
 endif::[]
-//
 // Turkish translation, courtesy of Rahman Usta <rahman.usta.88@gmail.com>
 ifeval::["{lang}" == "tr"]
 :appendix-caption: Ek bölüm
+:appendix-refsig: {appendix-caption}
 :caution-caption: Dikkat
+//:chapter-label: ???
+//:chapter-refsig: {chapter-label}
 :example-caption: Örnek
 :figure-caption: Görsel
 :important-caption: Önemli
@@ -506,6 +573,7 @@ ifeval::["{lang}" == "tr"]
 :manname-title: İSİM
 :note-caption: Not
 //:preface-title: Ön söz
+//:section-refsig: ???
 :table-caption: Tablo
 :tip-caption: İpucu
 :toc-title: İçindekiler
@@ -513,11 +581,13 @@ ifeval::["{lang}" == "tr"]
 :version-label: Versiyon
 :warning-caption: Uyarı
 endif::[]
-//
 // Ukrainian translation, courtesy of Kyrylo Yatsenko <hedrok@gmail.com>
 ifeval::["{lang}" == "uk"]
 :appendix-caption: Додаток
+:appendix-refsig: {appendix-caption}
 :caution-caption: Обережно
+//:chapter-label: ???
+//:chapter-refsig: {chapter-label}
 :example-caption: Приклад
 :figure-caption: Зображення
 :important-caption: Важливо
@@ -526,6 +596,7 @@ ifeval::["{lang}" == "uk"]
 :manname-title: НАЗВА
 :note-caption: Зауваження
 //:preface-title: Передмова
+//:section-refsig: ???
 :table-caption: Таблиця
 :tip-caption: Підказка
 :toc-title: Зміст
@@ -533,11 +604,13 @@ ifeval::["{lang}" == "uk"]
 :version-label: Версія
 :warning-caption: Попередження
 endif::[]
-//
 // Simplified Chinese translation, courtesy of John Dong <dongwqs@gmail.com>
 ifeval::["{lang}" == "zh_CN"]
 :appendix-caption: 附录
+:appendix-refsig: {appendix-caption}
 :caution-caption: 注意
+//:chapter-label: ???
+//:chapter-refsig: {chapter-label}
 :example-caption: 示例
 :figure-caption: 图表
 :important-caption: 重要
@@ -546,6 +619,7 @@ ifeval::["{lang}" == "zh_CN"]
 :manname-title: 名称
 :note-caption: 笔记
 //:preface-title: 序言
+//:section-refsig: ???
 :table-caption: 表格
 :tip-caption: 提示
 :toc-title: 目录
@@ -553,11 +627,13 @@ ifeval::["{lang}" == "zh_CN"]
 :version-label: 版本
 :warning-caption: 警告
 endif::[]
-//
 // Traditional Chinese translation, courtesy of John Dong <dongwqs@gmail.com>
 ifeval::["{lang}" == "zh_TW"]
 :appendix-caption: 附錄
+:appendix-refsig: {appendix-caption}
 :caution-caption: 注意
+//:chapter-label: ???
+//:chapter-refsig: {chapter-label}
 :example-caption: 示例
 :figure-caption: 圖表
 :important-caption: 重要
@@ -566,6 +642,7 @@ ifeval::["{lang}" == "zh_TW"]
 :manname-title: 名稱
 :note-caption: 筆記
 //:preface-title: 序言
+//:section-refsig: ???
 :table-caption: 表格
 :tip-caption: 提示
 :toc-title: 目錄