EmDashのやさしい用語集

CMS、コレクション、ローカル、デプロイ。よく出てくる言葉を、短い意味と具体例で調べられます。

目次

知らない言葉が出てきたときに、必要なところだけ読むページです。すべてを順番に覚える必要はありません。

まずは、各項目の太字の一文を読んでみてください。そのあとに、EmDashで使う場面や例を添えています。

よく探す言葉:CMS / コレクション / フィールド / Astro / Node.js / ローカル / デプロイ

ウェブサイトの基本

CMS

シーエムエス。サイトの記事や画像などを、管理画面から扱うための仕組みです。

記事を追加するたびにページのプログラムを書き直さなくても、用意された入力欄から中身を更新できるようにします。EmDashはCMSのひとつです。EmDash公式の紹介(別タブで開く)

ブラウザー

ウェブサイトを開いて見るためのアプリです。 Chrome、Safari、Edgeなどがあります。

EmDashの管理画面も、読者向けのページも、ブラウザーで開きます。管理画面を開いたときだけ、記事を書く人のための操作ができます。

URL

ユーアールエル。ウェブ上のページや画像などの場所を表す文字列です。

https://example.com/posts/coffee-tools/ のような形です。これは説明用の例です。ブラウザー上部のアドレス欄に表示される、ページの場所を思い浮かべてください。

ドメイン

インターネット上の接続先を名前で指定するものです。 上のURLの例では example.com が当たります。

ページごとの場所は、そのあとに続く /posts/coffee-tools/ などで表します。ドメインという名前を取得しただけで、記事の入ったサイトが完成するわけではありません。

サーバー

ブラウザーなどからの要求を受け取り、ページやデータを返す側のコンピューターやソフトです。

サイトを読むとき、ブラウザーがページを求め、サーバー側が応答します。練習中は、自分のパソコンの中でサーバー用のソフトを動かすこともできます。

ブラウザーとサーバーの関係は、MDNのウェブの仕組みの説明(別タブで開く)でも学べます。

記事と入力欄

管理画面

記事を書く人や、サイトを管理する人が使う操作画面です。

EmDashでは、記事の作成や画像の登録などを行います。見えるメニューやできる操作は、サイトの設定と、その人に与えられた権限で変わります。

コンテンツ

サイトで扱う中身のことです。 記事、商品説明、お知らせなどが当たります。

このガイドで「コンテンツを保存する」と書いていたら、まず「記事などの中身を保存する」と読み替えてみてください。

コレクション

同じ種類の情報をまとめて管理する入れ物です。

たとえば「記事」のコレクションに、記事を何本も保存します。「商品」なら商品名や価格、「イベント」なら開催日時など、その種類に合う項目を用意できます。

エントリー

コレクションの中に保存した、1件分の情報です。

「記事」の中なら記事1本、「商品」の中なら商品1件がエントリーです。記事を3本保存したら、エントリーは3件になります。

フィールド

1件の情報を構成する、個々の入力項目です。

記事のタイトル、本文、メイン画像などが当たります。「タイトルを書き換える」は値の編集、「タイトル欄そのものをなくす」はフィールドの変更です。

スラッグ

プログラムやURLで使う、識別用の名前です。

記事のURLでは coffee-tools、記事のコレクションでは posts のような名前を使う例があります。記事のスラッグとコレクションのスラッグでは用途が違うので、「何の名前か」も一緒に確認します。

コンテンツモデル

どんな種類の情報を、どんな項目で保存するかの設計です。

たとえば「記事にはタイトル・本文・画像を持たせる」と決めます。その設計が、管理画面の入力欄にも関わります。

コレクション・エントリー・フィールドの関係は、記事の入れ物と入力欄の表でも確認できます。仕様の出典はEmDash公式のコンテンツモデルの説明(別タブで開く)です。

メディア

サイトで使う画像、動画、音声、PDFなどのファイルです。

