AIツクリラボ

Next.js(App Router)で個人ブログを作る完全ガイド

AIツクリラボは、Next.js(App Router)で構築しています。始める前の経験はWordPressで記事を書いたことがある程度で、Next.jsもApp Routerも今回が初めてでした。このページでは、その状態からブログを作り、今も運用を続けるまでの流れを一本の道筋として整理します。個々の実装の詳細は、各見出しからリンクしている記事にまとめているので、気になった部分から読み進めてください。

全体像と前提

作ったのはこのブログ自体です。データベースやCMSの管理画面は使わず、記事をfrontmatter付きのMarkdownファイルとしてリポジトリに直接置き、Next.jsのApp Routerでビルド時に静的なHTMLへ変換しています。カテゴリーは「AIツール」「レンタルサーバー・VPS」「ノーコード・ローコード」「Next.js制作Tips」の4つで、このNext.js制作Tipsカテゴリーには、この文章を書いている時点で8本の記事が公開されています(執筆・公開準備中のものを含めると10本)。

もともとの経験はWordPressで記事を書いたことがある程度で、Next.jsもReactのサーバーコンポーネントも初めて触りながら組み立てました。CMSに慣れていたはずなのに、なぜあえてコードで作るNext.jsを選んだのかという一番手前の判断は、Next.jsとWordPress、ブログを作るならどっちがいい?にまとめています。

技術選定の理由

技術選定は、大きく3段階で決めています。

1つ目は「Next.js自体を選ぶか」です。WordPressの管理画面から書ける手軽さより、コードで作る自由度と表示速度を優先したいという判断が先にありました。この比較はNext.jsとWordPress、ブログを作るならどっちがいい?の通りです。

2つ目は「App RouterかPages Routerか」です。今後の新機能がApp Router側に追加されていく方針であること、layout.tsxでヘッダー・フッターのような共通レイアウトをシンプルに書けることを理由に、App Routerを選びました。詳しい比較はNext.jsのApp RouterとPages Router、なぜApp Routerを選んだかで解説しています。

3つ目は「CMSを使うか、Markdownで管理するか」です。記事数がまだ少ない個人ブログの規模では、CMSの管理画面よりもGitでファイルごと管理するほうが、変更履歴が残り、実質的なバックアップも兼ねられると判断しました。この判断が、後述する記事管理の仕組み全体の土台になっています。

ディレクトリ構成

実際のディレクトリ構成は、主要な部分だけ抜き出すと次のようになっています。

src/
  app/
    blog/[slug]/page.tsx         # 記事詳細ページ
    blog/[slug]/opengraph-image.tsx
    category/[slug]/page.tsx     # カテゴリーページ(このページ)
    tags/[tag]/page.tsx
    sitemap.ts / robots.ts
    layout.tsx
  components/                     # UIコンポーネント
  lib/
    posts.ts                      # 記事の読み込み・公開判定
    categories.ts                 # カテゴリー本文の読み込み
    markdown.ts                   # Markdown→HTML変換
    site-config.ts                # サイト名・カテゴリー定義
  types/                          # frontmatterの型定義
