Soil Teaching Ja

---
name: soil-teaching-ja
description: SOIL原典の認知的ページ役割とMode CオフラインHTMLで、大きな日本語と意味のある段階図を持つ教材を作る。
---

# SOIL 日本語教材スライド（非公式）

最初に各ページの題名、教える一点、学習者の作業、認知的役割、図の関係、短いラベル、結論を計画する。既定は計画確認を待つ。ユーザーが内部計画・題材・Mode C・styleを明示承認済みなら、その承認をinput/PLANに記録し、工程ごとの再確認は省略する。本作例はこの条件で制作した。

1. 同梱upstream/SKILL.mdとreferences/html-slide-deck.mdを必要範囲で読む。全体/部分、比較、順序、練習など、そのページの思考関係に合わせて図を決める。
2. assets/html-deck-templateを出力へコピー。1600×900 stage、semantic section、見出しとのaria-labelledby、unique data-slide-id、local styles.css/slides.jsを保つ。元テンプレートを直接変更しない。
3. 日本語を大きく短く配置。HTML/SVGの区画・線・数値で関係を示す。原典.fragmentを使い、題名・学習者の作業は最初から、根拠・答えは教える順で段階表示する。
4. 元controllerのadvance/retreatとfragment count、矢印/Space/Home/End/hash、全画面、reduce motion、印刷全段表示を保持する。CDN・remote font・analytics・新frameworkは不要。
5. 原典scripts/validate_html_deck.mjsを実行する。全頁を1280×720と1920×1080で確認し、文字・図・段階表示・キー操作・hash・全段表示の印刷を検査して直す。授業での理解度や紙での印刷品質は別に確認する。

実例はexample/、依頼と計画はexample/input/。index.htmlを直接開いて使える。大きい日本語の書体を変えるときは、配布許諾のある実TTFと原文ライセンスを含める。

SOIL Teaching Slides Skill by 李俊儀。原典 https://github.com/chunyifish/soil-teaching-slides 。この日本語改変SKILLと元の方法説明はCC BY-NC-SA 4.0（非商用・帰属・継承）、実行HTML template/JS/CSSはMIT、書体はOFL。原典の公認ではない。LICENSE-CONTENT.md/NOTICE.md/原MITを保持。