ポートフォリオをNext.jsでリニューアルする

天久保今年もやります、茨城県つくば市の町域であるところの天久保とは無関係な任意団体「天久保」のアドベントカレンダーレギュレーション: 週休2日制休日含め乱入あり去年のアドカレはこちら https://adventar.org/calendars/8233adventar.org

天久保 Advent Calendar 2023 19 日目の記事。

はじめに

GitHub - omemoji/omemoji.com: omemoji's portfolioomemoji's portfolio. Contribute to omemoji/omemoji.com development by creating an account on GitHub.github.com

ポートフォリオを Next.js で書き直し、機能を改善することにした。

当サイト「創作物紹介」は自分のプロフィール、絵や markdown で書いた記事を公開するポートフォリオである。最初は Nuxt.js で実装していたが、エコシステム及び情報の充実度、フレームワークの人気など様々な理由から Next.js で実装し直したいと考えるようになった。また、このサイトはコンテンツの更新や保守についてはそれなりに快適だったものの、大小様々な問題点を残していた¹。そこで、「創作物紹介」を作成してからちょうど 1 年が経過したということもあり、これを良い機会としてポートフォリオをリニューアル・改善することにしたのだった。

使用した技術

Next.js (Ver. 13.4, SSG)
Tailwind CSS
TypeScript
Cloudflare Pages
GitHub Actions

Next.js は app router を使用しており、ライブラリの兼ね合いからバージョンを 13.4 に留めている²。ホスティングは Cloudflare Pages で行っている他、GitHub のプロフィールの更新時にデプロイが行われるように GitHub Actions を使用している³。

機能及び実装

作品を公開する

1.作品一覧

Artworks | 創作物紹介omemoji's artworksomemoji.com

Instagram や Pixiv などのレイアウトを参考にしている。ページネーションも実装し、 1 ページあたり 9 つの作品が表示されるようになっている。

2.個別作品ページ

レイアウトをすっきりさせるとともに、タグ機能を追加した。また、作品のデータは lib/data.ts 内の配列で管理している。これにより、

/images/artworks に作品の画像ファイルを追加する
lib/data.ts 内の配列に作品の情報を追加する

だけでビルド時に作品ページをまとめて生成することが出来る。

export type artData = {
  slug: string;
  src: string;
  title: string;
  tag: string[];
  href: string;
  description: string;
};
export const artworks: Array<artData> = [
  {
    slug: "ink_drop",
    src: "/images/artworks/ink_drop.png",
    title: "Ink drop",
    tag: ["Krita", "Zugadan"],
    href: "https://www.instagram.com/p/Cy86MEcvrdo/",
    description: "水中に垂らされていく、金魚の形を成した墨滴",
  },
  // 中略
];

画像最適化

「創作物紹介」では数多くの作品の画像を扱うため、画像最適化は特に重要である。 Next.js における画像最適化の方法としては next/image が有名であるが、 next/image で画像を最適化するためには Node.js サーバー上でサイトを動かすか外部の画像プロバイダーを使う必要がある（つまり、ビルド時に最適化された画像を生成するわけではない）。このポートフォリオはそれらを使わずに SSG で作成するため、 next/image の恩恵を受けられないということになる。

そこで、画像最適化ライブラリとして next-export-optimize-images を用いる。

GitHub - dc7290/next-export-optimize-images: Optimize images at build time with Next.js.Optimize images at build time with Next.js. Contribute to dc7290/next-export-optimize-images development by creating an account on GitHub.github.com

next-export-optimize-images を使うのは全く難しくない。いくつかの設定を行った後普通に next/image を使うだけで、ビルド時に最適化された画像を生成してくれるようになる。また、

画像処理に sharp を用いており、高速である
キャッシュによって無駄に同じ処理を繰り返さない実装になっている

といった特徴があるようだ。

Markdown の処理

GitHub - hashicorp/next-mdx-remote: Load MDX content from anywhereLoad MDX content from anywhere. Contribute to hashicorp/next-mdx-remote development by creating an account on GitHub.github.com

Next.js で Markdown を使って記事を書く場合は、 next-mdx-remote を使うのがおすすめである。 next-mdx-remote を使うことで、 fs や fetch で取得した markdown ファイルを JSX にコンパイル・変換することが出来る。また、コンパイル時にオプションをつけることで、

remark/rehype プラグインを適用する
文書内の特定箇所をカスタムコンポーネントに変換する

といったことも可能である。

markdown ファイルを JSX にコンパイルする際、next-mdx-remote を用いて compiler 関数を作成しておくと便利である。

import { compileMDX } from "next-mdx-remote/rsc";
import remarkGfm from "remark-gfm";
import remarkGemoji from "remark-gemoji";
import rehypeSlug from "rehype-slug";
import rehypeAutolinkHeadings from "rehype-autolink-headings";
import MDXComponent from "components/MDXComponent";
import rehypeRaw from "rehype-raw";
import remarkUnwrapImages from "remark-unwrap-images";
import rehypePrettyCode from "rehype-pretty-code";
import { remarkLinkCard, linkCardHandler } from "lib/remark-link-card";
import remarkMath from "remark-math";
import rehypeKatex from "rehype-katex";
const compiler = async (source: string) => {
  const result: Promise<{
    content: JSX.Element;
    frontmatter: {
      emoji: string;
      slug: string;
      title: string;
      date: string;
      description: string;
      tags: string[];
    };
  }> = compileMDX({
    source,
    components: MDXComponent,
    options: {
      mdxOptions: {
        remarkPlugins: [remarkGfm, remarkGemoji, remarkUnwrapImages, remarkLinkCard, remarkMath],
24 collapsed lines
        rehypePlugins: [
          [rehypePrettyCode, { theme: "monokai", grid: true }],
          rehypeSlug,
          [rehypeAutolinkHeadings, { behavior: "wrap" }],
          rehypeKatex,
          rehypeRaw,
        ],

        remarkRehypeOptions: {
          allowDangerousHtml: true,
          handlers: {
            linkCard: linkCardHandler,
          },
          footnoteLabel: "脚注",
        },
        format: "md",
      },
      parseFrontmatter: true,
    },
  });
  return result;
};

