Size: a a a

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

2020 July 10

FM

Fox Mulder in DocOps-сообщество
Тоже вопрос. Может ли пандок сам выдирать рисунки из docx для asiidoc и класть их в папку /image/*.png ?
источник

NV

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

NV

Nick Volynkin in DocOps-сообщество
pandoc умеет конвертировать DOCX в reST, Markdown или AsciiDoc вместе с изображениями:

 pandoc -f docx --extract-media images -t rst -o document.rst document.docx 
pandoc -f docx --extract-media images -t markdown -o document.md document.docx
pandoc -f docx --extract-media images -t asciidoc -o document.adoc document.docx


Изображения будут в директории images. В любой разметке сразу будут правильные ссылки на них.
источник

NV

Nick Volynkin in DocOps-сообщество
Николай
Всем привет. А кто-нибудь женил статику сгенеренную sphinx с конфлюенсом? Чтоб была последовательность:
1. шуделер запускает автоатизированную сборку и генерацию (тут проблем нет)
2. поулченный html пушится на страницы конфа (вот тут не понятно куда копать)
не надо через HTML, есть плагин Sphinx Confluence Builder https://sphinxcontrib-confluencebuilder.readthedocs.io/en/latest/documentation.html
источник

NV

Nick Volynkin in DocOps-сообщество
Там без HTML, плагин добавляет новый таргет sphinx-build -M confluence, который собирает сразу XML конфлюенса и через API его пушит.
источник

NV

Nick Volynkin in DocOps-сообщество
@Lananovikova про это рассказывала в докладе, кстати.
источник

Н

Николай in DocOps-сообщество
Огонь! осталась ли запись?
источник

NV

Nick Volynkin in DocOps-сообщество
Николай
Огонь! осталась ли запись?
начни со статьи https://habr.com/ru/post/483898/
источник

Н

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

FM

Fox Mulder in DocOps-сообщество
Nick Volynkin
pandoc умеет конвертировать DOCX в reST, Markdown или AsciiDoc вместе с изображениями:

 pandoc -f docx --extract-media images -t rst -o document.rst document.docx 
pandoc -f docx --extract-media images -t markdown -o document.md document.docx
pandoc -f docx --extract-media images -t asciidoc -o document.adoc document.docx


Изображения будут в директории images. В любой разметке сразу будут правильные ссылки на них.
Спасибо громадное!
источник

L

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

FM

Fox Mulder in DocOps-сообщество
Может кому интересно:
По умолчанию пандок помещает картинки в папку /media, так как именно в этой папке лежат картинки в контейнере docx. Поэтому,  если мы указываем в команде при конвертации путь для хранения картинок, например images, то картинки будут храниться по пути /media/images/
Чтобы избавиться от этого надо команду:
pandoc -f docx --extract-media . -t asciidoc -o RA.adoc RA.docx
источник

FM

Fox Mulder in DocOps-сообщество
Буду копать по пути - можно ли при парсере и конверте из docx -> adoc добавлять к наименованиям картинок свои символы.
источник

A

Angela in DocOps-сообщество
может, до кучи кто-то подскажет, как запилить спойлеры под sphinx? это когда часть контента прячется под плюсик, и при его нажатии раскрывается/закрывается

вот такой нагугленный метод у меня почему-то не сработал
https://stackoverflow.com/questions/2454577/sphinx-restructuredtext-show-hide-code-snippets
источник

PV

Pavel Vrukhin in DocOps-сообщество
Angela
может, до кучи кто-то подскажет, как запилить спойлеры под sphinx? это когда часть контента прячется под плюсик, и при его нажатии раскрывается/закрывается

вот такой нагугленный метод у меня почему-то не сработал
https://stackoverflow.com/questions/2454577/sphinx-restructuredtext-show-hide-code-snippets
источник

A

Angela in DocOps-сообщество
спасибо! пойду тестировать
источник

FM

Fox Mulder in DocOps-сообщество
А вот у  меня такой вопрос исходя из рекламы канала -
где подготовка программистов сильнее: ВМК, МехМат или ИТМО?
источник

NV

Nick Volynkin in DocOps-сообщество
Промахнулась )))
источник

NV

Nick Volynkin in DocOps-сообщество
Но канал угарный, тоже рекомендую
источник

NV

Nick Volynkin in DocOps-сообщество
Тутанхамон:
Привет, рабы! Мне нужна пирамида. Сможете добавить этот проект к себе в портфолио.
источник