GitHub でお手軽文書公開

著者: フィッシュ
公開日: 2018年4月14日

ちょっとした文書を公開するときに、GitHub は無料かつ簡単に使えて、更新履歴もすべて保存されるため、とても便利です。ところが、GitHub の解説ページは、チームによるプログラムの共同開発を前提としていて、様々なコマンドが解説されているので、慣れていない人にはとっつきにくく感じるものが多いです。このページでは、

という方針で、お手軽に文書を公開する手順を示します。

手順1: アカウントの作成

GitHub のページ で、ユーザー名 (Username)、メールアドレス、パスワードを決めて入力します。 Username is already taken と表示されたら、そのユーザー名はすでに使われているので別のユーザー名を考えます。 緑色の Sign up for GitHub ボタンを押します。

Sign up

次にプランを選びます。とりあえず無料プランを選んでおけば良いでしょう。

Unlimited public repositories for free.
を選んで、緑色の Continue ボタンを押します。 アンケートに答えて緑色の Submit ボタンを押すか、skip this step でアンケートをスキップします。 しばらくすると GitHub から
[GitHub] Please verify your email address.
というようなタイトルのメールが届くので、メール中のリンクをクリックすることでメールアドレスが確認されて、GitHub のアカウントができます。

手順2: リポジトリの作成

GitHub にログインして、右上の + をクリックして New repository をクリックします。

New repository

リポジトリの作成画面が出るので、次の図のように入力します。

Create repository

これで、リポジトリができました。リポジトリの管理画面には

https://github.com/<ユーザー名>/<ユーザー名>.github.io
からアクセスできます。たとえば https://github.com/kyodaisuu/kyodaisuu.github.io です。公開されたホームページ (GitHub Pages) のアドレスは
https://<ユーザー名>.github.io
です。たとえば https://kyodaisuu.github.io となります。

手順3: ファイルのアップロード

リポジトリの管理画面から、Upload Files をクリックします。

upload
Drag files here to add them to your repository
と書かれている大きなエリアに、ファイルをエクスプローラやファインダからドラッグ&ドロップします。まとめて複数のファイルを追加することもできます。
choose your files
から、ファイルを選ぶこともできます。 Commit changes と書かれているところに、コメントを書きます。何も入れなくても自動的にコメントが入りますが、更新履歴にコメントが表示されるので、簡単なコメントを入れておくと良いと思います。 Commit changes ボタンを押すことで、ファイルをアップロードできます。このとき、すでにファイルが存在する場合はファイルが更新されます。 ファイルを更新してから、GitHub Pages に反映されるまでには多少時間がかかります。

付録: ディレクトリの作成

ディレクトリを作成する手順を記します。

GitHub では「空のディレクトリ」は作成できないので、ディレクトリを作成するときには、このように必ずファイルをいっしょに作成します。一度ディレクトリを作成すれば、リポジトリ管理画面からそのディレクトリに入って、手順3の方法でそのディレクトリにファイルをアップロードできます。

公式のヘルプ

GitHub Help が公式のヘルプです。この中で、このページに記したことと関連するページをまとめます。


フィッシュ