テンプレート

新しいノートを書くときは、近い形の snippet から始めます。公開前に title、description、本文、cell ID を置き換えてください。

通常ノート

説明と静的な code example だけで十分な topic に使います。

---
title: Topic name
description: Explain what this note covers in one sentence.
---

Start with the context readers need before the details.

## Background

Explain why this topic matters.

## Example

```rust
fn main() {
    println!("hello");
}
```

## Summary

Summarize the key points.

実行可能ノート

読者が parameter を変えて出力を確認する topic に使います。

---
title: Computation note
description: A note where readers can change inputs and inspect output.
---

Explain the model or computation before the cell.

```rust
//| id: unique-rust-cell-id
//| title: Calculate with Rust
//| run: reactive
//| crates: []
//| inputs:
//|   value: { type: range, label: value, min: 0, max: 10, step: 1, value: 3 }
println!("value = {value}");
```

Explain what changed in the result and what readers should notice.

Haskell 実行可能ノート

standard library の Haskell example と text output に使います。

---
title: Haskell note
description: A note where readers can change Haskell inputs and inspect output.
---

Explain the computation before the cell.

```haskell
--| id: unique-haskell-cell-id
--| title: Calculate with Haskell
--| run: reactive
--| inputs:
--|   count: { type: integer, label: count, min: 1, max: 8, step: 1, value: 4 }
import Data.List (intercalate)

let values = take count [1, 3 ..]
putStrLn (intercalate ", " (map show values))
```

Explain what readers should notice in the output.

図解ノート

構造、状態、手順を code よりも図で説明したいときに使います。

---
title: Diagram note
description: A note that explains structure or flow with Mermaid.
---

Explain how to read the diagram.

```mermaid
sequenceDiagram
  participant Reader as Reader
  participant Page as Documentation
  Reader->>Page: Open the page
  Page-->>Reader: Show the diagram and prose
```

Summarize the responsibility split or flow.

メディア付きノート

スクリーンショット、参照画像、補足 PDF に使います。

---
title: Media note
description: A note that uses images and PDFs.
---

![Result screenshot](/media/examples/sample.png)

<iframe class="media-frame" src="/media/examples/sample.pdf" title="Supplemental PDF"></iframe>

[Open the PDF in a new tab](/media/examples/sample.pdf)

日英ページの組

英語と日本語で同じ route を使います。

content/docs/features/example.mdx
content/docs/ja/features/example.mdx

翻訳で文章や label を調整する場合でも、例と cell ID はできるだけ揃えます。