メインコンテンツへスキップ

ブログをWordPressからHugoへ移行した

·3111 文字·
やってみた HTML Markdown
komori-n
著者
komori-n
目次

背景
#

はてなブログからWordPress on AWSに変えてそろそろ3年。WordPressに移行したことで、 豊富なプラグインやテーマの恩恵を受けることができ、快適に文章を投稿できるようになった。

しかし、最近ではWordPressサーバーの保守に問題が生じてきていた。 ありがたいことにブログの閲覧者数は順調に増加しているのだが、AWSで借りている弱小サーバーでは力不足のようで、 アクセス数の増加に十分ではなかった。実際、最近ではアクセス数が急激に増加した際にサーバーが落ちてしまう事象が しばしは発生していた。

AWSで借りるサーバーのグレードを上げれば鯖落ち問題は回避できるのだが、WordPressサーバーの移行は意外と面倒だと判明した。 新しくサーバーを借りてWordPressを立ち上げ、データベースを丸ごとコピーし、ドメインを移行する必要がある。 旧サーバーではプラグインを多くインストールしていたため、サーバー移転には多くリスクがあると感じた。

そこで、これを機にAWSサーバーでホスティングするのではなく、GitHub Pagesで静的に配信する方式に切り替えることにした。

GitHub Pagesにサイトを構築するには、HTML/CSSを静的に生成するフレームワークが必要になる。 静的サイトを生成するフレームワークは多数存在するが、今回はHugoを用いて構築することにした。 HugoはGoで作られた最近人気が高まっている静的サイトジェネレータである。 Hugoはシンプルながらカスタマイズが容易なフレームワークであり、 Hugoテーマがとても充実している。加えて、 Markdownベースのジェネレータなので、他のフレームワークへの乗り換えも容易に行える。 このような理由からHugoへの乗り換えを決めた。

Hugoのロゴ

乗り換え方法
#

WordPressからHugoへの乗り換え事例はネットで探せば多数が見つかるし、 Hugoの公式サイトにも移行方法が詳細に書かれている ので、ここでは特に詰まった点だけ触れる。

WordPressの記事を移行してHugoで新しくサイトを構築するには、以下の手順を踏むことになる。

  1. Hugoテーマを選ぶ(重要)
  2. 既存の記事を変換する
  3. コンフィグをいじって仕上げる

Hugoのテーマを選ぶ
#

Hugo公式サイトのテーマ一覧から、サイトに適用するテーマを選ぶ。 このステップがブログ移行にあたって最も重要であり、 選択を間違えると後から大きな手戻りが発生してしまうので慎重にテーマを選ばなければならない。

テーマによって見た目が変わるだけでなく、テーマによって拡張性やカスタマイズ性が大きくことなるので 注意が必要である。例えば、このブログで使用しているBlowfish / ブルーフグ というテーマは、豊富なドキュメント便利なショートコード優れたカスタイマイズ性が魅力である。 テーマによってコンフィグやショートコードのラインナップが異なるので、 後からテーマを変更すると大きな手直しが必要になる。 このように、見た目だけでなく要件に合ったHugoテーマを選ぶことがとても重要なのである。

Blowfish

既存の記事を変換する
#

次にWordPress版の記事をHugoで扱えるように変換する。

まず、公式サイトに書かれている通り WordPressにプラグインをインストールし、記事をMarkdown形式で変換する。 今回はJekyll Exporterを使用してJekyll形式に変換してから JekyllToHugoにより変換した。 更新日時やタイトル、<h1>~<h6>タグなどはきれいに変換することができた。

一方で、いくつかのコンポーネントは機械的に変換できていないようだった。

  • 画像
  • 内部リンク/外部リンク
  • コードブロック
  • 脚注

これらについては一つ一つ手作業で直していった1

変換に失敗したMarkdownの例
悲しみを背負った記事の例。脚注やリンクがMarkdown記法になっていない。

特に脚注の手直しがとても手間がかかった。WordPress版では Easy Footnotesというプラグインを使用していたのだが、 これを使っていた箇所は変換によりすべて壊れてしまっていたので、 全て手作業で直していった2。一部、どうしてもMarkdownでは表現できない脚注があったのだが、 そのような部分は記事本文を直して話の流れが壊れないようにした。

また、せっかくなのでHugoの機能をいくつか試してみた。 HugoやBlowfishにはshortcodeと呼ばれる便利記法がいくつか存在している。 ブログ移行を機に既存記事にざっと目を通し、shortcodeで書き換えられる部分は手直しを行った。

Markdown拡張によりこんなボックスを出すこともできる。

記事の移行は試行錯誤しながら行ったため、70個の記事の移行に約12時間かかった。

コンフィグをいじって仕上げる
#

先述した通り、Hugoではカスタマイズできる箇所が多くある。

旧サイトからシームレスに移行するためには、URLが変わらないように気をつける必要がある。 このブログは、WordPress版ではhttps://komorinfo.com/blog/<Title>の形式でURLを決めていた。 そのため、以前と同じURLに配置させるためには、relpermalinkurlの値をblog/<Title>のように設定する必要がある3。 こうすることで、移行前後で同じURLを使い続けることができる。

また、HugoとBlowfishにはこれ以外にもカスタマイズできるコンフィグがとても多くある。 それにより、旧サイトとにはなかった以下の新機能が使えるようになった。

  • / によりライトモードとダークモードの切り替えができる
  • から記事検索ができる
  • 記事の末尾に関連記事を表示する
  • とてもいい感じの背景画像を設定する

速度比較
#

狙い通りページ読み込み速度が向上したかどうか調べるために、 PageSpeed Insightsでモバイル版トップページのページ読み込み速度の比較を行った。

移行前のパフォーマンス測定結果
移行前(WordPress on AWS Lightsail)

移行後のパフォーマンス測定結果
移行後(Hugo on GitHub Pages)

Hugo版への移植により、パフォーマンスが70から100に向上した。 体感的にも、旧サイト特有のもっさり感が薄まり、ページ読み込みが爆速になったと感じる。

まとめ
#

WordPress on AWSからHugo on GitHub Pagesへの移行を行った。 サーバー保守の必要がなくなり、しかもページ読み込み速度がかなり向上した。 さらに、Hugoの機能によりシンプルでモダンな見た目の良いサイトになった。

komori-n/blog

My personal blog to share knowledges about C, C++, Rust, ,shogi, etc.

HTML
1
0

  1. ついでに著しくクオリティが低い記事はそっと消した ↩︎

  2. 一番大変だったのがdf-pnの最初の記事。 参考文献が多く、壊れた脚注を直すのに15分ぐらいかかった。 ↩︎

  3. HugoやBlowfishの良くない点として、baseURLと相対パスの扱いが少し粗いことが挙げられる。 baseURLがhttps://example.com/hoge/のとき、Hugoが管理するのは/hoge/以下に限られるのだが、 /blog/nyanという記事の参照がhttps://example.com/hoge/blog/nyanではなく https://example.com/blog/nyanとbaseURLを無視してしまうことがあった。 そのため、本サイトではBlowfishのレイアウトに少してを入れることでこの問題を回避している。 ↩︎

Related

ksnctf『Are you human?』Writeup
·2102 文字
やってみた CTF
4000円で画面つきIoTボタンを作る(Wio Terminal)
·2414 文字
やってみた C言語
Rust で AWS Lambda を利用する手順まとめ
·1320 文字
やってみた Rust