GitHub Pages について
GitHub Pages は、GitHub Enterprise Server のリポジトリから HTML、CSS、および JavaScript ファイル を直接取得し、任意でビルドプロセスを通じてファイルを実行し、ウェブサイトを公開できる静的なサイトホスティングサービスです。 GitHub Pages サイトの例は、GitHub Pages サンプル コレクションで確認できます。
作業を開始する� �合は、「GitHub Pages サイトを作成する」を参照してく� さい。
組織の所有者は、組織のリポジトリからの GitHub Pages サイトの公開を無効にすることができます。 詳細については、「Organization の GitHub Pages サイトの公開を管理する」を参照してく� さい。
GitHub Pages サイトの種類
GitHub Pages サイトには、3 つの種類があります。プロジェクト、ユーザ、そして Organization です。 プロジェクトサイトは、JavaScript ライブラリやレシピ集など、GitHub Enterprise Server の特定のプロジェクトに関するものです。 ユーザ及びOrganizationのサイトは、上の特定のアカウントに接続されます。
ユーザー サイトを公開するには、自分の個人アカウントが所有する <username>.<hostname>
という名前のリポジトリを作成する必要があります。 組織サイトを公開するには、<organization>.<hostname>
という名前の組織が所有するリポジトリを作成する必要があります。
プロジェクトサイトのソースファイルは、プロジェクトと同じリポジトリに保存されます。
GitHub Enterprise Server のアカウントごとに作成できるユーザまたは Organization サイトは 1 つ� けです。 Organization または個人アカウントで所有するプロジェクト サイトの数には、制限がありません。
サイトが利用できる URL は、 でサブドメインの分離を有効にしているかどうかで異なります。
サイトの種類 | Subdomain Isolation が有効 | Subdomain isolation が無効 |
---|---|---|
User | http(s)://pages.<hostname>/<username> | http(s)://<hostname>/pages/<username> |
Organization | http(s)://pages.<hostname>/<organization> | http(s)://<hostname>/pages/<organization> |
個人アカウントが所有するプロジェクト サイト | http(s)://pages.<hostname>/<username>/<repository>/ | http(s)://<hostname>/pages/<username>/<repository>/ |
組織アカウントが所有するプロジェクト サイト | http(s)://pages.<hostname>/<orgname>/<repository>/ | http(s)://<hostname>/pages/<orgname>/<repository>/ |
詳細については、「Subdomain Isolation の有効化」を参照するか、サイト管理者にお問い合わせく� さい。
GitHub Pages サイトの公開元
警告: サイト管理者がパブリック ページを有効にしている� �合、サイトのリポジトリがプライベートまたは内部であっても、GitHub Pages サイトはインターネット上で一般公開されます。 サイトのリポジトリにセンシティブなデータがあるなら、公開前にそのデータを取り除くのが良いでしょう。 詳細については、「エンタープライズで GitHub Pages を構成する」および「リポジトリについて」を参照してく� さい。
GitHub Pages サイトは、変更が特定のブランチにプッシュされるたびに公開されます。 公開ソースとして使用するブランチとフォルダーを指定できます。 ソース ブランチにはリポジトリ内の任意のブランチを指定でき、ソース フォルダーにはソース ブランチのリポジトリ (/
) のルートまたはソース ブランチの /docs
フォルダーのいずれかを指定できます。 変更がソース ブランチにプッシュされるたびに、ソース フォルダー内の変更が GitHub Pages サイトに公開されます。
詳しい情� �については、「GitHub Pages サイトの公開元の構成」を参照してく� さい。
静的サイト ジェネレーター
GitHub Pages は、リポジトリにプッシュされたあらゆる静的ファイルを公開します。 静的ファイルを自分で作成することも、静的サイトジェネレータでサイトをビルドすることも可能です。 ローカルまたは別のサーバー上で独自のビルドプロセスをカスタマイズすることもできます。
GitHub Pages に組み込まれている静的サイトジェネレータで、ビルドプロセスを容易化できる Jekyll のご利用をおすすめします。 詳細については、「GitHub Pages と Jekyll について」を参照してく� さい。
GitHub Pages は、デフォルトでは Jekyll を使ってサイトを構築します。 Jekyll 以外の静的サイト ジェネレーターを使用する� �合は、公開元のルートに .nojekyll
という空のファイルを作成し、静的サイト ジェネレーターの指示に従ってローカルでサイトをビルドします。
GitHub Pages は、PHP、Ruby、Python などのサーバーサイド言語はサポートしていません。
GitHub Pagesの利用上の制限
GitHub Pages は、オンライン ビジネス、eコマース サイト、主に商取引の円滑化またはサービスとしての商用ソフトウェア (SaaS) の提供のどちらかを目的とする、その他の Web サイトを運営するための無料の Web ホスティング サービスとしての使用を意図したものではなく、またそのような使用を許可するものでもありません。 GitHub Pages サイトは、パスワードやクレジットカード番号といった機密情� �のやりとりに使うべきではありません。
さらに、GitHub Pages の使用には、一獲千金を狙った計画、わいせつなコンテンツ、暴力的あるいは脅迫的なコンテンツや活動に関する制限など、GitHub 利用規約が適用されます。
Usage limits (使用状況の制限)
GitHub Pages サイトには、次の使用制限があります:
- GitHub Pages ソース リポジトリには、1 GB の推奨上限があります。
- 公開されたGitHub Pagesのサイトは1GB以上であってはなりません。
GitHub Pages での MIME タイプ
MIME タイプとは、ブラウザがリクエストするファイルの性質やフォーマットに関する情� �を提供するため、サーバーがブラウザに送信するヘッダのことです。 GitHub Pages は、数千のファイル拡張子にわたり、750 を超える MIME タイプをサポートしています。 サポートされている MIME の種類の一覧は、mime-db プロジェクトから生成されます。
ファイルごと、リポジトリごとにカスタ� MIME タイプを指定することはできませんが、GitHub Pages で使う MIME タイプを追� や変更することは可能です。 詳細については、mime-db のコントリビューション ガイドラインを参照してく� さい。
参考資料
- GitHub Skills の GitHub Pages
- "GitHub Pages"