記事の入れ物と入力欄を知ろう

コレクション、フィールド、エントリー。管理画面で出てくる3つの言葉を、同じ記事の例で説明します。

目次

記事を書く画面を開くと、タイトル、本文、画像など、いくつかの入力欄が並んでいます。

記事をまとめる入れ物が「コレクション」、タイトルなどの入力項目が「フィールド」、保存した記事1本が「エントリー」です。 同じ記事の例を使って、この3つの違いを見ていきましょう。

まず、記事を2本並べてみる

架空のブログ「週末ノート」に、次の2本を載せたいとします。表の内容は説明用の例です。

タイトル短い紹介文メインの画像
はじめてのコーヒー道具休日の一杯を楽しむ道具を紹介します。コーヒーカップの写真
雨の日の読書時間家で本を読む時間の楽しみ方を紹介します。本の写真

どちらの記事にも、「タイトル」「短い紹介文」「メインの画像」があります。内容は違っていても、入力する項目の種類は同じです。

EmDashでは、このように同じ種類の情報を、同じ形でそろえて保存することができます。

3つの言葉を、この表に当てはめる

コレクションは、同じ種類の情報を入れる場所

上の2本を入れる「記事」というまとまりが、コレクションです。

ほかに、会社の「お知らせ」や、お店の「商品」を管理したければ、それぞれの情報に合うコレクションを用意できます。

英語の管理画面では、記事が Posts と表示されることがあります。名前や、最初からあるコレクションは、サイトで使うひな型と設定によって変わります。

フィールドは、タイトルや本文などの1項目

「タイトル」「短い紹介文」「メインの画像」のような入力項目を、フィールドと呼びます。

表でいうと、縦の列の名前に当たります。1つの記事について、何を入力してほしいかを決めるものです。

エントリーは、実際に保存した1件

「はじめてのコーヒー道具」という記事1本が、エントリーです。

記事をもう1本保存すると、同じ「記事」のコレクションにエントリーが1件増えます。

この3つの関係は、公式のコンテンツモデルの説明(別タブで開く)でも基本として扱われています。

用語今の例に置き換えると
コレクション記事をまとめて管理する入れ物
フィールドタイトルや紹介文などの入力項目
エントリー入れ物の中に保存した記事1本

入力欄には、情報に合う種類がある

短いタイトルと長い本文では、入力しやすい形が違います。画像には、文字を書く欄よりも、画像を選ぶ欄が必要です。

この「どんな情報を扱う欄か」を 型 と呼びます。

入れたい情報欄の種類の例その形にする理由
記事のタイトル短い文字列短い名前を入力しやすくする
記事の本文リッチテキスト見出しや太字などを付けて文章を書く
メインの画像画像登録した画像を選ぶ
定員整数小数を使わない人数を扱う
開催日時日時日付と時刻として扱う

「リッチテキスト」は、見出し、太字、リンクなどを使える文章のことです。EmDashの設定では portableText という型名が出てきます。本文を書く段階では、「書式のある文章を扱う欄」と理解できれば十分です。公式のフィールド型一覧(別タブで開く)

画像は、登録済みのファイルを探せる「メディアライブラリ」から選ぶ仕組みがあります。サイトを作る人が画像を選ぶ欄を用意し、記事を書く人は画像ファイルを登録して、その欄で選びます。公式のメディアライブラリの説明(別タブで開く)

「必須」にするのは、空だと困る項目

項目には、入力を必須にする設定があります。

たとえば、タイトルのない記事は見分けにくいので、タイトルを必須にする、と考えられます。一方、すべての記事に写真を付ける予定がなければ、画像は任意にする選択もあります。

入力欄の数や必須にする項目は、サイトごとに決めます。書く人が毎回使う情報から考えると、不要な欄を増やさずに済みます。

このガイドで練習用のブログを設計するなら、まずはタイトルと本文を中心に考えます。これは説明を進めるための方針で、EmDashがすべてのサイトに要求する項目ではありません。

カテゴリは、記事につける分類

「コーヒーの記事」と「読書の記事」があるとき、カテゴリで分類できます。

コーヒーも読書も、同じ「記事」のコレクションに入れたままで構いません。そこに「コーヒー」「読書」という分類を付けます。

分けたいもの考え方の例
記事と商品入力したい項目が違うので、別のコレクションを検討する
コーヒーの記事と読書の記事同じ記事のコレクションで、カテゴリを分ける

カテゴリやタグのような分類の仕組みを、まとめて タクソノミー と呼びます。分類の名前や、どのコレクションで使うかは、サイトに合わせて設定します。公式の分類ガイド(別タブで開く)

表示する名前と、プログラム用の名前がある

管理画面では「記事」と表示していても、内部では posts のような名前で識別することがあります。この識別用の名前を スラッグ と呼びます。

コレクションやフィールドのスラッグは、プログラムがその情報を探すためにも使います。たとえば「記事」の入れ物を探すときに、画面上の日本語表示ではなく、posts という名前を使います。

記事1本のURLに使うスラッグもありますが、それは別の役割です。/posts/coffee-tools/ の coffee-tools のように、記事を識別する部分になります。

何のスラッグなのかを一緒に読むと、混乱を減らせます。コレクションやフィールドのスラッグは、公式資料では作成後に管理画面から変更できない識別名として扱われています。公式のコレクションの説明(別タブで開く)

入れ物の設計を、コンテンツモデルと呼ぶ

「記事のコレクションには、タイトルと本文と画像を持たせる」。このように、保存する情報の形を決めたものが コンテンツモデル です。「何を、どの項目に分けて保存するかの設計」と読んでください。

記事を書く人は、その設計で用意された欄に入力します。サイトを作る人は、入力された情報を、どこにどう表示するかを決めます。新しい入力欄に書いた情報は、ページ側にも表示する処理を用意して初めて読者に見えます。

なお、入力した文字を直すことと、入力欄そのものを削除することは影響が違います。フィールドを削除すると、その項目に保存されていた各記事の値も失われます。運用中の入力欄を変える作業は、記事の編集と分けて計画します。公式のモデル変更の説明(別タブで開く)

次は、書いた記事の状態を見てみよう

ここまでで、「記事の入れ物を選び、用意された欄に入力し、1件保存する」という流れが見えてきました。

次は、下書き・保存・公開の違いへ進みます。書いた記事が、いつ読者に見えるようになるのかを確認しましょう。

公式の参照元

関連ガイド

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

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