Size: a a a

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

2021 January 19

ME

Maria Ermakovich in DocOps-сообщество
iakov v
Турция? ;)
йеп
источник

EN

Ekaterina Noskova in DocOps-сообщество
Кипр тоже страна котиков)
источник

M

Maeg in DocOps-сообщество
Ekaterina Noskova
Кипр тоже страна котиков)
но только на севере )))
источник

СФ

Семён Факторович... in DocOps-сообщество
Серверный Кипр
источник

НН

Нац Нац in DocOps-сообщество
Maria Ermakovich
таки ты переехал в страну котиков?)
В следующем месяце уже!
источник

НН

Нац Нац in DocOps-сообщество
Kseniya Chudakova
🤟 Поздравдения! Остался на этой же позиции или сменил деятельность?
Остался-остался, чую я техрайтером и продолжу быть еще очень долго. Запал пока есть, да и есть что рассказывать
источник

ME

Maria Ermakovich in DocOps-сообщество
Нац Нац
В следующем месяце уже!
гарно!
источник

IS

Igor Shakhbazyan in DocOps-сообщество
Maeg
но только на севере )))
не согласен) южный (греческий) Кипр тоже ими оккупирован)
источник

L

Lex in DocOps-сообщество
Россия - тоже страна котиков, третье место в мире по количеству хвостатых на душу населения
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Lex
Россия - тоже страна котиков, третье место в мире по количеству хвостатых на душу населения
Аватарка в тему :з
источник

FS

Filipp Sentsov in DocOps-сообщество
Господа, всем добрый день!
Подскажите, пожалуйста, по следующему вопросу: Есть ли возможности без танцев с бубном страницы из конфлюенсы в md файлы конвертировать? (официальный саппорт предлагает выполнять следующую комбинацию confluence page -> html -> markdown). Может кто то использовал что то в работе?)
Заранее спасибо.
источник

L

Lana in DocOps-сообщество
Filipp Sentsov
Господа, всем добрый день!
Подскажите, пожалуйста, по следующему вопросу: Есть ли возможности без танцев с бубном страницы из конфлюенсы в md файлы конвертировать? (официальный саппорт предлагает выполнять следующую комбинацию confluence page -> html -> markdown). Может кто то использовал что то в работе?)
Заранее спасибо.
Ну или pandoc из html в md или можно плагином markdown exporter если единоразово можно без покупки лицензии на триале все экспортнуть
источник

FS

Filipp Sentsov in DocOps-сообщество
Lana
Ну или pandoc из html в md или можно плагином markdown exporter если единоразово можно без покупки лицензии на триале все экспортнуть
Спасибо!
источник

ME

Maria Ermakovich in DocOps-сообщество
Filipp Sentsov
Господа, всем добрый день!
Подскажите, пожалуйста, по следующему вопросу: Есть ли возможности без танцев с бубном страницы из конфлюенсы в md файлы конвертировать? (официальный саппорт предлагает выполнять следующую комбинацию confluence page -> html -> markdown). Может кто то использовал что то в работе?)
Заранее спасибо.
https://github.com/meridius/confluence-to-markdown

только чтоб заработало глянь Issues и сделай как там написано
источник
2021 January 20

А

Александр Мокрушин... in DocOps-сообщество
Доброе утро!
Подскажите, пожалуйста, как в Sphinx создать multiproject? Вообще, возможно ли это? Мне нужно сгенерировать сайт из нескольких репозиториев.
источник

NV

Nick Volynkin in DocOps-сообщество
Александр Мокрушин
Доброе утро!
Подскажите, пожалуйста, как в Sphinx создать multiproject? Вообще, возможно ли это? Мне нужно сгенерировать сайт из нескольких репозиториев.
Это делается довольно прямолинейно:

1. Выберите один «родительский» проект.

2. Содержимое остальных перед сборкой копируйте куда-то в поддиректорию родительского. Можно сразу добавить их как git submodules. Можно делать симлинк директории, если собираете под линуксом или макосью.

3. Привязывайте это содержимое как обычно, через директивы toctree в тех документах родительского проекта, куда вы хотите прицепить каждый из остальных проектов.

Например, вот документ родительского проекта:
https://github.com/tarantool/doc/blob/1.10/doc/index.rst
Из него получается страница https://www.tarantool.io/en/doc/latest/

В этом документе есть директива toctree, в ней есть элемент Cluster <book/cartridge/index>. Он указывает на  другой документ, который находится в отдельном репозитории: https://github.com/tarantool/cartridge/blob/master/rst/index.rst

При сборке проекта мы обновляем субмодули и копируем файлы документации из них в нужные места. Этот файл как раз попадает в /doc/book/cartridge/index.rst.

Из него в результате получается страница https://www.tarantool.io/en/doc/latest/book/cartridge/.
источник

А

Александр Мокрушин... in DocOps-сообщество
Nick Volynkin
Это делается довольно прямолинейно:

1. Выберите один «родительский» проект.

2. Содержимое остальных перед сборкой копируйте куда-то в поддиректорию родительского. Можно сразу добавить их как git submodules. Можно делать симлинк директории, если собираете под линуксом или макосью.

3. Привязывайте это содержимое как обычно, через директивы toctree в тех документах родительского проекта, куда вы хотите прицепить каждый из остальных проектов.

Например, вот документ родительского проекта:
https://github.com/tarantool/doc/blob/1.10/doc/index.rst
Из него получается страница https://www.tarantool.io/en/doc/latest/

В этом документе есть директива toctree, в ней есть элемент Cluster <book/cartridge/index>. Он указывает на  другой документ, который находится в отдельном репозитории: https://github.com/tarantool/cartridge/blob/master/rst/index.rst

При сборке проекта мы обновляем субмодули и копируем файлы документации из них в нужные места. Этот файл как раз попадает в /doc/book/cartridge/index.rst.

Из него в результате получается страница https://www.tarantool.io/en/doc/latest/book/cartridge/.
Большое спасибо!
источник

FS

Filipp Sentsov in DocOps-сообщество
Спасибо
источник

L

Lejbron in DocOps-сообщество
ID:0
С декабря прошлого года я руковожу командой технических писателей в tarantool.io. Это новый для меня продукт, новая роль и гора новых задач. Тематика канала теперь тоже расширится. В 2021 году ждите постов про:

— документацию как продукт;
— профессиональный рост писателя;
— руководство командой писателей;
— место и роль документации в технических коммуникациях, управлении знаниями и developer relations;
— и вакансии в @docops_jobs, наконец-то!

Документация как код, мероприятия и другие хорошие штуки тоже останутся. Надеюсь, что смогу уделять каналу больше времени, чем в сложном 2020-м.

Если вы хотите поработать со мной в команде, пишите в личку @nick_volynkin хоть сейчас. Добавьте резюме и примеры работ, лучше на английском.
Вот так внезапно стали коллегами;) поздравляю, успехов!
источник

NV

Nick Volynkin in DocOps-сообщество
Lejbron
Вот так внезапно стали коллегами;) поздравляю, успехов!
Спасибо )
источник