Content from イントロダクション
最終更新日：2024-09-21 | ページの編集
所要時間： 12分
概要
質問
- sandpaperとR Markdownを使ったレッスンはどのように書くことができますか？
目的
- 新しいレッスンテンプレートでマークダウンを使用する方法を説明しましょう
- コード、図、ネストされた課題ブロックの使い方を説明しましょう
はじめに
これはThe Carpentries
Workbenchによって作成されたレッスンです。内容の変わらないファイル（.md拡張を持つファイル）はPandoc風Markdownによって書かれて、コードによって内容が出力されるファイル（.Rmd拡張を持つファイル）はR
Markdownによって書かれています。 完全な説明を読みたい場合はIntroduction to The
Carpentries Workbenchを参照してください。
The Carpentries Workbenchによるレッスン作成には以下の3つのセクションが必要です：
-
questionsは、エピソードの冒頭に参加者がこれから学ぶ内容について表示されます。 -
objectivesは、上記の質問と一緒に表示されるエピソードの学習目標です。 -
keypointsは、エピソードの最後に学習目標を強調するために表示されます。
インラインのインストラクターノートは、インストラクターに課題のタイミングを知らせるのに役立ちます。
チャレンジ1：できますか？
このコマンドの出力は？
R
paste("This", "new", "lesson", "looks", "good")
出力
[1] "This new lesson looks good"課題2：課題ブロックの中に解決策を入れ子にする方法は？
少なくとも3つのコロンと solution タグを追加します。
図表
以下の構文で、静的な図にpandocマークダウンを使うことができます：
{alt='alt text for accessibility purposes'}
The Carpentriesはどなたでも大歓迎です
数学
\(\LaTeX\)方程式を使うことができます：
$\alpha = \dfrac{1}{(1 - \beta)^2}$
はこのようになります： \(\alpha = \dfrac{1}{(1
- \beta)^2}\)
悪くないでしょ？
まとめ
- 内容が変わらないエピソードには
.mdファイルを使用します。 - コードによって内容を計算する場合は
.Rmdファイルを使用します。 -
sandpaper::check_lesson()を実行することによってでレッスンの問題を特定します。 -
sandpaper::build_lesson()を実行することによってレッスンをローカルでプレビューできます。