制作ガイド
設計、実装、公開、保守まで、担当する作業を手順に沿って進めます。
目次
コンテンツ設計
- 記事の入れ物と入力欄を知ろうコレクション、フィールド、エントリー。管理画面で出てくる3つの言葉を、同じ記事の例で説明します。
- カテゴリとタグを整理するカテゴリとタグの使い分けから、分類を作って記事へ付ける流れまで。空の分類や、削除したときの扱いも整理します。
- スタッフと実績など、別の内容を結び付ける関係と参照欄の役割を知り、同じ情報を何度も書かずに管理する設計を考えます。
- 会社紹介などの固定ページを作り、メニューにつなぐ会社紹介やお問い合わせ案内のページを、内容の作成・URLでの表示・メニューへの追加に分けて仕上げます。
- 日本語サイトと言語設定を整える日本語の本文、管理画面の表示、記事の言語、URLの言語設定を分けて考えます。新規サイトと既存サイトで確認すべき点も説明します。
- 日本語サイトに、あとから英語のページを増やす既存の日本語記事を残し、翻訳の作成・公開・言語切り替えを順番に準備します。
- 入力項目から型を作り、コードの打ち間違いを見つけるEmDashの項目定義をTypeScriptへ書き出し、titleをtitelと書いたときに検出できるか試します。
- 入力項目の設計を、別の空のデータベースに再現するexport-seedで設計を書き出し、別名の練習用DBへ適用して項目が一致するか確かめます。
- 運用中サイトの項目を追加・変更する初期設定のseedと運用中のデータベースを区別し、既存の記事を保ちながら新しい入力欄を追加する流れを学びます。
テーマ制作
- テーマの役割と制作の進め方テーマは、保存した記事を読者向けの画面にする仕組み。文章、見た目、入力欄の役割を分けて、制作の順番を考えます。
- 小さなテーマを一つ作る既存の練習サイトに、サイト名と文章を表示するページを追加します。Astroファイルの読み方から順番に説明します。
- サイトのコードをGitで残し、変更を確かめるGitで記録するファイルと除外するデータを分け、1ファイルの変更を確認して履歴に残す練習をします。
- 記事一覧と詳細ページを作るCMSに保存した記事を読み込み、タイトルの一覧と本文のページを作ります。取得失敗と記事がない場合も分けて扱います。
- 写真付きの記事一覧を、練習用サイトで作る教材を起動し、写真がある記事とない記事を同じ一覧に表示します。16ページの実習はここから始めます。
- 記事を10件ずつ表示し、次のページへ進む12本の記事を10件と2件に分け、最後には次へ進むリンクを出さない一覧を作ります。
- 選んだ関連記事を表示し、下書きは除く参照用の入力欄で選んだ記事を詳細ページに表示し、非公開の記事が混ざらないか確かめます。
- サイト内検索と分類ページを作る検索欄とカテゴリ別の記事一覧を用意します。検索対象の設定、公開状態、URLとのつながりを順番に確認します。
- 管理画面で並べ替えられるメニューを作るリンクの名前と順番をコードに固定せず、EmDashのメニューから読み込みます。
- 全ページのお知らせを、1か所の変更で揃えるWidget Areaで共通表示を管理し、本文にコピーするひな形との違いを理解します。
- ページごとに「標準」と「幅広」の見た目を選ぶ選択欄と表示部品を対応させ、編集者がページ全体のレイアウトを切り替える設計を説明します。
- 編集者が使えるページ部品を作る本文のひな形、組み替えるページ部品、ページ全体のレイアウトを区別します。編集者の操作と開発者の準備をつなげます。
- 公開した記事だけをRSSで配信する公開記事のタイトルと要約からRSSを作り、下書きを含めずXMLとして返します。
- 記事の公開後に、一覧と詳細のキャッシュを更新する公開用にビルドしたサイトを手元で動かし、表示結果の再利用と、記事を公開した後の更新を確かめます。
- スマホ・キーボード・読み上げで使いやすさを確認するスマホ幅、文字の拡大、キーボード、読み上げで、実際の操作が完了するかを確かめる入口を作ります。
編集画面と公開フロー
- 管理画面を日本語に切り替えるSettingsのLanguageで日本語を選ぶ手順と、日本語が選択肢に出ない場合の確認場所を説明します。
- 下書き・保存・公開は、何が違う?記事を保存するとどうなるのか、いつ読者に見えるのか。公開済みの記事を直す場面まで、例で理解しましょう。
- 本文に見出し・リンク・表を入れる本文の見出し、リンク、表を一つずつ作り、保存した内容が公開ページでどう見えるか確かめます。
- 画像を登録して記事に使う写真を登録して記事に入れる流れと、画像の差し替え・削除で影響する範囲を説明します。
- 記事の画像を差し替えるとき、どこまで変わる?1か所だけ変える操作と、同じメディアを使う全ページに反映する操作を使い分けます。
- メニューと共通設定を管理するサイト上部のリンクやサイト名など、複数のページで使う情報を管理画面から整える考え方を説明します。
- 検索結果やSNSに出るタイトル・説明・画像を整えるSEO用の入力欄と、ページが実際に出力する情報を分け、検索結果や共有画像の確認方法を説明します。
- 公開する前の原稿を、確認してもらうには?期限付きのプレビューURLを使い、確認する原稿・公開版・共有範囲を整理します。
- 決めた日時に、記事を予約公開する記事を保存して公開日時を設定し、予約の変更・取り消し・公開結果を確認します。
- 同じ記事を2人で開いたら、どうなる?編集ロックの意味を知り、読み取り専用・引き継ぎ・保存エラーを使い分けます。
- 昨日の原稿に戻したい。変更履歴をどう使う?過去の版を読み比べ、現在の下書きへ戻す操作と、読者向けに公開する操作を区別します。
- 公開を取り消す・ごみ箱へ移す・元に戻す公開の取り消し、ごみ箱、履歴の復元を区別し、戻した後に何を確認するかまで説明します。
- JSONファイルから、記事の下書きを1本作るコマンドに長文を直接書かず、ファイルを読み込んで下書きを作り、管理画面で確認します。
- 古い情報で、記事を上書きしないようにする更新に_revを添え、先に保存された変更を古い内容で上書きしないことを確かめます。
プラグイン開発
- 既存プラグインを入れる・止める・外す管理画面から入れるプラグインと、制作担当者がコードへ組み込むものを分け、導入・停止・削除を説明します。
- 作りたい機能に合うプラグイン方式を選ぶプラグインの2つの方式を比較し、追加したい機能と設置先に合う方を選びます。管理画面で入れるものとnpmで入れるものの違いも説明します。
- サンドボックスで動くプラグインを作る分離した実行環境を用意し、記事保存のログと動作確認用のAPIを持つプラグインを登録します。
- ネイティブプラグインを作る記事を保存したときにログを出すプラグインを作ります。別フォルダーで作り、サイトへ取り込み、設定に登録する流れを説明します。
- 設定画面とデータ保存を組み込む管理者が変える設定、内部状態、一覧で扱う記録の保存先を選びます。保存用APIと設定画面、秘密値の扱いを整理します。
- 保存と公開を、別々のタイミングで記録する下書き保存と読者への公開を区別し、プラグインの処理とテストで確かめます。
- 要約が空の記事を、公開直前に止める下書きは保存し、公開するときだけ必須条件を確認するプラグインを作ります。
- 記事の編集画面に、公開前チェックの欄を追加する保存済みの要約を読み、入力済みか空欄かを管理画面のパネルへ表示します。
- 公開チェックを、自動テストで何度も確かめる実際のEmDashの保存・公開処理を使い、下書き保存、公開拒否、修正後の公開を確認します。
- プラグインが外部サービスへつながらないとき通信の許可、接続先、認証情報、実行環境を分けて調べ、必要なアクセスだけを設定します。
- 動作を確認してプラグインを配布するコードの検査、実際のサイトでの確認、配布物の確認を分けます。ネイティブのnpm配布とサンドボックスのレジストリ公開の流れを説明します。
外部サービス・AI連携
- EmDashの記事を、別のサイトやアプリでも使う管理画面と表示先を分ける構成で、取得する内容・認証・公開状態・更新反映を設計します。
- 問い合わせを、確実に受け付けて担当者へ届ける送信・保存・通知を分け、失敗や迷惑投稿、添付ファイルまで含めて運用を設計します。
- 今のMAフォームを使い、受付・通知・完了計測を確認する既存フォームを埋め込む前に保存先と通知先を調べ、受付・メール・計測を別々に確認します。
- MA・計測タグを入れ、ページ移動や二重計測を確かめる計測タグの置き場所、全ページへの適用、管理画面の除外、画面遷移による計測漏れを確認します。
- ドメイン変更・Cookie同意で計測はどう変わる?ドメインが変わる場合の訪問者識別と、Cookieへの同意・拒否・撤回を、具体的なテストに分けます。
- URLが変わっても、MAの自動メールを誤配信しないためにURL変更が自動メールや点数付けに与える影響を、切り替え前・切り替え中・再開後に分けて確認します。
- CMS・MA・CRMで、顧客情報の管理元を決める名前・連絡先・配信停止など、項目ごとの正しい管理元を決め、二重登録や古い情報での上書きを防ぎます。
- 既存会員のログインやECのカートと共存させる管理画面へのログインと読者の会員ログインを分け、Cookie、ログアウト、カート、キャッシュを確認します。
- チャット・地図・外部スクリプトが動かないとき外部の地図やチャットが表示されないとき、ページ・通信・相手の制限を順に切り分けます。
- 外部サービスとの連携が失敗しても、取りこぼさないためにAPIの権限・再送・重複防止・通知を整理し、連携を続けるための設計を説明します。
- 通知先が止まったときの処理を、テストで確かめる本物の通知を送らず、503エラーと200成功を再現し、記録が分かれることを確認します。
- 通知が重複・逆順・遅延したとき、連携を立て直す同じ通知が二度届く、順番が変わる、結果が分からない場合を、具体例と再開手順で整理します。
- AIに下書きを作ってもらい、人が確認して公開するサイト用MCPの役割と権限を知り、AIへの依頼・保存結果の確認・公開を分けて進めます。
- 言い方が違っても探せる検索を、AI Searchで検討する通常の検索との目的の違い、Cloudflareへの接続、検索対象と結果URLの確認を整理します。
認証・セキュリティ
- 管理画面へのログインとメールを整えるパスキー、メールのログイン、外部ログインの違いと、メール送信を実際に確かめる手順を説明します。
- 一緒に記事を書く人を、EmDashへ招待する担当する作業に合わせて権限を選び、招待とログインを確認します。
- 書く人・確認する人・公開する人を分ける標準の役割でできることを押さえ、部署別の制限や多段階承認を必要条件として整理します。
- 会社のアカウントでログインさせる前に確認すること外部ログインの追加と、社内の認証ルールを必須にする設定を分けて整理します。
- Cookieの安全設定とセキュリティヘッダーを確認するログイン情報の扱いとブラウザーへ伝える保護設定を分け、公開先で実際に確認する場所を説明します。
- 下書きの画像や社内PDFを、外へ見せないためには?記事の公開状態とファイルの公開範囲を分け、URL・配信先・キャッシュまで確認します。
- 個人情報は、どこに残り、どう消せばいい?本文・画像・問い合わせ・ログ・外部連携の保存先を整理し、削除と復旧時の扱いを決めます。
- 異動・退職・委託終了のとき、アカウントをどう止める?EmDash・会社の認証・API接続を分け、停止漏れを防ぐ一覧と確認手順を作ります。
- 誰が何をしたかを、あとから確認できるようにする記事の変更履歴と監査ログを区別し、必要なイベント・保存先・通知を整理します。
- 秘密の設定を登録し、手元と公開先で使い分ける練習用の秘密値を使い、ローカル設定とCloudflareのsecretが別々であることを、値を表示せずに確認します。
- 秘密の設定を入れ替えるとき、古い鍵は消していい?外部サービスの認証情報と保存内容を読む暗号化キーを分け、交換と復旧の順番を説明します。
- 公開前に、どこをセキュリティ確認してもらう?管理画面・公開ページ・API・追加機能を分け、診断範囲と修正後の確認を整理します。
公開・移行
- EmDashを公開する場所は、どう選べばいい?サーバー選びで見るべき条件を、プログラム・記事・画像の3つに分けて整理します。
- CloudflareとNode.js環境、何が違う?同じEmDashを動かす2つの構成を、保存先・運用・予約公開の違いから比べます。
- Cloudflare公開に必要な構成を理解するコードを動かすWorkers、記事を保存するD1、画像を保存するR2の役割を説明します。ローカルとの違いも整理します。
- 公開中のサイトに触らず、試す場所を作るコード・記事・画像・秘密の設定を分け、公開前の変更を別の環境で確かめます。
- 本番に触れずに、Cloudflareの練習用公開先を作る共通教材をパソコンで起動し、Cloudflareに2つの練習用ページを公開します。公開・保存先・ログ・秘密情報・切り戻しの5つの実習はここから始めます。
- 検証用と本番役で、データベースと画像の保存先を分ける別々のD1とR2を用意し、同じIDのメモや同じ名前の画像が混ざらないことを、手元と公開先で確認します。
- Cloudflareへ公開して動作確認するCloudflare用テンプレートから新しい検証サイトを作り、配置、初期設定、記事と画像の確認まで進めます。
- Node.js対応のサーバーへ公開するNode.jsの公開先で、コード・データ・秘密情報を準備し、起動と公開前確認を進める順序を説明します。
- ローカルの記事と画像を、公開先のEmDashへ移すサイトパッケージを使い、手元で作った記事や画像を空の公開先へ移す手順を説明します。
- 記事と画像を、もう1つの練習サイトへ引っ越す空の移行先を用意し、書き出し、取り込み計画の確認、実行、表示の照合まで進めます。
- 他のCMSから、何を移せて何を作り直す?記事・画像・見た目・機能を分け、移行前に確認する一覧を作ります。
- WordPressの記事と画像をEmDashへ取り込むWXRファイルで記事を取り込み、画像のコピーと公開状態の確認まで進めます。
- 引っ越し後も、前の記事URLから読めるようにする旧URLと新URLの対応表を作り、必要な転送とリンク切れの確認を行います。
- 会社サイトの/news/だけをEmDashにできる?サイト全体の移転と、URLの一部だけを別CMSへ振り分ける方法を分け、必要な確認経路を整理します。
- 新旧サイトのメニュー・検索・共通表示をそろえる別システムを並行運用するときのメニュー、共通デザイン、横断検索の管理方法を整理します。
- 自分のドメインでEmDashを公開するドメインをサイトへつなぎ、EmDashの公開URLとログインを確認する順番を説明します。
- サイトを移しても、会社のメールを止めないためにWebサイトとメールが同じドメインを使う場合に、変更前に残す設定と切り替え後の確認を説明します。
- 画像だけを、別のドメインから配信するR2やS3の公開URLを使う構成で、保存先と読者が開くURL、公開範囲を確認します。
- 旧サイトから新サイトへ、安全に切り替える更新停止・最後のデータ移行・切り替え・確認・戻す判断を、一つの時系列にまとめます。
- サイトを公開する前に、最後に確認すること読者の画面と管理者の操作を確認し、正式公開してよい状態を整理します。
- サイト移行後も、検索とアクセス計測を続けるURLや計測ID、管理権限を移行前後で照合し、計測漏れと二重送信を見つけます。
保守・トラブル対応
- サイトが止まったことに、どう気付く?表示・保存・定期処理を分け、通知先と対応時間まで決める監視の考え方を説明します。
- アクセスが増えても動くか、公開前に確かめる表示の速さと同時アクセスの違いを整理し、条件・中止基準・費用を決めて試す方法を説明します。
- 表示・画像・接続の問題を切り分ける画面が出ない、記事が出ない、画像が出ないなどを分けて確認します。データを消さずに、最初に見る場所を整理します。
- 管理画面にログインできないときは、どこを見る?画面が開かない場合、パスキーが使えない場合、メールが届かない場合を分けて確認します。
- 画像が出ない・古いままのときは、どこを見る?画像の登録、記事の保存、実際のURL、配信先を順番に確認して原因を絞ります。
- 公開したのに古い内容が出る。どのキャッシュを調べる?下書きと公開版を確かめたあと、データ・ページ・ブラウザーに残るコピーを分けて調べます。
- 公開先でエラーを起こし、ログから原因を見つけて直す練習用の500エラーを起こし、画面のリクエストIDとCloudflareのログを照合してから、設定を直します。
- サイトが止まったとき、最初に何をする?影響の確認から連絡・復旧・再発防止までを、慌てず進める順番で整理します。
- 保存すべきデータと復旧手順を整理するJSONの書き出し、サイト転送、障害からの復元を区別します。データベース、画像、コード、暗号化キーを一組で保存する考え方を学びます。
- バックアップから戻せるか、別の環境で確かめる復旧に必要な一式を揃え、公開中のサイトとは別の場所でデータと操作を確認します。
- CMSを復旧したあと、外部連携と権限を整えるCMSのバックアップを戻した後に、外部の最新データ・送信済み処理・失効した権限を照合してから連携を再開します。
- 更新のお知らせは、どこを読めばいい?リリース情報から、自分のサイトに関係する変更と必要な作業を見つけます。
- 新しいバージョンが出たら、今すぐ更新する?版番号の違いと更新内容を確認し、自分のサイトに必要な対応を判断します。
- 更新前の確認とアップデート手順更新予定を確認し、必要な復旧地点を用意してから新しい版を動かします。コード更新とデータベース移行の違いも説明します。
- 更新できたら、どこを確認すればいい?公開ページ・管理画面・記事・画像を同じ順番で確認し、更新の結果を記録します。
- 複数の公開作業とDB変更が重なったときの順序を決める古いビルドが後から公開される問題と、コード・DB変更の不一致を、順番と切り戻し条件で防ぎます。
- 前のコードへ戻して、データと画像が戻らないことを確かめるv1からv2へ更新した練習用Workerを切り戻します。コード・データベース・画像を別々に確認し、戻る範囲を理解します。