Size: a a a

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

2019 October 28

AK

Artem Krosheninnikov in DocOps-сообщество
Nick Volynkin
Если хранить и редактировать в md,  какие фичи останутся от xwiki? Нужно ли редактировать прямо в ней?
Сорри за поздний ответ. Не знаю, нужно ли редактировать из самой вики, интересен сам процесс хранения доков в репе и публикация их в xwiki. В противном случае за доками никто не следит и они потихоньку протухают
источник

AK

Artem Krosheninnikov in DocOps-сообщество
Точно то, что от xwiki отказаться не получится)
источник

NV

Nick Volynkin in DocOps-сообщество
Artem Krosheninnikov
Сорри за поздний ответ. Не знаю, нужно ли редактировать из самой вики, интересен сам процесс хранения доков в репе и публикация их в xwiki. В противном случае за доками никто не следит и они потихоньку протухают
Как обычно, pandoc умеет конвертировать в разметку xwiki. https://pandoc.org/
источник

NV

Nick Volynkin in DocOps-сообщество
То есть вы можете писать в Md/reST/Asciidoc и пушить доки в xwiki. Но тогда её придётся закрыть на редактирование, потому что обратно конвертировать пандок не умеет.
источник

DN

Dmitry Nagovitsin in DocOps-сообщество
а есть какой то универсальный способ доку с readthedocs выкачивать в пдф?
источник

DN

Dmitry Nagovitsin in DocOps-сообщество
ну или в чем то, что можно читать олфлайн?
источник

НН

Нац Нац in DocOps-сообщество
Сайт-скраппер любой
источник

iv

iakov v in DocOps-сообщество
У них на сайте внизу левого sidebar есть кнопочка, при нажатии на которую открывается окошко со ссылками на PDF и epub
источник

iv

iakov v in DocOps-сообщество
источник

iv

iakov v in DocOps-сообщество
Хотя от проекта к проекту набор доступных форматов может отличаться
источник

RG

Ramil G in DocOps-сообщество
Dmitry Nagovitsin
ну или в чем то, что можно читать олфлайн?
Если ты под мак или Линукс, Используй Aria2 в командной строке.
источник

RG

Ramil G in DocOps-сообщество
Для винды раньше был телепортПро
источник

NV

Nick Volynkin in DocOps-сообщество
iakov v
У них на сайте внизу левого sidebar есть кнопочка, при нажатии на которую открывается окошко со ссылками на PDF и epub
Бинго!
источник

RG

Ramil G in DocOps-сообщество
Nick Volynkin
Бинго!
Скучно
источник

NV

Nick Volynkin in DocOps-сообщество
Dmitry Nagovitsin
а есть какой то универсальный способ доку с readthedocs выкачивать в пдф?
А если репозиторий доступен, ты можешь скачать его сам и собрать себе в epub, например.
источник

DN

Dmitry Nagovitsin in DocOps-сообщество
Nick Volynkin
А если репозиторий доступен, ты можешь скачать его сам и собрать себе в epub, например.
каким инструментом?
источник

NV

Nick Volynkin in DocOps-сообщество
Dmitry Nagovitsin
каким инструментом?
доки на RTD собирает Sphinx, так что им
источник

NV

Nick Volynkin in DocOps-сообщество
попробую привести пример
источник

RG

Ramil G in DocOps-сообщество
Dmitry Nagovitsin
каким инструментом?
Видимо, гитом
источник

A

Angela in DocOps-сообщество
коллеги, как в rst под сфинксом сделать иконку между словами в тексте? вот так не работает(

Методы, закрытые авторизацией, отмечены значком |lock|:

.. |lock| img:: img/lock.png
источник