HugoでGoogle Search Consoleを設定する方法(所有権確認とサイトマップ登録)

【初心者向け・完全版】Hugo(PaperMod)× GitHub PagesにGoogle Search Consoleを導入する方法|所有権確認〜サイトマップ登録まで

🚀 はじめに:この記事でできること Hugo + PaperMod + GitHub Pagesで運用するブログに、Google Search Console(以下、Search Console) を導入するための完全ガイドです。 操作 → 目的 → 結果 → 注意/補足 の順で、初心者が迷いやすいポイント(URL構成・ユーザー/プロジェクトサイトの違い)も含めて整理します。 この手順を完了すると、所有権の確認が成功し、サイトマップ送信が完了、URL検査でクロール促進できる状態になります。 補足 この記事は HTMLファイルアップロード方式 で所有権確認を行い、サイトマップ登録・URL検査・運用の要点までを扱います。 🧭 前提:サイト種別とURL構成 本文着手前に、GitHub Pagesのサイト種別と公開URLを正しく把握します。これがSearch Consoleのプロパティ設定とbaseURL整合の土台になります。 操作 自サイトが ユーザーサイト か プロジェクトサイト かを確認する ユーザーサイト:https://username.github.io/ プロジェクトサイト:https://username.github.io/repository-name/ 目的 Search Console登録方式(URL プレフィックス)と、HugoのbaseURL/内部リンク/画像パス/OGPを公開URLに合わせて一貫させる。 前提 GitHub Pagesの公開設定が済んでいる(ユーザーサイト or プロジェクトサイト) 結果(この時点でできること) 以降の設定で、URL不一致による所有権確認失敗やサイトマップ404を回避できる。 注意 プロジェクトサイトは公開パスが/repository-name/ を含みます。Search ConsoleのURLプレフィックス、検証ファイルURL、サイトマップURLの末尾スラッシュとサブパスが一致しているか、常に確認しましょう。 補足:サイト種別の早見表 ユーザーサイト:https://username.github.io/(サブパスなし) プロジェクトサイト:https://username.github.io/repository-name/(サブパスあり) 🧩 前提条件の確認(Hugo設定) Search Console導入前に、Hugoの基本SEO設定(robots.txt と sitemap)を整えます。 操作 hugo.yaml(またはconfig.toml)に以下の設定を追加/確認 目的 robots.txt と sitemap.xml を自動生成し、クロールとインデックスの土台を作る。 前提 ...

🚀 Hugo + PaperMod + GitHub Pagesでブログ公開【初心者向け完全ステップガイド】

このガイドのゴール:Hugo + PaperMod を使ったブログを GitHub Pages に公開し、以降は記事を push するだけで自動更新できる状態にする。 ✅ 前提条件(必要な環境) Git と Hugo(Extended版) をインストール済み GitHubアカウントを保有 コマンドラインが使える(macOS/Linux/WSL いずれもOK) Extended版が必要な理由:PaperModなど一部テーマはSCSSのコンパイルにExtended版を使います。 🛠️ Hugoサイトの新規作成 hugo new site blog --format yaml # 新規Hugoサイト(設定ファイルをYAMLで作成) cd blog git init # Gitリポジトリを初期化 🎨 PaperModテーマの導入 最も簡単なのは Git Submodule でテーマを取り込む方法です。 git submodule add --depth=1 https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod hugo.yaml にテーマを指定します: theme: ["PaperMod"] 注意:GitHub Actions でビルドする際は actions/checkout の submodules: true を必ず設定してください(後述)。 代替案:Hugo Modulesでテーマを管理する方法もあります(hugo mod init → module.importsにPaperModを指定)。慣れるまではSubmoduleが分かりやすいです。 📝 Hugoの基本設定(hugo.yaml) 最低限の設定例を示します。後から拡張できます。 baseURL: "https://username.github.io/blog/" # 後で必ず自分の公開URLに合わせて変更 languageCode: "ja-jp" title: "My Hugo Blog" theme: ["PaperMod"] paginate: 10 outputs: home: ["HTML", "RSS", "JSON"] params: defaultTheme: "auto" # ダーク/ライト切替 ShowShareButtons: true ShowReadingTime: true ShowCodeCopyButtons: true showtoc: true # 記事内目次 images: ["images/og-image.png"] # OGP用 author: "HNEST" menu: main: - identifier: archives name: Archives url: /archives/ weight: 10 - identifier: tags name: Tags url: /tags/ weight: 20 ✍ 初回記事の作成とローカル確認 記事を作成します: ...