R Markdown ドキュメントの作成Creating R Markdown documents

R Markdown は、R の分析を、高品質のドキュメント、レポート、プレゼンテーション、およびダッシュボードに変換するドキュメント形式です。R Markdown is a document format that turns analysis in R into high-quality documents, reports, presentations, and dashboards.

R Tools for Visual Studio (RTVS) には、R Markdown 項目テンプレート、エディターのサポート (エディター内の R コード用の IntelliSense など)、ファイル生成機能があります。R Tools for Visual Studio (RTVS) provides a R Markdown item template, editor support (including IntelliSense for R code within the editor), and file generation capabilities.

R Markdown を使用するには:To use R Markdown:

  1. Visual Studio を閉じます。Close Visual Studio.
  2. (1 回のみ) pandoc.orgpandoc をインストールします。(One time only) Install pandoc from pandoc.org.
  3. Visual Studio を再起動すると、pandoc のインストールが選択されます。Restart Visual Studio, which should pick up the pandoc installation.
  4. knitr および rmarkdown パッケージをインストールします。インストールは、インタラクティブ ウィンドウから実行できます。Install the knitr and rmarkdown packages, which you can do from the interactive window:

    install.packages("knitr")
    install.packages("rmarkdown")
    
  5. [ファイル]、[新規] メニュー コマンドの順に選択し、一覧から [R Markdown] を選択するか、ソリューション エクスプローラーでプロジェクトを右クリックし、[R Markdown の追加] を選択して (または [追加]、[新しい項目] の順に選択し、一覧から [R Markdown] を選択して)、新しい R Markdown ファイルを作成します。Create a new R Markdown file using either the File > New menu command and selecting R Markdown from the list, or by right-clicking your project in Solution Explorer and selecting Add R Markdown (or Add > New Item... and selecting R Markdown from the list).

  6. 新しいファイルの既定の内容は次のとおりです。The default contents of the new file are as follows:

    ---
    title: "Untitled"
    output: html_document
    ---
    
    This is an R Markdown document. Markdown is a simple formatting syntax for authoring HTML, PDF, and Microsoft Word documents. For more details on using R Markdown see <http://rmarkdown.rstudio.com>.
    
    When you click the **R Tools | Publish | Preview** button a document will be generated that includes both content as well as the output of any embedded R code chunks within the document. You can embed an R code chunk like this:
    
    ```{r}
    summary(cars)
    ```
    
    You can also embed plots, for example:
    
    ```{r, echo=FALSE}
    plot(cars)
    ```
    
    Note that the `echo = FALSE` parameter was added to the code chunk to prevent printing of the R code that generated the plot.
    
  7. 編集中にいつでも、エディターで右クリックし、[プレビュー] を選択します。このメニュー項目には、HTML、PDF、Microsoft Word のオプションがあります。At any time during editing, right-click in the editor and select Preview, which has options for HTML, PDF, and Microsoft Word. このプレビューから、選択したファイル形式でファイルを保存できます。From that preview you can save the file as appropriate for the format you chose.