pjt222 Quartoレポートの作成
分析レポート、プレゼンテーション、ウェブサイト用の再現可能なQuartoドキュメントをセットアップして作成する。
使用タイミング
- 再現可能な分析レポートを作成する場合
- コード埋め込みのプレゼンテーションを構築する場合
- コードからHTML、PDF、Word文書を生成する場合
- R MarkdownからQuartoへ移行する場合
入力
- 必須: レポートのトピックと対象読者
- 必須: 出力形式（html, pdf, docx, revealjs）
- 任意: データソースと分析コード
- 任意: 引用文献ファイル（.bibファイル）
手順
ステップ1: Quartoドキュメントの作成
report.qmdを作成する:
---
title: "Analysis Report"
author: "Author Name"
date: today
format:
html:
toc: true
toc-depth: 3
code-fold: true
theme: cosmo
self-contained: true
execute:
echo: true
warning: false
message: false
bibliography: references.bib
---
期待結果： ファイルreport.qmdが、タイトル、著者、日付、フォーマット設定、実行オプションを含む有効なYAMLフロントマターとともに存在する。
失敗時： ---デリミタの一致とインデントが正しいことを確認してYAMLヘッダーを検証する。format:キーがサポートされているQuarto出力形式（html、pdf、docx、revealjs）のいずれかと一致することを確認する。
ステップ2: コードチャンク付きコンテンツの記述
## Introduction
This report analyzes the relationship between variables X and Y.
## Data
```{r}
#| label: load-data
library(dplyr)
library(ggplot2)
data <- read.csv("data.csv")
glimpse(data)
```
## Analysis
```{r}
#| label: fig-scatter
#| fig-cap: "Scatter plot of X vs Y"
#| fig-width: 8
#| fig-height: 6
ggplot(data, aes(x = x_var, y = y_var)) +
geom_point(alpha = 0.6) +
geom_smooth(method = "lm") +
theme_minimal()
```
As shown in @fig-scatter, there is a positive relationship.
## Results
```{r}
#| label: tbl-summary
#| tbl-cap: "Summary statistics"
data |>
summarise(
mean_x = mean(x_var),
sd_x = sd(x_var),
mean_y = mean(y_var),
sd_y = sd(y_var)
) |>
knitr::kable(digits = 2)
```
See @tbl-summary for descriptive statistics.
期待結果： コンテンツセクションに、{r}言語識別子と#|チャンクオプション（ラベル、キャプション、サイズ用）を持つ適切にフォーマットされたコードチャンクが含まれている。
失敗時： コードチャンクが```{r}構文（インラインバックティックではない）を使用していること、#|オプションがチャンク内部にあること（YAMLヘッダーではない）、ラベルプレフィックスが相互参照タイプと一致すること（図にはfig-、表にはtbl-）を確認する。
ステップ3: チャンクオプションの設定
一般的なチャンクレベルオプション（#|構文を使用）:
#| label: chunk-name # 相互参照に必須
#| echo: false # コードを非表示
#| eval: false # 表示するが実行しない
#| output: false # 実行するが出力を非表示
#| fig-width: 8 # 図のサイズ
#| fig-height: 6
#| fig-cap: "Caption text" # @fig-name参照を有効にする
#| tbl-cap: "Caption text" # @tbl-name参照を有効にする
#| cache: true # 高負荷計算をキャッシュ
期待結果： チャンクオプションが#|構文でチャンクレベルに適用され、ラベルが相互参照に必要な命名規則に従っている。
失敗時： チャンクオプションがレガシーの{r, option=value} R Markdown構文ではなく、#|構文（Quartoネイティブ）を使用していることを確認する。ラベル名には英数字とハイフンのみが含まれることを確認する。
ステップ4: 相互参照と引用の追加
See @fig-scatter for the visualization and @tbl-summary for statistics.
This approach follows @smith2023 methodology.
::: {#fig-combined layout-ncol=2}
{#fig-plotA}
{#fig-plotB}
Combined figure caption
:::
期待結果： 相互参照（@fig-name、@tbl-name）が正しい図と表に解決され、引用（@key）が.bibファイルのエントリと一致する。
失敗時： 参照されたラベルが正しいプレフィックス（fig-、tbl-）を持つコードチャンクに存在することを確認する。引用については、.bibのキーが完全に一致すること（大文字小文字を区別）と、YAMLヘッダーにbibliography:が設定されていることを確認する。
ステップ5: ドキュメントのレンダリング
quarto render report.qmd
# Specific format
quarto render report.qmd --to pdf
quarto render report.qmd --to docx
# Preview with live reload
quarto preview report.qmd
期待結果： 指定した形式で出力ファイルが生成される。
失敗時：
- quartoが見つからない場合: https://quarto.org/docs/get-started/ からインストール
- PDFエラー:
quarto install tinytexでTinyTeXをインストール - Rパッケージエラー: すべてのパッケージがインストールされていることを確認
ステップ6: 複数形式の出力
format:
html:
toc: true
theme: cosmo
pdf:
documentclass: article
geometry: margin=1in
docx:
reference-doc: template.docx
すべての形式をレンダリング: quarto render report.qmd
期待結果： 指定したすべての出力形式が正常に生成され、それぞれがターゲット形式に適切なスタイリングとレイアウトを持つ。
失敗時： 一つの形式が失敗し他が成功する場合、形式固有の要件を確認する: PDFにはLaTeXエンジンが必要（quarto install tinytexでインストール）、DOCXには有効な参照テンプレートが必要（指定されている場合）、形式固有のYAMLオプションは各形式キーの下に正しくネストされている必要がある。
バリデーション
- ドキュメントがエラーなしでレンダリングされる
- すべてのコードチャンクが正しく実行される
- 相互参照が解決される（図、表、引用）
- 目次が正確である
- 出力形式が対象読者に適切である
よくある落とし穴
- ラベルプレフィックスの欠落: 相互参照可能な図にはラベルに
fig-プレフィックスが必要、表にはtbl-が必要 - キャッシュの無効化: キャッシュされたチャンクは上流データが変更されても再実行されない。
_cache/を削除して強制実行 - LaTeXなしのPDF: TinyTeXをインストールするか、CSSベースのPDFには
format: pdfとpdf-engine: weasyprintを使用 - QuartoでのR Markdown構文:
{r, echo=FALSE}スタイルではなく#|チャンクオプションを使用
関連スキル
format-apa-report- APA形式の学術レポートbuild-parameterized-report- パラメータ化された複数レポート生成generate-statistical-tables- 出版品質の表write-vignette- Rパッケージ内のQuartoビニエット