html_document()
和html_document_base()
获得math方法
支持的论据Pandoc的所有数学渲染引擎:“mathjax”、“katex”、“mathml”、“webtex”和“gladtex”。为了向后兼容马特拉克斯
参数仍然有效,并且优先于math方法
,但我们建议使用新的math方法
参数而不是马特拉克斯
而后者在将来可能会被弃用。
您可以通过指定数学引擎math方法
作为引擎名称,例如。,
或同时提供名称和URL(用于马特拉克斯
,katex公司
和网络图文
):
对于math_method=“katex”
,默认情况下,KaTeX CDN将插入版本0.15.2(来自jsdeliver)。指向另一个CDN的自定义URL可以传递为网址
.
对于math_method=“webtex”
,默认情况下使用插入SVGhttps://latex.codecogs.com/svg.image?
.使用https://latex.codecogs.com/png.image?
对于PNG。请参见https://latex.codecogs.com用于支持的选项(dpi、background…)。
大多数HTML输出格式使用html_document()
或html_document_base()
基于as的格式应该会从这个新特性中受益。请参见?rmarkdown::html_document()
有关详细信息(谢谢,@阿图西, #1940).
github_document()
也获得了math方法
参数设置为“webtex”
默认情况下,LaTeX方程可以在Github Markdown文档中呈现为图像。以前,LaTeX方程未渲染。设置math_method=空
以停用。
添加了对的支持凯特克斯R包作为数学引擎math_method=“r-katex”
在HTML文档中。此方法提供了所有方程式的服务器端呈现,这意味着浏览器中不需要像通常的KaTeX或MathJaX方法那样进行JS处理。(谢谢,@杰伦, #2304).
锚固段
现在可以使用轻松定制风格
或深度
的元素锚固段
例如:
仍然可以使用CSS规则进行自定义。帮助页面中添加了详细的解释和示例?html_文档
.
改进了支持的格式中的突出显示机制突出
参数:
- 现在可以传递自定义主题文件
.theme主题
在里面突出
用于自定义Pandoc使用的语法突出显示样式.
- 除了Pandoc自己支持的主题外,包中还捆绑了另外两个主题:
高亮显示:箭头
主题针对可访问性和颜色对比度进行了优化(多亏了@重新装填)、和突出显示:rstudio
模仿RStudio编辑器主题。
- 仅适用于HTML输出,添加了可选下位(downlit)中的支持
html_document()
用于R语法高亮显示和自动链接。使用highlight_downlit=真
激活它(与中的参数相同蒸馏). 此功能需要下载包裹。
的模板html_document()
和ioslides_presentation()
获得了显示单行的新CSS规则<摘要>
内联内容(rstudio/rstudio#10589)。
md_document()
获得一个新的独立的
参数,这是错误的
默认情况下,除非toc=真
这允许根据Pandoc的模板输出作者、日期和其他元数据。由于Pandoc在其扩展中处理元数据块的方式受到限制yaml_metadata块
,preserve_yaml=真
现在停用任何扩展以允许rmarkdown公司直接处理YAML块的保留-这意味着它没有设置独立=真
默认情况下。与此同时,github_document()
获得preserve_yaml(保留山药)
争论(谢谢,@佛罗里达州, #2297).
补充可用模板()
列出特定包中可以与一起使用的所有模板rmarkdown::draft()
.
在Pandoc 2.15中提供支持后,powerpoint_presentation()
获得了增量
参数作为其他幻灯片格式。作为提醒,设置增量=真
将使列表以增量方式显示。在中查看更多信息Pandoc手册.
增加了对Pandoc的支持目录
HTML模板中的变量。这是第二次语言变量之后朗
.
添加了全局选项rmarkdown.html_dependency.header_attr
(真的
默认情况下)。它可以设置为错误的
选择HTML依赖项html_dependency_header_attrs()
在基于的文档中html_document_base()
(谢谢,@唾液brstudio/bookdown#865,@梅勒r-lib/downlit#1538)。
渲染使用运行时:shiny_prerendered
或运行时:shinyrmd
现在本机支持自定义模板。此前,自2.8版本以来,开发者不得不添加一条特别评论,<!-- 标题内容-->
,有条件地闪光预渲染
变量。(有关先前的行为,请参阅2.8中的新闻)。新行为插入需要特殊注释<!-- 标题内容-->
作为的最后一个元素$header-includes个$
。如果模板依赖于旧行为,并且需要在$header-includes个$
和<!-- 标题内容-->
,考虑将其包含在$header-includes个$
(谢谢,@阿图西,@加登布依#2249).
只有空服务器上下文的闪亮的预渲染文档不再出错。文档将使用空的服务器函数呈现,并且服务器。对
文件将被忽略。要使用服务器。对
,Rmd文档中不应存在服务器上下文(谢谢,@jcheng5号机组, #2305).
修复了带渲染的回归光泽_预渲染
文档(谢谢,@阿罗纳特金斯,@加登布依, #2218).
修复了中的问题波束呈现()
哪里头部-包括
将被覆盖包含=列表(in_header=)
(谢谢,@桑卡特, #2294). 修复与相同pdf文档()
(#1359).
修复了当number_sections=真
在中指定md_文档
和github_document(github_文档)
(谢谢,@阿图西, #2093).
草稿()
现在与一起工作开发工具::load_all()
和测试那个在其他包中使用时。
Lua过滤器:在共享.lua
用于其他软件包:
- 补充
类型()
Pandoc 2.17更改后功能向后兼容。
- 补充
打印调试()
以便在调试期间更容易地进行日志记录。
添加opt-in标签集
选项html_渐晕
。与中的类似功能相比html_文档
,此功能支持从ToC和URL导航。任何自定义格式都可以通过使用导出函数引入此功能html_dependency_tabset()
(谢谢,@阿图西, #2313).
修复2.8版中使用url时的回归css公司
争论(谢谢,@vnijs公司, #2163).
现在正确支持所有HTML依赖项,包括那些只有href公司
组件,但不是文件
组件型钢混凝土
属性。以前,rmarkdown公司会抛出错误'未提供html_dependency的路径'
使用呈现包含HTML依赖项的文档时href公司
组件(谢谢,@疯狂卡皮瓦拉,@马修斯特拉西奥托, #1805, #1948, #2151).
使用修复输出格式引发的错误文件作用域
功能(如中所示预订)(谢谢,@拉斐伦, #2149).
修复问题copy_ressource=真
在里面html文档库
其中很长的HTML文档在后期处理期间被截断(谢谢,@奥利维梅斯林, #2145).
什么时候?运行()
-正在生成运行时:闪亮
文档中,将在输出路径中使用一个额外的临时文件夹。路径中有额外的临时随机文件夹,可以使用可预测的输出文件名。(#2137)
什么时候?运行()
-正在生成运行时:闪亮
带有的文档{bslib}
主题,全局主题值未正确恢复。(#2160)
浮动ToC输入html_文档
现在可以隐藏未编号和未列出类的标题(谢谢,@阿图西, #1993).
修复R Markdown网站的Fontawose V5导航栏中的前缀处理以及与V4的兼容性。对于仅在V5中可用的图标,应使用完整的前缀+名称,尤其是新的绝妙的
前缀(例如。fab fa-r项目
). 如果没有使用前缀(例如非正式会议
而不是fas非正式会议
),的法
前缀将被添加用于V4兼容性,因为它在V5中已被弃用。我们建议按照Fontawese文档使用图标的完整前缀+名称。(#1994)
rmarkdown::site_generator()
当网站
在的YAML前件中找不到字段索引。房间
(谢谢,@kevinushey公司 @沼泽地, #2043).
修复Pandoc 2.5和latex-div.lua公司
-现在可以按预期无误地呈现文档(谢谢,@戴维德威尔斯, #2121).
修复默认为时样式和代码折叠按钮行为的问题共模:显示
。现在可以根据状态正确设置按钮样式aria-expanded(变量扩展)
属性已正确更新。此外,按钮上添加了新类,以允许在过渡期间进行样式设置:btn-坍塌
和btn-膨胀
分别在“Show to Hide”和“Hide to Show”转换期间应用。(以下为可折叠块的引导行为)(谢谢,@史蒂文哈罗斯, #2085).
修复问题引用_包
使用时没有效果.md文件
文件作为输入渲染()
具有乳胶和PDF输出格式(谢谢,@安德鲁斯, #2113).
一个新的内部选项rmarkdown.knit.ext码
已添加以控制渲染期间中间针织输出的扩展。默认为医学博士
生产*.knit.md(编织)
。仅适用于非常高级的使用(#2098)。
渲染()
不会产生任何*.utf8.md码
不再使用中间文件。这是以前版本的rmarkdown公司.自针织者1.24和rmarkdown公司2.0,只允许UTF-8输入文件。(#2098).
修复交叉设备链接无效
错误,当临时目录()
用于中间_目录
在里面渲染()
(谢谢,@戈里特科, #2096).
修正了HTML默认模板中浮动toc错误地放置在小窗口中的回归(谢谢,@鹰枝, #2071)
提供了一个运行时:闪亮
修复了传递修改后的bslib::bs_theme()
对象到html_document_base()
的主题
(谢谢,@cpsievert公司,#2049)。
渲染使用运行时:shiny_prerendered
或运行时:shinyrmd
现在将不再将完整文档作为正文插入产生的闪亮应用程序中,从而生成有效的HTML(谢谢,@达克普, #1912). 通常包含html依赖项的标题内容将在前面的标题末尾插入html文档</头>
,除非呈现的HTML包含<!-- 标题内容-->
特殊注释(参见htmltools::renderDocument()
). 为闪亮的预呈现文档设置了一个新的Pandoc变量,以允许使用$if(闪亮的预呈现)$
。此操作已在此包中的所有HTML模板中完成。自定义模板的用户应进行此更改,以提供对此运行时的支持。请参见rmarkdown公司默认模板(默认.html
)例如(2064)。
补充构造的
作为支持生成PDF输出的LaTeX引擎(谢谢,@德普利安79, #2078). 您可以通过添加引擎:“构造”
以YAML格式输出,例如pdf文档
.
当没有输出格式
以任何方式提供,但输出文件
中提供了渲染()
,将根据扩展名确定默认格式:“pdf文档”
对于.pdf格式
,或“文字文档”
对于.docx文件
。否则,它将“html_document”
与前一版本相同(谢谢,@pearsonca公司, #1569).
添加了新的全局选项rmarkdown.render.消息
.设置时错误的
,渲染()
将不会输出以开头的消息创建的输出:
允许RStudio IDE打开文档预览。这对于需要为自定义格式发出自己的输出消息的包开发人员非常有用。请参见?渲染器站点
有关此特殊消息的更多信息(2092)。
有关Lua过滤器的内部更改。他们现在有一个明确的Pandoc版本最低要求:如果不满足这个要求,Lua过滤器将跳过过滤器并打印警告。目前,所有过滤器都适用于Pandoc 2.1及以上版本(谢谢,@阿图西, #2088). 现在还有一种新的机制,可以让其他Lua文件加载共享Lua过滤器脚本:渲染()
将设置RMARKDOWN_LUA_SHARED(RMARKDOWN_LUA_共享)
指向Lua过滤器路径的env-var共享.lua
以便其他过滤器可以使用文件(os.getenv“RMARKDOWN_LUA_SHARED”)
。仅供内部使用,以避免重复(谢谢,@柏油树, #2103).
html文档库
获得acss公司
论点,对其html_文档
的css公司
参数现在通过了。这也解决了以下问题:.sas文件
或.scs
文件与此一起使用css公司
参数,当自包含:FALSE
此外,萨斯缓存机制现在可以在传递时使用.sas文件
或.scss文件
文件到css公司
争论(谢谢,@cpsievert公司,#2095)。
这个图_裁剪
PDF文档格式选项(例如pdf文档
和波束_表示
)支持该值“自动”
现在,这意味着图_crop=真
图形裁剪工具时pdfcrop公司
和幽灵手稿
可用。
的默认值图_裁剪
PDF输出格式的选项已从真的
到“自动”
(#2077).
rmarkdown::tufte_讲义
已弃用,将来将从此包中删除。它已移动到凝灰岩包装开始时间rmarkdown公司0.9.5(发布于2016年2月22日)。请使用tufte::tufte_讲义
而不是。
html_文档
(和html文档库
)的主题
参数现在可以理解bslib::bs_theme()
对象/参数,这意味着可以选择Bootstrap 4并更容易地创建自定义主题。有关示例,请参见https://github.com/rstudio/rmarkdown/pull/1706,有关上下文,请参阅https://rstudio.github.io/bslib网站/(谢谢,@cpsievert公司, #1706).
包含的文件.scss文件
/.萨斯
扩展名(即Sass文件)提供给html_文档
的css公司
参数现在使用{安全}
包装。此外,如果主题
是一个{bslib}
对象,这些Sass文件可能在主题
(谢谢,@cpsievert公司, #1706).
修复代码块中的行号问题.数字线
Pandoc的突出显示(谢谢,@奥萨维, #1876).
使用闪亮的运行时和全球的。对
(谢谢,@廖家汇-r,rstudio/flexdashboard#298)。
接受latex=“{options}”
,乳胶=1
,或乳胶=真
用于乳胶潜水。
添加输出格式过滤器
函数到默认站点生成器()
。使自定义网站生成器能够在呈现每个页面之前自定义甚至完全替换输出格式。
自动排除伦夫的目录render_site()
(谢谢,@jmbuhr公司, #1996)
不要强迫选项(htmltools.preserver.raw=真)
当设置了此选项时,其他软件包(例如yihui/xaringan293)不可能关闭此选项。
编织选项_pdf()
现在将在以下情况下引发警告图_crop=真
但由于需要工具而被禁用pdfcrop公司
和/或幽灵手稿
都不见了(谢谢,@网络风格的, #2016).
消除了html_文档
带有Bootstrap 4主题的输出(谢谢,@阿图西, #2019).
github_document()
即使某些标头以数字(#2039)开头,也会生成一个有效的目录。
修复问题针织印花数据框
. The...
参数不再传递给打印()
避免超车针织印花()
论据选项
和编码
自定义打印()
方法(#2047)。
编码现在已在中正确处理html_渐晕
检查相同标题和渐晕索引条目时(谢谢,@py-b型, #1978).
清洁场地()
现在默认为预览=真
并且不会再在没有通知的情况下删除文件。此更改将影响网站项目“构建”窗格中的“全部清除”按钮。clean_site(预览=FALSE)
必须运行才能有效地删除文件(#1973)。
中间产物.tex码
如果keep_tex=假
当R Markdown文档没有从工作目录中呈现时(谢谢,@vqv(vqv), #1308).
修复导致某些资源文件作为中间文件删除的错误中间_目录
与输入内容相同(谢谢,@贝尔马式的, #1248).
修复问题anchor_sections=真
和学习者(谢谢,@加登布依, #1938).
启用的使用服务器。对
和全球的。对
沿着运行时:shinyrmd
文件。
pkg_file_lua()
现在与一起工作开发工具::load_all()
和测试那个当用于其他包装时。
修复pandoc_convert(citeproc=TRUE)
不要压制--纳特比布
或--双乳胶
选项(谢谢,@阿图西, #1932).
pandoc-citeproc公司
现在,如果参考文献
字段是在另一个YAML块中定义的,而不是在第一个YAML块(谢谢,@bwiernik公司, #1364).
指定htmltools::htmlPreserve()
当pandoc>=v2.0时,应使用pandoc原始属性而不是保留标记。请注意,此选项仅对htmltools>=0.5.0.9003版本有效。
锚固段
在里面html_documents()
现在默认为错误的
。它是在以前的版本中引入的,默认为真的
,但在听取了社区的反馈后现在又恢复了(谢谢!)。这个#
仍然用作锚的字符,但可以使用CSS规则轻松更改。示例已添加到帮助页面?html_文档
.
使用Pandoc的默认值--电子邮件模糊处理
现在。以前,它被设置为没有人
显式地,这是Pandoc 1.17.2+的默认值。如果文档包含电子邮件地址,则只有使用Pandoc 1.17.2之前版本的用户才能看到生成的html源文件的内容发生更改。如果您想将Pandoc的命令行标志设置为另一个值(谢谢,@肖恩克罗斯, #1969).
请参见潘多克手册了解此选项的含义。
通过正确处理新前缀,修复导航栏中的Fontawese 5图标法
已被否决赞成fas公司
或绝妙的
(#1967)
没有标题行的表(可以在Pandoc中使用简单表格)现在使用时格式正确html_document()
格式(谢谢,@弗科尔特, #1893).
html_document()
获得锚固段
参数,这是真的
默认情况下,这样读者就可以轻松获得指向节标题的链接-当您将鼠标悬停在节标题上时,您将看到一个哈希符号#
位于标头的末尾,其中包含指向此标头的锚链接。您可以单击此链接并在web浏览器的地址栏中获取URL,或者右键单击它并从上下文菜单中复制URL。哈希符号由CSS规则定义a.anchor-section::在{content:“#”;}之前
。您可以通过覆盖此规则(例如,通过css公司
的论点html_文档
)并使用任何其他符号或图标,例如。,内容:“\02AD8;”
(谢谢,@阿图西, #1884).
pkg_file_lua()
如果预期的Lua文件不存在,则应该引发错误。
提供文件_目录
和中间_目录
返回时作为属性渲染()
什么时候run_pandoc=假
.
支持新的Pandoc 2.11--citeproc公司
标志用法,而不是pandoc-citeproc公司
外部过滤器。pandoc_convert()
和pandoc_citeproc_convert()
现在将根据使用的Pandoc版本使用正确的标志。逻辑导出于pandoc_citeproc_args()
。请参阅Pandoc发布说明有关新的城市规划署
处理(#1916)。
修复了隐藏代码块时代码高亮显示的问题。以前的版本引入了一个回归,当代码折叠
被激活,代码块被隐藏(谢谢,@马修·卡卢奇, #1921).
所需的最低版本xfun游戏软件包(v0.15)已被指定为R Markdown笔记本正常工作(谢谢,@jmc处理器, #1923).
修复了中的一个错误convert_ipynb()
中未指定语言时.ipynb文件
文件(谢谢,@根据3003, #1925).
介绍运行时:shinyrmd
作为更便于用户使用的别名运行时:shiny_prerendered
.
- Lua过滤器处理在内部得到了改进,并进行了一些用户界面更改(#1899):
- 新建导出函数
pandoc_lua_filter_args()
返回Pandoc命令行参数以添加Lua过滤器。
- 新参数
lua_过滤器
在里面pandoc_options()
传递要与格式一起使用的Lua筛选器路径。这允许输出格式作者使用潘多克
的论点输出格式()
并使用从格式获取过滤器fmt$pandoc$lua_filters
.
- 输出格式的Lua过滤器现在在中传递给Pandoc
渲染()
默认情况下,它们在任何其他格式定义或用户定义的Pandoc参数之前传递给Pandoc(通常通过pandoc_args(潘多克_ args)
输出格式的选项)。这样可以确保首先执行输出格式的过滤器。要更改默认值,您需要以自定义格式处理它(即修改fmt$pandoc$lua_filters
,如重新排序)。
- 新建导出函数
pkg_file_lua()
获取包含在包源中的Lua过滤器的完整系统路径安装/rmarkdown/lua
文件夹(谢谢,@阿图西, #1903).
修复了的路径分隔符css公司
Windows下HTML输出文件的YAML frontmatter中的参数。以前,在中使用正斜杠css公司
路径被转换为反斜杠(谢谢,@乔纳森·g, #1862).
自rmarkdown公司1.16,潘多克围栏Div公司
当输出格式为LaTeX时,将转换为LaTeX环境,例如。,::{.center数据latex=“”}
已转换为\开始{居中}
.属性数据-语言
的Div公司
是强制性的,即使它是空的。在rmarkdown公司2.2,我们悄悄地放弃了这一要求,这意味着:::{.center}
已转换为\开始{居中}
。这是一个坏主意,因为用户无法控制要转换为LaTeX环境的Div。以前,他们可以通过数据-语言
属性,但具有rmarkdown公司2.3,所有Div都无条件地转换为LaTeX环境。更重要的是,此更改导致了如下错误https://stackoverflow.com/q/62340425/559676和https://github.com/rstudio/bookdown/issues/883。因此数据-语言
属性在此版本中再次成为必需的。如果LaTeX环境不需要参数,可以使用data-latex=“”
.
两个Lua fitlers分页符.lua
和latex-div.lua公司
(引入于rmarkdown公司1.16)也适用于输出格式波束_表示
现在(谢谢,@黄祥云, #1815).
使用自定义格式时输出格式
功能,预编织(_K)
,opts挂钩
、和编织钩
现在可以引用rmarkdown::元数据
先前,rmarkdown::元数据
返回列表()
在这些功能中(谢谢,@阿图西,#1855)。
rmarkdown::find_external_resources()
现在可以发现外部模板文件。这反过来修复了html_文档
使用闪亮的
运行时和中间_目录
设置(谢谢,@阿图西,@cderv公司, #1865).
添加了number_sections(节数)
以下格式的参数:github_document(github_文档)
,ioslides_演示
,md_文档
,odt文档
,powerpoint_presentation(电源点表示)
,rtf文档
,slidy_presentation(slidy_presentation)
,文字_文档
它们由Lua过滤器供电,需要Pandoc>2.0。它将无声地对以前的pandoc版本没有任何影响(谢谢@阿图西1893). Pandoc>=2.10.1添加--节数
对于docx格式,因此文字_文档
更喜欢本机特性而不是Lua过滤器(谢谢,@jooyoungseo公司, #1869).
对于输出格式pdf文档
,选项图_裁剪
除非同时启用两个程序,否则不会启用pdfcrop公司
和幽灵手稿
被找到(谢谢,@达鲁普斯,yihui/knitr#954)。
修复了一个包含类的块的错误折叠-隐藏
隐藏其余块,甚至隐藏输出格式设置html_document(code_folding=“show”)
(谢谢,@阿图西, #1906).
更新的文档渲染()
为了更清楚地说明如何为输出格式
参数(谢谢,@乔纳森·g,#1907和rstudio/bookdown#930)。
将一些CSS样式(例如下划线、小大写和多列布局)从最新Pandoc的HTML模板移植到rmarkdown公司的HTML模板(谢谢,@阿图西, #1878, #1908).
导出了内部函数查找pandoc()
,还添加了两个参数,目录
和版本
,以便用户可以提供一个自定义目录,此函数可以在该目录下找到Pandoc,以及预期的Pandoc版本(谢谢,@康诺普,#1785)。
pandoc_metadata_arg()
是要生成的新Pandoc助手函数--元数据
Pandoc命令行的参数(谢谢,@cderv公司, #1789).
输出格式html_vignette()
现在警告您注意在标题
字段和内部指定的字段\渐晕图索引条目{}
通常情况下,它们应该是相同的(#1789)。
修复了渲染时编码的错误html_notebook
包含HTML小部件(谢谢,@cderv公司, #1799).
现在可以为指定目录标题html_文档
通过顶级选项toctile公司
在YAML前沿事务中(谢谢,@阿图西, #1771).
浮动TOC现在可以区分大小写(谢谢,@阿图西, #1783).
什么时候?code_folding=“显示”
用于输出格式html_文档
,通过指定块选项,代码块最初可以单独隐藏class.source='fold-hide'
(谢谢,@阿图西, #1798).
对于LaTeX/PDF输出格式pdf文档
,波束表示
、和上下文_文档
,论点引用包=“无”
已弃用,并且citation_package=“默认”
如果要由以下人员处理引文,则应使用pandoc-citeproc公司
(谢谢,@尼巴特,rstudio/bookdown#754)。
输出格式()
现在可以继承保持(_M)
和清洁支持
从基本格式(_F)
什么时候无效的
传递给这些参数。以前,必须显式指定keep_md(保留md)
和/或清洁支持
作为真的
或错误的
在里面输出格式()
因为它们无法继承相应的选项基本格式(_F)
。此行为与的其他参数不一致输出格式()
(谢谢,@阿图西, #1823).
这个聪明的
大多数输出格式的参数已被删除,因为Pandoc聪明的
默认情况下启用扩展,并设置智能:false
对于输出格式没有任何影响(这可能被认为是一个错误,但我们想去掉这个选项,因为它只存在于Pandoc 1.x的历史原因中,而Pandoc 2.x已经发布两年多了)。如果要禁用聪明的
扩展名,您可以使用选项md_extensions:智能
输出格式的,@阿图西,#1774)。
pdf文档()
不应指定几何学
变量时文档类
变量被传递给Pandoc(谢谢,@卷叶猴, #1782).
渲染()
现在,在使用Pandoc 2.8或更高版本渲染脚本时,尊重R脚本中的YAML元数据(谢谢,@恩索兰佐#1740,@cderv公司#1741)。
对于pandoc_convert()
,当参数to=“pdf”
,将更改为“乳胶”
内部(谢谢,@约翰内斯·弗里德里希, #1802).
渲染(run_pandoc=FALSE)
不再清理Markdown文件(通常由Rmd编织而成)(谢谢,@BrianDiggs公司, #1812).
添加了从返回的输出闪亮::runApp()
在内部rmarkdown::run()
(谢谢,@斯科勒克, #1760).
YAML标头现在已在中正确解析html_notebook
的中间产物.knit.md(编织)
文件,以便像添加书目这样的功能再次起作用(谢谢,@永远黑暗的,@cderv公司, #1747).
ioslides_演示
模板不再生成空<h2>
标记时间字幕
未在YAML中指定(谢谢,@jooyoungseo公司#1735,@克格鲁兹#1663).
不再居中#收割台
中的元素html_vignette()
输出(谢谢,@埃米尔·维特费尔特, #1742).
确保临时目录()
存在(通过tempdir(真)
)将HTML依赖项写入临时文件时,因为此目录可能会被意外删除(谢谢,Kurt Hornik,还有@卡拉伍#1743).
添加了幻灯片级别
的参数slidy_presentation()
(https://stackoverflow.com/q/59157211/559676).
删除了中的jQuery依赖项html_document_base()
(#1723). 为了避免像#1723这样的错误,Pandoc 2.8用户必须升级到Pandoc 2.9+。
对于pdf文档
,Pandoc生成的水平规则(v2.8之前)在TeX Live的最新版本中停止工作,与https://github.com/jgm/pandoc/issues/5801(即硬编码\线条粗细
到0.5磅
)应用于rmarkdown公司(谢谢,@cderv公司, https://stackoverflow.com/a/58646915/559676).
对于输出格式pdf文档()
,我们不再调整标题区域的垂直间距。这意味着PDF文档标题上方将有较大的间距。如果您喜欢旧(较小)间距,请下载https://github.com/rstudio/rmarkdown/blob/f6961af/inst/rmd/latex/compact-itle.tex并通过包括
的选项pdf文档
。但是,请注意,这意味着您不能在作者
除非您使用自定义LaTeX模板,否则将显示YAML前件的字段。使用默认的LaTeX模板,您将遇到#1716中的错误。此外压实层
不再支持YAML中的选项。
中的R代码头部-包括
在早期版本的rmarkdown公司。在将代码传递给Pandoc之前,应该对其进行评估(谢谢,@主控制室#1709,@cderv公司#1710).
这个编码
参数不再传递给中间产物_发生器
R标记输出格式。这个中间产物_发生器
函数只能接受参数输入文件
和中间_目录
现在(请参见?rmarkdown::output_format
). 这对开发人员来说是一个突破性的变化。如果您是输出格式开发人员,则必须删除编码
您的中间产物_发生器
如果输出格式使用此函数。
这个编码
参数不再传递给提供
站点生成器的元素(请参见?rmarkdown::render_site
).
这个编码
参数已从中的许多内部函数中删除rmarkdown公司包装。现在假设所有输入文件都是UTF-8编码的。如果您看到错误消息,如“error in乐趣(arg=…)
:未使用的参数(arg=。。。
)“,请将问题(带有可复制的示例)提交给https://github.com/rstudio/rmarkdown。
添加了新的输出格式上下文文档()
支持ConTeXT输出(谢谢,@RLesur公司#1725,@jooyoungseo公司#1713).
render_site()
如果设置了自动旋转:true
在里面_站点.yml
(谢谢,@泽希奥, #1564).
补充提取
的参数md_document()
。其默认值为“.md”。此参数旨在与一起使用变体
参数(例如。,variant=“上下文”
和ext=“.pdf”
)(谢谢,@阿图西, #1715).
ioslides_presentation()
样式表已更新以便打印。浏览器会收到通知,演示文稿应优先以横向打印,不留边距(谢谢,@RLesur公司, #1718).
恢复了修复程序#1703并对#1700应用了替代修复程序,因为原始修复程序带来了新的错误#1714(谢谢,@巴勃罗伯纳乌 @cderv公司 @埃弗隆 @阿罗纳特金斯).
标签不适用于Pandoc 2.8(谢谢,@mnazarov公司, #1723).
这个pdf文档
如果头部-包括
YAML中的字段是一个空列表(谢谢,@cderv公司, #1728).
这个pandoc-citeproc公司
现在可以在Windows上正确找到二进制文件。这修复了一个问题pandoc_citeproc_convert()
(谢谢@cderv公司, #1651).
补充自包含
的参数html_渐晕
要保留中间目录,如果self_contained=错误
(谢谢,@cderv公司, #1641).
现在可以使用\newpage(新页面)
或\分页符
Rmd文件中的命令。这是可能的,因为Pandoc的pagebreak Lua过滤器。请参阅vignette(“lua过滤器”,package=“rmarkdown”)
(谢谢,@cderv公司, #1626).
Pandoc扩展ascii_标识符
默认情况下不再启用。如果你还需要它,你可以用这个参数md_extensions=“+ascii_identifiers”
在输出格式函数中。然而,请注意,这将在未来版本的Pandoc中触发错误。
输出格式可以由任意YAML文件配置,该文件过去被限制为_输出.yml
或_输出.yaml
。可以通过输出(_yaml)
的论点渲染()
或输出(_yaml)
YAML前端的顶级参数,将使用现有的第一个参数。如果输出(_yaml)
都是为指定的渲染()
然后是YAML的头条新闻渲染()
具有优先权。如果没有找到,那么_输出.yml
或_输出.yaml
如果存在(谢谢,@阿图西, #1634).
添加了一个Pandoc-Lua过滤器,以便在输出格式为乳胶
或光束发生器
.基本上是围栏式潜水:::{.NAME data-latex=“[选项]”}
已转换为\开始{NAME}[选项]\end{NAMEneneneep
在LaTeX。属性数据-语言
必须提供,即使它是空字符串(这意味着LaTeX环境没有任何可选参数)。例如,:::{.verbatim data-latex=“”}
生成逐字记录
环境,以及::{.minipage data-latex=“{.5\textwidth}”}
生成\开始{迷你页}{.5\textwidth}
。此Lua筛选器最初由编写@RLesur公司在https://github.com/yihui/bookdown-crc/issues/1。它将允许用户创建用于HTML和LaTeX输出的自定义块(例如,信息框或警告框)。
补充keep_html
的参数github_document(github_文档)
因此,要在工作目录中保存预览HTML文件(谢谢,@阿图西, #1650).
对于pdf文档()
,当YAML封面中指定自定义文档类别或几何设置时,请勿将边距覆盖为1英寸(谢谢,@正在运行, #1550)
的默认值编码
此包中所有函数中的参数(例如渲染()
和render_site()
)已从更改getOption(“编码”)
到UTF-8型
。我们一直希望只支持UTF-8rmarkdown公司,针织者,以及未来的其他相关软件包。有关更多信息,请阅读https://yihui.org/en/2018/11/biggest-regret-knitr/。
选项toc_float:真
对于html_文档
现在保留文本格式(谢谢,@代码实习生, #1548).
对于输出文件
的论点渲染()
,如果文件名不包含扩展名(例如。,render('foo.Rmd','html_document',output_file='bar')
将生成工具栏.html
); 请参阅帮助页?rmarkdown::render
有关详细信息(谢谢,@重新装填, #1551).
当临时浮动(_F)
为启用html_文档
格式(谢谢,@卡罗琳·克莱顿#1235和@RLesur公司#1243).
修复了第二次执行发光_预渲染
文档包含href公司
依赖关系会导致渲染前检查错误(谢谢,@斯科勒克, #1562).
这个*_文件
由于对上一版本中的#1503和#1472进行了不适当的修复,目录未被正确清除(谢谢,@wxli0型#1553,@cderv公司#1566).
添加了一个输出_扩展
的参数pdf文档()
可以启用/禁用LaTeX输出格式的Pandoc扩展(谢谢,@宏远家,rstudio/bookdown#687)。
修复了#1483,它阻止在Firefox中显示三角形<details><summary></摘要></details>
使用了(#1485,@比萨洛)
提供rmarkdown.pandoc.args命令
作为一个针织者中的程序包选项knitr::opts_knit
(#1468,@noamross公司).
添加导出功能pandoc_exec()
,返回包(#1465、#1466)使用的pandoc二进制文件的路径@诺亚姆罗斯).
new_session:true
在里面_站点.yml
原因render_site()
在新的R会话中渲染每个文件,消除了一些跨文件的困难,例如函数屏蔽(#1326,#1443@詹尼伯).
添加了LaTeX命令\直通(passthrough)
在默认LaTeX模板中--列表
潘多克旗(rstudio/bookdown#591)。
中的图标柔性仪表板::valueBox()
由于在前一版本(#1388,rstudio/flexdashboard#189)#1340中升级了FontAwesome,因此没有达到全尺寸。
添加了生成选项卡集下拉列表的功能,可以通过添加.tabset下拉列表
类到标题(例如。,#标题{.tabset.tabset-dropdown}
) (#1405). 谢谢@斯蒂芬弗里奇贡献必要的代码(1116)。
这个黑暗地
主题(Bootswatch的深色变体平淡地
主题)已添加到html_文档
和html_notebook
(#1409, #889).
修复了当语法突出显示主题不是默认主题(#654,#1399)时,导致代码块上出现滚动条的回归。
修复#1407:反应式表达式可以破坏Shiny R Markdown文档的节标题。
固定#1431:渲染()
使用中间_目录
输出格式为powerpoint_presentation(电源点表示)
有一个习惯引用文档
找不到参考文档。
修复了网站导航栏无法正确显示子菜单的问题(#721,#1426)。
添加了对光亮预渲染文档的检查,以查找所有html依赖项,匹配所有执行包,并匹配主要R版本(#1420)。
添加了一个参数缓存=真
内部功能rmarkdown:::find_pandoc()
,以便用户可以通过rmarkdown:::find_pandoc(缓存=FALSE)
(谢谢,@锤子, #1482).
为简单的R Markdown网站添加了RStudio项目模板,以便用户可以从RStudio:新项目->新目录->简单R降价网站
(谢谢,@凯维努西, #1470).
修复#1471:Pandoc(2.x版)的语法高亮显示主题与Bootstrap样式不匹配(谢谢,@gponce-ars公司#1471,@cderv公司#1489).
修复了呼叫时#1224和#1288中的警告渲染()
用绝对值输出目录(_D)
或中间_目录
.
修复#1300:呼叫渲染()
具有中间_目录
当中间目录位于不同的设备或文件系统上时,可能会失败。
修复#1358:呼叫渲染()
具有中间_目录
如果Rmd文档包含动态生成的书目文件,则将失败。
添加了新参数幻灯片级别
到powerpoint_presentation()
(#1270).
这个锡锡合金包已成为必需的依赖项(要将R标记生成PDF)。
补充压实层
变量设置为LaTeX默认模板,以控制LaTeX的使用标题
包裹;默认为真的
(#1284).
pdf_document(模板=空)
不工作(#1295)。
恢复对R Markdown网站使用任何HTML格式的能力(#1328)。
添加选项
的参数页面_表格()
以启用显式传递显示选项。
添加pandoc_citeproc_convert()
用于转换书目文件(例如BibTeX文件)的功能。
更新至Font Awesome 5.0.13版(#1340)。
添加站点资源()
用于计算网站所需的资源文件的功能。
导出默认站点生成器()
功能。
这个最新文档(_document)
格式不应该清理图形目录(谢谢,@埃米尔特布,rstudio/bookdown#582)。
启用更改输出文件的后处理器,以指定基本后处理器仍应应用于原始输出文件。
修复了一个问题df_print:分页
其中未打印行名称并添加了对的支持行名称.打印
选项来控制打印时间。
添加聪明的
的选项文字文档()
格式。
在生成波束形成器演示时保存渲染中间体(修复#1106)。
修复了指定NULL/NULL/empty参数值(#729和#762)时出现的问题。
当无法预呈现文档时,错误消息更好。(#1125)
光泽::renderText()
不适用于降价部分标题(#133)。
这个价值
的论点pandoc_variable_arg()
现在可能会丢失(#287)。
ioslides演示文稿支持背景色和图像(#687)。
如果通过呈现另一个Rmd文档,则无法呈现Rmd文件中的HTML小部件rmarkdown::render()
在本文档中(#993)。
努力清理在渲染()
(#820).
在Shiny R Markdown文档中评估R代码块的环境错误(#1162,#1124)。
不要打电话围巾
当文档中没有引文且输出格式为pdf文档()
具有引用包='natbib'
(#1113).
渲染()
如果输出格式为PDF,但在建立索引或书目(#1166)时出现任何错误,则将停止。
波束呈现()
当引用包!='无'
(#1161).
基于文件的输入在参数化文档中不起作用(#919)。
rmarkdown现在与Pandoc2.0兼容(#1120)。
渲染()
具有中间_目录
R图(#500)失败。
添加了两种新的输出格式最新文档(_document)
和最新碎片(_fragment)
(#626).
HTML输出中图像的相对路径不应解析为绝对路径(#808)。
render_site()
不支持单个Rmd(#793)的多种输出格式。
使用以下生成的下载按钮下载Rmd源文件时,Unicode字符可能会被置乱html_document(代码下载=真)
(#722).
将highlight.js从v1.1升级到v9.12.0(#988,#907)。
争论keep_md=真
实际上保留了标记输出文件knitr::knit()
现在(如文件所述)。以前,它通过将YAML元数据(标题、作者、日期)与原始Markdown输出文件(#450)的主体连接起来,生成一个新的Markdown文件。
对于md_document()
,何时variant==“降价”
和perserve_yaml=真
潘多克论点--独立的
不应使用(#656)。
添加对df_print的支持以处理其他dplyr类:grouped_df、rowwise_df和tbl_sql。
添加新的运行时:shiny_presendered
交互式文档的模式。
在运行时将“section-”前置到ids:shinny[_prendered]以消除与shinny输出id的潜在冲突
对highlight.js、pagedtables、slidy、ioslides和navigation使用html_dependencies(运行时的改进依赖行为:shirn[_prendered])
序列化运行时:闪亮的[_prendered]依赖于JSON而不是.rds
ioslides:在连接attr[“class”](#836)之前检查是否为null
添加rmarkdown.onKnit/onKnitCompleted包装挂钩
当读入R作为列表名称(#841)时,yaml文件中的非ASCII键也应标记为UTF8
删除分页表(#829)中的键-列特殊情况左对齐
替换浮动目录标题中的反斜杠(#849)
tibble的建议而非导入(R 3.0兼容性)
添加分页表
在HTML文档中打印分页表的功能
支持{.active}
用于设置初始活动选项卡的属性(#789)
添加编织根目录
的参数渲染()
和YAML标题,方便设置knitr的root.dir选项
改进浮动目录子主题中文本的对齐方式
无法呈现YAML中包含正斜杠的书目文件路径(#875)
修复了如果路径包含多字节字符,渲染R笔记本的尝试可能失败的问题。
修复了默认Beamer模板在某些版本的pandoc(<=1.17.2)的段落之间没有提供垂直填充的问题。
尝试在Windows上自动安装latexmk
补充数据框_打印
html_document格式的选项,用于可选打印数据帧knitr::卡布尔
,的易怒的
包或任意函数
修复render_site无法正确显示中文字符的问题
修复了忽略显式传递给呈现的knit_meta的问题
参数编辑:不允许NULL覆盖以前的状态
参数编辑:修复带有表达式的参数的错误名称
参数编辑:当参数配置为使用“多”选择器时,允许多个值
切换了添加格式依赖项的顺序html_文档
以便额外依赖项(_D)
在引导等之后添加到末尾(#737)
pdf_document(保持时间=真)
将生成.tex文档,即使PDF转换失败(#779)。
将乳胶页眉包含移动到\开始{document}之前
运行时的特殊“全局”块标签:shinny,指定块在全局环境中运行一次且仅运行一次(多用户shinny文档的启动性能改进)
确保支持文件是可写的(#800)
使“显示代码”按钮对CSS更友好(#795)
排除输出目录(_D)
来自站点文件(#803)
导出导航栏html
和yaml_front_matter公司
功能
总悬浮量
不再自动设置toc=真
添加了一个参数错误
到pandoc_available()
当(如果)错误=真
)找不到所需版本的pandoc。
补充html_notebook
用于创建包含源代码和输出的HTML文档的格式。
补充resolve_output_format(解决输出格式)
函数(用于需要镜像默认格式解析逻辑的前端提供
).
补充代码_下载
选择html_文档
提供在文档中嵌入Rmd源代码的可下载副本的选项。
补充幻灯片级别
选项设置用于单个幻灯片的标题级别。
补充硬线断裂
选择github_document(github_文档)
处理GitHub的降价渲染器在换行方面的行为变化。
对pandoc自包含html
当pandoc>=1.17时(此版本中修复了pandoc挂起的错误)
默认高亮显示引擎html_文档
现在重点介绍bash、c++、css、ini、javascript、perl、python、r、ruby、scala、stan和xml
补充打印
子期权临时浮动(_F)
控制用户打印HTML页面时是否显示目录。
补充自述文件
选择html_渐晕
它除了渲染vignette外,还自动创建包级别的README.md(用于GitHub)。
支持keep_md(保留md)
在里面html签名
格式。
如果可执行文件latexmk.exe存在,请尝试在Windows上自动安装latexmk包。
设置的能力opts挂钩
在里面针织品(_O)
(#672)
补充渲染器站点
以及用于将目录内的文档集合呈现为网站的相关功能。
能够使用简单的yaml格式定义html_document导航栏。
补充预编织(_K)
和后编织
输出格式挂钩。
发现乳胶
依赖项并将它们添加到.tex码
前导码(#647)
新增所有输出格式
函数枚举为Rmd注册的所有输出格式。
更改图_标签
对于所有格式,默认为TRUE
更改图_retina
HTML格式为2(不再取决于图_标签
)
在绑定到pandoc目录(#632)之前,确保pandoc二进制文件存在
处理“default_output_format”(#638)的相对路径
从html_document中消除重复的视口元标记
为Pandoc 1.15.2(#643)的LaTeX模板添加了书目乳胶书目样式支持
允许覆盖html_document自定义css中的页眉字体大小(#652)
修复了出现带代码折叠的水平滚动条(#654)
指定总悬浮量
在里面html_文档
现在自动设置toc=真
启用每头opt-out oftoc浮动
通过{.toc-ignore}属性
正确处理ioslides_presentation(#661)中的软换行
不要将文本模式用于代码折叠btn(非默认主题中的文本可见性)
修复了从.md文件呈现非HTML格式的问题(在knit之前解决运行时问题)
html_dependency_脚踏板
现在接受theme=“default”参数
当pandoc>=1.17.0.2时,使用pandoc 1.17.0.2兼容的LaTeX模板
支持的自定义模板ioslides_演示
补充分析
的选项ioslides_演示
用于谷歌分析
删除了额外的标签<p></p>
围绕代码块的HTML输出(通常由htmltools生成),以避免像<p><div></div><p>
(#685)
为OpenDocument文本输出添加了odt_document格式
为rtf格式输出添加了rtf_document格式
为github风格的降价输出添加了github_document格式
仅对主题化HTML文档应用白色背景(#588)
- 补充
设置为默认的HTML模板,以使其更好地与移动浏览器配合使用。(#589)
指定–在自定义pandoc参数后筛选pandoc-citeproc
代码块中的长行将被包装在html_vignette()
输出(#595)
添加了新参数run_pandoc=真
和knit_meta=空
到渲染()
。请参阅的帮助页提供
了解详细信息。(#594)
这个簇状讲义
format现在委托给凝灰岩
包,不再提供基本模板。
当pandoc>=1.15.2时,使用pandoc 1.15.2兼容的LaTeX模板
修复Beamer模板和pandoc 1.15.2的问题
将嵌入式JQuery更新至v1.11.3,将Bootstrap更新至v3.3.5。
公开核心HTML依赖项以供自定义R标记格式使用。
新建html文档
主题:“流明”、“纸”、“砂岩”、“单纯形”和“雪人”。
能够包含多年龄段的引导程序导航栏html_文档
网站
添加了对的支持摘要
字段到html_文档
格式
添加了对浮动目录的支持(通过tocify)html文档
通过在顶级标题上使用{.tabset}类增加了对选项卡集的支持
添加了对中R代码块的折叠/展开的支持html_文档
支持网址
CSS文件中的引用运行时:闪亮
将通用选项文件的名称更改为_输出.yml
调整中使用的pandoc转换pandoc自包含html
为了防止挂起较大的脚本元素(使用“markdown”而不是“markdown-strict”作为输入格式)
当输出为LaTeX/PDF且在Windows上使用引用包natbib或bibrate时,在将书目文件传递给Pandoc之前,将删除文件扩展名.bib。这是因为MikTeX中的bibtex总是将扩展名.bib添加到书目文件中,例如它将foo.bib视为foo.bb.bib。(#623)
在干净的环境中渲染闪亮的文档;修复了Shiny文档中的代码可以访问内部R标记状态的问题