EmDashの「メディアライブラリ」は、登録したファイルを探したり選んだりする画面です。「記事の文字」と「その記事に使う写真」を分けて考えると、役割がわかりやすくなります。

タクソノミー

記事などを分類する仕組みです。 カテゴリやタグが、その例です。

「カテゴリ」という分類の中に「コーヒー」「読書」などの分類項目を用意し、記事に付けます。分類項目は、公式資料では term(ターム)とも呼ばれます。EmDash公式の分類ガイド(別タブで開く)

保存と公開

下書き

公開する前に、書いたり直したりしている内容です。

新しい記事の書きかけに加え、公開中の記事を直している内容も、下書きとして保存する場合があります。その場合、読者には今の公開版を見せたまま、修正版を準備できます。

公開

保存した内容を、読者に見せる版として使うことです。

EmDashの記事の「公開」は、サイト自体をインターネットへ設置する作業とは別です。自分のパソコンで練習中に記事を公開しても、それだけで世界中からサイトにアクセスできるようにはなりません。

プレビュー

公開前の内容が、ページ上でどう見えるか確認することです。

プレビューで確認するだけでは、公開版は変わりません。修正が見えないときは、下書きのプレビューと通常の公開ページのどちらを開いているかを確認してください。

リビジョン

ある時点の原稿を残した、変更履歴の記録です。

履歴を使う設定では、過去の内容を確認したり、下書きへ戻したりできます。記事の履歴を残すことと、サイト全体をバックアップすることは、別の目的です。

編集時の例は下書き・保存・公開の違いへ。状態の扱いはEmDash公式のContent Lifecycle(別タブで開く)を参照しています。

キャッシュ

一度用意したデータや応答を保存し、あとで再利用する仕組みです。

毎回同じ処理をしなくてよいので、表示を速くするためなどに使います。設定によっては古い表示がしばらく残ることがあり、更新確認では見直す対象になります。

サイトを作る道具

Astro

アストロ。ウェブサイトを作るための開発用の道具です。

EmDashのサイトでは、ページの作りをAstroで用意し、そこへEmDashが管理する記事などを表示します。両者の関係は最初の入門ガイドで説明しています。

テーマ

EmDashでは、サイト作りの出発点になるファイル一式です。

ページや共通部品、設定などを含むAstroのプロジェクトとして提供されます。作り始めたあとは、そのサイトのファイルを編集して仕上げていきます。EmDash公式のテーマの説明(別タブで開く)

プラグイン

EmDashに機能を追加するためのプログラムです。

たとえば、記事が保存されたときに処理を動かしたり、管理画面に機能を追加したりできます。方式によって、必要な設定や導入方法が変わります。EmDash公式のプラグインの説明(別タブで開く)

Node.js

ノード・ジェイエス。JavaScriptのプログラムを、ブラウザーの外で動かすためのソフトです。

自分のパソコンでEmDashの開発用サイトを動かすときにも使います。手順が指定するバージョンに合っているかを確認します。Node.js公式の紹介(別タブで開く)

npm

エヌピーエム。必要なプログラムの部品を取り寄せ、管理する道具です。

この部品を「パッケージ」と呼びます。ガイドのコマンドに出てくるnpmは、コマンド入力画面で使う道具を指します。npmという名前は、部品を配布する仕組みやウェブサイトにも使われます。npm公式の説明(別タブで開く)

ターミナル

文字で指示を入力し、プログラムを動かすための画面です。

Macの「ターミナル」アプリや、VS CodeのTerminalパネルなどが当てはまります。ウェブの検索欄とは別です。このサイトではわかりやすく「コマンド入力画面」とも呼びます。Windowsの練習では、VS Codeのこの画面の中でコマンドプロンプトを使います。

コマンドプロンプト

Windowsで、文字の指示を受け取って実行する道具です。

英語ではCommand Promptと書かれ、cmdという名前で表示されることもあります。このサイトのWindows用コマンドは、特に指定がなければこれを使います。VS Codeでの開き方から準備できます。

