Size: a a a

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

2017 December 28

EM

Ekaterina Maslova in DocOps-сообщество
Большое спасибо! Сейчас буду изучать. Времени дали мало...
источник

NV

Nick Volynkin in DocOps-сообщество
Ekaterina Maslova
Большое спасибо! Сейчас буду изучать. Времени дали мало...
А можно посмотреть на ваши исходники? Я бы вам показал на практике, что делать.
источник

EM

Ekaterina Maslova in DocOps-сообщество
Конечно! Отправлю в личку.
источник

ЕД

Егор Доронин in DocOps-сообщество
Если нужно сделать хорошо, то SDL Studio (Trados) в помощь. Это решение недешевое, но, по моему опыту, самое толковое.
источник

NV

Nick Volynkin in DocOps-сообщество
Традос умеет GNU Gettext?
источник

NV

Nick Volynkin in DocOps-сообщество
Оно же .po
источник

ЕД

Егор Доронин in DocOps-сообщество
15 Студия точно умеет, для 11-й нужно скачать фильт с сайта разработчика
источник
2018 January 05

ЕД

Егор Доронин in DocOps-сообщество
Интересный момент - после долгого заигрывания с неструктурированными форматами, Вики и т.п. мне дали карт-бланш на тестовое внедрение DITA в первом квартале 2018, с реализацией на базе AWS.
источник

ЕД

Егор Доронин in DocOps-сообщество
Постараюсь держать вас в курсе по мере внедрения
источник
2018 January 09

NV

Nick Volynkin in DocOps-сообщество
@DarthVader ждём блог про внедрение!
источник
2018 January 17

A

Anatoliy in DocOps-сообщество
Всем привет.
Есть такой вопрос.
Вот документация написано в доковском документе (.docx). Есть ли вариант переработать каким либо конвектаром, чтобы на выходе получить документы Markdown или reStructuredText с сохранением ссылок на главы и картинками?
источник

A

Anatoliy in DocOps-сообщество
Юзаем для документации read the docs. Тут коллеги из соседнего отдела решили тоже взять на вооружение. Но беда в том, что вся документация в docx.
Знаете что либо по альтернативным способам или как лучше разместить документация в docx формате, чтобы было по примеру read the docs?
источник

NV

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

ЕД

Егор Доронин in DocOps-сообщество
.docx это, унутре, xml
источник

ЕД

Егор Доронин in DocOps-сообщество
Теоретически можно xslt-преобразованием, если схема известна, приводить к .md его
источник

ЕД

Егор Доронин in DocOps-сообщество
Где-то в прошлом году пробегала информация, что в какой-то организации так версионирование сделано - превращается док в мд, и уже этот мд правится и хранится в репозитории
источник

ЕД

Егор Доронин in DocOps-сообщество
Я решал задачу в лоб - скриптом и node.js конвертировал, с последующим причесыванием регулярными выражениями
источник

ЕД

Егор Доронин in DocOps-сообщество
Но результат часто был субоптимальный, когда накладывались таблицы на особенности markdown
источник

A

Anatoliy in DocOps-сообщество
Понял.
Сейчас попробовал Pandoc, вполне годно выглядит. Но проблема с картинками только,но думаю, подправят.
Спасибо за оперативную помощь.  )
источник

NV

Nick Volynkin in DocOps-сообщество
А картинки, как раз, можно вытащить из xml
источник