Private RepositoryのObsidian VaultをHugo Moduleとして読み込みサイトをビルドする

Obsidian VaultにHugoのContentフォルダを指定する を発展させ、Private RepositoryのObsidian VaultをHugo Moduleとして読み込みサイトをビルドする。

今日(2025/08/24)時点の全体像は下図のとおり。

Obsidian Hugoのシステム概要図

GitHub

リポジトリ 公開範囲 説明
vault-content private Obsidian VaultかつHugoのコンテンツのためのリポジトリ。
gohugo-data private Hugo dataのためのリポジトリ。
gohugo-theme public Hugo themeのためのリポジトリ。
gohugo-site public Hugoプロジェクト。Hugo Modulesで、vault-content, gohugo-data, gohugo-themeを読み込む。

メリット

  • Obsidian vaultをHugoのメインプロジェクトから分離することで、Privateリポジトリに変更できる。
    • 必要に応じて特定フォルダはHugoでも非公開にできる。

デメリット

  • Hugo ModulesでContent, Theme, Dataを別々にリポジトリ管理することになるため、管理が煩雑になる。
    • 特に、リポジトリを跨いでPrivateリポジトリからHugo Modulesを取得しないといけないので、GitHub Personal Access Token(PAT)の管理が必要。