<h2 id="h8a175a9b0e">前提</h2><h3 id="h466509ec71">やること</h3><p>このブログのコア部分のみつくります。<br>具体的には記事の取得、全文検索、目次の自動作成、シンタックスハイライトの導入など。</p><h3 id="he010dcdcb1">やらないこと</h3><p>microCMSやNext.jsの細かい解説<br>ESLintやPrettierの導入など<br>PWAやダークモード対応、ローディング時のプログレスバーの導入（これらは別記事で紹介しています。）</p><h2 id="h41d9282cc6">主な使用技術</h2><ul><li>TypeScript</li><li>Next.js</li><li>Tailwind CSS</li><li>microCMS</li></ul><p>その他のライブラリ等</p><ul><li>highlight.js</li><li>cheerio</li></ul><p><br></p><h2 id="h0ef859a5d4">環境構築</h2><p>microCMSは、アカウント作成、ログイン、サービス作成まで済ませておいてください。<br><br>以降はフロント側の構築に入ります。<br>各自、Next.js、TypeScript、Tailwind CSSの環境を準備してください。<br>特にコードは変更しなくて大丈夫です。<br><br>microcms-js-sdkをインストール</p><pre><code>npm i microcms-js-sdk</code></pre><p><br>/.env.localを作成し、サービスドメインとAPIキーを設定します。（サービスドメインは環境変数にしなくても良かったかも）</p><pre><code>SERVICE_DOMAIN=xxxx
API_KEY=zzzz</code></pre><p>/src/libs/client.tsを作成し、クライアントのインスタンスを作成します。</p><pre><code>import { createClient } from "microcms-js-sdk";

export const client = createClient({
&nbsp; serviceDomain: process.env.SERVICE_DOMAIN,
&nbsp; apiKey: process.env.API_KEY,
})</code></pre><p><br>これでデータ取得の準備は完了です。<br>後のシンタックスハイライト導入のために、highlight.jsというライブラリをインストールします。</p><pre><code>npm i highlight.js</code></pre><p><br>後の目次自動作成のためにcheerioというライブラリをインストールします。</p><pre><code>npm i cheerio</code></pre><p>以上で環境構築は終了です。<br><br></p><h2 id="h26fd63e0da">実装編</h2><h3 id="hdc5f1fe0e6">microCMSでAPI実装</h3><p>GUIでAPIの定義をしていきます。<br>（）内はエンドポイントです。</p><ul><li>カテゴリー（category）</li><li>タグ（tags）</li><li>著者（author）</li><li>ブログ（articles）</li><li>人気の記事（popular-articles）</li></ul><p>ユニーク設定や必須設定はなるべくオンにしたほうが、フロント実装時にエラーハンドリングの処理が減って楽になると思うので適宜調整してください。<br><br>以下（）内はフィールドの種類です。</p><h4 id="hf639be3538">カテゴリー &amp; タグ</h4><p>name（テキストフィールド）<br></p><h4 id="hf01389028b">著者</h4><p>name（テキストフィールド）<br></p><h4 id="h6cfaa47bdb">ブログ</h4><p>title（テキストフィールド）<br>description（テキストエリア）<br>slug（テキストフィールド）<br>body（リッチエディタ）<br>tags（複数コンテンツ参照 - タグ）<br></p><h4 id="hff0683e746">人気の記事</h4><p>articles（複数コンテンツ参照 - ブログ）<br><br>以上で最低限のAPIスキーマの実装は完了です。<br>作成、更新日時や公開、非公開フラグはデフォルトであるので、そこは意識しなくて大丈夫です。<br></p><h3 id="hace76aa732">フロントエンド実装</h3><p>ブログの取得、目次の自動作成、全文検索機能の実装をします。</p><h4 id="h6f57dedeb2">作成したブログの取得</h4><p>SDKとgetStaticPropsを使用して取得します。<br>/src/pages/blog/index.tsxでブログ一覧の取得（ISR）</p><pre><code>import type { GetStaticProps, NextPage } from "next";
import { client } from "../libs/client/client";
type Blog = {
&nbsp; title: string;
&nbsp; description: string;
&nbsp; image: {
&nbsp; &nbsp; url: string;
&nbsp; };
&nbsp; body: string;
&nbsp; category: {name: string};
&nbsp; tags: { name: string }[];
&nbsp; createdAt: string;
};

