роли/аннотации, которые особым образом будут процесситься генератором RST→DOCX

про форматирование табличек, да

У меня так и не вышло быстро сделать шаблон в чём-то кроме Word'а, который был бы визуально похож на то, какие договора кажутся "нормальными" разным бухгалтерам и юристам

Пошел другим путём, подставляю данные в docx
https://github.com/guigrpa/docx-templates

Кайфовая либа на NodeJS для подстановки данных через GraphQL'ный формат запросов в обычный docx. Либа не трогает внутреннюю структуру ворда совсем, таблицы, колонтитулы, форматирование, всё остаётся как есть.

Умеет в условия, циклы и т.д.

Формат GraphQL будет удобен людям с опытом генерации статических сайтов на Gatsby, при желании позволяет легко любой источник подключить

У нас была схема с docx

Его фактически бессмысленно класть в гит, плюс каждый раз большое мучение с превращением его в шаблон.

Лучше вспомнить 15-летней давности опыт с латехом

docx это же вроде zip-архив с xml внутри? можно, наверное, это xml-содержимое класть в git?

В теории да, на практике там адище :)

Я именно так и шаблонизировал его

Обязательно потом напишите опыт перевода бухгалтеров и юристов на LaTeX. Очень интересно будет👍

Шаблон договора всё же не документация. Какой практический смысл имеет возможность проследить историю шаблона тех же доп.соглашений, вести ветки?

У нас есть пара шаблонов и пара исторических копий для памяти, но вот не скажу что сильно без гита тут страдаем

Учитывая что тут в целом будет как я скажу, так что условия немного нечестные :)


Но в целом пока без возражений маркдаун вместо ворда

Например увидеть что предлагаемые формулировки уже были и от них откпзались

Интересная идея, кстати

А как с гитом это делать, сообщениями к коммитам суть правок помечать или какой-то поиск по diff'ам?

В наших реалиях продаваемого нами нашего же софта договор - сложная штука, к которому нужна масса человеческих пояснений.

Прям как код: строчка хитроумного вызова и к нему абзац: зачем так сделано

У мен пока что идея инлайном в одном документе вести по сути два документа

Ну а история изменений гита видна

Прям сняли с языка))
Главное, чтобы цель оправдывала средства.
Юриспруденция среда весь и весьма консервативная. Если инструмент, коим, например, является LaTeX, имеет высокий порог вхождения, то вряд ли его будут использовать в профессиональной среде...
Но опыт безусловно будет интересно узреть))

Смотрите, какая няша
file-tree-generator

📦src
┣ 📂main
┃ ┗ 📂docs
┃ ┃ ┗ 📂privatecloud
┃ ┃ ┃ ┣ 📂images
┃ ┃ ┃ ┣ 📂themes
┃ ┃ ┃ ┣ 📂_includes
┃ ┃ ┃ ┣ 📜App.java
┃ ┃ ┃ ┗ 📜DevTools.adoc
┣ 📂scripts
┗ 📂test
┃ ┗ 📂docs
┃ ┃ ┗ 📂privatecloud
┃ ┃ ┃ ┣ 📂themes
┃ ┃ ┃ ┣ 📂_includes
┃ ┃ ┃ ┗ 📜AppTest.java

Причём решил попробовать совершенно случайно

девтулс.адок - символично