コードチュートリアルサイトでのGitの使用

Question

プロジェクトをプログラミングしようとしている一連のブログ投稿が含まれている教材サイトを作りたいと思います。各ブログの投稿の目標は、問題の一口を取り出して解決し、コードを段階的に作成することです。

私は読者のためのコードを提供したいと思います。そうすれば、私たちは投稿＃3の前に完成したコードをダウンロードしてそこから作業することができます。したがって、各ブログ投稿には、以前のコードセットを基にした独自のコードセットがあります。

これは基本的にgitがコミットする仕組みを反映しているように思えます。作品を完成させると、コミットします。コードのさまざまなセクションにアクセスするには、エンドユーザーはリポジトリをクローンし、ポスト＃3の特定のコミットをチェックアウトする必要があります。

これを行うより良い方法はありますか？また、ブログ投稿の変更前にプロジェクトを解凍して投稿の先頭に置いて、gitをまったく使用しないようなやり方もできます。さらに別の方法として、リポジトリ内に複数の異なるフォルダを作成することができます。各フォルダはブログ投稿の名前を付けられ、それぞれがブログ投稿のポイントまでプロジェクトの完全コピーを持ちます。

チュートリアルサイトでコードを提供するにはどうすればよいと思いますか？

Answer 1

これを達成するにはgithubでブランチまたはタグを使用します。

git checkout -b Tutorial_3 
...do some work here... 
git commit -a -m "Tutorial 3 Code" 
git push origin Tutorial_3 

リーダー：

git clone YOUR_REPOSITORY.git 
cd YOUR_REPOSITORY 
git fetch 
git checkout Tutorial_3 

Answer 2

うん、それはどのように私のPHP tutorial worksです。私はチュートリアルのコードを最初に反復的で有機的な方法で書いて、それを中心にテキストを書きました。素晴らしいことは、私がチュートリアルコードを更新したときに、いくつかのコンソールスクリプトを使ってチュートリアル全体を再生成できることです。

このアプローチの利点は、HTML差分の各変更をレンダリングできたことです。チュートリアルコードを変更するために、私は変更をリベースしてから、リモートに強制的にプッシュします。私は別のバージョンを維持するためにブランチを使用していますが、これはGitのやや乱暴な誤用ですが、動作します（see the repo here）。

私はtext repoを同様の方法で管理しています。ブランチはバージョンなので、自由に古い履歴を書き換えることができます。

リベースのルートを下っている場合は、コミットハッシュが保証されていないため、テキスト内のコミットを参照するのは難しいことに注意してください。これを回避するには、次のようにメッセージを使用してコミットを調べます。

<?php renderDiffFromComment('Add post view page') ?>