export const getStaticProps: GetStaticProps = async () =&gt; {
&nbsp; const blogs: Blogs = await client.get({ endpoint: "blogs" });
&nbsp; return {
&nbsp; &nbsp; props: {
&nbsp; &nbsp; &nbsp; blogs: blogs,
&nbsp; &nbsp; },
&nbsp; &nbsp; revalidate: 60 * 60,
&nbsp; };
};

type Props = {
&nbsp; blogs: Blogs;
};
const Index: NextPage&lt;Props&gt; = (props) =&gt; {
&nbsp; return (
 &nbsp; &nbsp; &lt;div&gt;
&nbsp; &nbsp; &nbsp; &nbsp; &lt;ul&gt;
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; {props.blogs.contents.map((blog, index) =&gt; {
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; return (
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &lt;li key={index}&gt;
                      &lt;Link href={`/blog/${blog.slug}`}&gt;
                         &lt;a&gt;
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;     {blog.title}
                         &lt;/a&gt;
                      &lt;/Link&gt;
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &lt;/li&gt;
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; );
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; })}
&nbsp; &nbsp; &nbsp; &nbsp; &lt;/ul&gt;
&nbsp; &nbsp; &nbsp; &lt;/div&gt;
&nbsp; );
};

export default Index;</code></pre><p>/src/pages/blog/[slug].tsx</p><pre><code>import "highlight.js/styles/hybrid.css";


import cheerio from "cheerio";
import hljs from "highlight.js";
import type { GetStaticPaths, GetStaticProps, NextPage } from "next";
import { TableOfContents } from "src/components/blogs/TableOfContents";
import { Tag } from "src/components/blogs/Tag";
import { ClockSvg } from "src/components/icons/svgs/ClockSvg";
import { FolderOpenSvg } from "src/components/icons/svgs/FolderOpenSvg";
import { Layout } from "src/components/layouts/Layout";
import { Headline1 } from "src/components/utils/Headline1";
import { client } from "src/libs/client/client";
import { fixDateFormat } from "src/libs/fixDateFormat";
import type { Blog, Blogs } from "src/types/types";

export const getStaticPaths: GetStaticPaths = async () =&gt; {
&nbsp; const blogs: Blogs = await client.get({ endpoint: "blogs" });

&nbsp; const paths = blogs.contents.map((blog) =&gt; {
&nbsp; &nbsp; return `/blog/${blog.slug}`;
&nbsp; });

&nbsp; return { paths: paths, fallback: false };
};


