2024-09-15

Deploy this branch to GitHub Pages

Settings > Pages > Branch を main, /(root) からホスティングというふうにしてみた

.md 以外のファイルは?

https://noriyotcp.github.io/til/TypeScript/fields.ts にアクセスしたらファイルをダウンロードしてしまった
ホスティングしてるからそりゃそうなのかもしれないがあんま良くない /docs からホストするようにしたけど上記現象は変わらない。一旦 Unpublish にしたけどそれでもダウンロードしちゃうなあ。でも仕方ないのかな?
将来的に別の SSG に乗り換える時のことを考慮すると、公開したいものは /docs にまとめておいたほうがいいのかもしれないなあ

というわけで一旦公開停止してやり直し

/docs に設定してやり直し

やり直してデプロイまで完了したのだがサイトが見つからない。しばらく待ってもダメだったので Actions から最後のワークフローをもう一度実行してみる
なんかよくわからないがキューに入ったまますぐに action が動かないなあ…

Cancel run するが Failed to cancel workflow になるなあ

うーん

docs/test.md に手を加えてもう一度プッシュするとワークフローが走りだし、無事デプロイが完了したがサイトが公開されないな

docs/index.html

GitHub Pages はこれを見にいくので docs にこれがあれば良さそう

README.mdの内容が表示されています。(厳密には、README.mdから生成されたindex.html)

https://qiita.com/c3drive/items/f9b4d9497c588049d65c#%E4%BD%BF%E3%81%84%E6%96%B9

最初 /(root) からホスティングした時にはそのことは確認済み

ln -s README.md docs/README.md

root の README から docs/README.md へ向けて symlink を貼る
そいつもコミットする

error

/usr/local/bundle/gems/pathutil-0.16.2/lib/pathutil.rb:292:in `in_path?': Too many levels of symbolic links @ rb_check_realpath_internal - /github/workspace/docs/README.md (Errno::ELOOP)

うーん、too many level of symbolic links ですと?

docs/README.md

docs/index.html はもう消した。/README.mddocs/README.md にコピーしてプッシュ。しかしページは真っ白なまま(反映されるのが遅かったかもしれない)
docs/README.md のほうを修正してプッシュすると反映された

この記事を見ると /README.md/docs/README.md の両方がある場合、前者のほうをデフォルトとして扱う、と書いてあるが自分の場合後者のほうだなあ?

https://tomcam.github.io/least-github-pages/github-pages-create-readme.html

.md ファイルを docs/ 配下へ

公開したいファイルだけ docs/ へ移動させた
これらを生成したりまとめたりするスクリプトがあるのだが、それらはそっちへ移動したくない
だが実行した時に /docs にファイルが作成されるようにもしたい

docs/ 配下のファイルが変更されたときだけデプロイしたい

GitHub actions をカスタムするしかないかなあ

https://docs.github.com/ja/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site#%E3%82%AB%E3%82%B9%E3%82%BF%E3%83%A0-github-actions-%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BC%E3%81%AB%E3%82%88%E3%82%8B%E5%85%AC%E9%96%8B

TODO

  • docs/ 配下のファイルが変更されたときだけデプロイしたい
  • docs/_config.yml の方は不要か?
  • file の作成日時と最終変更日時の取り出し
    • frontmatter の date に使う
    • 合わせてfrontmatter を挿入するためのスクリプト書く
    • template.sh も見直し
    • tasklist のスタイリングについて。なぜかドラフトに戻されちゃってるけど
      • https://github.com/pages-themes/hacker/pull/83/files