Home / Posts

公開日
最終確認日

ブログをWordPressからFreshに移行した過程の紹介②【技術選定と記事の移行】

ブログをWordPressからFreshに移行した過程の紹介②【技術選定と記事の移行】

どうも。Reoです。

このブログをWordPressからFreshに移行した話の続きです。

前回「背景編」を踏まえて、今回は実際にどのように着手していったかを紹介していきます。

Obsidian にやることを書き出す

WordPress製のブログを別のナニカに移行するにあたり、何をやる必要があるのか、どういうブログを目指したいかを書き出していきました。

2024-10-ブログをWordPressからFreshに移行した過程の紹介②【技術選定と記事の移行】-7958c29cddca43b88824322a8dc59d7f

とってもざっくりです。
上から順にうまく書き出していったわけではなく、思いついたことをメモしていっています。

現状をまとめる

そもそも現状ってどうなってるんだ?というのが気になったのでまとめました。

2024-10-ブログをWordPressからFreshに移行した過程の紹介②【技術選定と記事の移行】-764f07363cb943288281f589e74d52e2

記事の構成とかもまとめました。

手順を考える

これもざっくりです。
2024-10-ブログをWordPressからFreshに移行した過程の紹介②【技術選定と記事の移行】-02b5f9f5d09746438f077841f8d9dc5e
各リンクで、それぞれまとめています。

このリンク内でそれぞれ何が書いてあるかざっくりと紹介します。

uruly.xyzで使う技術を選定する

とだけ書いてある。全然選定してないですね。決定版かも。

Obsidianの保管庫をブログとリンクさせる

Obsidian のディレクトリ構成が書かれていました。

└── post
    ├── 2024-09-11-slug1
    │   ├── index.md
    │   └── images
    │       └── hoge.png
    └── 2024-09-11-slug2
        ├── index.md
        └── images
            └── hoge.png
└── private
    ├── 2024-09-11-slug3
    │   ├── index.md
    │   └── images
    │       └── hoge.png
    └── 2024-09-11-slug4
        ├── index.md
        └── images
            └── hoge.png
└── draft
    ├── 下書き.md

完成版とはちょっとだけ違いますが、だいたいこんな感じになっています。

ブログを書く手順として、以下のようにしたいと書かれています。

  1. draftで下書きを書く。
  2. 日付を冒頭につけたディレクトリに必要な画像フォルダ images と.mdファイルを入れる
  3. 公開する時に postディレクトリにぶち込む。
  4. 公開後に非公開にしたい場合は postディレクトリから privateディレクトリに入れ直す。

だいたい本番でもこんな感じでやっています。

uruly.xyzのフロントエンドの実装について

Deno Freshを使いたい!ということで Deno Fresh について 調べてみた。

と一言だけです。

(Deno Fresh についての中でめちゃくちゃお勉強メモがあります。)

uruly.xyzのデプロイ方法について

開発は、Push したらデプロイされる方式であって欲しい。
記事の修正は即時反映がいいけれど、デプロイ時間があってもいいのか考える。

WordPress の記事をマークダウンにして書き出す

後述しますが、ツールを使えば簡単にできそうだなというイメージだけしていました。

実際にこの方法を用いました。

WordPressの記事をMarkdown形式に一括出力する方法より、1度xmlとして保存してから、node.jsのツールを使って変換する。

wordpress-export-to-markdown

uruly.xyzのマークダウンのattributes

実際に記事を書く時にマークダウンに追加したいattributesを考えてありました。

- title
- date
- categories
- coverImage
- tags

Deno Freshをお勉強しよう!

とにかく Fresh を使ってみたいという気持ちが大きかったので、まずはお勉強を始めました。

Deno をはじめよう

まずは、Deno 自体のお勉強を少し行いました。

Deno 日本語マニュアルを一通り読みました。例のところは試していませんが、途中のサンプルは実際に手を動かしながら読みました。

Fresh のドキュメントを読もう

Fresh のドキュメントは英語なので、そのまま読むとふわっとした理解になってしまうのが明らかだったので、翻訳をしました。ChatGPTに投げていました。

基本はドキュメントを翻訳して、もったいないのでそのままObsidian 上に残しておいただけですが、グラフビューを見るといっぱい勉強したんだなぁって気になりました。

2024-10-ブログをWordPressからFreshに移行した過程の紹介②【技術選定と記事の移行】-81b6fc064fc74dabbcafe9bec4a4bee3
Freshもドキュメントを読みながら実際に動かしてみて勉強しました。

ドキュメントを全部読むってことはしたことがなかったんですが、普通にいいですね。実際に使っていないことも多いですが、全体のフワッとした概要を知っているだけでも捗りました。

これで、移行先をFreshにする覚悟ができました。

WordPressの記事をマークダウンに変換する

Freshではマークダウンで書かれた記事を配置する予定だったので、これまでWordPress上で書いてきた記事はマークダウンに変換しなければいけません。

この方法についての詳しくは別記事で紹介しています。
WordPressの記事やコメントをマークダウンに変換してみた

参考と使ったツール

WordPressの記事をMarkdown形式に一括出力する方法の記事を参考に、wordpress-export-to-markdownを使いました。

フォークしてカスタマイズ

