この記事でわかること
- 公式手順の前提バージョンを確認する
- 秘密情報を公開リポジトリに置かない
- ローカル実行とインターネット公開を分ける
先に検証用の環境を決める
EmDash CMSについて、公式の最初のサイト作成ガイドは、Node.jsで実行するStarterテンプレート、SQLite、ローカルのメディア保存を使う例です。クラウドのアカウントなしで手元の操作を試せる構成ですが、この状態が本番公開やバックアップの完成を意味するわけではありません。
記事確認時の公式ガイドではNode.js 22.23.4以降とnpmが前提です。要件や対応版は変更されるため、作業する時点で公式のPrerequisitesを読み直し、バージョンを確認してから始めます。使用中のWordPress本体やデータベースを置き換えない場所を選びます。
公式ウィザードで雛形を作る
公式手順ではターミナルから「npm create emdash@latest」を実行し、プロジェクト名、Node.js、Starter、パッケージマネージャーなどを対話形式で選びます。コマンドは内容と取得先を自分で確認して実行し、表示される案内が公式資料と違う場合は先へ進まず調べます。
雛形作成後は作成されたディレクトリで「npm run dev」を実行し、表示されたローカルURLを開きます。ローカルアドレスは自分の端末で確認するためのもので、外部の読者がアクセスできる本番サイトのURLとは区別します。
初期設定と編集を試す
公式例ではローカルURLの管理画面へ進み、サイト名と管理者情報を設定してパスキーを登録します。認証器の保存先と復旧手段を決め、実在する公開サイトの管理者情報や顧客情報を学習用の環境へ無造作に持ち込まないようにします。
サンプル投稿のタイトルを変更し、保存と公開操作の違いを試してから、別タブで公開ページを確認します。自分が実際に試した内容と、公式資料をもとに説明している内容は区別し、未検証の動作を実体験として記事に書かないことが大切です。
秘密鍵と停止方法を確認する
公式ガイドでは暗号化キーが`.env`に生成され、プラグインの秘密情報を復号するために必要とされています。`.env`をGitなどで公開せず、本番で利用するなら安全な方法でバックアップし、共有先と復元手順を運営者間で決めます。
確認が終わったら開発サーバーを停止し、検証データを残すかを決めます。外部公開にはデプロイ先、ドメイン、セキュリティ、データ保存、ログと費用の検討が別途必要です。手元で開けたことだけを公開準備完了としないでください。
実験記録には公式手順のURL、確認日、環境の版、操作と結果を残します。画面は更新されることがあるため、作業日には公式情報を読み直してください。エラーを外部に共有するときは、メールアドレス、秘密鍵、アクセストークンなどが含まれていないか確認します。解決できない場合は作業を中止し、既存の公開サイトを触らずに原因を調べます。
公開用の秘密情報を検証環境に使い回さず、試験が終われば不要な接続を停止してください。
- 公式のNode.js要件を作業日に確認した
- 既存サイトと別のフォルダーで試した
- `.env`と暗号化キーを公開しない
- 下書き・公開・表示を一巡した
- 公開環境の要件を別に整理した
参考にした公式情報
確認日:2026-11-07。提供条件や仕様は変更される場合があります。
広告・アフィリエイトリンクを含む場合があります。編集・掲載方針