PowerShell

コマンドプロンプトと同じく、文字の指示を実行する道具の一つです。

VS CodeをWindowsで使うと、最初はPowerShellが開く設定になっています。コマンドプロンプトとは、一部の指示や変数の書き方が違います。このサイトの練習ではコマンドプロンプトを選んでください。VS Codeの公式説明(別タブで開く)

Windows Terminal

コマンドプロンプトやPowerShellを、中に開いて使うためのアプリです。

入力画面を用意するアプリと、その中で指示を実行する道具は別です。Windows Terminalを開いたときも、中身がコマンドプロンプトかPowerShellかで使う書き方が変わります。このサイトではVS Codeの入力画面を使うので、Windows Terminalを別途用意する必要はありません。Microsoftの説明(別タブで開く)

コマンド

コマンド入力画面へ入力する、文字の指示です。

node --version は、Node.jsのバージョンを表示する指示です。手順には、コマンドの文字だけでなく、実行する場所や、結果の確かめ方も書かれます。MDNのコマンドライン入門(別タブで開く)

プロジェクト

ひとつのサイトを作るための、ファイルや設定のまとまりです。

多くの場合、ひとつの作業用フォルダーとして扱います。「プロジェクトを開く」は、そのサイト一式が入ったフォルダーをコードエディターなどで開く意味で使います。

パス

ファイルやフォルダーなどの場所を表す書き方です。

src/pages/ なら、src の中にある pages フォルダーです。URLのドメインよりあとの /posts/coffee-tools/ のような部分もパスと呼びます。どの場所について話しているかを確認しましょう。

コードエディター

プログラムや設定のファイルを編集するためのアプリです。

Visual Studio Codeなどがあります。記事本文をEmDashの管理画面で書く作業と、サイトのファイルをコードエディターで直す作業は、目的が違います。作業場所の違いを読む

保存場所とサイトの公開

ローカル

このガイドでは、自分のパソコン上のことです。

「ローカルで試す」は、自分のパソコンでサイトを動かして確かめることです。localhost は、接続している端末自身を指す名前です。友人の端末で同じURLを開いても、あなたのパソコンを指しません。

本番環境

実際の利用者に、サイトを提供している環境です。

練習用のサイトと本番のサイトは、どちらのデータを編集しているか区別します。練習用に書いた記事が、自動的に本番へ移るわけではありません。

デプロイ

作ったプログラムや設定を、動かす環境へ配置して反映することです。

サイトをインターネット上で動かすときや、ページの作りを更新するときに出てきます。「記事を公開する」と「サイトのプログラムをデプロイする」は、操作の対象が違います。

データベース

情報を整理して保存し、必要なときに取り出す仕組みです。

EmDashでは、記事や設定などを保存します。データベースにはSQLiteやCloudflare D1などを使えます。画像ファイルそのものを保存するストレージとは役割が違います。EmDash公式のデータベースガイド(別タブで開く)

ストレージ

データを保存しておく場所のことです。

EmDashの「メディアストレージ」なら、アップロードした画像などの実体を置く場所です。Cloudflare R2や、ローカルのフォルダーなどを使う構成があります。EmDash公式のストレージガイド(別タブで開く)

バックアップ

元に戻す必要が出たときに備え、データなどを別に保存しておくことです。

EmDashでは、データベースだけでなく画像の実体なども保存対象です。「保存できた」と「そこから復元できる」を、分けて確認します。EmDash公式のバックアップガイド(別タブで開く)

環境変数

プログラムへ、動かす環境ごとの設定を渡す仕組みです。

たとえば、接続先のURLや、認証に使う秘密の値を渡します。環境変数に入れる内容が、すべて秘密というわけではありません。手元の開発環境では、.envファイルから渡す場合があります。Astro公式の環境変数の説明(別タブで開く)

Cloudflare

クラウドフレア。サイトを動かしたり、配信したりするためのサービスを提供しています。

