我使用 git 和 GitHub 维护文档。源文件是 Pdftex 的 TEX 文件以及用于编译的一些其他文件（如图形）。这些文件是版本化的。编译后，他们会生成一个 PDF 文件（解释了我项目的所有细节）。
不需要对生成的 PDF 文件进行版本控制，因为它是从源代码构建的。对编译后的 PDF 进行版本控制将是一大堆资源。
但是，我希望查看我的 GitHub 存储库的人可以立即阅读最后编译的 PDF，这样他们就不需要自己编译了。这种可能性会被那些只想快速浏览的人所欣赏，不是吗？
GitHub 如何做到这一点？
【问题讨论】：
您的下载页面位于http://github.com/user/project/downloads。如果需要，您可以使用他们的API 自动处理此问题。
编辑： 正如 Thomas 所指出的，下载 API 从那时起一直是 deprecated，并已被另一个名为“Releases”的工作流程所取代。然后，您可以将二进制文件附加到特定版本。
【讨论】：
是的，您可以这样做。转到“下载”选项卡并上传您的 PDF 文件。其他用户将能够看到它。
【讨论】：
据我所知，这不是可以按照您想要的方式完成的事情。想象一下有人将分支反转为旧版本。如果 PDF 没有版本控制，它会发生什么？
git 在其版本控制方面非常有效，除非您的 PDF 非常大，否则如果您真的想要它在用户拉动时将其保留在其中，应该没问题。
个人建议不要在分支中包含PDF，直接使用GitHub的下载页面即可。它允许您放置与您的项目相关的文件，这些文件不一定与源一起使用。开发人员通常使用它来放置他们的发布版本等的 tarball。
【讨论】：