ttimasdf/README.md

## README.md

      
    Raw
  

              README.md
            
          
    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"

  
## setup-git-hook.sh
#!/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
	#!/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