私は git と GitHub でドキュメントを管理しています。ソース ファイルは、Pdflatex 用の TEX ファイルと、コンパイルに使用される他のいくつかのファイル (Figure など) です。これらのファイルはバージョン管理されています。コンパイル後、彼らは PDF ファイルを生成します (これは私のプロジェクトのすべての詳細を説明しています)。
結果の PDF ファイルはソースから構築されるため、バージョン管理する必要はありません。PDFをコンパイルしたバージョン管理は、リソースのウエストになります。
ただし、私の GitHub リポジトリをチェックアウトした人が最後にコンパイルされた PDF をすぐに読めるようにして、自分でコンパイルする必要がないようにしたいと思います。ざっと見たいだけの人には、そういう可能性はありがたいですよね。
これは GitHub でどのように行うことができますか?
にダウンロード ページがありますhttp://github.com/user/project/downloads。必要に応じて、 APIを使用してこれを自動的に処理できます。
編集: Thomasが指摘したように、ダウンロード API は廃止され、「 Releases 」と呼ばれる別のワークフローに置き換えられました。その後、バイナリ ファイルを特定のリリースに添付できます。
はい、できます。[ダウンロード] タブに移動し、PDF ファイルをアップロードします。他のユーザーはそれを見ることができます。
私の知る限り、これは思い通りにできるものではありません。誰かがブランチを古いバージョンにリバースしたと想像してください。PDF がバージョン管理されていない場合、どうなりますか?
git はバージョン管理の方法が非常に効率的であり、PDF が非常に大きい場合を除き、ユーザーがプルしたときに本当にそこに置きたい場合はそのままにしておいても問題ありません。
個人的には、ブランチに PDF を含めずに、GitHub のダウンロード ページを利用することをお勧めします。必ずしもソースとは関係のない、プロジェクトに関連するファイルを置くことができます。これは通常、開発者がリリース ビルドなどの tarball を作成するために使用します。