9 writing写作

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

9.1 学习资源

9.1.1 在线资源

Enough Markdown to Write a Thesis. 免费在线图书https://biostats-r.github.io/biostats/quarto/。生物统计学社群贡献，关于如何快速使用Quarto进行写作。

9.2 Markdown语法

9.2.1 带圈字符

（1）行内代码写法：经测试，以下代码在html和docx输出下都是正常显示。

带圈数字：knitr::asis_output("\U2460")显示为①
带圈符号：knitr::asis_output("\U24C7")显示为Ⓡ。

（2）代码块写法：经测试，以下代码在html和docx输出下都是正常显示。

```{r}
#| results: asis
## 图注
cap_note <- "说明：$\U2460$左侧柱条表示旱区，右侧柱条表示非旱区；$\U2461$所归属地区根据单位的组织机构登记信息所属地区进行划分确定，由编者整理得到。"
cap_source <- "资料来源：科技部网站。"

cat(
  paste0(
    cap_note,
    "\n",
    cap_source
  ),
  collapse = "\n"
)
```

说明：$①$左侧柱条表示旱区，右侧柱条表示非旱区；$②$所归属地区根据单位的组织机构登记信息所属地区进行划分确定，由编者整理得到。资料来源：科技部网站。

（3）行内单美元对写法：经测试，以下代码将不能如愿显示。

$\U2460$ 显示为：$\U2460$

参考资源：

Unicode with knitr and Rmarkdown。队长问答
Unicode compart: https://www.compart.com/en/unicode/U+2470。可查询。

9.3 书稿撰写

9.3.1 输出格式

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

9.4 文献引用

9.4.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）

参考资源：

可以查看官方文档。
Citations and bibliographies 在线书

9.4.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