DEV Community
·
我如何通过Git钩子和Pandoc自动生成`resume.pdf`
内容提要
本文介绍了如何通过Git钩子自动将简历的Markdown文件转换为PDF。使用Pandoc和MacTeX，每次编辑index.markdown文件时，都会生成相应的PDF并与提交一起推送。
关键要点
-
本文介绍了如何通过Git钩子自动将简历的Markdown文件转换为PDF。
-
使用Pandoc和MacTeX，每次编辑index.markdown文件时，都会生成相应的PDF并与提交一起推送。
-
简历可在https://pavol.kutaj.com查看，PDF下载链接为https://pavol.kutaj.com/assets/Pavol-Kutaj-Resume.pdf。
-
安装Pandoc：使用Homebrew安装Pandoc，命令为brew install pandoc。
-
安装MacTeX：使用Homebrew安装MacTeX，命令为brew install --cask basictex。
-
使用Pandoc将Markdown转换为PDF，命令为pandoc -V geometry:"top=2cm, bottom=1.5cm, left=2cm, right=2cm" -f markdown-implicit_figures -o "./assets/Pavol-Kutaj-Resume.pdf" index.markdown。
-
创建Git钩子：导航到Git钩子目录，命令为cd .git/hooks。
-
创建预提交钩子：创建pre-commit文件并打开，命令为touch pre-commit和nano pre-commit。
-
在预提交钩子中添加脚本以检查index.markdown是否被提交，并运行Pandoc命令生成PDF。
-
设置预提交钩子的可执行权限，命令为chmod +x pre-commit。
-
测试设置：确保index.markdown和./assets/目录存在，运行提交过程以验证钩子是否正常工作。
延伸问答
如何通过Git钩子自动生成PDF简历？
通过创建预提交钩子，在每次提交时检查index.markdown文件是否被修改，并使用Pandoc将其转换为PDF。
安装Pandoc和MacTeX的命令是什么？
安装Pandoc的命令是`brew install pandoc`，安装MacTeX的命令是`brew install --cask basictex`。
如何使用Pandoc将Markdown文件转换为PDF？
使用命令`pandoc -V geometry:"top=2cm, bottom=1.5cm, left=2cm, right=2cm" -f markdown-implicit_figures -o "./assets/Pavol-Kutaj-Resume.pdf" index.markdown`。
如何创建和设置Git的预提交钩子？
导航到.git/hooks目录，创建pre-commit文件，添加脚本并设置可执行权限，命令为`chmod +x pre-commit`。
如何测试Git钩子的设置是否正常？
确保index.markdown和./assets/目录存在，然后运行提交过程以验证钩子是否正常工作。
生成的PDF简历可以在哪里查看和下载？
生成的PDF简历可以在https://pavol.kutaj.com查看，下载链接为https://pavol.kutaj.com/assets/Pavol-Kutaj-Resume.pdf。
