GitHub Pagesでの静的ファイルのホスティングの確認

[ftnext]

解決したい問題

• _static/css 下のCSSが当たらない
• _images 下の画像が見つからない

[ftnext]

解決策

GitHub Pagesで公開しているディレクトリ（このリポジトリではdocs）の下に .nojekyll という空ファイルを置く

ref: https://stackoverflow.com/a/39691475
ref2: https://github.blog/2009-12-29-bypassing-jekyll-on-github-pages/

.nojekyll を置かずにGitHub Pagesをデプロイしたところ、docsの下の_staticや_imagesが404となった。

• https://ftnext.github.io/2021_slides/_static/css/common.css
• https://ftnext.github.io/2021_slides/_images/202102django_girls_tutorial_ja_top.png
  この状態でdocsの下に .nojekyll を置いたが、有効になるのに時間がかかった（キャッシュのようなものがある？）

[ftnext]

まとまったQiita
https://qiita.com/tutuz/items/88a32d94d700b33dc3ea#github-pages-%E3%81%A8%E3%81%AE%E9%80%A3%E6%90%BA

https://d-tsuji.github.io/sphinx-sample/ の裏にある https://github.com/d-tsuji/sphinx-sample/tree/master/docs はディレクトリ配置の参考になる

sphinx.ext.githubpages を試したい（現状buildディレクトリとdocsディレクトリが食い違っているのが問題か）
https://www.sphinx-doc.org/ja/master/usage/extensions/githubpages.html

[ftnext]

make revealjs した後のリリース手順

後々自動化するためのメモ

HTMLの配置

$ mkdir docs/rakus_Feb_oss
$ cp build/revealjs/rakus_Feb_oss/not_only_code_but_various_contributions.html docs/rakus_Feb_oss/

HTMLの中を置換

_static/revealjs4 -> reveal.js

buildの下とdocsの下とでreveal.jsのあるディレクトリが違うため

画像の配置

_images の下に移動

$ mkdir docs/_images
$ cp build/revealjs/_images/202102django_girls_tutorial_ja_top.png docs/_images/

静的ファイルの配置

_static/css に移動

$ mkdir -p docs/_static/css
$ cp build/revealjs/_static/css/common.css docs/_static/css/

この後に以下のコマンドを実行
#1 (comment)