ファイルを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 を押します。

公式の参照元

関連ガイド

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

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