Инструменты пользователя

Инструменты сайта



// PlantUML редакторы

В первую очередь для рабочего стола, не для WEB.

На текущий момент мне понравилось три решения, которые могут работать с отдельными файлами без создания проектов и так далее:

  • PlantUML QEditor
  • Расширение для Visual Studio Code - PlantUML
  • Плагин для NetBeans

В первом не хватает подсветки синтаксиса. Третий достаточно тяжеловат (всё же сам NetBeans сам по себе - IDE), так что второй вариант - пока мой выбор. Раньше Visual Studio Code не использовал, и сейчас он больше для редактирования PlatnUML с предпросмотром, но со своими задачами справляется достойно. Не хватает, правда, Assistant, как в PlantUML QEditor.

PS в IDEA есть достаточно удобный плагин, особенно если в рамках проекта нужно диаграммы думать. Мне же больше по душе запуск без IDE проекта, дабы не отвлекаться. PPS для WEB: www.plantuml.com/plantuml/form быстро сгенерить или посмотреть.

// PlantUML: временные диаграммы

Как-то пропустил сей момент, но в PlantUML появились Временные диаграммы (Timing Diagram):

Жаль, что когда они были ооооочень нужны (сейчас не так), удобного инструмента я не нашёл.

// PlantUML: параллельное выполнение в Sequence Diagram

Давно хотелось иметь в PlantUML возможно в Sequence диаграмме рисовать две параллельные ветки выполнения (на самом деле иногда больше, но хотя бы…).

И вот, случайно в последней версии нащупал такую команду:

par2
  ...
else
  ...
end

Т.е. при примерно таком коде:

@startuml
hide footbox

A++
par2
    A -> B ++
    B -> B ++
    return
    return
else
    A -> C ++
    C -> C ++
end
A--

@enduml

мы получим следующую картинку:

в общем, чего и хотелось.

Правда при таком подходе, если, допустим, A, B и C - разные потоки, то операции с A нужно корректно вставлять в одну из веток par2

PS в примере можно видеть различные операции типа ++ и найти их описание можно здесь: http://plantuml.sourceforge.net/incubation.html

// AsciiDoc и PlantUML

AsciiDoc - язык разметки и утилита для генерации, из этой самой разметки, документов самых разных форматов: Unix man pages, HTML, PDF, OpenOffice и т.п. (список поддерживаемых форматов можно расширить модулями). При этом текст разметки напоминает некоторые WiKi (типа той же DokuWiki) и остаётся читабельным даже без компиляции в какой либо выходной формат. Часто используется для приготовления документации к продуктам.

PlantUML - тоже язык разметки, и тоже текстовый, для генерации различных UML диаграмм.

Резонный вопрос: как бы их скрестить. Помогает модульность AsciiDoc, в частности фильтры. В скором времени находим уже готовое решение: http://code.google.com/p/asciidoc-plantuml/

Устанавливается просто:

  1. скачиваем файл plantuml.zip
  2. натравливаем на него команду:
    asciidoc --filter install plantuml.zip

Либо, для пользователей ArchLinux, ипользуем пакет из AUR: https://aur.archlinux.org/packages/asciidoc-plantuml

После чего, в тело документа можно вставлять такие блоки:

[plantuml]
------
User -> (Start)
User --> (Use the application) : Polish label-Zażółć gęślą jaźń

:Main Admin: ---> (Use the application) : This is\nyet another\nlabel
------

И оно заменится картинкой с диаграммой.

Под катом снимок экрана редактора asciidoc-gui с предпросмотром диаграммы.