概要

参考: 公式HELP

  • github pagesは、ユーザー・組織・プロジェクトのいずれかに紐づく
  • ユーザー・組織のページを作るには、<name>.github.ioという名前のレポジトリを作る
  • ユーザー・組織のURLは、<name>.github.io
  • プロジェクトのURLは、<owner>.github.io/<repository>
  • ユーザー・組織ページのソースは、レポジトリ内のデフォルトブランチのルート/。 ただし、以下に設定変更可能。ブランチは任意のものを指定可能。ルートディレクトリは、/か/docsを選択可能
  • プロジェクトページのソースは、gh-pagesのルート/

Jekyllについて

参考: 公式

以下の設定は変更できない(github pages上では)

lsi: false
safe: true
source: [your repo's top level directory]
incremental: false
highlighter: rouge
gist:
  noscript: false
kramdown:
  math_engine: mathjax
  syntax_highlighter: rouge

Jekyllはデフォルトでは以下を無視する

  • /node_modules, /vendor
  • _, ., #で始まるファイル/フォルダ
  • ~で終わるファイル/フォルダ
  • 設定でexcludedされているもの

逆に、これらを対象にしたい場合にはincludeを設定する。

todo

プロジェクトサイト

hotoku/blogレポジトリをgithubに作成し、gh-pagesブランチ以下にjekyllのソースを配置。 hotoku.github.io/blogにトップページは正しく表示された。一方で、jekyllの作成するリンクが hotoku.github.io/2020/09/28/github-pages.htmlになってしまい、リンクをたどると404エラー。 本来はhotoku.github.io/blog/2020/09/28/github-pages.htmlへのリンクを作成するべき。

▶ 解決: _config.ymlにbaseurlという設定があった。

CSS他

  • CSS
  • タイトル
  • フッター
  • SNS