Этот статья является логическим дополнением статьи «Использование Microsoft Word с Git»

Для того, чтобы настроить git diff необходимо:

1. Установите pandoc .
2. Скажите git, как обрабатывать diff-файлы .docx.
   1. Создайте или отредактируйте файл ~ / .gitconfig (linux, Mac) или «c: \ Documents and Settings \ user.gitconfig» (Windows), чтобы добавить

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

   2. В своем бумажном каталоге создайте или отредактируйте файл .gitattributes (linux, Windows и Mac), чтобы добавить

      <code> *.docx diff=pandoc
      </code>

   3. Вы можете зафиксировать .gitattributes так, чтобы он оставался с вашей бумагой для использования на других компьютерах, но вам нужно будет редактировать ~ / .gitconfig на каждом новом компьютере, который вы хотите использовать.

Теперь вы можете увидеть довольно разноцветный diff с изменениями, внесенными вами в ваш .docx-файл с момента последнего фиксации

<code>git wdiff file.docx
</code>

Чтобы увидеть все изменения с течением времени

<code>git log -p --word-diff=color file.docx
</code>

Отслеживайте изменения в документах Word (.docx), получая разницу с фиксацией.

Автоматически при запуске git commit.

Это будет работать только с linux / Mac или Windows, запускающей git из оболочки bash.

1. Установите pandoc . Pandoc — это программа для преобразования между различными форматами файлов. Это позволит нам преобразовать файлы Word (.docx) в Markdown (.md).
2. Настройте git-крючки, чтобы включить автоматическую генерацию и отслеживание копий файлов .docx Markdown.Скопируйте эти файлы с крючками в .git/hooksкаталог проекта git и переименуйте их, или софт-ссылку на них ln -s, и сделайте их исполняемыми ( chmod u+x *.sh):
   • pre-commit-git-diff-docx.sh -> .git / hooks / pre-commit
   • post-commit-git-diff-docx.sh -> .git / hooks / post-commit

   Теперь каждый раз, когда вы запускаете git commit, крюк предварительной фиксации запускается автоматически, прежде чем вы увидите окно для ввода сообщения журнала. Крючок — это скрипт, который делает копию в формате Markdown (.md) каждого файла .docx, который вы совершаете. Крюк post-commit затем корректирует коммит, добавляя файлы .md.

Ручное создание копии файла .docx Markdown.

Это работает в Linux, Mac и Windows.

1. Установите pandoc .
2. При необходимости отредактируйте документ Word .
3. Запустите pandoc из командной строки linux или Windows. Это создаст версию Markdown вашего файла (без рисунков, но с уравнениями в латексном формате)

   <code> pandoc -s file.docx -t markdown -o file.md
   </code>

4. Обновите журнал изменений
5. Зафиксируйте оба файла с git

   <code> git add file.docx file.md
    git commit</code>

Оригинал статьи: https://github.com/vigente/gerardus/wiki/Integrate-git-diffs-with-word-docx-files