はじめに
今回はGitHub Pagesを使って自分の作ったWebページの公開方法をわかりやすくまとめて記事にしようと思います。
私はGitHub Pagesの存在を今まで知りませんでした。今回の学習を通してGithub Pagesの公開方法を学習しました。そんな初心者でも簡単にサイトを公開する事ができる便利な機能を紹介していこうと思います!!
今回は、個人でVScodeでコーディングしたサイトをGithub Pagesを使って公開する方法を紹介します。
GitHubアカウントは既に登録済みを想定しています。
GitHub Pagesとは??
GitHubから提供されている、静的サイトのホスティングサービスのことを言います。
静的サイトとは、ユーザー操作でページ内容が変わらないHTML.CSSなどでコーディングされたサイトのことです。
ユーザーの操作でページ内容が変化するサイトの公開はできません。
GitHubのアカウントを持っていれば無料で公開する事ができます。
GitHub Pagesの公開までの手順
- リモートリポジトリを作成
- リポジトリにファイルを追加
- サイトを公開する
こんな感じの手順で進めて行きます。
そんなに手数は多くないです。
それでは、実際に説明しながら進めて行きたいと思います。
1. リモートリポジトリを作成
① GitHubのリモートリポジトリを作成します。
Topページ右上の+
ボタンから、New Repository
を選択します。
② リポジトリ名を入力して、Publicでリポジトリを作成します。
※ 無料アカウントだとPublicアカウントしか公開できません。
リポジトリ名は基本的になんでも大丈夫ですが、ここで設定したリポジトリ名によってこの後に公開するWebページのURLが変わります。
「アカウント名.github.io」とした場合
公開URLは、https://アカウント名.github.io
となります。
「それ以外の場合」
公開URLは、https://アカウント名.github.io/リポジトリ名
となります。
今回はリポジトリ名をgithubpages_test
として作成して行きたいと思います。
リポジトリ名を入力して、Publicを選択してCreate repositoryを押して新しいリポジトリを作成する。
ローカルリポジトリからプッシュしてファイルを追加する
ターミナルで
$ git init
$ git add .
$ git commit -m "githubpages_test"
$ git remote add origin git@github.com:kuuuuumiiiii/githubpages_test.git
$ git branch -M main
$ git push -u origin main
とコマンド操作してリモートリポジトリにローカルリポジトリのファイルをプッシュします。
こんな感じでプッシュできました。
GitHub Pagesでサイトを公開する
いよいよGitHub Pagesでサイトの公開をしていきます。
右上にあるSettings
を押したら左側のPages
を選択する。
そうすると次のような画面になるのですが、Branchの部分がNone
になっているのでmain
に変更してSaveをする。
これで設定は完了です。
GitHub Pagesの部分にURLが発行されます。
このURLの発行には時間がかかる場合があります。
GitHub Pagesの部分に表示されたURLでWebサイトを表示することができるようになりました!
思わぬ落とし穴
GitHub Pagesの設定が完了したので、いざURLに飛んでみようと思ったら...
エラー!?
なんでかなと思ったらファイルの指定がされていませんでした。
GitHub Pagesで表示されているURLは
rootの直下にあるindex.htmlはそのままでも表示できるみたいです。
今回は下記のようなURLが生成されました。
https://kuuuuumiiiii.github.io/githubpages_test/
今回私が作成したファイルは
上記のような構成になっています。
なので次のようなURLにて表示する事が可能でした。
https://kuuuuumiiiii.github.io/githubpages_test/pages_test/index.html
自動生成されたhttps://kuuuuumiiiii.github.io/githubpages_test/
をrootとしたパスを指定する事で表示できるようになります。
無事表示することができました。(よかった。。。)
最後に
今回はGitHub Pagesを使ってWebサイトを公開する方法をまとめてみました。
個人でやる時とチームでやる時とではまた違うようなのでそのあたりはまた学習していきたいと思います。
最後までご覧いただきありがとうございました。