从 git 提交生成 PDF 日志答案

【问题标题】：Generate a PDF logbook from git commits从 git 提交生成 PDF 日志
【发布时间】：2011-06-27 05:54:31
【问题描述】：

我知道我可以使用 git log 以各种方式查看以前的提交，但我想知道这里是否有人可以推荐一些好的工具来从 git 提交创建 PDF 或 HTML 日志。我希望我能够生成类似于 Github 提交日志风格但信息不同的东西。

如果人们对生成这些日志的程序没有任何想法，如果我尝试制作自己的生成器，他们的想法或建议是什么？

【问题讨论】：

【解决方案1】：

由于项目很快就要到期了，所以我自己编写了一个快速脚本来按照我想要的方式输出日志，它只是从 git-log 中抓取数据并将其输出到模板中（从 github 借来的）。

【讨论】：

【解决方案2】：

可以使用 'ccze' 和 -h（html 输出）开关

git log | ccze -A -h > gitlog.html

【讨论】：

【解决方案3】：

我写了一个从我的标签生成变更日志的。你可以阅读更多关于它的信息in my blog post，但基本的想法是一个写得很好的标签基本上应该无论如何都应该做到这一点，并且可以轻松地提供用户级文档。

【讨论】：

【解决方案4】：

如果你仍然使用 Github，我想知道，为什么不保存 html 和引用的 css 文件并通过 html2pdf 转换器运行它们，比如Pisa converter。

只要稍微调整一下我认为的 css，您就可以得到与您想要的完全一样的高质量格式的 pdf。

或者，您可以将差异存储在 txt 文件中，并通过包含 html 的库传递它们以进行语法突出显示，如 Pygments 并按照与 Pisa 类似的过程，如上所述。

【讨论】：

git-hub 日志以我喜欢的方式格式化，但我希望能够添加更多相关信息，例如添加和删除。我想我可能只是借用他们的 HTML 并编写快速 python 脚本来使用某种模板引擎解析它。