善悪の彼岸

社会人5年目、ものづくりと哲学と研究が好き

【HP作成】GithubPagesを利用して無料でポートフォリオサイトを作成する【Jekyll】

HP作るぞ

  • 自分の制作物とか載せるためにHP作るぞ.

どんなHP?

  • 自分の作品とか掲載する普通のポートフォーリオサイト
  • 普通にCV,自己紹介,成果物,ブログのリンクとかとかてきとーに載せたい

プラットフォーム選定

  • Wordpressでもいいがサーバーレンタルに金がかかる模様
  • GithubPages
    • 無料で使える.
    • HP制作をGitで管理できる
    • データベースとかは使えない

結論:金かけたくないしとりあえずGithubPagesで作る

Github Pagesでホームページを作る

  • Github Pagesのサイト作成の流れは大体以下の感じ
    • GithubにHPを構成するファイルを配置するリポジトリを作成する
    • Jekyllを使ってテンプレートページをローカルに作成し,ローカルにコミットする
    • 最初に作ったリモートリポジトリにpushする
    • GithubActionが自動でHPをデプロイしてくれるので確認

Github上にリポジトリを作成する

 ローカルにプロジェクトを作成してgitの初期化をする

mkdir REPOSITORY-NAME
cd REPOSITORY-NAME
git init

Jekyllをインストールしてテンプレートページを作成する

  • Jekyllとはテンプレートをもとに静的ホームページをGithubPages上で作れる静的サイトジェネレータらしい.Rubyで動く
    • Markdownでもサイトを作れるとか

Gitをローカルにインストールする

Rubyをローカルにインストールする

Jekyllをローカルにインストールする

  • コマンドプロンプトで以下のコマンドを実行,bundlerをインストールする
    • gemとはRubyのパッケージのこと
    • bundlerとはgemを管理するためのツールで、bundler自体もgemの一種
gem install bundler
  • 続いてJekyllをインストールする
gem install jekyll
  • 下記コマンドでサイト用のテンプレートを生成する
jekyll new --skip-bundle
  • ここまでやるとフォルダの中身がこんな感じになるはず

テンプレ作成直後のフォルダ内
- 下記コマンドを実行し,ローカルでHPを実行

jekyll s 

ローカルでのHP実行

Jekyllの設定を行い,作ったホームページをGithubにデプロイする

gem "jekyll", "~> 4.3.2"
gem "github-pages",  "~> GITHUB-PAGES-VERSION", group: :jekyll_plugins
bundle install

-ディレクト内にある_config.ymlを編集する - これをやらないと正常にCSSが読み込まれずHPが崩れるので必ずやる

domain: my-site.github.io       # my-siteの部分を置き換え
url: https://my-site.github.io  # my-siteの部分を置き換え
baseurl: /REPOSITORY-NAME/      # REPOSITORY-NAMEの部分を作成したリポジトリの名前に変える
  • 作ったテンプレートをgit commitしてリモートリポジトリにpushする
git add .
git commit -m "ジキルを使ってHP作成!等"
#USERとREPOSITORYは作成したリポジトリ名とユーザー名に置き換え
git remote add origin https://github.com/USER/REPOSITORY.git
git push -u origin master

GitHub Pages側の設定を行い,作ったHPを確認する

  • 作ったリポジトリのSettings > Pages
  • SourceをDeploy from a branchにBranchを以下のように設定(デフォルトでなってるかも

GithubPagesの設定

  • 2,3分待ってVisit siteを押下すると作成したHPが見れる

gakutosasabe.github.io

まとめ

  • GithubPagesとJekyllを使ってテンプレートからポートフォリオサイトの雛形を作成できた
  • WordPressを使ってもいいけど,個人サイトならGithubPagesで十分な気がする

参考