テーマの役割と制作の進め方
テーマは、保存した記事を読者向けの画面にする仕組み。文章、見た目、入力欄の役割を分けて、制作の順番を考えます。
目次
記事を保存しただけでは、見た目は決まらない
テーマは、保存した記事を読者にどう見せるかを決める仕組みです。たとえば「週末ノート」に書いたコーヒーの記事を、写真の大きなカードにするか、文字だけの一覧にするか、本文の幅をどれくらいにするかを決めます。
EmDashのテーマは、Astroというウェブ制作の仕組みで作るプロジェクトです。テーマの中には、ページの作り方、共通の部品、文字や色の指定、最初に用意する入力欄の定義などが入ります。
テーマ制作のガイドでは、まず自分のパソコンで動かすサイトに小さなページを作ります。用意されたサイトで記事を書くだけなら、テーマ制作を学ぶ必要はありません。
管理画面とテーマで、変えるものが違う
| やりたいこと | 主に操作する場所 |
|---|---|
| 記事のタイトルを直す | EmDashの管理画面 |
| 記事に写真を選ぶ | EmDashの管理画面 |
| 記事一覧を2列にする | テーマのコード |
| 写真をタイトルの上に置く | テーマのコード |
| 「所要時間」という入力欄を増やす | コンテンツの定義と、それを表示するテーマ |
テーマのコードは、パソコンのコードエディターで編集します。これは、プログラムや設定ファイルを編集するためのアプリです。ブラウザーに表示されているページの文字を直接編集する操作とは違います。
最初に知る言葉は、この4つ
HTMLは、見出し、段落、リンクなど、画面の内容に役割を付ける書き方です。<h1>は大きな見出し、<p>は段落、<a>はリンクを表します。
CSSは、文字の大きさ、余白、色などを指定する書き方です。HTMLで「見出し」と決めたものを、CSSで「この大きさで表示する」と整えます。
JavaScriptは、値を取り出したり、条件に応じて処理を変えたりする言語です。TypeScriptは、そこに「この値は文字」「この項目が必要」といった情報を加え、間違いに気づきやすくする仕組みです。
最初から全部を書く練習はしません。次のガイドで使う部分だけ、その場で説明します。
よく開くフォルダー
プロジェクトの一番外側にあるpackage.jsonと同じ階層から見た場所です。
| 場所 | 役割 | この章での使い方 |
|---|---|---|
src/pages/ | URLに対応するページ | 練習用ページを追加する |
src/layouts/ | 複数ページの共通の枠 | サイト名と本文の枠を作る |
src/components/ | 繰り返し使う部品 | 必要に応じてカードなどを分ける |
seed/seed.jsonなど | 新しいサイトの初期設定 | 入力欄の初期状態を確認する |
emdash-env.d.ts | 自動生成された型の情報 | 直接編集せず、再生成する |
たとえばsrc/pages/practice/index.astroを追加すると、通常は/practice/というURLのページになります。src/components/にファイルを置くだけでは、URLは増えません。ページからその部品を呼び出して使います。
この章の進め方
- ファイル編集の練習で、ファイルを作り、文字と色を変えます。
- 小さなテーマを一つ作るで、複数ページに使う共通の枠を作ります。
- 記事一覧と詳細ページで、管理画面に保存した記事を読み込みます。
- ページ部品で、編集者が内容を組み立てられる仕組みを知ります。
- 検索と分類ページで、記事を探す入口を増やします。
- 運用中の項目変更で、記事を残しながら入力欄を変える手順を確認します。
制作中は、記事が1件ある場合に加え、0件の場合、画像がない場合、長い日本語のタイトルでも表示を確認しましょう。内容の量や画像の有無が変わっても、表示が崩れないようにします。
配布できるテーマにするには
配布する前に、別の人が新しいサイトで使い始められるかを確認します。テーマを動かすために必要な部品(依存パッケージ)、最初に登録するデータ、使う入力欄、環境ごとの設定値(環境変数)の説明を揃えてください。配布するファイルに、個人のデータベース、メール送信の秘密鍵、実際の記事が紛れ込んでいないかも確認します。
EmDashのテーマ制作の全体像は公式のテーマ制作ガイド(別タブで開く)にあります。この章の例は、その仕組みを小さく分けて学ぶためのものです。