EmDashの公式ガイドでは、プログラムを動かすWorkers、データベースのD1、画像などを保存するR2を組み合わせる構成を紹介しています。3つは、それぞれ担当する仕事が違います。公式のCloudflare公開ガイド(別タブで開く)

開発や自動化で出てくる言葉

この章の言葉は、別のガイドで見かけたときに調べてください。設定やプログラムの例を読む場面で使います。

Git

ギット。ファイルの変更を記録し、過去の状態を確認できるようにする道具です。

サイトのプログラムを、いつ、どう直したか管理するときに使います。EmDashのデータベースや画像まで、何もしなくても一緒にバックアップされるわけではありません。Git公式のバージョン管理の説明(別タブで開く)

API

エーピーアイ。プログラムから、別の機能を利用するための決まりや窓口です。

たとえば、人が管理画面のボタンを押す代わりに、プログラムから記事の一覧を取得する場面で使います。利用できる操作や、必要な認証は、APIごとに決まっています。MDNのAPIの説明(別タブで開く)

MCP

エムシーピー。AIを使うアプリなどと、外部の道具や情報をつなぐための共通のやり取りの決まりです。

EmDashには、MCP経由で記事を読んだり更新したりする操作があります。使える操作は、接続の設定と利用者の権限で決まります。EmDash公式のMCPの説明(別タブで開く)

テーマ・プラグイン制作の言葉

JSON

ジェイソン。項目名と値を組にして、情報をやり取りする書き方です。

{"title": "週末ノート"} なら、title という項目に「週末ノート」という値を持っています。文字列を二重引用符で囲み、複数の項目をカンマで区切ります。package.json やAPIの結果で見かけます。

関数

名前を付けて呼び出せる、処理のまとまりです。

getEmDashCollection("posts") は、「記事の一覧を取り出す処理を、postsを対象に呼び出す」という例です。関数を使うことで、その処理を毎回最初から書かずに済みます。

引数

ひきすう。関数へ渡す値です。

getEmDashCollection("posts") の "posts" が引数です。「どの記事を取り出すか」のように、処理に必要な情報を渡します。

戻り値

もどりち。関数が処理の結果として返す値です。

記事を取り出す関数なら、取得した記事や、失敗したかどうかの情報が戻ってきます。手順の「戻り値を確認する」は、受け取った結果を確認する意味です。

配列

はいれつ。複数の値を、順番に並べたものです。

["coffee", "books"] は2つの文字列を並べた例です。記事一覧も、複数の記事を配列として受け取り、1件ずつ表示する場面があります。

HTML

エイチティーエムエル。文章に、見出し・段落・リンクなどの役割を付ける書き方です。

<h1>は最も上位の見出し、<p>は段落です。Astroのファイルでも、画面に出す部分をHTMLに近い書き方で作ります。

CSS

シーエスエス。文字の大きさ、色、行間、余白など、画面の見た目を指定する書き方です。

本文を変えずに読みやすい幅へ整えたり、スマートフォンの画面に合わせたりするときに使います。

TypeScript

タイプスクリプト。JavaScriptに、値の種類を確かめるための情報を加えた言語です。

JavaScriptは、値を取得したり条件に応じて処理を変えたりするための言語です。TypeScriptでは「タイトルには文字列が必要」などをコード上で示し、編集・ビルド時に間違いを見つけやすくします。すべての動作を自動で保証するものではありません。

ビルド

書いたコードを、配布や実行に使う形へ組み立てる処理です。

npm run buildなどで行います。成功しても、インターネットへの配置や、実際の記事保存まで完了したことにはなりません。

seed

シード。新しいサイトを始めるときの、入力欄や初期データの定義です。

初期設定済みのサイトでseedファイルを変更しても、運用中の入力欄が自動で変わるわけではありません。項目変更を参照してください。

Portable Text

ポータブルテキスト。段落・見出し・リンクなどを、構造を持つデータとして保存する形式です。

