ファイルを1つ作って、文字と色を変えてみる
コードを貼る場所、ファイルの保存、ブラウザーでの確認を、小さな練習ページで体験します。
目次
コードは、VS Codeで作ったファイルの編集欄に貼り付けます。このガイドでは、練習用のページを1つ作り、文字と色を変えて、保存した結果をブラウザーで見るところまで進めます。
先にEmDashのローカル起動を終え、weekend-note をVS Codeで開いておきます。ファイル一覧に src と package.json が見える状態です。
以降の「コマンド入力画面」は、VS Codeのターミナルです。Windowsではコマンドプロンプトを選びます。入力画面の開き方を確認してください。
1. 練習用のファイルを作る
左側の一覧から src、その中の pages を開きます。pages を右クリックして New File(新しいファイル)を選び、hello.astro と入力します。
weekend-note/
└── src/
└── pages/
└── hello.astro.astro まで含めてファイル名です。もし同名のファイルがある場合は、hello-practice.astro など別名にします。その場合、あとで開くURLも /hello-practice/ に読み替えます。
2. ファイルへコードを貼り、保存する
作ったファイルの中央の編集欄に、次を全部コピーして貼り付けます。
<!doctype html>
<html lang="ja">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>はじめての練習</title>
</head>
<body>
<h1>週末ノートへようこそ</h1>
<p>自分で作ったページを、ブラウザーで見ています。</p>
</body>
</html>
<style>
body {
max-width: 40rem;
margin: 2rem auto;
padding: 0 1rem;
color: #222;
font-family: sans-serif;
line-height: 1.8;
}
h1 {
color: #0b57d0;
}
</style>Macは Command + S、Windowsは Ctrl + S で保存します。メニューの File → Save からも保存できます。今操作しているのは hello.astro の編集欄です。VS Codeの編集操作(別タブで開く)
3. ブラウザーで開く
サイトをまだ起動していなければ、weekend-note のコマンド入力画面で npm run dev を実行します。すでに起動している場合は、そのまま使います。
起動時に表示されたURLの末尾へ /hello/ を付けます。たとえば http://localhost:4321/hello/ です。このURLをブラウザーで開き、「週末ノートへようこそ」という青い見出しと、下の文章が見えるか確認します。
Astroでは、src/pages/hello.astro のようなページファイルを置くと、対応する /hello/ という場所から開けます。Astroのページの説明(別タブで開く)
4. 文章を一か所変えてみる
VS Codeに戻り、<h1> と </h1> の間だけを「休日の楽しみを集めよう」に変えて保存します。ブラウザーを確認し、表示が変わらなければページを再読み込みします。
h1 は見出し、p は段落を表す目印です。このような目印をタグと呼びます。多くのタグは、始まりの <h1> と終わりの </h1> で内容を挟みます。
ここでは日本語の文章の部分を変えます。タグの <、>、/ はそのままにしておくと、文章の役割を保って編集できます。
5. 見出しの色を変えてみる
ファイル末尾の h1 の指定を探します。
h1 {
color: #0b57d0;
}#0b57d0 を #222222 に変えて保存します。見出しが濃いグレーになれば、色の指定を変えられています。
h1 は変更対象、color は文字色、#222222 は色を表す値です。: は項目と値を区切り、; は指定の終わりを示します。こうした見た目の指定がCSSです。
上の短い囲みは、先ほどのファイルの一部分です。hello.astro 全体を短いCSSだけに入れ替えず、<style> の内側の該当箇所を編集してください。AstroのCSSの説明(別タブで開く)
この後のコード例の読み方
| ガイドに書いてあること | 作業する場所 |
|---|---|
| 「コマンド入力画面で実行」 | 指示を入力してEnterを押す画面 |
| 「このファイルの全体」 | 指定された新しいファイルへ、囲みの中を全部貼る |
| 「既存の設定へ追加」「抜粋」 | 開いているファイルの指定された部分へ追加・変更する |
Astroの例では、ファイルの先頭に --- で挟まれた部分が出てきます。そこには、ページを表示する前にデータを用意する処理を書きます。import は別のファイルや機能を読み込む指定です。今回の練習ページでは、表示前にデータを用意する処理がないため、この部分は使いません。Astroの構成(別タブで開く)
うまく表示されないとき
| 症状 | 確認すること |
|---|---|
| 404になる | ファイルが src/pages/hello.astro にあるか。URLとファイル名が対応しているか |
| 接続できない | サイトを起動したコマンド入力画面が動いているか |
| 古い文字のまま | 変更したファイルを保存したか。別のサイトやURLを開いていないか |
| エラー画面になる | タグやかっこを消していないか。表示されたファイル名と行番号を見る |
変更を戻すときは、編集欄でMacなら Command + Z、Windowsなら Ctrl + Z を使い、その後で保存します。ファイルを閉じた後など、元に戻せない場合は、このガイドの最初のコードと見比べます。
文章と色を変えられたら、次は小さなテーマを一つ作るへ。今回のページに続いて、複数のページで共通の枠を使う練習をします。作業を終えるときは、サイトを起動したコマンド入力画面で Control + C を押します。