安装pandoc
什么是pandoc
pandoc是一个文件转换工具,支持不同文件间的相互转换,具体见https://github.com/jgm/pandoc 输入文件,支持的格式如下:
commonmark creole docbook docx dokuwiki epub fb2 gfm haddock html ipynb jats json latex man markdown markdown_github markdown_mmd markdown_phpextra markdown_strict mediawiki muse native odt opml org rst t2t textile tikiwiki twiki vimwiki
输出文件支持格式如下:
asciidoc asciidoctor beamer commonmark context docbook docbook4 docbook5 docx dokuwiki dzslides epub epub2 epub3 fb2 gfm haddock html html4 html5 icml ipynb jats jira json latex man markdown markdown_github markdown_mmd markdown_phpextra markdown_strict mediawiki ms muse native odt opendocument opml org plain pptx revealjs rst rtf s5 slideous slidy tei texinfo textile xwiki zimwiki
安装
参考:https://pandoc.org/installing.html。进入下载页面,获取安装包
#linux #$TGz源文件路径 $DEST安装路径 tar xvzf $TGZ--strip-components 1 -C $DEST
修改配置
修改.gitconfig
1.添加文件名中文支持 [core] quotepath = false 2. wdiff比较word [ diff "pandoc"] textconv=pandoc --to=markdown prompt = false [alias] wdiff = diff --word-diff=color --unified=1
增加.gitattributes
你可以在你项目的文件根目录下里新增一个.gitattributes文件,并进行设置。如果不想让这些属性文件与其他文件一同提交,也可以在.git/info/attributes文件进行设置
#.git/info/ attributes *.docx = pandoc
如果想要查看历史修改:
git log -p --word-diff=color file.docx
不足
1. 不支持doc读取,只能比较docx文件,如果要对文档进行管理,建议保存为docx
2. 只能比较显示的文本,对图片增加删除修改后,比较显示的是 markdown格式,不利于观看
3. 总的来说,如果要管理文档,还是建议先用其他工具比较在提交比较靠谱.git diff对比有些不足。
4. 如有其他实现手段欢迎后台留言讨论。