R Markdown
の使い方R Markdown
とはR Markdown
とは「R
と
Markdown
が結合されたもの」Markdown
とは John Gruber と Aaron Swartz
が2004年に提案した Markup言語
R Markdown
を使うと、コード、実行結果、説明文を同時に文書化できるRStudio
上でR Markdown
を使う利点HTML
, PDF
, MSWord
,
PowerPoint
などHTML
での出力を推奨R Markdown
とは何か?
・Markup
言語、Markdown
、R Markdown
の違いを知るためには
2 種類のテキストの違いを知る必要がある
plain text
)・書式情報などが含まれていないテキストのみで構成されている文書
・「書式情報」とは文書の余白、文字の大きさ、文字の色などのこと
・ Rmd
ファイルに書き込んでいる R
コードも「プレーンテキスト」
・「プレーンテキスト」の例:
- macOS
の TextEdit
- Windows
のメモ帳
・「プレーンテキスト」には書式設定や図表の挿入などの機能はない
rich text
)・書式情報や図表なども含まれる文書
・「リッチテキスト」の例:
- Microsoft
Word
- Pages
- LibreOffice Writer
・リッチテキストでは書式の設定や図表・リンクの挿入などができる
Markup
言語とは・プレーンテキストのみでリッチテキストを作成するための言語
・Markup
言語の代表的な例・・・
HTML:(HyperText Markup Language)
・html
には図表があり、太字、見出し、水平線などテキスト以外の情報を含む
・html
はテキストのみで書かれている
・画面を出力するためにはウェブブラウザが必要
・ウェブブラウザの一例:
- Firefox
- Chrome
- Edge
・これらのウェブブラウザがテキストファイルを読み込む
→ 解釈
→ 書式が付いている画面を出力する
Markdown
とは・Markup
言語をより単純な文法で再構成したもの
R Markdown
とは・Markdown
に R
コードとその結果を同時に載せることができる Markdown
のこと
R Markdown
の設定手順手順 | 手順の内容 | Steps |
I.
R プロジェクト作成 |
:フォルダを作る(例:keiryo_2023 ) |
1 - 5 |
II.
Rmd ファイル作成 |
:
ファイルを作る(例:first_trial.Rmd ) |
6 - 10 |
III.
Knit |
:
ファイルを出力する(例:first_trial.html ) |
11 - 18 |
R
プロジェクト作成R
プロジェクトを作成すること =
R
プロジェクトフォルダを作成することStep_1
:RStusio
を起動して File
→
New Project
を選ぶStep_2
:Create Project
の中から New Directory
を選ぶStep_3
:Project Type
の中から New Project
を選ぶStep_4
:New Project
を選ぶと、次のような画面が表示されるR
プロジェクトフォルダを置く場所を指定するR
プロジェクトフォルダをデスクトップに置くよう指定するBrowse
」 をクリックする
Step_5
:Browse
」
をクリックすると、次のような画面が表示されるDesktop
」をクリックopen
」をクリックするStep_6
:Step_6
の画面に戻るDirectory name:
」に keiryo_2023
と入れてみるCreate Project
」をクリック
Directory name
を入力する際の注意
・半角・英数字を使う(全角文字とスペースは使わない)
・記号はアンダーバー「-
」とピリオド「.
」を使う
・ハイフン「-
」は使わない
・アルファベットから始める(数字や記号から始めない)
Step_7
:keiryo_2023
」を確認R
プロジェクトの名前
Rmd
ファイル作成Step_8
:File
→ New File
→ R Markdown
を選ぶ
Step_9
:Title:
に R Markdown の使い方
と入力(ここでは日本語もスペースも ok)Author:
に自分の名前を入力(ここでは日本語もスペースも
ok)Date:
に "r Sys.Date()"
と入力すると、自動的に日付を付けてくれるDefault Output Format:
にはデフォルトの
HTML
をチェックOK
をクリックStep_10
:Rmd
ファイルができたRmd
ファイルの名前は Untitled1
Knit
knit
)」→
「文字を編んで出力する」という意味Step_11
:Knit
をクリックするStep_12
:Rmd
ファイルに名前を付けるStep6
と同様、日本語は使えないSave As
: に first_trial
と入力Save
をクリックSave As
:
に入力する際の注意
・半角・英数字を使う(全角文字とスペースは使わない)
・記号はアンダーバー「-
」とピリオド「.
」を使う
・ハイフン「-
」は使わない
・アルファベットから始める(数字や記号から始めない)
注意:
first_trial.Rmd
が出力される際、Step_13
と Step_14
の 2
つのケースが想定される
Step_13
のように表示された場合 → Step_16
に進むStep_14
のように表示された場合 → Step_15
の指示に従うStep_13
:first_trial.html
)Step_14
:RStudio
とは別画面の html
で開かれる