Отслеживание версий файлов DOCX в Git

Git нативно не предусматривает возможности отслеживания изменений в файлах DOCX, как в том же TXT.

Чтобы получить хоть какую-то возможность для этого, необходимо выполнить указанные ниже действия.

Данные действия осуществлялись на MacOS. В качестве примера специально разрабатывалась памятка по домовой выписке, переработанная на основании исходника (JPEG изображение).

1. Установить Pandoc.

2. В корневом каталоге ОС необходимо создать или сразу отредактировать, если уже создан, файл .gitconfig, в который добавить:

[diff "pandoc"]
   textconv=pandoc --to=markdown
   prompt = false
[alias]
   wdiff = diff --word-diff=color --unified=1

3. Папка вашего проекта, в котором будете работать с файлами DOCX, должна быть инициализирована в качестве GIT-репозитория (если ещё не сделали этого, то сейчас самое время). В корневом каталоге вашего проекта, то есть в этой самой папке, создать файл .gitattributes, в который добавить одну строчку:

*.docx diff=pandoc

4. Предыдущие действия позволят отслеживать внесённые изменения в DOCX файлы в командной строке (терминале) с помощью команды:

git wdiff "наименование файла.docx"

Можно использовать и стандартную команду:

git diff "наименование файла.docx"

5. НО! Данные действия позволят отследить изменения только в командной строке (терминале). На GitHub конкретные изменения по тексту показываться не будут, вы лишь увидите сообщение "Binary file not shown" и на сколько байтов изменился файл DOCX. Чтобы на GitHub видеть конкретные изменения по тексту можно с помощью Pandoc конвертировать DOCX в MD (Markdown). Для этого перед каждой подготовкой (git add) файлов к коммиту выполняем команду:

pandoc -s "наименование файла.docx" -t markdown -o "наименование файла.md"

Затем, как обычно:

git add --all
git commit
git push

На GitHub будут оба файла, но в MD мы сможем увидеть конкретные изменения по тексту.