我使用git和GitHub维护文档。源文件是Pdflatex的TEX文件和用于编译的一些其他文件(如图)。这些文件是版本化的。编译后,他们会生成一个PDF文件(解释我项目的所有细节)。
无需对生成的PDF文件进行版本控制,因为它是从源代码构建的。编译PDF的版本控制将成为资源的一部分。
但是,我希望检查我的GitHub存储库的人可以立即读取最后编译的PDF,这样他们就不需要自己编译了。这种可能性会被那些只想快速浏览的人所欣赏,不是吗?
如何使用GitHub完成?
答案 0 :(得分:9)
您在 http://github.com/user/project/downloads
处有一个下载页面。如果需要,您可以使用API自动处理此问题。
修改:正如Thomas所述,下载API已经deprecated,并且已被另一个名为“Releases”的工作流程所取代。然后,您可以将二进制文件附加到特定版本。
答案 1 :(得分:4)
是的,你可以这样做。转到“下载”标签并上传您的PDF文件。其他用户将能够看到它。
答案 2 :(得分:1)
据我所知,这不是以你想要的方式完成的事情。想象一下有人将分支转换为旧版本。如果PDF没有版本化,会发生什么?
git在版本控制方面非常有效,除非你的PDF版本非常大,否则如果你真的希望它在用户拉动时就把它留在那里应该没问题。
就个人而言,我建议您不要在分支中包含PDF,只需使用GitHub的下载页面即可。它允许您放置与项目相关的文件,这些文件不一定与源文件一起使用。这通常被开发人员用来放置他们的发布版本等的tarball。