Size: a a a

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

2020 February 10

DB

Dima Boger in DocOps-сообщество
OpenAPI (swagger) спецификация сама по себе это yaml/json файл
источник

S

Sylvestr in DocOps-сообщество
Можно ли использовать маркдаун в свагер? Если можно, то как?
источник

S

Sylvestr in DocOps-сообщество
Dima Boger
OpenAPI (swagger) спецификация сама по себе это yaml/json файл
То есть в свагере маркдауном писать не получится не при каких обстоятельствах?
источник

DB

Dima Boger in DocOps-сообщество
swagger ui умеет рендерить маркдаун-описания к эндпоинтам
источник

S

Sylvestr in DocOps-сообщество
Может быть есть какие-нибудь утилиты для этого?
источник

S

Sylvestr in DocOps-сообщество
Dima Boger
swagger ui умеет рендерить маркдаун-описания к эндпоинтам
Так, вот ui мне еще не приходилось пользоваться
источник

DB

Dima Boger in DocOps-сообщество
А чем ты пользуешься?
источник

DB

Dima Boger in DocOps-сообщество
У вас автогенерируемый сваггер или ты сам его пишешь?
источник

S

Sylvestr in DocOps-сообщество
Сейчас я только его изучаю
источник

S

Sylvestr in DocOps-сообщество
Пока не испльзовал в практике
источник

DB

Dima Boger in DocOps-сообщество
источник

S

Sylvestr in DocOps-сообщество
То есть достаточно в титле указать маркдаун?
источник

S

Sylvestr in DocOps-сообщество
В любом случае спасибо за помощь
источник

DB

Dima Boger in DocOps-сообщество
Нет, тайтл там просто для примера так назван. Там можно открыть редактор по ссылке ниже и самому поиграться
источник

BN

Baharev Nick in DocOps-сообщество
Приветствую, коллеги! Подскажите инструмент для конвертации html в md, причем не облачный. Спасибо!
источник

DB

Dima Boger in DocOps-сообщество
Baharev Nick
Приветствую, коллеги! Подскажите инструмент для конвертации html в md, причем не облачный. Спасибо!
Дока пандока предлагает вот это

pandoc -s -r html http://www.gnu.org/software/make/ -o example12.text
источник

BN

Baharev Nick in DocOps-сообщество
Dima Boger
Дока пандока предлагает вот это

pandoc -s -r html http://www.gnu.org/software/make/ -o example12.text
не думал, что пандок может такое. спасибо)
источник

NV

Nick Volynkin in DocOps-сообщество
Baharev Nick
не думал, что пандок может такое. спасибо)
Он всё может )
источник

BN

Baharev Nick in DocOps-сообщество
еще один вопрос: как быть, если файлы расположены локально, на ПК?
источник

DB

Dima Boger in DocOps-сообщество
у меня под рукой сейчас нет пандока — если туда просто пусть к .html указать не сжует?
источник