9  writing写作

本章将分析Quarto的学术助手价值，包括academic journal写作、zotero整合等技术。

9.1 书稿撰写

9.1.1 输出格式

html格式的支持整体还可以，pdf格式输出对中文支持目前不是很友好。根据yihui的说法，quarto团队目前基本很少有华人工程师，对中文关注不够。

9.2 文献引用

9.2.1 视觉化引用

具体操作如下：

  • 本地电脑同时打开并运行Zotero桌面软件和Rstudio。

  • Rstudio项目下的.qmd文档以Visual视窗打开。

  • Rstudio \(\Rightarrow\) Visual \(\Rightarrow\) Insert 下拉 \(\Rightarrow\) Citation

  • 此时，.bib文档会自动添加该文献，例如文献条目(Hansen 2016)。

注记

如果是行内引用（in-text citations），那么source视图下要注意markdown语法后使用空格。例如语法：@hansen2022认为巴拉巴拉`显示结果为： Hansen (2022) 认为巴拉巴拉。

重要

Visual界面和Source界面来回切换会导致markdown代码的某些不可控变动。包括：增加更多的空格；callout blocks的div会改变（正确的如{.callout-note}会变动为callout-note）

参考资源：

9.2.2 其他引用方法

1.使用rbbt包方法。

  • 安装R包rbbt
#renv::install("paleolimbot/rbbt")
library(rbbt)

  • 手动进行条目引用。可以采用rbbt包搜索zotero文献条目并完成markdown语法引用。安装好rbbt包后，可以在Rstudio \(\Rightarrow\) Addins \(\Rightarrow\) RBBT: Insert Zotero Citation。

  • 自动添加条目信息。对于Quarto book项目，条目信息都存放在.bib文件。rbbt包可以对当前文档自动完成条目检查，并快速更新当前文档中的全部文献条目到当前文档指定的.bib文件。因此，我们需要明确指定当前文档的yml参数信息。

具体过程如下：

（1）首先，我们在05-academic.qmd文档中引用了：

@hansen2017a 证明了巴拉巴拉。

渲染后html文档显示为：

Hansen (2017) 证明了巴拉巴拉。

（2）在05-academic.qmd文档的yml参数区进行设置，指定本文档对应的条目信息存放文件（.bib文件）。

---
bibliography: bib/references-chpt05.bib
---

（3）使用rbbt包Rstudio插件对本文档条目进行.bib文件的自动添加和更新。Rstudio \(\Rightarrow\) Addins \(\Rightarrow\) RBBT: Updates the bibliography for the current document from Zotero.。此时，我们可以看到条目获得了自动添加。

# bib/references-chpt05.bib

@article{hansen2017a,
  title = {Regression Kink with an Unknown Threshold},
  author = {Hansen, Bruce},
  date = {2017},
  journaltitle = {Journal of Business \& Economic Statistics},
  volume = {35},
  number = {2},
  pages = {228--240},
  publisher = {{Taylor \& Francis}},
  file = {D\:\\gdriver\\zotero-local\\AUTH\\Hansen\\Hansen_2017_Regression kink with an unknown threshold.pdf;D\:\\zotero-store\\storage\\8USS56VF\\07350015.2015.html}
}

（4）最后，如果是Quarto book项目，还需要统一管理多个篇章的.bib文件。具体通过_quarto.yml文件做如下设定：

link-citations: true
bibliography: 
  - bib/references.bib
  - bib/references-chpt05.bib