Hugo - PaperMod が GitHub Pages で CSS スタイルを構築していない問題の解決

はじめに

#

最近 WordPress から Hugo に移行したので、PaperMod というテーマを気になってサイトのテーマとして選びました。

しかし、ローカルでは正常に工作しているのに、GitHub Pages にアップロードしたらページのスタイルが潰されました。

baseURL も正常に設定されているので、一時的に原因が分からなくなりました。その時、開発ツールでサイトをチェックした後、このエラーコードが発見しました。

解決策

#

一言で言えばサブリソース完全性検証に通らなかったです。

コンフィグファイルで検証機能を無効化して解決する策もあるが、サイトの安全性が下げる恐れがあります。

完全に Wiki に書いた方法で構築したのに、なぜこんな問題が起こされたのかが気になっています。

そして色々のことを調べたら、この解決策を見つけました。

The best solution I have found so far, If you are building your Hugo site on Windows, in your .github.io GitHub Pages repository, add a .gitattributes file that requests CSS files be checked out with CR/LF line endings with the line *.css text eol=crlf e.g.

Source: Failed to find a valid digest in the integrity attribute #114

まさかに改行コードの問題でしだ。

この解決策によって、.gitattributes ファイルを作成し、 *.css text eol=crlf を中に書きます。

そしてファイルを再アップロードして、改行コードを CRLF に変更すれば解決できます。

サイトが正常に戻りました。