подскажите пожалуйста: у меня сейчас есть набор требований, они лежат в отдельных файликах.
Я хочу настроить генерацию из них единого файла в стиле гостдаун.
Т.е. мне хочется сделать из них сквозную нумерацию.
Я смотрю на маркдаун, аскидок и прочее и у меня возникает ощущение, что за предыдущую тысячу лет ничего кроме латеха тут рабочего не придумали =(
Может быть я ошибаюсь и есть способ как-то перекомпоновать файлы со сквозной нумерацией?
Я себе вижу решение так:
делаем файл с содержимым вида:
include useless_unreadable_gost_header.txt
include doc/text1.txt
include doc/text2.txt
include doc/text3.txt
include useless_unreadable_gost_footer.txt
Может я упускаю что и есть достаточно мощные инструменты для обработки таких шаблонов?
Не совсем понятно, что значит сквозная нумерация. Если у каждого из требований свой заголовок, то они естественным образом переименуются. При необходимости, при вставке в главный файл можно менять уровень заголовка.
Если нужно что-то ручное, то в asciidoc есть специальный атрибут "счетчик", который каждый раз принимает новое значение. Счетчик может быть именованным. Можно также сбрасывать счетчик. Т.е. если у нас несколько файлов требований и они с помощью директивы include включены в единый документ, то нумерация будет сквозная. Или не сквозная (по желанию) или это может переключаться атрибутом в главном файле.