export const getStaticProps: GetStaticProps = async (context) =&gt; {
&nbsp; const blogs: Blogs = await client.get({ endpoint: "blogs" });
&nbsp; const blogDetail = blogs.contents.filter((blog) =&gt; {
&nbsp; &nbsp; return blog.slug === context.params?.slug;
&nbsp; });


&nbsp; // 見出しの作成
&nbsp; const $ = cheerio.load(blogDetail[0].body);
&nbsp; const headings = $("h2").toArray();
&nbsp; const tableOfContents = headings.map((data: any) =&gt; {
&nbsp; &nbsp; return {
&nbsp; &nbsp; &nbsp; text: data.children[0].data,
&nbsp; &nbsp; &nbsp; id: data.attribs.id,
&nbsp; &nbsp; &nbsp; level: data.name,
&nbsp; &nbsp; };
&nbsp; });

&nbsp; return {
&nbsp; &nbsp; props: { blogDetail: blogDetail[0], tableOfContents: tableOfContents, parsedHtml: $.html() },
&nbsp; };
};
type Props = {
&nbsp; blogDetail: Blog;
&nbsp; tableOfContents: any;
&nbsp; parsedHtml: any;
};
const BlogDetailPage: NextPage&lt;Props&gt; = (props) =&gt; {
&nbsp; return (

&nbsp; &nbsp; &nbsp; &lt;div&gt;
&nbsp; &nbsp; &nbsp; &nbsp; {/* タイトル */}
&nbsp; &nbsp; &nbsp; &nbsp; &lt;h1&gt;{props.blogDetail.title}&lt;h1/&gt;
&nbsp; &nbsp; &nbsp; &nbsp; {/* サムネイル */}
&nbsp; &nbsp; &nbsp; &nbsp; &lt;img
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; src={props.blogDetail.image.url}
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; alt=""
&nbsp; &nbsp; &nbsp; &nbsp; /&gt;
&nbsp; &nbsp; &nbsp; &nbsp; {/* カテゴリー */}
&nbsp; &nbsp; &nbsp; &nbsp; &lt;p&gt;
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; {props.blogDetail.category.name}
&nbsp; &nbsp; &nbsp; &nbsp; &lt;/p&gt;
&nbsp; &nbsp; &nbsp; &nbsp; {/* タグ */}
&nbsp; &nbsp; &nbsp; &nbsp; &lt;ul&gt;
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; {props.blogDetail.tags.map((tag, index) =&gt; {
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; return (
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &lt;li key={index}&gt;
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;{tag.name}
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &lt;/li&gt;
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; );
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; })}
&nbsp; &nbsp; &nbsp; &nbsp; &lt;/ul&gt;
&nbsp; &nbsp; &nbsp; &nbsp; {/* 作成日時 */}
&nbsp; &nbsp; &nbsp; &nbsp; &lt;p className="flex items-center text-gray-500"&gt;
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &lt;ClockSvg className="block w-4 h-4" /&gt;
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &lt;span className="block"&gt;{fixDateFormat(props.blogDetail.createdAt)}&lt;/span&gt;
&nbsp; &nbsp; &nbsp; &nbsp; &lt;/p&gt;
&nbsp; &nbsp; &nbsp; &nbsp; {/* 目次 */}
&nbsp; &nbsp; &nbsp; &nbsp; &lt;div&gt;
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &lt;p className="py-4 font-bold"&gt;{props.blogDetail.description}&lt;/p&gt;
&nbsp; &nbsp; &nbsp; &nbsp; &lt;/div&gt;
&nbsp; &nbsp; &nbsp; &nbsp; &lt;div&gt;
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &lt;h3 className="py-4 font-bold text-center"&gt;目次&lt;/h3&gt;
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &lt;TableOfContents tableOfContents={props.tableOfContents} /&gt;
&nbsp; &nbsp; &nbsp; &nbsp; &lt;/div&gt;
&nbsp; &nbsp; &nbsp; &nbsp; &lt;article
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; className="pt-4"
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; // eslint-disable-next-line @typescript-eslint/naming-convention
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; dangerouslySetInnerHTML={{ __html: props.parsedHtml }}
&nbsp; &nbsp; &nbsp; &nbsp; &gt;&lt;/article&gt;
&nbsp; &nbsp; &nbsp; &lt;/div&gt;

&nbsp; );
};
export default BlogDetailPage;


</code></pre><p><br></p><h4 id="hf270234485">目次の自動作成</h4><p>cheerioというライブラリを使用します。<br>htmlを読み込ませるとクラス名を付与したりしてくれるので、その結果を表示させています。<br></p><h4 id="h098b876b84">検索機能の追加</h4><p>microCMSが全文検索APIも提供しているので、そちらを利用します。<br>やることは簡単で、クエリパラメーターにキーワードを付与するだけで実装できます。<br></p><h4 id="h24f39ed847">シンタックスハイライトの導入</h4><p>highlight.jsを使用します。<br>こちらもcheerioを応用して、クラス名を付与したりして装飾しています。<br>↓サンプルコード</p><pre><code>  // シンタックスハイライトの導入
	  $("pre").each((_, element) =&gt; {
	    $(element).addClass("hljs block bg-gray-600 rounded-sm overflow-x-auto");
	  });
	  $("pre code").each((_, element) =&gt; {
	    const result = hljs.highlightAuto($(element).text());
	    $(element).html(result.value);
	    $(element).addClass("p-2 block");
	  });</code></pre><p><br></p><h2 id="ha214098e44">まとめ</h2><p>かなりざっくりで申し訳ないですが、以上がNext.jsとmicroCMSでブログサイトを構築する手順になります！<br>SDKもとても便利で、爆速でブログの最低限の機能を実装できました。<br><a href="https://twitter.com/mayo1201blog" target="_blank" rel="noopener noreferrer">Twitter</a>などからDMいただければ質問には答えますので、お気軽にご質問ください！<br>実際に使っているコードも<a href="https://github.com/mayone-du/mayoblog" target="_blank" rel="noopener noreferrer">GitHub</a>で公開していますので、よかったらどうぞ😗</p>

Next.jsとmicroCMSでブログ開発をしたので、構築手順を記事にまとめました。全文検索機能や目次の自動作成、シンタックスハイライトの導入などをしています。

typescriptのタグが付く記事一覧

Next.jsとmicroCMSで作るブログ開発