週次制作フロー¶
毎週の授業ページは、次の流れで作ります。
通常フロー¶
- 前回またはテンプレートをコピーする
- 今回のタイトル、目標、使用ファイルを書く
- 本編、デモ、演習、提出欄を書く
- 画像や軽量動画を
assets/に置く mkdocs serveで表示確認するmkdocs build --strictでビルド確認する- GitHubへpushする
- Cloudflareのデプロイ結果を確認する
- LMSや授業連絡でURLを共有する
確認チェックリスト¶
- トップページから授業回へ到達できる
- 画像が表示される
- 動画が再生できる、または外部リンクが開ける
- コードブロックが読める
- スマートフォン幅でも大きく崩れない
- 未公開メモや素材元の作業ファイルが混ざっていない
- 提出先、締切、使用ファイルが最新になっている
Marpとの使い分け¶
| 用途 | 形式 |
|---|---|
| 毎週の授業本体 | このHTML教材 |
| 投影用、単発配布、PDF配布 | Marp |
| 動画、デモ、演習手順 | HTML教材 |
| 保管、制作途中、検証 | 現在の教材制作リポジトリ |