ローカルの記事と画像を、公開先のEmDashへ移す
サイトパッケージを使い、手元で作った記事や画像を空の公開先へ移す手順を説明します。
目次
手元のEmDashで作った記事や画像は、サイトパッケージを書き出し、公開先の空のEmDashへ取り込んで移せます。サイトパッケージは、記事、入力欄の構成、変更履歴、メディアなどをまとめた.emdashファイルです。
自分のパソコンで動くローカルのサイトと公開先では、記事を保存するデータベースが別になっている場合があります。コードの配置だけでは記事や画像は自動で移らないため、この転送作業が必要です。WordPressからの移行は移行ガイドで扱います。
先に、移行先を準備する
この手順は、元と移行先の両方へ管理者としてログインできる状態から始めます。公開先がまだなければ、先にCloudflareへの公開などで準備してください。
同じ版・同じテーマのコードを用意し、公開先でEmDashが動く状態にします。テーマの.astroファイルや独自のプログラムは、コードの配置として別に準備します。
サイトパッケージの取り込み先は、公式の条件を満たすコンテンツが空のサイトです。管理者の初期設定と保存先は必要ですが、試しに記事や画像を追加してあると、取り込みが止まる場合があります。
入っているものを消して無理に空にする前に、別の新しい移行先を作れるか考えましょう。取り込み画面には、何が条件に合わないか表示されます。
言語と、移らないものも確認する
元サイトで使っている言語を、移行先の**i18n設定(サイトで使える言語の設定)**にも用意します。たとえばjaは日本語、enは英語を表すコードです。jaとして保存された記事を移すなら、移行先もjaを受け入れられる必要があります。本文が日本語かどうかだけで判断せず、元サイトの言語設定を制作担当者と確認します。設定のないサイトは、既定でenだけを受け入れます。
ログインに使うパスキー、外部から接続するための鍵であるAPIトークン、プラグインの保存データや秘密の設定値は、パッケージに入りません。著者の表示を引き継いでも、その人が同じ方法でログインできるとは限らないため、移行先の管理者とログイン方法は別に準備します。外部メディアサービス上の画像も、参照は残っても実体はコピーされません。
含まれる範囲と空のサイトの条件は、公式のサイト転送ガイド(別タブで開く)で確認できます。
1. 元のローカルサイトから書き出す
ローカルのEmDashを起動し、その管理画面へ管理者として入ります。作業中の編集を終えてから、次を進めます。
- **Settings → Transfer(設定 → サイトの転送)**を開く。
- **Export(書き出し)**で、コメントを含めるか確認する。
- **Export site(サイトを書き出す)**を選び、画面を開いたまま進行を待つ。
- **Export ready(書き出し完了)**になったら、**Download package(パッケージをダウンロード)**で
.emdashファイルを保存する。
保存したファイルには下書きや、著者・コメント投稿者のメールアドレスが含まれることがあります。公開用の素材フォルダーには置かず、管理する場所へ保存します。
2. 公開先で解析する
公開先のEmDash管理画面を開きます。ブラウザーのアドレスを見て、取り込み先が公開先になっていることを確認します。
**Settings → Transfer → Import(取り込み)**で、**Choose package file(パッケージファイルを選ぶ)**から保存したファイルを選びます。アップロードと解析のあと、書き出し元、日時、版、件数を確認します。
Blockersは、そのままでは実行できない条件、Warningsは注意が必要な内容です。変換される内容、削除される初期データも読みます。わからない項目があれば、その項目名と説明を制作担当者へ渡します。初期設定で作られた部品を入れ替える場合があるため、取り込み対象の確認を飛ばさないでください。
3. 著者とサイト名を選び、取り込む
**Authors(著者)**で、元の著者を公開先のユーザーに対応させます。**Site identity(サイトの名前や説明)**では、元の情報を使うか、移行先のものを残すか選びます。
内容を確認して**Start import(取り込みを開始)**を実行します。終了後に表示される取り込み結果の記録を、**Copy receipt(記録をコピー)**で保存します。Verifiedは、取り込んだデータがパッケージと照合されたことを示します。サイトの見た目やログインは、次の手順で別に確認します。
4. ページを開いて確認する
取り込み結果の記録と見比べながら、本文、画像、カテゴリ、下書き、変更履歴、著者を実際に確認します。移行先のURLやログイン、プラグインの動作は別途確認が必要です。
サイトの公開状態も移行先のものが残ります。検索向けのStaging設定を変える場合は、確認を終えてから行います。取り込み結果の記録と、表示や操作の確認結果を残したら、公開前チェックへ進みましょう。