本文へ移動
Senu English

最初のノートを書く

約 5 分で読めます

このサイトのページは、どれも content フォルダーにある Markdown のファイルです。Markdown は、いくつかの記号が書式になるプレーンテキストです。この章ではノートを一つ書き換え、もう一つ書き足して、Senu がそれをどう取り込むかを見ます。

1 分でわかる Markdown

サンプルのノートを書き換える

サイトにはサンプルのノートが付いています。ブラウザーで http://127.0.0.1:3000/ja/sample-note を開いて見てください。ファイルは content/ja/50-sample-note.md です。

エディターで content/ja/50-sample-note.md を開いてください (Visual Studio Code なら、ファイル、フォルダーを開く、で senu フォルダーを選び、左の一覧で content、ja、そのファイルの順に開きます)。ファイルの中身をすべて次の文章に置き換えて、保存してください。

# 書き換えたサンプルのノート

このノートはただの Markdown ファイル、`content/ja/50-sample-note.md` です。
タイトルとこの段落を書き換えました。

## 気づいたこと

- `#` で始まる行がページのタイトルになった。
- `-` で始まる行がこの箇条書きの項目になった。
- `cargo run` のようにバッククォートで囲んだ言葉はコードのように見える。

[最初の章](/ja/start)に戻る。

ブラウザーでページを再読み込みしても、何も変わりません。Senu はノートを動いているあいだではなくビルドするときに読むので、動いている Senu はビルドしたときのページを持ち続けます。Senu が動いているターミナルで Ctrl+C を押し、同じコマンドをもう一度実行してください。cargo run はファイルの変更に気づき、起動の前にビルドし直します。

cargo run --quiet -- site
senu: listening on http://127.0.0.1:3000

ブラウザーでページを再読み込みするか、二つ目のターミナルで確かめます。

curl -s http://127.0.0.1:3000/ja/sample-note | grep "<h1>"
<h1>書き換えたサンプルのノート</h1>

自分のノートを足す

ノートのファイル名は二つのことを決めます。名前は 51-my-first-note.md のように、2 桁の数字、ハイフン、小文字の英字・数字・単独のハイフンでできたスラッグ、そして .md の順に並べます。数字は章の一覧での位置を決め、スラッグはアドレスになります。このファイルなら http://127.0.0.1:3000/ja/my-first-note です。日本語のノートでも、ファイル名には英字を使います。

エディターで content/ja/51-my-first-note.md という名前の新しいファイルを作ってください (Visual Studio Code なら、ja フォルダーを右クリックして「新しいファイル」を選び、名前を入力します)。次の文章を入れて保存します。

# 最初のノート

今日は自分のコンピューターで Rust のプログラムを動かし、そのページをブラウザーで読んだ。

- プログラムの名前は Senu。
- ターミナルで Ctrl+C を押すまで動き続ける。

さっきと同じように Senu を再起動してください。Senu のターミナルで Ctrl+C を押し、同じコマンドを実行します。

cargo run --quiet -- site
senu: listening on http://127.0.0.1:3000

http://127.0.0.1:3000/ja/my-first-note を開いてください。タイトルの下に、読むのにかかる時間の目安が表示されています。この目安を計算する関数は、あとの章で作り直します。ノートは章の一覧にも、サンプルのノートのすぐ後ろに並んでいます。51 は 50 の次だからです。二つ目のターミナルで確かめます。

curl -s http://127.0.0.1:3000/ja/my-first-note | grep "<h1>"
<h1>最初のノート</h1>
curl -s http://127.0.0.1:3000/ja/ | grep my-first-note

最初のページには、章の一覧と目次の 2 か所にノートが載ります。

<li><a href="/ja/my-first-note">最初のノート</a></li>
<li><a href="/ja/my-first-note">最初のノート</a></li>

ノートをどこかに登録する必要はありませんでした。Senu はビルドのときに content/ja にある .md ファイルをすべて見つけるので、ファイルを足して再起動するだけで十分です。

演習

ノートに Rust の公式サイト https://www.rust-lang.org/ へのリンクを足し、Senu を再起動して、ブラウザーでリンクをたどってください。

解答. 下の最後の行のようなリンクの行を content/ja/51-my-first-note.md に足して、ファイルを次のようにします。

# 最初のノート

今日は自分のコンピューターで Rust のプログラムを動かし、そのページをブラウザーで読んだ。

- プログラムの名前は Senu。
- ターミナルで Ctrl+C を押すまで動き続ける。

次は [Rust の公式サイト](https://www.rust-lang.org/)でもっと読んでみたい。
cargo run --quiet -- site
senu: listening on http://127.0.0.1:3000
curl -s http://127.0.0.1:3000/ja/my-first-note | grep rust-lang.org
<p>次は <a href="https://www.rust-lang.org/">Rust の公式サイト</a>でもっと読んでみたい。</p>

うまくいかないとき

次へ: Senu が「だめ」と言うとき