knitr tangled R 代码中缺少块名称

Question

当在Sweave 文档上使用Stangle 时，输出包括一个给出块名称的注释。这在教学环境中非常有用，可以在学生剪切和粘贴时引导学生了解代码。但是，当我使用knitr 从.Rnw 生成.R 代码时，不包括块名称（至少我可以看到）：

knit('example.Rnw',tangle=TRUE)

我可以在为knitr 编写的文档上运行Stangle，除非块参数中存在不兼容的情况，这会阻止运行Stangle 而不会出现错误。

有没有办法强制 knitr 在包含块名称（和/或数字）的纠结 R 代码中生成 cmets，如原生 Stangle？

Answer 1

感谢@kohske（我刚刚自己想通了……）

purl() 有一个 documentation 参数，默认设置为 1（1=将块头添加到代码中；0 什么都不做，2 添加块头作为 roxygen cmets）。如果你想坚持knit(.,tangle=TRUE)，你只需要在纠结之前opts_knit$set(documentation=1)。