WordPressでエクスポートした export.xmlには、カスタムフィールドやコメントの値が入っていますが、wordpress-export-to-markdownの機能には、それらの値を吸い出す機能がありませんでした。

リポジトリをプライベートでフォークさせてもらい、自分用にカスタマイズをしました。

WordPressでは自作プラグインで「追記」という機能を作っていました。カスタムフィールドを使っています。

2024-10-ブログをWordPressからFreshに移行した過程の紹介②【技術選定と記事の移行】-a2ce65da96fd4386b0eaed2246e91661

これは、addition.md としてエクスポートするようにしました。

また、「参考リンク」という機能もカスタムフィールドで作っていましたが、その部分は記事の最後に追記するという実装をしてエクスポートするようにしました。

2024-10-ブログをWordPressからFreshに移行した過程の紹介②【技術選定と記事の移行】-c7f8fe5b28884f7abc39c38e2b85c6ae

コメントも持ってきました。 今までコメントくれた方、ありがとうございます…!大事にかかえてきました。

2024-10-ブログをWordPressからFreshに移行した過程の紹介②【技術選定と記事の移行】-eca4506ae64e4eaf95e973a04fa676a4

現在はコメントフォーム機能を未実装なのですが、そのうち作ろうと思います。読んだよーだけでも嬉しいです。

Obsidianの保管庫として開いてみる

Obsidian 上でexportした記事を開きます。

2024-10-ブログをWordPressからFreshに移行した過程の紹介②【技術選定と記事の移行】-08da0ca2ff9247f0a11aeec97fb1faa7

年ごとに保存され、画像は各投稿の imagesフォルダに入っています。
また、追記を書いた時は各投稿のフォルダの中に additionsフォルダを作り、追記コメントを入れました。

コメントはファイル名を Dateにして保管しています。

この状態で、Obsidian上で画像が表示されなかったので、画像が表示されるように画像パスも修正してエクスポートするようにしています。

GitHubにリポジトリを作る

マークダウンになったWordPressの記事をGitHubで管理するようにしました。

詳細については別途記事を書きますが、これにて無事に全てのWordPress上のコンテンツをマークダウンに変換し、GitHubで管理できるようになりました。

どうやってFreshとコンテンツを紐づける?

さて、Freshのお勉強も終わり、既存の記事もマークダウンに変換できたところで最難関の「どうやってFreshとコンテンツを紐づけるのか」問題に直面しました。

この問題の解決策としてあげられた候補は以下の通りです。

  • GitHub APIを利用する
    これは5000回/hourの制限があるらしい。絶対大丈夫っしょって思うけど、一旦保留。
  • GitHub サブモジュールで紐づける ✅ 大成功
    まずはこれを試す。
  • なんかしらのDBを通す
  • コンテンツ自体をFreshで配信する

大成功した方法しか結局試していません!

GitHubサブモジュールで紐づける

これについても詳しくは別途記事を書きます。

(TODO: FreshでGitHubサブモジュールからコンテンツを取得する記事を書く)

Fresh のリポジトリを親とし、コンテンツのリポジトリを子とします。

ひらめき

Freshの公式ブログ記事「# How to Build a Blog with Fresh」にて、Freshでのブログの作り方が書かれています。

ここではブログのコンテンツは、Freshプロジェクト内の posts に入れられます。

my-fresh-blog/
├── .vscode
├── posts         👈 ココ
├── routes
├── static
├── deno.json
├── dev.ts
├── fresh.gen.ts
├── import_map.json
├── main.ts
├── README.md
└── twins.config.ts

postsの中にブログ記事のコンテンツである first-post.mdが配置されます。

この部分だけ別のリポジトリにしたくない?と思い、サブモジュール化を思いつきました。

これにより、API等や外部DBを使わずに Deno.readTextFile を使って、内部のコンテンツを取得しています。

同期は一手間

git サブモジュール機能を使うのは初めてだったんですが、サブモジュール側のコンテンツを更新した後に、親のFreshも更新しなければ変更は反映しません。

開発時は、コンテンツを更新したら git submodule update --remote を行ってコミットをしながら変更を反映させていました。

最終的には以下の workflow を実装して、コンテンツのリポジトリを更新すると再デプロイするようにしています。

  • サブモジュール側に workflow (Freshのworkflowを実行する)
  • Fresh 側の デプロイ時の workflow にサブモジュールの更新を組み込む

コンテンツとFreshを紐付けてローカルで記事を表示し、それがデプロイ後にも表示された瞬間は嬉しかったです。

まとめ

そんなこんなで、以下のような構成に決まりました。

これまで これから
フロントエンド WordPress Fresh 🍋 (フルスタック)
コンテンツ管理 WordPress(MySQL) GitHub サブモジュール (DBは使っていない)
サーバー Xserver Deno Deploy(サーバーレス)
コンテンツエディタ WordPress の Classic Editor Obsidian
ローカル環境 VVV Deno 環境
デプロイ方法 wordmove Deno Deploy

つづくかも

あとは地道にFreshで構築をしていくだけなんですが、何か書けることがあったら続きます。

追記

2025-04-26追記

この方法は現在は使っていません!ブログをFreshからNext.jsに移行しています。

© 2015 うるおいらんど
とじる