Hugo テーマ “Docsy” の Bootstrap 5 対応

投稿 685文字

Hugo Docsy

kubernetes.io などのオープンソース系技術サイトでよく用いられ、GitHub では Google のレポジトリにホストされていて安心感のある Docsy テーマですが、2022/11/02現在は Bootstrap 4 系でテーマが開発されています。

かたや、Bootstrap の最新メジャーバージョンである Bootstrap 5 は 2021年5月にリリースされていますので、そこそこの時間が経過しているように感じますね。とはいえ Bootstrap をアップデートしたところで劇的な変化はないため、安定重視で現行バージョンのまま利用するでも実害ないのでしょう。

私は Docsy テーマにその他独自のテーマを組み合わせて利用しているため、実質2つのテーマを同時に利用している状況で、片方を Bootstrap 5 にあげたい都合が生じたので、 Docsy の Bootstrap 5 対応の計画を調べてみました。

Bootstrap 5 への対応状況

Issue は 2021年3月の時点から Open になっているようです。直後は Hugo に起因すると思われる SCSS 関連のエラー等もあったようですが、この夏頃から進展があるようです。

Upgrade to Bootstrap 5.2 揃 Issue #470 揃 google/docsy

参照サイト

Upgrade to Bootstrap 5.2 揃 Issue #470 揃 google/docsy

Bootstrap 5 has some changes that seem to break Docsy site builds #304 #464. (Edit: @chalin) Info: the last BSv4 build A link to the last …

By github.com

対応時期は 2023年1月の Bootstrap 4 の EOL (Eod of Life) を目掛けて準備を勧めているようです。

  • v4 critical support ends: 2022/11
  • v4 EOL: 2023/01

Bootstrap

参照サイト

Bootstrap

Check end-of-life, release policy and support schedule for Bootstrap.

By endoflife.date

このサイト、様々なソフトウェアの EOL がリストアップされていてとても便利ですね。

Docsy に採用されるバージョン

8月のコミットですが、 Bootstrap のバージョンは 5.2 で検証が進んでいました。

"dependencies": {
    "@fortawesome/fontawesome-free": "6.1.2",
    "bootstrap": "5.2.0"
},

ここまでくるともう目前ですので、リリースされるであろう 22Q4 マイルストーンの動向をチェックしながら、楽しみに待ちたいと思います。

22Q4 Milestone 揃 google/docsy

参照サイト

22Q4 Milestone 揃 google/docsy

A set of Hugo doc templates for launching open source content. - 22Q4 Milestone 揃 google/docsy

By github.com