ASCIIDOC: добавление ссылки на index.html во все документы для быстрой навигации

Я создаю HTML-документацию с помощью плагина Gradle org.asciidoctor.convert и хочу добавить легкодоступную ссылку на основной индексный документ на каждую сгенерированную страницу.

Из index.adoc я указываю на отдельные страницы, например:

== Troubleshooting
* <<KNOWN-ISSUES.adoc#,Known issues>>
* <<monitoring.adoc#,Monitoring>>

но я хотел бы иметь возможность быстро вернуться к index.html с любой страницы.

Моя первоначальная идея состояла в том, чтобы изменить сгенерированный TOC, но я не могу понять, как я могу это сделать.


asciidoc asciidoctor
person gavenkoa    schedule 24.03.2019    source источник

Ответы (1)


arrow_upward
1
arrow_downward

Хакерский обходной путь только для вывода HTML:

asciidoctor {
    attributes \
        'toc-title': '<a href="index.html">↑Go Home↑</a>'
}

Буду рад увидеть альтернативное решение.

person gavenkoa    schedule 24.03.2019