Макросы GOSTGen
Макросы GOSTGen предназначены для разметки элементов контента страницы, автоматизации построения некоторых составляющих документа и манипулирования выводом страницы в ODT документ. Использование макросов не мешает восприятию страницы в Confluence, но позволяет формировать выходной документ в соответствии со строгими правилами ГОСТ.
Разметка элементов контента
Согласно требованиям ГОСТ, такие элементы, как таблицы, рисунки, сноски и приложения документа должны иметь последовательную нумерацию. Ссылки в тексте документа на эти элементы должны указывать на его номер и не должны содержать имени референциального объекта, которое указывается текстом, должно склоняться и не входит в саму ссылку. Например: при ссылке на таблицы необходимо указывать — «… приведено в таблице 1», «… приведено в таблицах 2 – 4». Для решения этой задачи GOSTGen предлагает набор соответствующих макросов. Каждый из макросов разметки элементов документа на странице Confluence формирует якорь, что позволяет создавать для них работоспособные в режиме просмотра страницы ссылки, используя тип ссылки «Дополнительно».
Подробнее о макросах разметки контента и авто-нумерации
Макросы контента
Макросы контента помогают внести в документ дополнительные стилистические элементы, которые нельзя реализовать стандартными средствами редактора Confluence и автоматизировать некоторые рутинные операции по манипулированию контентом.
Макрос управления ориентацией страницы. Размещается либо непосредственно в абзаце или заголовке, с которого необходимо повернуть страницу, либо абзацем выше. Если по ошибке макрос помещен в таблицу или список, то он «всплывет» на основной уровень документа
Макрос выводит в выходном документе содержимое подраздела «Перечень приложений к документу», собрав эту информацию по разметке приложений макросами «Приложения к документу». Вывод осуществляется либо в виде списка, либо в виде таблицы, в зависимости от значения параметра макроса
Макрос позволяет включить указанную страницу Confluence в выходной документ. В отличии от стандартного макроса «Включить страницу», макрос GOSTGen не выводит включенную страницу в режиме просмотра текущей страницы Confluence, а лишь формирует ссылку на включенную и выводит свои параметры. Дополнительно, макрос позволяет управлять уровнем заголовков включенной страницы, начав их уровня задаваемого параметром макроса
Макрос позволяет включить для указанной страницы Confluence ее дочерние страницы в выходной документ. В режиме просмотра текущей страницы Confluence макрос формирует ссылку на включенную страницу и выводит свои параметры. При формировании выходного документа в него будут включены отдельными подразделами дочерние страницы к указанной. Параметры макроса позволяют определить стартовый уровень заголовков подразделов, регулярные выражения для фильтрации дочерних страниц по заголовкам и порядок формирования заголовков в выходном документе из названий страниц
Макрос предназначен для управления выводом таблицы в выходной документ и позволяет отключить проверку наличия нумератора для таблицы, отключить вывод рамок ячеек таблицы, отключить формирование заголовка таблицы. Макрос удобно использовать, если необходимо сверстать в Confluence нечто подобное титульному листу документа
Макрос анализирует данные указанной в параметре таблицы, выбирая уникальные комбинации значений из заданных колонок. Результатом работы макроса является список уникальных комбинаций, который может быть выведен либо в существующую таблицу, если макрос размещен внутри таблицы, либо в виде отдельной строки, если макрос размещен вне таблицы. При необходимости, в выборке может быть реализована автонумерация строк
Макрос формирует заголовок в выходном документе со стилем «Псевдозаголовок 1». Применяется для создания ненумеруемых заголовков документа, которые не должны попадать в оглавление.
Если у ваc активировано и настроено расширение GOSTGen для обработки макросов Yogi Requirement, то данный макрос соберет все размеченные этими макросами требования и построит для них матрицу соответствия от исходных требований (depends). Более подробная документация разрабатывается под специфику использования Yogi Requirement Macro в вашем Confluence