本文へ移動
Senu English

作ったものと、この先の学び方

約 5 分で読めます

あなたは Rust のプログラムを起動し、そのページをブラウザーで読み、Markdown でノートを書き、メッセージを通して Senu の決まりを知り、関数の一つをテストから先に作り直しました。どの手順も同じ小さなプログラムを使っていました。

覚えておくこと

正直な限界

動かしたプログラムは Senu ライブラリのデモで、製品ではありません。このサイトはノートをビルドするときにしか読みません。アカウントもデータベースもなく、ブラウザーからノートを書き換える方法もありません。動作は Linux でしか確かめていません。サービスを作るときに使うのは、その裏にあるライブラリです。ライブラリガイドはそこから始まります。

この先の学び方

演習

ここで学んだことを、自分の言葉でもう一つノートに書いてください。番号は 53 にして、最初のノートからリンクします。

解答. content/ja/53-what-i-learned.md のような名前で、1 行目がタイトルのファイルなら何でもかまいません。content/ja/51-my-first-note.md に [学んだこと](/ja/what-i-learned)を読む。 のような行を書いてリンクし、Senu を再起動してリンクをたどってください。

発展: 見た目を変える

Senu のページの見た目は、Tailwind CSS から来ています。templates/*.html に書かれた bg-white (白い背景) のような小さなクラスです。Tailwind はそこで見つけたクラスの CSS の規則だけを assets/ui.generated.css に書き出し、Cargo はコミット済みのそのファイルを Senu に組み込みます。だからここまではほかの道具が要りませんでした。クラスを変えるには、Node.js 24 とそれに付く npm が一度だけ必要です。公式サイトからインストールし、確かめます。

node --version

Ctrl+C で Senu を止めます。エディターで templates/site_base.html を開き、<header class="border-b border-gray-200 bg-white"> の行を探します。その行の bg-white を bg-rose-100 に書き換え、ファイルを保存します。これで上の帯の背景が薄いローズ色になります。rose はまだどのテンプレートにも使われていません。すぐ上のスキップリンクの行にも bg-white がありますが、そちらはそのままにします。下の枠は同じ変更を差分 (diff) で示したものです。- で始まる行が元の行、+ で始まる行が新しい行で、空白で始まる行は場所を示す変わらない行です。-、+、行頭の空白は入力しません。

--- a/templates/site_base.html
+++ b/templates/site_base.html
@@ -11,3 +11,3 @@
 <a href="#main" class="absolute -top-16 left-2 z-10 border-2 border-blue-700 bg-white px-3 py-2 text-blue-700 underline focus:top-2"><%= frame.labels.skip %></a>
-<header class="border-b border-gray-200 bg-white">
+<header class="border-b border-gray-200 bg-rose-100">
 <div class="mx-auto flex max-w-6xl flex-wrap items-baseline justify-between gap-x-6 gap-y-2 px-5 py-3">

スタイルシートには新しいクラスの規則がまだないので、一致した行を数える grep -c は 0 を表示し、終了ステータス 1 で終わります。

grep -c bg-rose-100 assets/ui.generated.css
0

npm ci は package-lock.json に書かれたとおりの道具を一度だけインストールし、--silent はその報告を隠します。npm run css は、クラスを変えるたびにスタイルシートを作り直します。

npm ci --silent
npm run css

> css
> tailwindcss -i assets/ui.css -o assets/ui.generated.css --minify

≈ tailwindcss v4.3.3

Done in 0ms

grep -o は一致した部分だけ、ここでは新しい規則を表示します。

grep -o '\.bg-rose-100{[^}]*}' assets/ui.generated.css
.bg-rose-100{background-color:var(--color-rose-100)}

Senu をもう一度起動し、http://127.0.0.1:3000/ を再読み込みすると、上の帯がローズ色になっています。

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

テンプレートと assets/ui.generated.css は一緒にコミットします。そうすれば Node のない読者にも同じ見た目が届きます。すべてのページのフォントや色を変えたいときは、assets/ui.css の @theme ブロックを編集し、もう一度 npm run css を実行します。ただし記事の中のリンクは別です。Typography はそこで自分の色を持つので、記事の中のリンクの色は @theme では変わりません。templates/site_base.html の <main> に prose-a: のクラスを付ければ変わります。