Как установить область действия атрибутов документа в AsciiDoc
Я хочу установить атрибут keywords на основе иерархии разделов.
Например, предположим, что у вас есть следующий документ AsciiDoc:
= Article
:keywords: keyword0
== Section1
:keywords: keyword1
== Section2
{keywords}
В этом примере {keywords} я ожидаю результат keyword0. Другими словами, я не хочу, чтобы значение атрибута keywords, установленного в Section1, переносилось в Section2.
Однако результаты Asciidoctor.js Live Preview показывают keyword1. Можно ли установить область действия на основе иерархии разделов атрибута ключевых слов?
Если описанный выше метод не соответствует практике AsciiDoc, дайте мне знать, есть ли более эффективные стратегии проектирования документов AsciiDoc.
Ответы 2
Самое близкое, что вы могли бы сделать, это:
= Article
:default-keywords: keyword0
:keywords: {default-keywords}
== Section1
:keywords: keyword1
== Section2
:keywords: {default-keywords}
{keywords}
Вам придется заранее сбрасывать атрибут :keywords: при каждом начале раздела, но, по крайней мере, вам не нужно будет знать, каковы фактические ключевые слова по умолчанию в этот момент, определив их ровно один раз вверху.
Функциональность, которую вы ищете, выходит за рамки предполагаемых возможностей Asciidoc. Это связано не с какими-то недостатками в его реализации, а с тем, что описываемые вами возможности относятся к области программирования и структурного программирования, а не к документальному описанию. Ваши требования действительны и понятны, но они не предназначены для обработки такими языками разметки, как Asciidoc.
Мне тоже нравится включать программирование в свою документацию. Для решения подобных задач я разработал язык метаразметки, который может оказаться вам полезным. Он интегрируется с различными инструментами, включая препроцессор Asciidoctor, и безупречно работает с плагином IntelliJ Asciidoctor и AsciidocFX.
Основная идея состоит в том, чтобы объединить метаразметку с разметкой вашего документа, обработать метаразметку и затем передать полученный чистый документ Asciidoc в процессор Asciidoc. Такой подход позволяет использовать макросы метаразметки вместо атрибутов Asciidoc, что, на мой взгляд, является ограниченным решением проблемы и часто не дает результатов, за исключением очень специфических случаев.
Язык метаразметки, который я разработал, называется Jamal, и вы можете найти его здесь: