テーマの役割と制作の進め方

テーマは、保存した記事を読者向けの画面にする仕組み。文章、見た目、入力欄の役割を分けて、制作の順番を考えます。

目次

記事を保存しただけでは、見た目は決まらない

テーマは、保存した記事を読者にどう見せるかを決める仕組みです。たとえば「週末ノート」に書いたコーヒーの記事を、写真の大きなカードにするか、文字だけの一覧にするか、本文の幅をどれくらいにするかを決めます。

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. ファイル編集の練習で、ファイルを作り、文字と色を変えます。
  2. 小さなテーマを一つ作るで、複数ページに使う共通の枠を作ります。
  3. 記事一覧と詳細ページで、管理画面に保存した記事を読み込みます。
  4. ページ部品で、編集者が内容を組み立てられる仕組みを知ります。
  5. 検索と分類ページで、記事を探す入口を増やします。
  6. 運用中の項目変更で、記事を残しながら入力欄を変える手順を確認します。

制作中は、記事が1件ある場合に加え、0件の場合、画像がない場合、長い日本語のタイトルでも表示を確認しましょう。内容の量や画像の有無が変わっても、表示が崩れないようにします。

配布できるテーマにするには

配布する前に、別の人が新しいサイトで使い始められるかを確認します。テーマを動かすために必要な部品(依存パッケージ)、最初に登録するデータ、使う入力欄、環境ごとの設定値(環境変数)の説明を揃えてください。配布するファイルに、個人のデータベース、メール送信の秘密鍵、実際の記事が紛れ込んでいないかも確認します。

EmDashのテーマ制作の全体像は公式のテーマ制作ガイド(別タブで開く)にあります。この章の例は、その仕組みを小さく分けて学ぶためのものです。

公式の参照元

関連ガイド

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

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