今あるAstroサイトに、お知らせ管理だけを追加する
既存ページを残してEmDashを組み込み、公開方式と保存先の変化を確認します。
目次
既存のAstroサイトにEmDashを追加して、お知らせだけを管理画面で更新できるようにする方法があります。会社案内など、今あるページのファイルは残して使えます。
Astroは、サイトのページを作るための道具です。プロジェクトは、そのサイトのファイルをまとめた作業用フォルダーを指します。
ここでは、どこを変更し、何を残すかを整理します。Astro以外のサイトへ、そのまま同じ設定を追加する手順ではありません。ファイルの編集と公開先を管理している人が進めます。
最初に、今のサイトの動かし方を確認する
既存のプロジェクトをコードエディターで開き、package.json、astro.config.mjs、公開時の作業メモを確認します。使っているソフトの一覧はpackage.json、Astroの設定はastro.config.mjsにあります。
WindowsではVS Codeのターミナルでコマンドプロンプトを選びます。MacでもVS Codeのターミナルを使えます。入力画面の開き方
そのフォルダーを作業場所にしたコマンド入力画面で、次を1行ずつ実行します。Node.jsはプログラムを動かす土台です。操作場所に迷ったら、作業に使う道具と画面で確認してください。
node --version
npx astro --version2つの命令は版の確認用で、EmDashを追加する命令ではありません。数字を含む版番号が出たら、両方を控えます。「見つかりません」などのエラーや、インストールの確認が出たら、まず作業フォルダーと既存プロジェクトの準備状態を確かめます。
公式の既存サイト向けガイドは、Astro 6以降とNode.js 22.16以降を前提にしています。Astro 7.4以降ではNode.js 22.23.4以降という条件もあるため、採用する版の組み合わせを公式の必要条件(別タブで開く)で照合します。
作成済みのHTMLを置くだけだったサイトにも、管理画面やデータ取得の処理を動かすサーバーが必要になります。現在契約している公開先でその処理を動かせるか、組み込み前に確認してください。
残すページと、管理する内容を分ける
たとえば、次のように担当を分けられます。
| 場所 | 管理する方法 |
|---|---|
| 会社案内 | 既存のAstroファイルを維持する |
| お知らせの原稿 | EmDashのコレクションへ保存する |
| お知らせ一覧・詳細 | AstroのページからEmDashの公開済み内容を読む |
| 管理画面 | EmDashが用意する入口を使う |
既存のMarkdownファイルや画像が、自動的に管理画面へ取り込まれるわけではありません。新しいお知らせだけをEmDashで始めるのか、過去分も登録するのかを決めます。
変更前の状態を残し、別の環境で組み込む
Gitなどでコードを保存し、公開中のサイトとは別の作業場所を用意します。Node.js構成の公式手順では、次の役割を追加します。
- EmDash本体と、管理画面で使うReactの組み込み。
- Astroを公開先に合わせて動かす部品(アダプター)。
- 記事を整理して保存するデータベース(DB)と、画像ファイルを保存する場所。
src/live.config.tsに、EmDashのデータを読む設定。- 必要な秘密の設定値と、その保管先。
組み込み作業では、公式のInstall EmDashの手順(別タブで開く)を開き、追加するソフト、設定ファイル、取得設定を順に揃えます。上の一覧は役割の整理なので、項目名をファイルに書き足すだけでは動きません。
すでにCloudflareなどのアダプターを使っている場合は、Node.js用を重ねて追加しません。既存の公開先に合う構成を使います。また、設定例で既存のファイル全体を上書きせず、今ある連携や設定を残して統合します。
最初は、確認用ページ1枚でつなぐ
組み込み後に開発サーバーを起動し、コマンド入力画面に表示されたURLの末尾に/_emdash/admin/を付けて開きます。管理者の準備を終えたら、お知らせを1本作り、公開します。
制作担当者は、既存ページとぶつからない確認用URLを作り、その公開済みのお知らせを表示します。公式の組み込みガイド(別タブで開く)には、取得用のページ例があります。
確認用ページで読めたら、既存のデザインに合う一覧・詳細へ組み込みます。/news/など、もともと使っているURLを二重に担当するページを作らないよう確認します。
元からあるページも開いてから公開する
トップ、会社案内、フォーム、404画面を確認します。お知らせは、公開済みが表示され、下書きは読者へ出ない状態を確かめます。画像の登録と、サーバーを再起動したあとの保存状態も対象です。
最後に、試したコードだけでなく、公開先のDB・画像保存先・秘密の設定も揃えます。確認用のローカルデータを使い続けるつもりなら、公開先への転送も別に計画します。