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

Пожалуйста )

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

2018 January 18

Так'с.
И снова я, снова за советом.
Есть ли альтернатива Read The Docs, которая работает с .doc и .docx?
Которая предоставит хоть как-то похожий функционал в виде удобного чтения.
Я вот уже копаюсь с этими документациями почти два месяца. Как у вас только хватает нервов и сил работать с документацией?

10:52пожаловаться #2

Как именно вы хотите работать с этими форматами? Просматривать, редактировать, централизованно хранить?

Егор Доронин in DocOps-сообщество

10:54пожаловаться #3

ЕД

Надо просто различать средство создания документа от средства доставки

10:55пожаловаться #4

Read The Docs и вообще подход «документация как код» предполагает, что вы создаете документы в формате разметки, а потом публикуете в удобный вам формат.

10:55пожаловаться #5

Конкретно Read The Docs умеет публиковать только на сайт, насколько я знаю.

10:55пожаловаться #6

Только просматривать.

10:56пожаловаться #7

Вы хотите собирать в docx и отправлять его читателям?

10:57пожаловаться #8

Есть готовый файл docx с документацией.
Нужно его разместить, чтобы можно было зайти,посмотреть документацию в удобном виде (как в том же read The Docs, когда документация написана в .md и .rst)

10:59пожаловаться #9

RTD работает с исходниками только в форматах rST и MD.

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

Я понимаю смысл идеи "Документация как код" и мне это нравится больше, но они не хоят переписывать документацию из .docx в тот же .md для удобного испол.

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

Как вы хотите поддерживать этот документ? Вы его и дальше будете редактировать в Word?

11:00пожаловаться #12

Если да, то я бы вам предложил паковать результат в PDF и рассылать, чтобы у читателей не было соблазна редактировать что-то там.

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

Если готовы дальше редактировать в MD, то один раз прогнать через pandoc, руками подправить и дальше редактировать уже в MD. А публиковать на сайт или в PDF

11:01пожаловаться #14

Nick Volynkin

Как вы хотите поддерживать этот документ? Вы его и дальше будете редактировать в Word?

Ну или не вы, а кто-то другой.

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

Anatoliy

А ещё можно разместить на Google Drive / Google Docs и сделать ссылку с правами только на чтение.

11:03пожаловаться #16

Вот предложил такую же альтернативу, чтобы прогнать один раз, подправить косяки и все.
Но попросили уточнить,все же есть способ или другой инструмент размещения документации, по типу read The Docs, только для .docx, что бы не прогонять.
Через пол часа нужно дать ответ.

11:04пожаловаться #17

Вот решил у вас проконсультироваться.

11:04пожаловаться #18

Вот что ещё важно: кто читатели, как они получают доступ к документу, нужно ли этот доступ ограничивать? RTD — это публично доступный сайт. Docx можно отправлять по почте и контролировать процесс.

11:04пожаловаться #19

«по типу read The Docs» — это чтобы на сайте было?