Size: a a a

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

2020 February 10

BN

Baharev Nick in DocOps-сообщество
уже проверяю)
источник

BN

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

NV

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

A

Angela in DocOps-сообщество
Baharev Nick
pandoc тащит! все работает)
у меня вообще складывается впечатление, что пандок много где под капотом работает 😅
источник

BN

Baharev Nick in DocOps-сообщество
Nick Volynkin
он ещё и пачкой может
мне бы с одним файлом до конца разобраться)) картинки пропадают в итоговом файле
источник

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-сообщество
Вот наверняка тот же ключ --extract-media images
источник

BN

Baharev Nick 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. В любой разметке сразу будут правильные ссылки на них.
спасибо, буду проверять
источник

iv

iakov v in DocOps-сообщество
Baharev Nick
мне бы с одним файлом до конца разобраться)) картинки пропадают в итоговом файле
а где они у вас исходно лежат, если у вас просто html один исходный? Если в нём не абсолютные URL, pandoc не сможет узнать, где они лежат
источник

NV

Nick Volynkin in DocOps-сообщество
iakov v
а где они у вас исходно лежат, если у вас просто html один исходный? Если в нём не абсолютные URL, pandoc не сможет узнать, где они лежат
Браузер же узнаёт как-то )
источник

NV

Nick Volynkin in DocOps-сообщество
В смысле, если открыть локальный HTML
источник

iv

iakov v in DocOps-сообщество
браузер их из сети загружает, а вот если html просто на диске лежит, то все относительные url ведут тоже в локации на диске. если там на диске файлы лежат, то всё ОК :)
источник

iv

iakov v in DocOps-сообщество
но тогда возникает вопрос, если у вас уже есть папочка с картинками на диске, то что имеется в виду под "картинки пропадают в итоговом файле"?
источник

BN

Baharev Nick in DocOps-сообщество
iakov v
но тогда возникает вопрос, если у вас уже есть папочка с картинками на диске, то что имеется в виду под "картинки пропадают в итоговом файле"?
я открывал новый файл, а там только пути прописаны вместо изображений.
источник

BN

Baharev Nick in DocOps-сообщество
мне кажется, так не должно быть, или я не прав?
источник

NV

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

DS

Devorah Sperlin in DocOps-сообщество
всякая душа, которая не осквернилась и чиста, будет обладать региональными и федеральными бюджетами
источник
2020 February 11

NV

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

DS

Devorah Sperlin in DocOps-сообщество
Nick Volynkin
Нейросети шутят лучше, чем я
Ох, извините, я видимо сослепу не то и не туда((.Хорошо,  еще лайтовый текст отправился🙈
источник

EP

Elena Parameshwari L24[Mg7] in DocOps-сообщество
Ребята и девчата, привет! Хочется с вами посоветоваться. У нас разработчики ведут новый проект, и встроенную документацию (ака описание встроенного языка) решили "писать сами". Сейчас они хранят это дело, как мне показали, в Confluence, в виде каталогов и файлов формата md. А меня на днях "попросили вычитать". Но меня волнует такой аспект: предполагается работа с этими markdown-файлами "просто через git", и есть подозрение, что если оставить все в текущей организации, с развитием этого встроенного языка, я рискую потерять "контроль" над тем, что происходит. Хотелось бы спросить у тех, кто работает с mardown, как вы организуете хранение файлов, как можно, например, "хотя бы оценить объем текста", как отслеживаете изменения этого текста (например, если документы и их изменения для следующих версий планируется отдавать на перевод)? Пока мне не кажется управляемой куча папок и файлов, которую мне хотят "просто выгрузить из confluence". И это немного напрягает...
источник