export default compiler;

Remark/Rehype プラグイン（一例）

GitHub Flavored Markdown を書けるようにするもの（remark-gfm）から Tex 記法で数式を書けるようにするもの（remark-math, rehype-katex）まで、様々なプラグインがある。

**GitHub Flavored Markdown (GFM)**

| ある   | なし   |
| ------ | ------ |
| ロック | ジャズ |
| 語録   | 名言   |
| 肉     | 魚     |
| 葉っぱ | 根っこ |

- [x] 朝ご飯
- [x] 昼ご飯
- [ ] 夜ご飯

**gemoji**

:v: :grin: :hand:

**数式**

$$
\frac{4}{\pi} = \sum_{i=0}^{\infty} \frac{(-1)^n (4n)!(1123+21460n)}{882^{2n+1}(4^{n}n!)^4}
$$

GitHub Flavored Markdown (GFM)

ある	なし
ロック	ジャズ
語録	名言
肉	魚
葉っぱ	根っこ

朝ご飯
昼ご飯
夜ご飯

gemoji

✌️ 😁 ✋

数式

\frac{4}{\pi} = \sum_{i=0}^{\infty} \frac{(-1)^n (4n)!(1123+21460n)}{882^{2n+1}(4^{n}n!)^4}

リンクカード

Zennなどで使われているカード形式のリンクを作れるようにした。例えば

https://www.google.com

というように単独でリンクを記述した場合、ビルド時に以下のようなカード状のリンクが生成される。 ⬇

Googlewww.google.com

リンクの検出やカスタムコンポーネントの書き方といった具体的な実装については、以下のサイトを参考にした。

自分のウェブサイトにブログカードを実装してみたzenn.dev

unified を使って Markdown を拡張するzenn.dev

Next.jsでブログをつくった | 点点公社自作ブログの実装についてwww.haxibami.net

メタデータの取得

ここでは、リンクカードの作成に必要な情報の取得について説明する。上のリンクカードを見てみると、

サイトのタイトル
サイトの説明
画像
URL

の 4 つの要素で構成されていることが分かる。これらの情報を取得するためには、サーバーサイドでリンク先の HTML からメタデータ（title や OGP 画像など）を取り出す処理を行えば良い。例えば、

fetchでリンク先の HTMl を取得し、そのレスポンスを文字列に変換する
変換した文字列をCheerioで読み込んでそれぞれのメタデータを取得する

といった方法がある。

OGP 画像の最適化・埋め込み

外部サイトから取得した画像のリンクをそのまま貼った場合、画像のサイズが大きすぎて読み込みに時間がかかる場合がある。そのため、取得した画像は base64 形式に変換・最適化した後 HTML に直接埋め込むようにしている。ここでは画像最適化に sharp を使っており、リサイズと webp フォーマットへの変換を行っている。実装は以下のサイトを参考にした。

A is for Astronaut | 点点公社Astroでサイトを書き直したwww.haxibami.net

デプロイ

Cloudflare Pages の無料プランでホスティングしている。以前は GitHub Pages を使っていたが、ドメインを Cloudflare で管理しているためホスティング全体を Cloudflare で完結させることにした。

以下のリンクに従って Cloudflare Pages と GitHub リポジトリを連携させることで、リポジトリの更新時に自動デプロイが可能となる。 GitHub Pages と比較すると、設定が楽⁴だったり商用利用が可能⁵といったメリットがある。

Git integrationConnect your Git provider to Pages.developers.cloudflare.com

リンクカードを実装する
markdown 内で特定のノードをカスタムコンポーネントに変換する
リモートの markdown ファイルを取得・処理する

などある程度複雑なことでもライブラリや実装例が探しやすく、作業を楽に進めることが出来た⁷。

改善点

目下の改善点として、

もう少しデザインを凝る
作品や記事ページの OGP 画像をいい感じに生成する
RSS 対応
記事の目次
閲覧者数の増加⁸

などに着手していきたい。

備考

以前の実装

Nuxt3+Tailwind CSSでギャラリー付きポートフォリオを作成するzenn.dev

Nuxt.js による実装はこちらを参照。

カスタムコンポーネント（このサイトにおいてはリンクカードや画像最適化用コンポーネントなど）を使うときにそのタグを markdown ファイル内に直接書かなければならない、ページネーションに一切対応していない、リンクカードの画像を最適化出来ないため転送量が増加してしまう、など ↩
主に next-export-optimize-images のせい ↩
https://raw.githubusercontent.com/omemoji/omemoji/main/README.md を next-mdx-remote で読み込むことで、 GitHub のプロフィールを「創作物紹介」のプロフィールに使い回せるようにしている ↩
GitHub Pages の場合、自動でデプロイするために GitHub Actions の workflow を書く必要がある ↩
今の所予定はない ↩
パフォーマンスについては以前からこのくらいの点数だったが、「おすすめの方法」の点数なども向上した ↩
恐らく Nuxt.js でも工夫すれば似たようなことは出来る ↩
これはサイト自体というよりコンテンツの充実度やコミュニケーション・広報の問題だと思われる ↩

創作物紹介