konoma 0.18.0 - Docs.rs

# konoma チュートリアル — 触りながら覚える

[English version](./tutorial.md) ← `Tab` でこのリンクをフォーカスし、`Enter` で開けます。

このファイルは konoma 自身で読む前提で書かれています。つまり、ここで説明する機能は
**その場ですべて試せます**。読みながら使うキー: `j`/`k` スクロール・`q` 戻る・
`?` いま見ている画面のヘルプ。

## 1. スクロールと行き来

`j`/`k` でスクロール（半ページ: `Ctrl-d`/`Ctrl-u`、先頭/末尾: `g`/`G`）。
`q` を押すとファイルツリーへ戻ります — `tutorial.ja.md` を選んで `Enter` で
戻ってきてください。この「ツリー ⇄ 全画面プレビュー」の往復が konoma の中核です。
分割ペインはなく、常に全画面で見ます。

## 2. Tab でリンクを辿る

Markdown のリンクはフォーカスできます。`Tab` を何度か押すと、フォーカス（反転表示）が
文書内のリンクとチェックボックスを順に巡回します。試してみてください:

- [markdown.ja.md](./markdown.ja.md) — Markdown 描画の見本（表・コード・Mermaid・画像）
- [sample.csv](./sample.csv) — 整列テーブルで開く: `h j k l` でセル移動、
  `y` でセル/行/列コピー
- [sample.png](./sample.png) — 画像プレビュー: `+`/`-` ズーム、`h j k l` パン
- [sample.pdf](./sample.pdf) — PDF: `J`/`K` でページ送り

`Tab` でフォーカス → `Enter` で開く → `q` でここへ戻る、を一往復してみてください。

## 3. このチェックボックスを切り替える

チェックボックスは操作できます: `Tab` でフォーカス → `Space`（または `Enter`）でトグル。
変更は**このファイルに書き戻されます** — 実際の状態を安全に編集しています
（書き込み前にディスク上のファイルを照合し、1文字だけを書き換えます）。

- [ ] `j`/`k` でスクロールした
- [ ] `Tab` + `Enter` でリンクを開いて `q` で戻ってきた
- [ ] このチェックボックスを `Space` で切り替えた

## 4. 検索とコピー

- `/` でプレビュー内検索、`n`/`N` で一致間を移動。
- `R` でこのファイルの生 Markdown ソース表示に切替。ソース表示（およびコード/テキスト）では
  `v` で文字単位、`V` で行単位の範囲選択 — `h j k l` で伸ばし、`y` でコピー。
  `Y` は AI チャット用の `@path#L12` 参照をコピーします。
- ツリーでは `y` がコピーメニュー: ファイル名・相対/フルパス・`@相対パス` 参照。

## 5. ツリーはファイルマネージャ

ツリーに戻って（`q`）:

- `/` で入力しながら絞り込み、`Esc` で解除。
- `Space` でファイル管理メニュー: 作成 `n`・リネーム `r`・削除 `d`（確認付き・
  ゴミ箱行き=復元可能）・コピー/カット/ペースト `c`/`x`/`p`。
- `.` で隠しファイル表示、`s` でソートメニュー、`i` でファイル情報。
- `m` + 英字でカーソル位置をブックマーク（小文字=このプロジェクト内・大文字=グローバル）。
  `'` で一覧が開き、英字キーで直接ジャンプ。**プレビュー中でも使えます**
  （表示中のファイルが登録されます）。

## 6. Git をその場で

このディレクトリが git リポジトリ内なら: `o` で変更ハブ（stage/unstage/コミット）、
変更ファイル上の `d` で全画面 diff、ハブ内の `l` で log・`g` でコミットグラフ。
変更ファイルはツリーで色付き表示され、コードプレビューにはエディタ風の変更ガターが出ます。

## 7. AI エージェントの作業を眺める

「左に konoma・右にコーディングエージェント」レイアウトのための看板機能:

- `F` — フォローモード: ファイルがディスク上で変わるたび、konoma が自動でその diff を
  表示します。任意のキーで手動に戻り、`F` で再開。
- `C` — 未コミット変更ファイルのフラット一覧。`n`/`N` で変更間ジャンプ。
- `y` → `@` / `Y` — `@path` / `@path#L12-34` 参照をコピーしてエージェントとの会話に貼る。

## 次に読むもの

- どの画面でも `?` — すべてのビューが自分のキーを説明します。
- ガイド・設定・キーマップの完全版は README からリンクされたドキュメントサイトに、
  全設定項目の逐条解説は `config.example.toml` にあります。

最後のチェックをどうぞ:

- [ ] 完了! konoma を楽しんでください。