Skip to the article
Senu 日本語

When Senu says no

About 4 min read

Senu checks every note before it starts serving. When a note breaks a rule, Senu prints what is wrong and where, and stops, so a broken page never reaches the browser. In this chapter you make a scratch note, break it on purpose in several ways, read each message, and finally delete it.

First stop Senu: press Ctrl+C in the terminal where it runs. Keep the second terminal open.

A note without a title

In your editor, create the file content/en/52-scratch.md with this text, which has no title line:

This scratch note forgot its title.

In the first terminal, start Senu:

cargo run --quiet -- site

Instead of the listening line, Senu prints:

senu: content/en/52-scratch.md:1: the first block must be a level-1 heading, such as `# My note`

Read it from left to right: the program that complains (senu), the file, the line in that file (1), and what is wrong. The prompt comes back at once, because Senu stopped. Programs also report success or failure with a number called the exit status: 0 means success and anything else means failure. Senu uses 2 for problems that you can fix in its input; typing echo $? right after a command prints that command's exit status.

A link that is not allowed

Give the note a title, and add a link that would run code instead of opening a page. Replace the content of content/en/52-scratch.md with:

# Scratch

[Click me](javascript:alert(1))
cargo run --quiet -- site
senu: content/en/52-scratch.md:3: the link "javascript:alert(1)" is neither a page of this site, such as "/", nor an https:// address

Senu accepts two kinds of link only: the exact address of a page of this site, such as /start or /ja/start, and an address that starts with https://. Everything else is refused, because a link is the easiest way to smuggle something unexpected into a page.

HTML is shown, not run

Markdown files may contain HTML tags, but Senu never hands them to the browser as HTML. Replace the content of content/en/52-scratch.md with:

# Scratch

<script>alert("hi")</script>

This time Senu starts:

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

Open http://127.0.0.1:3000/scratch. The tag appears as text in a code box and does not run. The second terminal shows how: the angle brackets became &lt; and &gt;, which a browser displays as < and > but never runs.

curl -s http://127.0.0.1:3000/scratch | grep alert
<pre><code>&lt;script&gt;alert("hi")&lt;/script&gt;

A name that breaks the rule

Stop Senu with Ctrl+C. Rename the file to 52-Scratch.md, with a capital S: in your editor, right-click the file and choose Rename. You can do the same in the terminal with mv, which moves a file and so can also rename it:

mv content/en/52-scratch.md content/en/52-Scratch.md
cargo run --quiet -- site
senu: content/en/52-Scratch.md: the file name must be two digits, a hyphen, a slug of lowercase letters and digits joined by single hyphens, then .md, such as 51-my-note.md

Delete the scratch note

Delete content/en/52-Scratch.md in your editor (right-click, Delete), or in the terminal with rm, which removes a file for good:

rm content/en/52-Scratch.md

Start Senu again:

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

The scratch page is gone. -w "\n" makes curl print a line break after the answer, so that the prompt starts on a new line:

curl -s -w "\n" http://127.0.0.1:3000/scratch
Not Found

It has left the chapter list too. When grep finds nothing, it prints nothing, and its exit status is 1:

curl -s http://127.0.0.1:3000/ | grep scratch

Exercise

Stop Senu, create content/en/51-tasks.md containing the line # Tasks, and start Senu again. Which rule does the new file break, and how do you fix it?

Solution. The file content/en/51-tasks.md is:

# Tasks
cargo run --quiet -- site
senu: content/en/51-tasks.md: the number 51 is already used by content/en/51-my-first-note.md

Two notes in the same language cannot share a number, because the number decides the order. Give the new note a free number, such as 53-tasks.md, or delete it, here with rm:

rm content/en/51-tasks.md

If something goes wrong

Every message names the file. The most common ones are:

If Senu seems to ignore a change even after a restart, run cargo clean -p senu, which deletes Senu's own build results, and start it again.

Next: your first Rust function.