Skip to content

Instantly share code, notes, and snippets.

@ttimasdf ttimasdf/README.md
Last active May 17, 2018

Embed
What would you like to do?
Integrate Git diffs and commits with Word DOCX files

Inspired from: https://github.com/vigente/gerardus/wiki/Integrate-git-diffs-with-word-docx-files

Usage:

cd /path/to/your/repo/with/docx

sh -c "$(curl -fsSL https://gist.githubusercontent.com/ttimasdf/7965baab972b901c1f8349ce5fcb5e09/raw/setup-git-hook.sh)"

Done!

git diff and git commit will show your DOCX transparently as text file. Exported markdown file will be named with scheme "${file%.docx}.exported.md"

#!/bin/bash
pandoc -v >/dev/null 2>&1 || {
echo >&2 "This script along with the included hooks requires pandoc to work. Aborting.";
exit 1;
}
# goto top level
cd `git rev-parse --show-toplevel`
grep -q "textconv=pandoc" .git/config ||
cat >>.git/config <<SETUPEOF
[diff "pandoc"]
textconv=pandoc --to=markdown
prompt = false
SETUPEOF
grep -q "diff=pandoc" .gitattributes ||
cat >>.gitattributes <<SETUPEOF
*.docx diff=pandoc
SETUPEOF
mkdir -p .git/hooks
cat >.git/hooks/pre-commit <<SETUPEOF
#!/bin/bash
# Credit:
# https://github.com/vigente/gerardus/wiki/Integrate-git-diffs-with-word-docx-files
# ========================================================================
# SUMMARY
# ========================================================================
#
# "pre-commit-git-diff-docx.sh:" Small git (https://git-scm.com/)
# hook. It works in combination with another hook,
# "post-commit-git-diff-docx.sh".
#
# Together, they keep a Markdown (.md) copy of .docx files so that git
# diffs of the .md files show the changes in the document (as .docx
# files are binaries, they produce no diffs that can be checked in
# emails or in the repository's commit page).
#
# ========================================================================
# DEPENDENCIES
# ========================================================================
#
# post-commit-git-diff-docx.sh
# pandoc (http://pandoc.org/)
#
# ========================================================================
# INSTALLATION
# ========================================================================
#
# 1) put both scripts in the hooks directory of each of your git
# projects that use .docx files. There are several options,
# e.g. you can put them in ~/Software and soft link to them from
# the hooks directory, e.g.
#
# cd $PROJECTPATH/.git/hooks
# ln -s ~/Software/pre-commit-git-diff-docx.sh pre-commit
# ln -s ~/Software/post-commit-git-diff-docx.sh post-commit
#
# or you can make a copy in the hooks directory
#
# cd $PROJECTPATH/.git/hooks
# cp ~/Software/pre-commit-git-diff-docx.sh pre-commit
# cp ~/Software/post-commit-git-diff-docx.sh post-commit
#
# 2) make sure that the scripts are executable
#
# cd ~/Software
# chmod u+x pre-commit-git-diff-docx.sh post-commit-git-diff-docx.sh
#
#
# ========================================================================
# DETAILS:
# ========================================================================
#
# This script makes a Markdown format copy (.md) of any .docx files in
# the commit. It then lists the .md file names in a temp file called
# .commit-amend-markdown.
#
# After the commit, the post-commit hook
# "post-commit-git-diff-docx.sh" will check for this file. If it
# exists, it will amend the commit adding the names of the .md files.
#
# The reason why we cannot simply add the .md files here is because
# `git add` adds files to the next commit, not the current one.
#
# This script requires pandoc (http://pandoc.org/) to have been
# installed in the system.
# Author: Ramon Casero <rcasero@gmail.com>
# Version: 0.3.0
# Copyright © 2016-2017 University of Oxford
#
# University of Oxford means the Chancellor, Masters and Scholars of
# the University of Oxford, having an administrative office at
# Wellington Square, Oxford OX1 2JD, UK.
#
# This file is part of Gerardus.
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details. The offer of this
# program under the terms of the License is subject to the License
# being interpreted in accordance with English Law and subject to any
# action against the University of Oxford being under the jurisdiction
# of the English Courts.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
# abort commit if pandoc is not installed
pandoc -v >/dev/null 2>&1 || {
echo >&2 "I require pandoc to keep track of changes in .docx files but it's not installed. Aborting.";
exit 1;
}
# go to the top directory of this project, because filenames will be
# referred to that location
cd `git rev-parse --show-toplevel`
# delete temp file with list of Mardown files to amend commit
rm -f .commit-amend-markdown
# create a Markdown copy of every .docx file that is committed, excluding deleted files
for file in `git diff --cached --name-only --diff-filter=d | grep "\.docx$"`
do
# name of Markdown file
mdfile="${file%.docx}.exported.md"
echo Creating Markdown copy of "$file"
#echo "$mdfile"
# convert .docx file to Markdown
cat >"$mdfile" <<EOF
# Do **NOT** edit this file directly
This file is generated automatically by git with pandoc. Edit corresponding docx only!
EOF
pandoc "$file" -t "markdown" >> "$mdfile" || {
echo "Conversion to Markdown failed";
exit 1;
}
# list the Markdown files that need to be added to the amended
# commit in the post-commit hook. Note that we cannot `git add`
# here, because that adds the files to the next commit, not to
# this one
echo "$mdfile" >> .commit-amend-markdown
done
# remove the Markdown copy of any file that is to be deleted from the repo
for file in `git diff --cached --name-only --diff-filter=D | grep "\.docx$"`
do
# name of Markdown file
mdfile="${file%.docx}.exported.md"
echo Removing Markdown copy of "$file"
if [ -e "$mdfile" ]
then
# delete the Markdown file
git rm "$mdfile"
# list the Markdown files that need to be added to the
# amended commit in the post-commit hook. Note that we
# cannot `git add` here, because that adds the files to the
# next commit, not to this one
echo "$mdfile" >> .commit-amend-markdown
fi
done
SETUPEOF
cat >.git/hooks/post-commit <<SETUPEOF
#!/bin/bash
# Credit:
# https://github.com/vigente/gerardus/wiki/Integrate-git-diffs-with-word-docx-files
# ========================================================================
# SUMMARY
# ========================================================================
#
# "pre-commit-git-diff-docx.sh": Small git (https://git-scm.com/)
# hook. It works in combination with another hook,
# "pre-commit-git-diff-docx.sh".
#
# Together, they keep a Markdown (.md) copy of .docx files so that git
# diffs of the .md files show the changes in the document (as .docx
# files are binaries, they produce no diffs that can be checked in
# emails or in the repository's commit page).
#
# ========================================================================
# DEPENDENCIES
# ========================================================================
#
# pre-commit-git-diff-docx.sh
# pandoc (http://pandoc.org/)
#
# ========================================================================
# INSTALLATION
# ========================================================================
#
# See pre-commit-git-diff-docx.sh
#
# ========================================================================
# DETAILS:
# ========================================================================
#
# This script checks whether file .commit-amend-markdown exists. If it
# exists, it amends the previous commit adding the names of .md files
# inside it.
# Author: Ramon Casero <rcasero@gmail.com>
# Version: 0.1.0
# Copyright © 2016 University of Oxford
#
# University of Oxford means the Chancellor, Masters and Scholars of
# the University of Oxford, having an administrative office at
# Wellington Square, Oxford OX1 2JD, UK.
#
# This file is part of Gerardus.
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details. The offer of this
# program under the terms of the License is subject to the License
# being interpreted in accordance with English Law and subject to any
# action against the University of Oxford being under the jurisdiction
# of the English Courts.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
# go to the top directory of this project, because filenames are
# referred to that location
cd `git rev-parse --show-toplevel`
# check whether the commit included .docx files that were converted to
# markdown (.md) format
if [ -a .commit-amend-markdown ]
then
# add Mardown versions (.md) of the .docx files to amend the
# commit
cat .commit-amend-markdown | xargs git add || {
echo "Git cannot add Markdown files to amend the commit";
exit 1;
}
# delete the file with the list of Markdown files to avoid an
# infinite loop
rm .commit-amend-markdown
# add the .md file by amending the last commit
## --no-verify: prevent infinite loop, don't go into the pre-commit
## hook again
echo Amend last commit adding .md files
git commit --amend -C HEAD --no-verify || {
echo "Git cannot amend the commit";
exit 1;
}
fi
exit
SETUPEOF
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.