自動ジェネレータでのページの作成
GitHub Enterprise の [Automatic Page Generator] を使用して、プロジェクト、ユーザ、または Organization 用に 1 ページの Web サイトを素早く作成できます。
[Automatic Page Generator] は 1 ページの Web サイトを作成するために設計されました。 複数ページの Web サイト構築に関心をお持ちの場合は、Jekyll を使用することをおすすめします。 当面の対策として複数ページを [Automatic Page Generator] のサイトに追加するには、index.html ファイルをリポジトリのルートにコピーして、別の Web ページのテンプレートとして編集することができます。 この方法には、HTML についてある程度の知識が求められます。
メモ: GitHub Pages のソース設定でサイトを /docs master branch (master ブランチにある /docs フォルダ) から公開するように設定していると、[Automatic Page Generator] は無効になります。 詳しい情報についてはGitHub Pagesのための公開ソースの設定を参照してください。
ユーザおよび Organization ページ
ユーザおよび Organization ページのサイトを生成するには、<username>.[hostname]
という名前のリポジトリを作成する必要があります。 ユーザ名や Organization 名は必ず自分独自のものでなければなりません。そうでなければ GitHub Pagesサイトは構築されません。 [Automatic Page Generator] はリポジトリの [Settings] ページからアクセスできます。 ユーザおよび Organization ページの詳細についてはこちらでお読みいただけます。
プロジェクトページ
[Automatic Page Generator] を使用すると、どのプロジェクトリポジトリにある GitHub Pages サイトでも公開できます。
警告: リポジトリは必ず前述の命名規則に従って作成してください。そうしないと GitHub Pages サイトを公開できません。
[Automatic Page Generator]
-
GitHub Enterprise で、リポジトリのメインページへ移動します。
-
リポジトリ名の下で [Settings] をクリックします。
-
[Automatic Page Generator] ボタンをクリックします。
-
Markdown エディタでコンテンツを作成します。
-
[Continue To Layouts] ボタンをクリックします。
-
用意されているテーマを使用してコンテンツをプレビューします。
-
気に入ったテーマが見つかったら、[Publish page] をクリックします。
GitHub Pages サイトが生成され次第、それの HTML コードのローカルコピーを取得できます。 生成したのがプロジェクトページサイトの場合、新しいブランチをフェッチしてチェックアウトします:
$ cd repository
$ git fetch origin
> remote: Counting objects: 92, done.
> remote: Compressing objects: 100% (63/63), done.
> remote: Total 68 (delta 41), reused 0 (delta 0)
> Unpacking objects: 100% (68/68), done.
> From https://hostname/user/repo.git
> * [new branch] gh-pages -> origin/gh-pages
$ git checkout gh-pages
> Branch gh-pages set up to track remote branch gh-pages from origin.
> Switched to a new branch 'gh-pages'生成したのがユーザページサイトの場合、コードは gh-pages ブランチではなく master ブランチにあるため、master をチェックアウトしてプルしてください。
$ cd repository
$ git checkout master
> Switched to branch 'master'
$ git pull origin master
> remote: Counting objects: 92, done.
> remote: Compressing objects: 100% (63/63), done.
> remote: Total 68 (delta 41), reused 0 (delta 0)
> Receiving objects: 100% (424/424), 329.32 KiB | 178 KiB/s, done.
> Resolving deltas: 100% (68/68), done.
> From https://hostname/user/repo.git
> * branch master -> FETCH_HEAD
> Updating abc1234..def5678
> Fast-forward
> index.html | 265 ++++
> ...
> 98 files changed, 18123 insertions(+), 1 deletion(-)
> create mode 100644 index.html
> ...