Size: a a a

DocOps-сообщество

2021 October 12

VS

Vadim Smelyanskiy in DocOps-сообщество
Не помню, какой стандарт Markdown в Typora, но может быть парсер "щадящий", и он лишние столбцы игнорировал

Что я имею в виду под "лишними":
Представим таблицу из 3 столбцов, где в первой строке 1 и 2 ячейка объединены. Проходясь по синтаксису, парсер увидит, что в 1 строке 2 столбца. Тогда в остальных строках после 2 столбца можно игнорировать символы или воспринимать их как контент. Это уж как разработчик сделает
источник

A

ARN in DocOps-сообщество
спасибо... Typora и ZIM используют сходный диалект но только если в окне Pref меню Edit для ZIM выставить Markdown Pandoc, а не Wiki как по умолчанию
источник

a

arvikon in DocOps-сообщество
Вот тут -- https://babelmark.github.io/ -- тестируйте как разные имплементации Markdown рендерят в HTML. Одна таки нашлась, которая рендерит разметку белорусов с объединением ячеек -- https://github.com/xoofx/markdig
источник

NV

Nick Volynkin in DocOps-сообщество
С отрисовкой проблем не должно быть, потому что это стандартная фича HTML
источник

DL

Dmytro Lispyvnyi '(🌲... in DocOps-сообщество
да, действительно, не подумал
источник
2021 October 13

DB

Dima Boger in DocOps-сообщество
А в чём сейчас можно красиво нарисовать относительно большую схему взаимодействия компонентов (наверное это то, что UML называет Component Diagram) и не умереть?

Требования:
- текстовый формат, который можно хранить в гите и отрисовывать в схемки при помощи CLI / сборщиков документации
- первый элемент диаграммы не значит корень дерева
- хорошо решает задачу взаимного расположения или даёт возможность его кастомизировать

Я попробовал PlantUML но остался недоволен его распологатором, у меня получаются очень скученные схемки 🤔
источник

NK

Nata Kazakova in DocOps-сообщество
источник

ME

Maria Ermakovich in DocOps-сообщество
mermaid.js
но фиг знает, мне плантюмл удобнее. пробовали играться с направлениями стрелок?
источник

DB

Dima Boger in DocOps-сообщество
а как их потом хранить-редактировать?
источник

Y

Yaroslav in DocOps-сообщество
в PlantUml очень неожиданно меняются местами инстансы при директивной расстановке стрелок (- можно найти приемлемый вариант. Но т.е. тоже подразумевается ручная работа
источник

NK

Nata Kazakova in DocOps-сообщество
а там куча вариантов и форматов
источник

NK

Nata Kazakova in DocOps-сообщество
источник

NV

Nick Volynkin in DocOps-сообщество
источник

NK

Nata Kazakova in DocOps-сообщество
источник

DB

Dima Boger in DocOps-сообщество
я не нашёл в Mermaid.js component diagram 🤔

можно попробовать в flowchart уложить конечно
источник

NV

Nick Volynkin in DocOps-сообщество
Нее, XML это суррогат, чистый plaintext-формат лучше
источник

ME

Maria Ermakovich in DocOps-сообщество
предпочитаю выгружать в SVG, тогда они back-portable в draw.io, ну и можно редактировать в текстовом редакторе типа Atom, но это для любителей хардкора (я там максимум могу подписи и направления стрелок поменять)
источник

NP

Nikolaj Potashnikov in DocOps-сообщество
вообще, довольно странно, plantuml основан на dot... только механизм ранжирования они сделали "как бы более дружественным", но на самом деле — нет.  То, что называется направлением стрелок — на самом деле задание ранга одного объекта относительного другого (хотя, уверен, абсолютными рангами пользоваться гораздо проще). Поэтому в расположении объектов никакой непонятности нет. Для борьбы со скученностью можно увеличить расстояния между объектами. А вот подписи только справа от стрелок — это неприятно. И стрелку в PlantUML иногда очень странно загибают

Вот тут можете поэксперементировать с кучей диаграмм из текста https://kroki.io/
источник

NP

Nikolaj Potashnikov in DocOps-сообщество
Посмотрел, mermaid там есть и чистый dot (GraphViz) — тоже
источник

DB

Dima Boger in DocOps-сообщество
kroki — класс, спасибо!
источник