Тут нужно определиться что ценнее - возможность передавать диаграмму между разными сетями и организациями или менять оформление для всех диаграмм организации, исправив include файл на общем ресурсе? Из моего опыта не было обратно-несовместимых изменений стилей - только введение новых форматов.
Если вы укажете над наименованием participant комментарий с кратким наименованием вашего компонента, то именно оно попадёт в строку промежуточных заголовков
Обработка ошибки отсутствия файла, указанного в include ожет зависеть от средства рендеринга. Если оно выдает ошибку (а, как я тут почитал - это наиболее распространенный способ), то Вы правы - отсутствие include сделает диаграмму вообще нечитаемой.
На третьем уровне я бы вынес стили и макросы в версионируемый include
Мысль с include была, но она усложняет переносимость диаграммы - если при рендеринге в других сетях или организациях не будет доступа к нужному include, то форматирование диаграммы "съедет". Хотя, для решения уровня организации, этот шаг будет полностью оправданым, согласен.
Ваш инструмент уже разбирает синтаксис PlantUML или пока работает как текстовый препроцессор?
seq_add_head.html - пока просто тектовый препроцессор. Сложные случаи со стрелками в note или комментариях может обработать некорректно. Но он разрабатывался как быстрый "костыль" для удобного форматирования sequence.
И как вы фиксируете версию шаблона у уже согласованной диаграммы?
Версия шаблона в рамках предлагаемого решения никак не фиксируется, и это тоже "зона развития". Диаграмма содержит копию стилей, и если шаблон меняется, старые диаграммы остаются «замороженными» в том виде, в котором были согласованы.
Тут нужно определиться что ценнее - возможность передавать диаграмму между разными сетями и организациями или менять оформление для всех диаграмм организации, исправив include файл на общем ресурсе? Из моего опыта не было обратно-несовместимых изменений стилей - только введение новых форматов.
Да, я тоже в недоумении. Приходится каждую фичу искать по всему интернету...
это только при использовании seq_add_head.html и UML Seq — заголовки для АС v006.xlsx для фомирования промежуточных заголовоков. В самом plantUML такой функции я не нашел.
Обработка ошибки отсутствия файла, указанного в include ожет зависеть от средства рендеринга. Если оно выдает ошибку (а, как я тут почитал - это наиболее распространенный способ), то Вы правы - отсутствие include сделает диаграмму вообще нечитаемой.
Пожалуйста! Не сразу удалось эту возможность найти)
Спасибо за комментарий! Отвечаю по порядку.
Мысль с include была, но она усложняет переносимость диаграммы - если при рендеринге в других сетях или организациях не будет доступа к нужному include, то форматирование диаграммы "съедет". Хотя, для решения уровня организации, этот шаг будет полностью оправданым, согласен.
seq_add_head.html - пока просто тектовый препроцессор. Сложные случаи со стрелками в note или комментариях может обработать некорректно. Но он разрабатывался как быстрый "костыль" для удобного форматирования sequence.
Версия шаблона в рамках предлагаемого решения никак не фиксируется, и это тоже "зона развития". Диаграмма содержит копию стилей, и если шаблон меняется, старые диаграммы остаются «замороженными» в том виде, в котором были согласованы.