content/
  posts/*.md                      # 記事本文
  categories/*.md                 # カテゴリーページの本文(このファイル)

app/配下のディレクトリ名がそのままURLになる、という規約は、Pages Routerのpages/ディレクトリとは感覚が異なりました。この違いはApp RouterとPages Routerの違いでも比較表として整理しています。

記事管理の仕組み

記事はすべてfrontmatter付きのMarkdownで管理していて、title・description・date・category・tagsが基本項目です。それ以外に、実際にどこまで確かめた記事かを示すexperienceLabel、アフィリエイトリンクの有無を示すhasAffiliate、構造化データ用のfaqなども任意で持たせています。

公開日を管理画面から設定するのではなく、dateに未来の日付を指定しておくだけで自動的に公開される「予約投稿」の仕組みも実装しています。CMSを使わない代わりに、frontmatterの日付だけで公開・非公開を切り替える具体的な実装はNext.jsブログに予約投稿機能を実装するにまとめています。

SEO実装

SEOまわりは、Next.jsのMetadata API・JSON-LD構造化データ・sitemap.tsによる自動生成・OGP画像の自動生成・記事同士の内部リンクという要素で構成しています。

タイトル・description・canonical URLをコードで管理する方法、ArticleとBreadcrumbListのJSON-LD、sitemap.ts/robots.tsによるサイトマップの自動生成はNext.jsブログを高速化する画像・フォント最適化Tipsにまとめています。

SNSシェア時の画像は記事ごとにnext/ogで自動生成していて、その実装はNext.jsでOGP画像を自動生成するで解説しています。

記事同士をどうつなげるかという内部リンクの設計方針はブログの内部リンク設計の考え方、検索エンジンへの登録とアクセス解析の導入手順はNext.jsブログにGoogle Search Console・Analyticsを導入する手順にまとめています。

デプロイと運用

ホスティングはVercelを使い、記事ページはgenerateStaticParamsでビルド時にすべて静的HTMLとして生成しています。公開後に内容が頻繁に変わらないアフィリエイトブログの性質上、静的生成を第一選択にするという考え方はNext.jsブログを高速化する画像・フォント最適化Tipsの通りです。

運用面ではrevalidate = 3600という設定で、1時間おきにページを再検証させています。これにより、予約投稿の記事が公開日を迎えたときも、手動で再デプロイしなくても自動的に反映されます。記事を追加・更新する作業は、Markdownファイルを編集してGitにpushするだけで完結していて、CMSの管理画面を開く工程はありません。

つまずいたところ一覧

実装しながら実際につまずいた点を、記事へのリンクつきで一覧にしておきます。

記事数が少ないうちは気づきにくいものの、増えてから効いてくる工夫として、ブログの内部リンク設計の考え方もあわせて参考にしてください。

この分野の記事一覧

Next.js制作Tips

Next.jsブログのカテゴリーページを、ガイド本文つきのピラーページにする【Markdownで本文を置き、無ければ従来表示にフォールバック】

このブログのカテゴリーページは、記事カードを並べるだけの一覧から、冒頭にガイド本文と目次、FAQを持つページへ作り替えました。本文をcontent/categories/*.mdで管理する構成、本文が無いカテゴリーの扱い、配下記事のリンク漏れをビルド時に警告する仕組みをコード付きで解説します。

11分で読めます🔵 実装記録
Next.js制作Tips

Next.jsのRoute HandlerでRSSフィードを自作する【検索から外す記事と、SNSに流したい記事を別フィードにした理由】

このブログのRSSフィードは、外部ライブラリを使わず、Route Handlerで文字列を組み立てて出力しています。予約投稿が公開日を迎えたら自動で載る仕組み、noindexの記事を除外する判断、そして検索エンジン向けの設定とSNS拡散を別の関心事として分けるために作った2つ目のフィードを解説します。

12分で読めます🔵 実装記録
Next.js制作Tips

Next.jsのブログに構造化データ(JSON-LD)を実装する【純粋関数に集約して、XSS対策つきで埋め込む】

このブログは、記事・パンくず・FAQ・カテゴリーページなどにschema.orgの構造化データ(JSON-LD)を出力しています。生成ロジックを副作用のない関数にまとめた構成と、scriptタグに埋め込む際に「<」「>」「&」をエスケープする理由を、実際のコードで解説します。

10分で読めます🔵 実装記録
Next.js制作Tips

Markdown記事の画像をNext.jsの最適化配信にのせる【next/imageを使わずfigure化・サイズ自動取得】

このブログは記事をMarkdownからHTML文字列に変換して出すため、next/imageコンポーネントを直接使えません。それでも画像のリサイズ・WebP変換・レイアウトシフト防止を得るために作った、rehypeプラグインと、外部パッケージなしで画像サイズを読み取る関数をコード付きで解説します。

14分で読めます🔵 実装記録
Next.js制作Tips

Markdown変換にrehypeの自作プラグインを挟む【アフィリエイトのrel自動付与とh1のh2降格】

このブログの記事は生HTMLを直書きするため、アフィリエイトリンクのrel属性の付け忘れやh1の重複が起こりえます。それを変換時に機械的に防ぐ、rehypeの自作プラグイン2つと、rehype-rawを前段に置かないと動かない理由、プラグインを並べる順序の考え方をコード付きで解説します。

11分で読めます🔵 実装記録
Next.js制作Tips

スクロールで隠れるヘッダーと「トップに戻る」ボタンを実装する【CSSだけで作ろうとして直した話】

このブログのヘッダーは、下にスクロールすると隠れ、上にスクロールすると戻ります。右下の「トップに戻る」ボタンは、最初CSSのscroll-driven animationで作りましたが、表示されないページが出たためscrollイベント方式に作り直しました。両方の実装をコード付きで解説します。

11分で読めます🔵 実装記録
Next.js制作Tips

Markdown記事のコードブロックにコピーボタンを付ける【rehype-pretty-codeの生HTMLにDOM操作で後付け】

このブログのコードブロックは、シンタックスハイライト・言語ラベル・コピーボタン付きです。Markdownから変換された生HTMLにはReactのonClickを付けられないため、マウント後にDOMを走査してボタンを差し込んでいます。その仕組みとCSS、二重追加を防ぐ工夫をコード付きで解説します。

10分で読めます🔵 実装記録
Next.js制作Tips

Next.jsのブログに、今読んでいる見出しが光る追従目次を実装する【IntersectionObserverでスクロールスパイ】

このブログのPC表示では、記事の目次が右側に追従し、今読んでいる見出しがハイライトされます。Markdownから目次を作る部分、IntersectionObserverで現在位置を判定する部分、そして実装中に踏んだ「ページ遷移後に先頭まで戻らない」「サイドバーの文字が透ける」という2つの不具合をコード付きで解説します。

16分で読めます🔵 実装記録
Next.js制作Tips

Next.jsブログの関連記事を、カテゴリー・タグ・公開日のスコアで自動選出する【多様性より関連性を選んだ話】

このブログの記事末にある関連記事は、カテゴリー一致・共通タグ数・公開日の近さを足し合わせたスコアで自動選出しています。「別カテゴリーを最低1件混ぜる」ルールが関連性の薄い記事を押し込んでいた問題と、それを最低スコアの閾値で解決した経緯をコード付きで解説します。

21分で読めます🔵 実装記録
Next.js制作Tips

自宅PCで動くAI自動売買の結果を、Next.jsの静的サイトで公開する運用ダッシュボードの作り方

AI日本株自動売買の結果を公開している運用状況ページ(/results)は、自宅PCのPythonがJSONを書き出してgit pushし、Next.jsがそれを読んで表示する構成です。ライブラリを使わないSVGチャート、日経平均・TOPIXとの比較線、少ない母数を誇張しない表示の工夫をコード付きで解説します。

19分で読めます🔵 実装記録
Next.js制作Tips

Next.jsのサイドバーにGA4の実データで閲覧数ランキングを作る【認証情報をブラウザに出さない構成】

このブログのサイドバーにある「閲覧数ランキング」は、Google Analytics Data APIからサーバー側で実際のページビュー数を取得し、その順に並べています。認証情報をクライアントに渡さない構成と、実際に踏んだ2つの不具合(空の結果がキャッシュされ続ける・5件に満たない)をコード付きで解説します。

16分で読めます🔵 実装記録
Next.js制作Tips

Next.jsのHydrationエラー、本当の原因はSVGの<title>だった【誤診から特定までの記録】

運用状況ページに自作のSVGチャートを追加した直後、Hydrationエラーが出始めました。最初は別の箇所を疑って的外れな修正をしてしまい、切り分け直して特定した原因はチャート内のSVGの<title>要素でした。その経緯と切り分け手順をまとめます。

14分で読めます🔵 実装記録
Next.js制作Tips

Next.jsとWordPress、ブログを作るならどっちがいい?

アフィリエイトブログをNext.jsで作るかWordPressで作るか迷っている人向けに、それぞれのメリット・デメリットを実体験ベースで整理しました。運用コストや複数人での執筆のしやすさについても触れています。

9分で読めます🔵 実装記録