小さなテーマを一つ作る

既存の練習サイトに、サイト名と文章を表示するページを追加します。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の記事を一覧と詳細に表示します。

公式の参照元

関連ガイド

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

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