Size: a a a

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

2021 September 21

NV

Nick Volynkin in DocOps-сообщество
Для каждого документа конфиг? А зачем?
источник

D

Denis in DocOps-сообщество
Ну вот например, чтобы название каждому свое давать.
источник

J

Jonny Cuba in DocOps-сообщество
В корне index как оглавление для всех доков, в подпапках отдельные доки со своими index
источник

D

Denis in DocOps-сообщество
У нас из выходных форматов пока только ворд. Поэтому я раскидываю исходники по папкам, а в каждую папку кладу index.rst и conf.py/
источник

J

Jonny Cuba in DocOps-сообщество
У нас другая структура, один конфиг на все, поэтому если настройки докбилда меняешь, одно название ко всем документам, вот я и думал, что может есть решение (переменная), которое подтягивает название доки, например из caption и вставляет в каждый docx-документ
источник

D

Denis in DocOps-сообщество
Вообще там вроде список в конфиге docx-builder. Можно попробовать туда добавить свойства других доков. В документации docx-builder не нашел такого, может плохо искал.
источник

J

Jonny Cuba in DocOps-сообщество
Вот это, интересно уже)) надо покопать
источник

D

Denis in DocOps-сообщество
docx_documents
This value determines how to group the document tree into docx files.
источник

D

Denis in DocOps-сообщество
Скорее всего, несколько доков опубликует.
источник

D

Denis in DocOps-сообщество
Отпишитесь по результатам, пжл
источник

J

Jonny Cuba in DocOps-сообщество
У нас дженкинс публикует разные доки по тегам
источник

J

Jonny Cuba in DocOps-сообщество
Ок, посмотрю как и что
источник

D

Denis in DocOps-сообщество
Коллеги, вопрос снова по docx-builder. Кому-то удалось публиковать таблицы с нужным стилем? Делаю все как в доке, но стиль всегда Normal
источник

NP

Nikolaj Potashnikov in DocOps-сообщество
На самом деле, не очень точная табличка, и немного устаревшая
источник

NP

Nikolaj Potashnikov in DocOps-сообщество
мне кажется, как по сложности эко-системы, так и по возможностям, можно упорядочить так: md -> rst -> asciidoc
источник

V

Vasiliy in DocOps-сообщество
Спасибо. Пока остановился на asciidoc, но надо допиливать оформление нормальное.
источник

NP

Nikolaj Potashnikov in DocOps-сообщество
У них же есть сейчас два стиля: традиционный Asciidoc и Antora (если говорить о web). Последний достаточно хороший, как мне кажется
источник

V

Vasiliy in DocOps-сообщество
Antora выглядит интересно, спасибо
источник

J

Jonny Cuba in DocOps-сообщество
Денис, все работает, каждый док можно назвать своим именем, сфинкс генерит документы, с нужными названиями
источник

D

Denis in DocOps-сообщество
Спасибо за информацию! Подумаю, может и нам такое подойдет.
источник