Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ForNeVeR/ExtDiff
Compare documents using MS Word from the command line.
https://github.com/ForNeVeR/ExtDiff
diff microsoft-word powershell
Last synced: about 1 month ago
JSON representation
Compare documents using MS Word from the command line.
- Host: GitHub
- URL: https://github.com/ForNeVeR/ExtDiff
- Owner: ForNeVeR
- License: mit
- Created: 2016-08-14T03:18:36.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-10-19T15:57:07.000Z (about 2 months ago)
- Last Synced: 2024-10-31T21:03:10.429Z (about 1 month ago)
- Topics: diff, microsoft-word, powershell
- Language: PowerShell
- Size: 29.3 KB
- Stars: 125
- Watchers: 11
- Forks: 19
- Open Issues: 3
-
Metadata Files:
- Readme: Readme.md
- Changelog: CHANGELOG.md
- License: License.md
Awesome Lists containing this project
- my-awesome-github-stars - ForNeVeR/ExtDiff - Compare documents using MS Word from the command line. (PowerShell)
README
ExtDiff [![Status Aquana][status-aquana]][andivionian-status-classifier]
=======
This is a small command line script that will compare two files using Microsoft
Word file comparison tool. Microsoft Word will be started using COM automation.
It is useful as a diff tool for Word-related file types.
## Using via command line
To run the script, execute it through PowerShell like this:
```console
$ powershell -File Diff-Word.ps1 oldfile.docx newfile.docx
```
Or via the batch file:
```console
$ diff-word.cmd oldfile.docx newfile.docx
```
## Using the GUI form
![UI Form Screenshot][docs.ui-form]
To run the GUI form, run the script `start-gui.cmd`: it will open a form that stays on top of all the system windows,
and you can drag files from Windows Explorer to two text fields
(first for the old document, and second for the revised document).
When you click the **Compare** button, it will start Word application with chosen documents as in command line usage,
and the form will lose the "stay on top of all windows" behavior.
It will regain this property again after the button **Clear** is clicked.
If you drop multiple files into either box, then the first element will be placed in the box where files are dropped, and the second one into the other box.
## Using via Git Integration
You can also use this tool with git, so that `git diff` will use Microsoft Word
to diff `*.docx` files.
To do this, you must configure your `.gitattributes` and `.gitconfig` to support
a custom diff tool.
### `.gitattributes`
To configure your `.gitattributes`, open or create a file called
`.gitattributes` in your git repo's root directory. Add the following text to a
new line in this file:
```
*.docx diff=word
```
It is also possible to create a global `.gitattributes` file that will be
applied to every repository in a system. To do that, create a file
`.gitattributes` in your home directory, and then perform the following command:
```console
git config --global core.attributesfile ~/.gitattributes
```
### `.gitconfig`
To configure your `.gitconfig`, open or create the file in your home directory.
Then, add the following to your `.gitconfig`:
```ini
[diff "word"]
command = /diff-word-wrapper.cmd
```
Replace `` with the path to this repo's
location on disk.
-------
Idea taken from [TortoiseSVN diff-doc script][tortoisesvn-diff-doc].
Additional Documentation
------------------------
- [License (MIT)][docs.license]
- [Changelog][docs.changelog]
[andivionian-status-classifier]: https://github.com/ForNeVeR/andivionian-status-classifier#status-aquana-
[docs.changelog]: CHANGELOG.md
[docs.license]: License.md
[docs.ui-form]: docs/ui-screenshot.png
[status-aquana]: https://img.shields.io/badge/status-aquana-yellowgreen.svg
[tortoisesvn-diff-doc]: https://sourceforge.net/p/tortoisesvn/code/27268/tree/trunk/contrib/diff-scripts/diff-doc.js