小さなテーマを一つ作る
既存の練習サイトに、サイト名と文章を表示するページを追加します。Astroファイルの読み方から順番に説明します。
目次
まず、文章だけのページを作る
このガイドでは、自分のパソコンで動く「週末ノート」に/practice/という練習ページを追加します。ページを表示しながら、サイト名などの共通部分と、ページごとに変わる本文をどう組み合わせるかを学びます。
前提は、ローカル起動を終えたNode.js用のプロジェクトです。Node.js 22.23.4以上、EmDash 1.4.0を対象にしています。ファイルを作る・貼り付ける・保存する操作は、ファイル編集の練習で先に試せます。
1. プロジェクトを開く
コマンドはVS Codeのターミナルで入力します。Windowsではコマンドプロンプトを選びます。入力画面の開き方
コードエディターでweekend-noteフォルダーを開きます。中にpackage.jsonとsrcが見える状態にしてください。コマンド入力画面もそのフォルダーに移動し、まだ起動していなければ次を実行します。
npm run devコマンド入力画面に表示されたローカルURLを控えます。以下ではhttp://localhost:4321を例にしますが、実際に表示された番号を使います。
2. 共通の枠を作る
src/layouts/LearningLayout.astroを作ります。layoutsフォルダーがなければ、エディターで先に作ってください。次がこのファイルの全体です。
---
import { getSiteSettings } from "emdash";
interface Props {
title: string;
}
const { title } = Astro.props;
const settings = await getSiteSettings();
const siteName = settings.title || "週末ノート";
---
<!doctype html>
<html lang="ja">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>{title} | {siteName}</title>
</head>
<body>
<header><a href="/practice/">{siteName}</a></header>
<main><slot /></main>
<footer>学んだことを、一つずつ。</footer>
</body>
</html>
<style is:global>
body {
margin: 0;
color: #222;
background: #fff;
font-family: sans-serif;
line-height: 1.8;
overflow-wrap: anywhere;
}
header, main, footer {
max-width: 48rem;
margin-inline: auto;
padding: 1.5rem;
}
main { min-height: 50vh; }
a { color: inherit; }
a:hover { text-decoration: none; }
img { max-width: 100%; height: auto; }
</style>最初の---で挟まれた部分は、表示前に行う処理です。importは使う機能を読み込む指定、await getSiteSettings()はEmDashからサイト設定を受け取る処理です。
Astro.propsには、この枠を使うページから渡された値が入っています。ここではtitleというページ名を受け取ります。{title}や{siteName}は、その場所に値を表示する書き方です。
<slot />には、ページごとの本文が入ります。共通のヘッダーとフッターの間に、別の文章を差し込めるようにしています。末尾のstyleは、この練習ページの見た目を指定しています。
3. 枠の中に入れるページを作る
次にsrc/pages/practice/index.astroを作り、以下を保存します。
---
import LearningLayout from "../../layouts/LearningLayout.astro";
---
<LearningLayout title="練習ページ">
<h1>週末の楽しみを、少しずつ。</h1>
<p>コーヒーや本について、学んだことを残す場所です。</p>
</LearningLayout>../../は、ファイルの場所からフォルダーを2つ上がる指定です。practiceからpagesへ、さらにsrcへ戻って、layouts内のファイルを読み込んでいます。
title="練習ページ"は、先ほどの枠に渡すページ名です。h1とpの部分が、枠のslotに入ります。
4. ブラウザーで確かめる
ローカルURLの末尾に/practice/を付けて開きます。例はhttp://localhost:4321/practice/です。確認する状態は次の3つです。
- 画面に、管理画面で設定したサイト名と本文が表示される。
- ブラウザーのタブ名が「練習ページ | サイト名」になる。
- ブラウザーを狭くしても、本文が画面の外にはみ出さない。
本文の一文を変えて保存し、ブラウザーに反映されるかも確認します。ここで変えた文章は、CMSの記事ではなく、ファイルに直接書いた文章です。
表示できないとき
404は、そのURLのページが見つからない状態です。ファイルがsrc/pages/practice/index.astroにあるか、URLのpracticeが同じ綴りか確認します。
Cannot find moduleのような表示なら、読み込むファイルの名前や../../の数を確認します。getSiteSettingsで失敗する場合は、EmDashの初期設定が終わっているか、もとのトップページと管理画面が開けるかを先に確かめます。
この枠は学習用です。検索結果向けの説明、共有画像、公開前に表示を確認するプレビューの仕組みなどは省いています。実際に公開するテーマでは、公式資料で方法を確認し、検索結果向けの設定(SEO)とプレビューの仕組みも組み込んでください。
終わるときはコマンド入力画面でControl + C、再開するときは同じフォルダーでnpm run devです。次はCMSの記事を一覧と詳細に表示します。