写真付きの記事一覧を、練習用サイトで作る
教材を起動し、写真がある記事とない記事を同じ一覧に表示します。16ページの実習はここから始めます。
目次
管理画面に入れた写真は、記事のタイトルと一緒に一覧へ表示できます。この実習では「週末ノート」という小さなサイトを動かし、写真の有無で表示を切り替えます。
完成した教材を用意しています。まず動くものを見てから、どのファイルが表示を作っているのかを確かめましょう。HTMLやJavaScriptを最初から書ける必要はありません。
練習用サイトを準備する
対象は EmDash 1.4.0 / Astro 7.4.5 / Node.js 24.22.1 です。macOSで実行確認しました。Windowsの入力例はコマンドプロンプト用ですが、Windows実機ではまだ確認していません。パソコンの準備を参考にNode.jsとVS Codeを用意してください。
- ZIPを展開します。
emdash-technical-labsというフォルダーができます。 - VS Codeで「ファイル → フォルダーを開く」を選び、そのフォルダーを開きます。
- 「ターミナル → 新しいターミナル」を選びます。画面下部に文字を入力する場所が出ます。
- Windowsは入力画面右上のメニューで Command Prompt(コマンドプロンプト) を選びます。Macは通常のzshで進められます。
- 次を1行ずつ入力し、その都度Enterを押します。最初の
node -vでv24.22.1を基準に確認し、古い場合はNode.jsの準備に戻ります。
node -v
cd publish-check
npm ci
npm run build
cd ../weekend-note
npm ci
npx emdash seed seed/seed.json
npm run devcd は作業するフォルダーを移す命令です。npm ci は教材で指定した版の部品をそろえます。初回はインターネット接続が必要です。npm run build はプラグインのコードを実行できる形にします。seed は練習用の記事や入力欄を用意する命令です。
最後に http://127.0.0.1:4350 が案内されれば起動できています。4350が使われていたら、先に別の練習サイトが起動していないか確認してください。起動表示の番号が違う場合は、この後に開くURLの番号もそろえます。
起動用の画面は開いたままにします。続けて別のコマンドを実行したいときは、VS Codeで新しいコマンド入力画面を開き、weekend-noteへ移動してください。起動画面が入力待ちへ戻るかどうかは、実行環境によって異なります。終了時の操作は、このページ末尾で説明します。
初回だけ、ブラウザーで次のURLを開きます。
http://127.0.0.1:4350/_emdash/api/setup/dev-bypass?redirect=/_emdash/admin手元の開発サイトで使う特別なログイン方法です。本番サイトには使いません。2回目からは http://127.0.0.1:4350/_emdash/admin を開いてください。 初回用URLを繰り返すと、教材のメニューが初期状態に戻る場合があります。
起動時には weekend-note/emdash-env.d.ts も自動で作られます。これは、入力欄の名前や値の種類をコードエディターなどへ伝える「型情報」のファイルです。後で npm run check を使うときは、先にここまでの起動と管理画面の確認を済ませてください。
用意されたデータを見る
管理画面の「記事」を開きます。「週末の記録 01」から「週末の記録 12」までの公開記事と、「公開しない練習用の下書き」が入っています。この実習での「公開」は、手元のサイトに表示することです。インターネットへ配信する作業ではありません。
| 入力欄 | コードでの名前 | 用途 |
|---|---|---|
| タイトル | title | 一覧の見出し |
| 要約 | excerpt | 一覧に添える短い説明 |
| 写真 | featured_image | 一覧の画像 |
| 本文 | content | 記事詳細の文章 |
| 関連記事 | related_posts | 他の記事へのつながり |
教材では記事の言語設定を初期値のEnglishのままにしています。日本語の本文は書けます。ここでは言語の切り替えを行わず、すべて同じ設定で進めます。
1. 管理画面で写真を入れる
「週末の記録 01」を開き、「写真」に教材の weekend-note/exercises/sample.png を選びます。単色の練習用画像です。自分で用意した写真でも構いません。画像の説明を入力できる場合は、内容が伝わる短い文章を入れます。
保存が終わったら「変更を公開」を押し、確認画面でも「変更を公開」を押します。保存しただけでは、公開中の一覧へ変更が出ない場合があります。
ブラウザーで http://127.0.0.1:4350/cards/ を開きます。01の記事だけに画像が付き、他の記事はタイトルと要約だけで表示されれば成功です。
登録した写真のID、元の寸法、代替テキストは、画像の情報をCLIで調べる方法でも確認できます。
2. 一覧を作るコードを見る
VS Codeで weekend-note/src/pages/cards.astro を開きます。教材には次のコードが入っています。別の内容に変えてしまった場合は、ファイル全体をこれで戻せます。
---
import { getEmDashCollection } from 'emdash';
import { Image } from 'emdash/ui';
import Layout from '../layouts/Layout.astro';
const { entries, error } = await getEmDashCollection('posts', {
limit: 20,
orderBy: { published_at: 'desc' },
});
if (error) {
return new Response('記事を読み込めませんでした。', {
status: 500,
});
}
---
<Layout title="写真付きの記事一覧">
<h1>写真付きの記事一覧</h1>
{entries.length === 0 && (
<p>公開中の記事はまだありません。</p>
)}
<ul>
{entries.map(post => (
<li>
{post.data.featured_image && (
<Image image={post.data.featured_image} />
)}
<a href={`/posts/${post.id}/`}>
{post.data.title}
</a>
<p>{post.data.excerpt}</p>
</li>
))}
</ul>
</Layout>getEmDashCollection は記事の一覧を読む命令です。entries に記事、error に取得失敗の情報が入ります。limit: 20 は最大20件、published_at: 'desc' は公開日時の新しい順です。
post.data.featured_image && ... は「写真が入っているときだけ、この部分を出す」という条件です。写真がない記事には、壊れた画像の印を出しません。Image はEmDashの画像情報を受け取って表示する部品です。
post.id は、公開向けの取得結果で記事URLに使う識別子です。管理用のIDとは使い分けます。リンク先を押すと、教材にある詳細ページが開きます。
写真の代替テキスト・表示サイズ・読み込み優先度は、Image 部品に渡す値で指定できます。
3. 表示の条件を確認する
一覧を見て、写真を入れた記事には画像が付き、写真がない記事には画像が出ないことを確認します。下書きはこの一覧に出ません。limit: 20 を limit: 3 に変えて保存すると、表示件数を3件にできます。確認後は20へ戻してください。
画像が出ない場合は、写真の選択だけで止まらず「変更を公開」まで進んだかを見ます。ページ自体が開かない場合は weekend-note で npx astro dev status を実行し、起動しているURLを確認します。
公開中の記事を読む方法は公式のコンテンツ取得ガイド(別タブで開く)にも載っています。次は10件ずつのページ送りへ進めます。
終了するとき・次回続けるとき
npm run devを実行した画面が入力待ちに戻っていなければ、その画面でControl + Cを押して停止します。入力待ちに戻ったあともサイトが動き続けている場合は、weekend-noteでnpx astro dev stopを実行します。次回は同じフォルダーでnpm run devを実行してください。初期データを入れるseedコマンドを繰り返す必要はありません。