Hugoサイトのメンテナンス

Wed, 15 Jul 2026 11:24:16 +0900

記事を書くのには慣れてきたけれど、そうするとウェブサイトを構成するフォルダや書類の名前とかファイル構造とかが気になってくる（中身の外側、というか）。

そもそもVScode上でターミナルを起動できることにさっき気づいた……。アンタ（VScode）ってただのエディタじゃなかったんだね。ポテンシャルを生かせてなかったよ。なんかごめん。

というわけでちょっとおさらい、そして気になっていたことを修正（例によっていちいちGeminiに質問しつつ）。

まず、Hugoサイトの構成について復習

layoutsというフォルダは「ウェブサイトの見た目を定義する」もので中身は.htmlファイル。
archetypesというフォルダは「新しく作る記事の初期設定を決める」もので中身は.mdファイル。
hugo.tomlは、サイト全体を規定する一番重要な書類で、サイト名、URL、使用テーマ、メニュー、言語設定などをここで設定する（トップページの表示内容を[params]などとして供給することもあるが、見た目そのものを整形するのはlayouts内のindex.html）。
content > postsフォルダ内のMarkdown書類や画像が、自分でつくるサイトの中身。ちなみに、この「content」だけは単数形！　Hugoの内部システムで厳密に定義されているため、スペル変更はできない仕様なんだって。「情報やコンテンツという抽象概念（不可算名詞）の集まり」という意味でこの単語が採用されたとのこと。
themesは主に外観のきせかえパーツ。いろんな人がつくってくれているのをさしかえできる。この中身は更新されることがあるので触らない！　どこかカスタマイズしたいときはlayoutsフォルダにここから必要なHTML書類をコピーしてそれを変更する。
publicはHugoを起動すると自動で生成されるから触っても意味なし。ごちゃついてきたら捨ててもよい（すぐに新しいのができる）。

Hugoには「特定のフォルダ名を見て、自動でその役割を判断するルール（ディレクトリ構造の約束事）」があるとのこと。だから、こういう決まった書き方があるのだね。自分で勝手に直したりつくったりしちゃいけないんだな。あたりまえか。

Hugoのファイル構造の整理とアーキタイプ設定

ファイル構造の整理。フォルダ名postをpostsに。hugo.tomlのナビゲーションメニューのリンク名を直しただけだと、エラーに。個別記事内に、別記事へのリンクがはってあってそこにフォルダ名の指定があったのを忘れていた。
個別記事ページで、タグが記事より下に表示されていたのを、タイトル、日付の下に入れたい。theme > layoutsからコピーしたsingle.html内でタグの位置を修正。どこまでタグの指示に関することなのかがわかりにくいので難しかった。
新規記事作成は手動でMarkdown書類を作成していたけど、テンプレートを整えておけばよいのだった。TOML形式（+++区切り、キーと値を=で結ぶ）だったのをちょっと書き慣れてきたYAML形式（−−−区切り、キーと値を:で結ぶ）にして、今使っているフォーマットになるように。Archives用に年月を設定するのだけわからなかった。これでhugo new posts/20XX-XX-XX.mdと入力すればpostフォルダ内に新規記事が作成されるみたい。

ちょっと、なるほどと思ったのは、「数字」の扱い方。単に文字列とみなすこともできるけれど、数字にはいろいろ機能がある。「数」「値段」「気温」「日付（年月日）」「時間」「角度」「緯度経度」などいろんなことを表せる（今、あたりまえのことを言っています）。

コンピュータに数字を与えるとき、何も指定しないとただの記号で、ほかの文字と同じ扱いになってしまう。だから「これはいずれかのデータ（型）、固定の文字列ではなく、決まった動き方（増え方減り方、上限下限などの決まりがある）をするものだよ！」と指示しないいけないということだ。

指定するとなにが変わるかというと、それに従った法則で動くようになる。日付だよと指定すれば、「2026/16/35」とかにはならず、日付専用の動きをする。

……なんだか、なにもかもが、誰かが発明して、整理して運用して「普通のこと」にしてきたんだな。とても勉強になっている。

「今やった作業を他人に説明するときにはなんて言ったらいいのだろう」ということからして、疑問ばかりだ。言葉が合っているか、他人に伝わるか（相手のレベルにもよるし、自分がわかるかもあるし）、説明できるか。ひっかかりがちな性格のせいでなかなか進まないけど、おもしろくはある。

やったことをPushしようとしたらリポジトリにあるデータとちがうよ！とエラー。あれ……Pullしたはずなのになあ。

hint: Updates were rejected because the tip of your current branch is behind
hint: its remote counterpart. If you want to integrate the remote changes,
hint: use ‘git pull’ before pushing again.
hint: See the ‘Note about fast-forwards’ in ‘git push –help’ for details.

VScode on akios+ext

Hugoサイトのメンテナンス

まず、Hugoサイトの構成について復習

Hugoのファイル構造の整理とアーキタイプ設定