NV
То есть в рамках консультирования вы пишете документацию или хотя бы настраиваете инструменты для неё? Это очень интересно.
Size: a a a
2019 October 15
NV
Вот. Освоил sphinx - хочу почитать что и как делают коллеги...
Из интересного: недавно Лана Новикова рассказывала, как их Сфинкса пушить доки в Конфлюенс
NV
DocOps-митап начинается с доклада о том, как вести репозиторий с документацией. Рассказывает Константин Валеев, сотрудник Ростелекома и один из авторов Foliant.
NV
Вот в этом видео второй или третий доклад
СИ
То есть в рамках консультирования вы пишете документацию или хотя бы настраиваете инструменты для неё? Это очень интересно.
Та документация которая есть - меня категорически не устраивает. Куций doc с ужасным форматированием и без подсветки кода. Я лучше 2 часа потрачу на приведение доки в порядок чем этот ужас буду заказчику показывать...
NV
Та документация которая есть - меня категорически не устраивает. Куций doc с ужасным форматированием и без подсветки кода. Я лучше 2 часа потрачу на приведение доки в порядок чем этот ужас буду заказчику показывать...
начните с pandoc, сэкономите время :)
NV
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. В любой разметке сразу будут правильные ссылки на них.AY
начните с pandoc, сэкономите время :)
++++
СИ
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. В любой разметке сразу будут правильные ссылки на них.Вот за это большое человеческое спасибо
NK
Перевод курса по документированию API теперь есть в форме сайта: https://starkovden.github.io.
ES
круть! спасибо!
BN
полезная инфа, спасибо за ссылку
AR
прикольно)
NK
«Как замотивировать наших ребят делиться своим опытом через текст?» — недавно опубликованный совет от Людмилы Сарычевой. Хорошая тема на пересечении редактуры, деврела и управления знаниями.
Я там написал коментарий на основе своего опыта в Plesk и коллективной мудрости DevRel-сообщества. Если вам есть что добавить — присоединяйтесь.
Я там написал коментарий на основе своего опыта в Plesk и коллективной мудрости DevRel-сообщества. Если вам есть что добавить — присоединяйтесь.
KC
Привет всем, подскажите, какой используете поисковый движок по справочному центру? ru-en-zh
iv
Привет всем, подскажите, какой используете поисковый движок по справочному центру? ru-en-zh
Вопрос не по существу: у вас используется текст на китайском? Держите это всё в UTF8 или в каких-то специальных китайских кодировках?
KC
Вопрос не по существу: у вас используется текст на китайском? Держите это всё в UTF8 или в каких-то специальных китайских кодировках?
сейчас только ru-en, китайский только в планах
NV
Вопрос не по существу: у вас используется текст на китайском? Держите это всё в UTF8 или в каких-то специальных китайских кодировках?
Конечно в utf8
NV
А, это я ответил про нас (Plesk).
iv
вообще интересно, как обстоят дела с поиском по китайским текстам, с учётом того, что пробелы в китайском особо не используются и как делить текст на ключевые слова человеку, привыкшему к пробелам, не очень понятно