今ある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 --version

2つの命令は版の確認用で、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構成の公式手順では、次の役割を追加します。

  1. EmDash本体と、管理画面で使うReactの組み込み。
  2. Astroを公開先に合わせて動かす部品(アダプター)。
  3. 記事を整理して保存するデータベース(DB)と、画像ファイルを保存する場所。
  4. src/live.config.tsに、EmDashのデータを読む設定。
  5. 必要な秘密の設定値と、その保管先。

組み込み作業では、公式のInstall EmDashの手順(別タブで開く)を開き、追加するソフト、設定ファイル、取得設定を順に揃えます。上の一覧は役割の整理なので、項目名をファイルに書き足すだけでは動きません。

すでにCloudflareなどのアダプターを使っている場合は、Node.js用を重ねて追加しません。既存の公開先に合う構成を使います。また、設定例で既存のファイル全体を上書きせず、今ある連携や設定を残して統合します。

最初は、確認用ページ1枚でつなぐ

組み込み後に開発サーバーを起動し、コマンド入力画面に表示されたURLの末尾に/_emdash/admin/を付けて開きます。管理者の準備を終えたら、お知らせを1本作り、公開します。

制作担当者は、既存ページとぶつからない確認用URLを作り、その公開済みのお知らせを表示します。公式の組み込みガイド(別タブで開く)には、取得用のページ例があります。

確認用ページで読めたら、既存のデザインに合う一覧・詳細へ組み込みます。/news/など、もともと使っているURLを二重に担当するページを作らないよう確認します。

元からあるページも開いてから公開する

トップ、会社案内、フォーム、404画面を確認します。お知らせは、公開済みが表示され、下書きは読者へ出ない状態を確かめます。画像の登録と、サーバーを再起動したあとの保存状態も対象です。

最後に、試したコードだけでなく、公開先のDB・画像保存先・秘密の設定も揃えます。確認用のローカルデータを使い続けるつもりなら、公開先への転送も別に計画します。

公式の参照元

関連ガイド

メニュー
ホーム公式ドキュメント (別タブで開く)

キーワードを入力すると、ガイドの内容から探せます。