如何在papaja的kable表格中正确渲染IPA字体？

问题场景 #

正文中使用TIPA渲染IPA符号正常，但用kable()生成包含Unicode IPA字符的表格时，出现LaTeX错误：

! LaTeX Error: Unicode character ɪ (U+026A)
           not set up for use with LaTeX.

 Try other LaTeX engines instead (e.g., xelatex) if you are using pdflatex.

已在YAML中指定XeLaTeX引擎，相关代码如下：

表格数据定义：

IPA_table <- tribble(~Gloss, ~IPA, "baby", "beibi",
                 "ball", "bɑl", "cow", "kaʊ")

表格输出代码：

knitr::kable(IPA_table,
              "latex", booktabs=T, longtable=T, align="c") %>%
   kable_styling()

YAML前置内容：

output:
   papaja::apa6_pdf: default
   latex_engine: xelatex

解决方案 #

1. 修正YAML配置，指定支持IPA的字体 #

papaja默认字体不支持IPA Unicode字符，需通过header-includes加载fontspec包并设置支持IPA的字体（如Charis SIL、Doulos SIL，需提前安装到本地系统）。修正后的YAML：

output:
  papaja::apa6_pdf:
    latex_engine: xelatex
header-includes:
  - \usepackage{fontspec}
  - \setmainfont{Charis SIL}
  - \setsansfont{Charis SIL}

2. 调整kable代码，为IPA列单独指定字体 #

通过kableExtra::column_spec给IPA列绑定支持的字体，同时设置escape = FALSE让LaTeX字体命令生效：

knitr::kable(IPA_table,
             "latex", booktabs = TRUE, longtable = TRUE, align = "c",
             escape = FALSE) %>%
  kable_styling() %>%
  column_spec(2, latex_column_spec = ">\\fontspec{Charis SIL}")

3. 备选方案：改用TIPA命令替代Unicode字符 #

如果不想依赖Unicode字体，可将IPA列内容替换为TIPA的LaTeX命令，同时确保文档加载tipa包：

# 修改表格内容为TIPA命令格式
IPA_table <- tribble(
  ~Gloss, ~IPA,
  "baby", "be\\textipa{\\i}bi",
  "ball", "b\\textipa{\\d{a}}l",
  "cow", "k\\textipa{\\ae{}u}"
)

# 输出表格（无需额外字体配置）
knitr::kable(IPA_table,
             "latex", booktabs = TRUE, longtable = TRUE, align = "c",
             escape = FALSE) %>%
  kable_styling()

内容的提问来源于stack exchange，提问作者Catherine Laing