Телеграмм чат группы docsascode страница 347

Хоть садись и сам пиши))

13:32пожаловаться #1

P

Коллеги, вижу активность.... ))
Позвольте под шумок спросить: у меня сейчас vscode упорно не желает рендерить в превью встроенные в asciidoc plantuml.
Там один норм. плагин для превью аскидока и он этого делать у...порно не хочет.
Есть у кого решение?..
Уже что только не перепробовал...

graphwiz установлен?

Нац Нац in DocOps-сообщество

13:33пожаловаться #2

НН

Блин, для вскода нет норм плагина, чтобы отображал тулбарчик для основных команд для аскидока...
Для маркдауна, где команд раз два и обчелся, такое есть.
Грустно...

Для маркдауна он депрекейтед
>toolbar took up a lot of space on the VS Code status bar, and did not follow best practices for extension UX

для аскидока там будет вообще махина (наверн)

13:35пожаловаться #3

АК

graphwiz установлен?

plantuml уже вроде без него обходится...
пытался выключить опцию use asciidoctor js, тогда он командную строку использует, задал в ком строке /usr/bin/asciidoctor -r asciidoctor-diagram -o-, проинсталлил asciidoctor-diagram, аскидоктор пишет, что не находит эту диаграмму...

13:37пожаловаться #4

P

Хоть садись и сам пиши))

в опенсорс нужно контрибьютить пока молодой, часики-то тикают)

13:37пожаловаться #5

АК

в опенсорс нужно контрибьютить пока молодой, часики-то тикают)

в 46 еще можно?.. ))))

13:37пожаловаться #6

P

в 46 еще можно?.. ))))

в 46 уже пора взгрустнуть о всех упущенных возможностях поконтрибьютить и сделать с уже приобретённым опытом!

13:39пожаловаться #7

АК

в 46 уже пора взгрустнуть о всех упущенных возможностях поконтрибьютить и сделать с уже приобретённым опытом!

первый пункт уже осилил, перехожу к остальным )))

13:40пожаловаться #8

P

(пытаюсь подталкивать окружающих публиковать свои поделки для себя, чтобы люди во всём мире реже переписывали одно и то же)

13:43пожаловаться #9

АК

Нац Нац

Для маркдауна он депрекейтед
>toolbar took up a lot of space on the VS Code status bar, and did not follow best practices for extension UX

для аскидока там будет вообще махина (наверн)

хм... ну да, то в атоме было...)
Да хоть бы менюху какую с подразделами сделали...
Ладно, попробую какие-то макросы замутить, а то постоянно с этим не работаю, а когда надо что-то поправить, постоянно лезу в доку...
Ну, это такое, плюсы и минусы невизуального, компромиссы...

13:43пожаловаться #10

АК

(пытаюсь подталкивать окружающих публиковать свои поделки для себя, чтобы люди во всём мире реже переписывали одно и то же)

Да, можно даже сказать, что опен-сорс комьюнити - шаг к идеальному человеческому сообществу: делиться, помогать... В других сферах это не так развито...
В голове рождается идея для альтернативы сериалу черное зеркало: белое зеркало)
Только бы ща в расизме не обвинили )))))

13:47пожаловаться #11

P

plantuml уже вроде без него обходится...
пытался выключить опцию use asciidoctor js, тогда он командную строку использует, задал в ком строке /usr/bin/asciidoctor -r asciidoctor-diagram -o-, проинсталлил asciidoctor-diagram, аскидоктор пишет, что не находит эту диаграмму...

я просто использую плагин для Intellij, там он ещё нужен, буквально вчера ставил

13:48пожаловаться #12

АК

я просто использую плагин для Intellij, там он ещё нужен, буквально вчера ставил

хм... а попробую поставить...
хотя, у меня-то не ошибки пишет, а просто отображает [plantuml] как обычный соурс-текст
Я переключил на командную строку, как писал выше, теперь не могу заставить, чтобы юзал -r asciidoctor-diagram

13:50пожаловаться #13

V

раз такая пьянка.. расскажите про волшебную пилюлю.
Есть доки в основном в word во что лучше сейчас смотреть, что бы в последсвии сделать нормальную документацию на ПО. направьте, пинком в зад, в какие инструменты копать.

Сейчас видится, что всё перевести в MD или rST с нарезкой по главам, а дальше все собирать в единый документ, ну и на выходе в pandoc для разных форматов..

15:04пожаловаться #14

V

мы сейчас как раз выбираем иснтумент, как говорится, надо выбрать сегодня, что бы завтра не было мучительно больно.

15:05пожаловаться #15

V

Ах да забыл сказать, мы не можем пользовать разные клауды, как говорится только селфхостед

Семён Факторович in DocOps-сообщество

15:06пожаловаться #16

СФ

https://github.com/foliant-docs/foliant вам в помощь

GitHub

foliant-docs/foliant

Comprehensive markdown-based documentation toolkit - foliant-docs/foliant

15:06пожаловаться #17

V

Comprehensive markdown-based documentation toolkit - foliant-docs/foliant

Семён Факторович

https://github.com/foliant-docs/foliant вам в помощь

GitHub

foliant-docs/foliant

его как раз смотрим.

Семён Факторович in DocOps-сообщество

15:07пожаловаться #18

СФ

мы для своих нужд с нуля сделали аналогичную штуку, но на RST (тоже генерит HTML, DOCX и PDF с возможностью кастомизации дизайна, расширения синтаксиса RST и пр.)

Семён Факторович in DocOps-сообщество

15:07пожаловаться #19

СФ

в общем-то, основное ограничение тут — необходимый вам набор выходных форматов