EmDashの本文に使われます。HTML文字列とは違い、Astro側ではPortableTextなどの表示用部品に値を渡します。

フック

記事の保存など、決まったタイミングで処理を呼び出す仕組みです。

保存した後のcontent:afterSaveと、公開した後のcontent:afterPublishは別です。フックの使い方で選び方を説明しています。

サンドボックス

サイト本体から分離した実行環境で、プログラムを動かす仕組みです。

サンドボックス型のプラグインは、許可された窓口を通して記事などを扱います。ネイティブ型には同じ隔離の仕組みがないため、どの処理やデータに触れるかを、導入前に確認する必要があります。

runner

ランナー。サンドボックスの実行環境を用意し、プラグインを動かす仕組みです。

プラグインを登録するだけでは不十分で、Node.jsやCloudflareに合うrunnerの準備が必要です。

binding

バインディング。Cloudflareのプログラムと、データベースなどのサービスを結び付ける設定です。

たとえばコードで使うDBという名前を、実際のD1データベースへつなぎます。名前を変えるときは、設定とコードの両方を合わせます。

マイグレーション

保存済みのデータ構造を、新しい版に合わせる処理です。

EmDash内部の移行と、自分で追加した記事の入力欄の変更は別です。前のコードへ戻しても、適用済みのDB変更は自動では取り消されません。

scope

スコープ。認証トークンに許された操作の範囲です。

APIトークンは、プログラムが認証に使う秘密の文字列です。content:readなら記事を読む範囲を表します。利用者の役割による権限も別に確認されるので、scopeだけであらゆる操作ができるわけではありません。

外部サービスとの共存で使う言葉

MA

見込み客への案内などを自動化する道具です。 閲覧やフォーム利用をきっかけにメールを送る場合があります。CMSを移すときはタグと自動配信の条件を確認します。

CRM

顧客との関係や対応履歴を管理する道具です。 MAと同じメールアドレスが入っていても、どちらが正しい管理元かは別に決めます。顧客情報の管理元

GTM

Google Tag Managerの略で、サイトの計測タグなどを管理する道具です。 アクセスの集計そのものを行うGoogle Analyticsとは役割が違います。タグの設置場所

サイトがブラウザーへ保存させる小さな情報です。 ログインや計測などに使われますが、目的と送信する範囲はCookieごとに違います。同意とドメイン変更

セッション

一連の操作を同じ利用者によるものとして扱い、ログイン中などの状態を保つための仕組みです。 Cookieに識別用の値を入れる構成もあります。同じドメインでも、別システムのログインが自動で共通になるとは限りません。会員ログインとの共存

CSP

ページで許可する読み込み元などを決めるセキュリティの仕組みです。 Content Security Policyの略です。外部部品が止まる理由になっても、全部の制限を外さず必要な通信を調べます。埋め込みの問題

Webhook

あるサービスで起きたことを、別のサービスの受信先へ知らせる通知です。 再送や順番の違いをどう扱うかは、送受信の設計で決めます。通知の重複・逆順

SSO

一つの認証元を使って、複数のサービスへログインする仕組みです。 Single Sign-Onの略です。管理者向けと読者向けのログインは別に確認します。会社の認証

冪等性

べきとうせい。同じ処理を繰り返しても、1回行ったときと同じ結果になる性質です。 たとえば同じ受付通知が二度届いても、問い合わせは1件だけ登録します。再送の設計

復旧の目標を決める言葉

RPO

どこまでのデータの損失を許容するかという目標です。 1時間なら、障害が起きた時点からさかのぼって最大1時間分の更新を失う想定です。バックアップを1時間おきに取るだけで、必ず達成できるとは限りません。

RTO

業務やサービスを、どれくらいの時間で戻したいかという目標です。 たとえば「障害発生から2時間以内に、記事の閲覧と問い合わせの受付を再開する」と決めたら、RTOは2時間です。復元の練習で、実際にかかった時間と比べられます。

公式の参照元

関連ガイド

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

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