スライド教材執筆 Skill

技術研修用スライド教材の作成基準を定義します。

スライド作成の情報源

スライド作成のする上での情報源はテキスト教材（各研修コースのtextフォルダ）の内容から作成します。 スライドのファイル名から、同じ章番号ののテキスト教材の内容を確認し、その内容に合わせてスライドを作成します。 （スライドのファイル名がslides/chapter-02.mdならtext/chapter-02.mdの内容を基にスライドを作成します。）

参照ルール

以下のルールファイルも参照してください：

• @rules/common/writing-style.md - 文章作成の基本方針

基本構造

Frontmatter設定（必須）

各章ごとに独立したMarkdownファイルとし、frontmatterでメタデータを設定：

---
marp: true
title: [その章のタイトル]
draft: false
---

スライド構成要素（必須順序）

1. Frontmatter
2. 章タイトルのh1見出し
3. スライド区切り線「---」
4. 学習項目毎のスライド内容
5. まとめ

---
marp: true
title: [その章のタイトル]
---

# Git概要

---

## この章で学ぶこと

- 本章では次の内容を学習します。
	- [学習項目1]
	- [学習項目2]
	- [学習項目3]
	- [学習項目...]

---

## [学習項目1のタイトル]

- [学習項目1を完結にまとめた1文]
	- [学習項目1をよりわかりやすくするための箇条書き文章]
	- [学習項目1をよりわかりやすくするための箇条書き文章]

---

## [学習項目2のタイトル]

- [学習項目1を完結にまとめた1文]
	- [学習項目1をよりわかりやすくするための箇条書き文章]
	- [学習項目1をよりわかりやすくするための箇条書き文章]

---

## この章のまとめ

- [学習内容をまとめた箇条書き文章]
	- [学習内容をまとめた箇条書き文章]
	- [学習内容をまとめた箇条書き文章]

---

スライドデザイン原則

レイアウト

• 1スライド1トピックの原則
• 箇条書きを基本とした簡潔な構成
• 階層構造（メイン・サブポイント）の活用

文章スタイル

• 体言止めまたは簡潔な文
• キーワードを太字で強調
• 専門用語は初回に説明を付与

視覚的要素

• 図表・画像を積極的に活用
• ![](images/slide/画像名.svg) 形式で挿入
• 概念図はdrawio.svg形式を推奨

具体例

---
marp: true
title: Spring Boot概要
---

# Spring Boot概要

---

## 本章について

- 本章では次の内容を学習します。
	- Spring Bootとはどんなものかを理解する
	- Spring Frameworkとはどのようなものかを理解する
	- Spring BootとSpring Frameworkの違いについて理解する
	- Spring Bootプロジェクトの作成方法について理解する

---

## Spring Bootとは

- Spring Boot（スプリングブート）は、オープンソースのJavaフレームワークです。
	- JavaのWebアプリケーションフレームワークであるSpring Frameworkを使用して作成されたアプリケーションを、少ない設定で、短期間で実行できることを目的に設計・開発されました。

![](images/overview/sboot-image.png)

---

## Spring Bootの特徴

- Spring Bootの主な特徴
	- スタンドアロンSpringアプリケーションの作成
	    - SpringApplicationクラスのrun()メソッドを呼び出すだけでSpringアプリケーションを起動可能
	- Webサーバーコンテナの組み込み
	    - Tomcat、Jetty、UndertowなどのWebサーバーコンテナを組み込み
	- 自動設定
	    - アプリケーションの設定を自動的に行うため、開発者が設定を行う必要なし
	- スターター依存関係
	    - 必要な依存関係を提供するスターター依存関係を提供

---

## Spring Frameworkとは

- Spring Framework（スプリングフレームワーク）は、Javaプラットフォーム向けのオープンソースアプリケーションフレームワークです。
  - Javaプラットフォームのアプリケーション開発を簡素化するための機能を提供します。

**Spring Frameworkの機能**

機能|説明
---|---
コア機能|DI（依存性注入）やAOP（アスペクト指向プログラミング）などのコア機能をベースにして、Webアプリケーションの機能を提供
Spring MVC|WebアプリケーションにおけるMVC（Model-View-Controller）モデルを提供
Spring Data|データベース接続を行うための機能を提供
Spring Security|認証や認可、脆弱性対策などのセキュリティ機能を提供

---

## この章のまとめ

- この章では次のことについて学びました。
	- Spring Bootは迅速でかつ高品質なJavaのアプリケーションを作成するためのフレームワーク
	- Spring BootはSpring Frameworkをベースにしている
	- Spring Bootのプロジェクト作成方法

スライド設計原則

情報量の調整

• 1スライドあたり3-7項目を目安
• 重要ポイントに絞った内容
• 詳細は補足資料やハンズオンで補完

視認性

• 十分な文字サイズ
• 適切な色彩対比
• シンプルで読みやすいレイアウト

講義進行への配慮

• 適切なペース配分
• 質問・議論の余地を含む構成
• ハンズオンとの連携を考慮

ファイル命名規則

• chapter-XX.md 形式（XXは章番号の2桁）
• 出力先: dist/slides/chapter-XX.md