Log message:
(textproc/R-rmarkdown) Updated 2.10 to 2.19
rmarkdown 2.19
================================================================================
- No longer use `xfun::isFALSE()` internally.
rmarkdown 2.18
================================================================================
- `rmarkdown::render()` argument `output_file` is now used for all
output formats, if there is only one name for multiple output
formats (thanks, @MaelAstruc, #2421).
- Custom output formats can provide a custom function to convert
Markdown input to the desired output format now. To do so, define
the output format via `output_format(pandoc =
pandoc_options(convert_fun = function(...) {}))`. The default
converting function is `pandoc_convert()` in this package. See the
help page `?pandoc_options` for more details.
rmarkdown 2.17
================================================================================
- `rmarkdown::render_site()` will now also look for `index.rmd` in
addition to `index.Rmd` for custom site generator in YAML with
`site:` (thanks, @kamalsacranie, #2409).
- Icons in tabset dropdown are now correctly shown, including when
`self_contained: false` (thanks, @cpsievert, #1697).
rmarkdown 2.16
================================================================================
- Pandoc 2.19 has deprecated the argument `--self-contained`. If you
have installed Pandoc 2.19+, **rmarkdown** will use
`--embed-resources --standalone` as recommended by Pandoc for output
formats that use the option `self_contained = TRUE` (#2382).
- `pandoc_version()` returns a version number of the form
`X.Y.Z.YYYY.MM.DD` for the nightly build of Pandoc now, where
`YYYY.MM.DD` is its build date. Previously it would return
`X.Y.Z.9999` to indicate the nightly version.
rmarkdown 2.15
================================================================================
- Fix navbar issue with website when using Boostrap 5 with **bslib**
(thanks, @guasi, #2379, @cpsievert, #2384).
- The `tufte_handout()` function inside **rmarkdown** is defunct
now. Its codebase was moved to the **tufte** package in 2016, and
this function was marked as deprecated in 2021. Please use
`tufte::tufte_handout()` instead of
`rmarkdown::tufte_handout()`. The latter will be removed eventually
from this package.
- `github_document()` gains `math_method = "default"` and defaults to
it. No special processing will be done to inline maths in `$` and
block maths in `$$` as now [Github supports
\
it](https://github.blog/changelog/2022-05-19-render-mathematical-expressions-in-markdown/)
and will render using Mathjax (thanks, @kylebutts, #2361).
rmarkdown 2.14
================================================================================
- Improved highlighting theme `arrow` regarding accessibility.
- Fixed an issue with `site_generator()` detection of a site project
(thanks, @bhattmaulik, #2344).
- Fixed an issue with Shiny prerendered documents and Pandoc not
correctly rendering last Markdown paragraph in HTML (thanks,
@gadenbuie, #2336).
- Fixed a bug that `site_generator()` fails to detect the root dir of
the site and causes infinite recursion (thanks, @fisher-j, #2339).
- `html_vignette()` gains `code_folding` argument (thanks, @atusy, #2340).
- `html_document()` can opt-out `code_folding = "show"` or \
`"hide"`
for individual code blocks by adding the `fold-none` class to the
code blocks (thanks, @atusy, #2348).
- When using a development version of Pandoc, a `.9999` suffix is
appended to version number so that `pandoc_available()` can
correctly compared version with last release.
rmarkdown 2.13
================================================================================
- Fix an issue with older R version and vignette building (#2324).
- Fix an issue with older R version and `preserve_yaml = TRUE` in
`md_document()` (#2325).
- Long title in `ioslides_presentation` failed to work with Pandoc
2.17.x (thanks, @Am386DX-40, #2327).
rmarkdown 2.12
================================================================================
- `html_document()` and `html_document_base()` gains the `math_method`
argument to support [all the math rendering engines from
Pandoc] (https://pandoc.org/MANUAL.html #math rendering-in-html):
"mathjax", "katex", "mathml", "webtex", \
and "gladtex". For backward
compatibility, the `mathjax` argument still works and will take
precedence over `math_method`, but we recommend using the new
`math_method` argument instead of the `mathjax` argument, and the
latter could be deprecated in the future.
You can specify a math engine via `math_method` as an engine name, e.g.,
```yaml
output:
html_document:
math_method: katex
```
or provide both a name and a URL (for `mathjax`, `katex` and `webtex`):
```yaml
output:
html_document:
math_method:
engine: mathjax
url: https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-chtml-full.js
```
For `math_method = "katex"`, KaTeX CDN will be inserted in version
0.15.2 by default (from jsdelivr). A custom URL toward another CDN
can be passed as `url`.
For `math_method = "webtex"`, it will default to inset SVG using
`https://latex.codecogs.com/svg.image?`. Use
`https://latex.codecogs.com/png.image?` for PNG. See
https://latex.codecogs.com for supported options (dpi, background,
...).
Most HTML output format using `html_document()` or
`html_document_base()` as based format should benefit from this new
feature. See `?rmarkdown::html_document()` for details (thanks,
@atusy, #1940).
- `github_document()` also gains the `math_method` argument set to
`"webtex"` by default so that LaTeX equations can be rendered in the
Github Markdown document as images. Previously, LaTeX equations were
not rendered. Set `math_method = NULL` to deactivate.
- Added support for [**katex**](https://docs.ropensci.org/katex/) R
package as a math engine with `math_method = "r-katex"` in HTML
documents. This method offers server-side rendering of all the
equations, which means no JS processing is needed in the browser as
with usual KaTeX or MathJaX methods. (thanks, @jeroen, #2304).
- `anchor_sections` can now be easily customized using `style` or
`depth` element for `anchor_sections`. For example:
```yaml
output:
html_document:
anchor_sections:
style: symbol # use symbol style ("hash", "symbol", \
"icon")
depth: 2 # max depth to apply anchor on (default to max which is 6)
```
Customizing using a CSS rule is still possible. Detailed explanation
and examples have been added to the help page `?html_document`.
- Improved the highlighting mechanism in formats that supports `highlight` argument:
* It is now possible to pass a custom theme file `.theme` in
`highlight` argument for customizing the [syntax highlighting
style used by
Pandoc](https://pandoc.org/MANUAL.html#syntax-highlighting).
* In addition to Pandoc's own supported themes, two more themes are
bundled in the package: `highlight: arrow` a theme [optimized for
accessibility and color contrast](https://www.a11yproject.com/)
(thanks to @apreshill), and `highlight: rstudio` to mimic the
RStudio editor theme.
* For HTML output only, added optional
[downlit](https://downlit.r-lib.org/) support in `html_document()`
for R syntax highlighting and autolinking. Use `highlight_downlit
= TRUE` to activate it (same argument as in **distill**). This
features require the **downlit** package.
- Templates for `html_document()` and `ioslides_presentation()` gained
a new CSS rule to display single line `<summary>` content inline
(rstudio/rstudio#10589).
- `md_document()` gained a new `standalone` argument, which is `FALSE`
by default unless `toc = TRUE`. This allows to output authors, date
and other metadata per the Pandoc's template. Due to limitation in
how Pandoc is handling metadata blocks in its extensions
`yaml_metadata_block`, `preserve_yaml = TRUE` now deactivate any
extension to let **rmarkdown** directly handle the keeping of YAML
block - this means it does not set `standalone = TRUE` by
default. Meanwhile, `github_document()` gained the `preserve_yaml`
argument (thanks, @florisvdh, #2297).
- Added `available_templates()` to list all the templates from a
specific package that can be used with `rmarkdown::draft()`.
- Following support in Pandoc 2.15, `powerpoint_presentation()` gained
a `incremental` argument as other slide formats. As a reminder,
setting `incremental = TRUE` will make lists to display
incrementally. See more in [Pandoc's
MANUAL](https://pandoc.org/MANUAL.html#incremental-lists).
- Added support for Pandoc's `dir` variable in HTML templates. This is
the second [Language
Variables](https://pandoc.org/MANUAL.html#language-variables) after
`lang`.
- Added a global option `rmarkdown.html_dependency.header_attr`
(`TRUE` by default). It can be set to `FALSE` to opt-out the HTML
dependency `html_dependency_header_attrs()` in documents based on
`html_document_base()` (thanks, @salim-b rstudio/bookdown#865,
@maelle r-lib/downlit#1538).
- Rendering using `runtime: shiny_prerendered` or `runtime: shinyrmd`
now natively supports custom templates. Previously since 2.8,
developers had to add a special comment, `<!-- HEAD_CONTENT -->`,
conditionally to `shiny-prerendered` variable. (See also NEWS from
2.8 for the previous behavior). The new behavior inserts required
special comment `<!-- HEAD_CONTENT -->` as a last element of
`$header-includes$`. If templates rely on the old behavior and
require some contents between `$header-includes$` and `<!--
HEAD_CONTENT -->`, consider including them with `$header-includes$`
(thanks, @atusy, @gadenbuie #2249).
- A shiny prerendered document with only a empty server context does
not error anymore. Document will be rendered with a empty server
function and `server.R` file will be ignored. To use `server.R`, no
server context should be present in the Rmd document (thanks,
@jcheng5, #2305).
- Fixed a regression with rendering `shiny_prerendered` document
(thanks, @aronatkins, @gadenbuie, #2218).
- Fixed an issue in `beamer_presentation()` where `header-includes`
would be overwritten by `includes = list(in_header =)` (thanks,
@samcarter, #2294). Same fix as for `pdf_document()` (#1359).
- Fixed broken links to section headers when `number_sections = TRUE`
is specified in `md_document` and `github_document` (thanks, @atusy,
#2093).
- `draft()` now works with `devtools::load_all()` and **testthat**
when used in other packages.
- Lua Filters: Added two more functions in `shared.lua` for other package to use:
* Added `type()` function backward compatible following Pandoc 2.17 changes.
* Added `print_debug()` for easier logging during debug.
- Add opt-in `tabset` option to the `html_vignette`. In contrast to
the similar feature from `html_document`, this feature supports
navigation from ToC and URL. Any custom formats can introduce this
feature by using an exported function `html_dependency_tabset()`
(thanks, @atusy, #2313).
rmarkdown 2.11
================================================================================
- Relative paths in parent directories in the `css` argument of
`html_document()` were incorrectly normalized to absolute paths by
#2095 in v2.8. Now relative paths in parent directories will no
longer be converted to absolute paths (thanks, @daijiang,
yihui/xaringan#331).
- It is possible to specify the version of jQuery via a global option
now, e.g., `options(rmarkdown.jquery.version = 2)` (note that the
default major version is `3`). This is mainly for advanced users and
developers to test different versions of jQuery.
- `pandoc_citeproc_convert()` now handles correctly bib file
containing specific UTF-8 characters on non default UTF-8 systems
like Windows (thanks, @mitchelloharawild, #2195).
- Shiny prerendered documents are now pre-rendered in a child
environment to avoid allowing the results of static code chunks to
exist in the Shiny app environment (@gadenbuie, #2203).
- The previously unexported function `convert_ipynb()` is exported now
(thanks, @acircleda).
|
Log message:
(textproc/R-rmarkdown) Updated 2.3. to 2.8
rmarkdown 2.8
================================================================================
- Fix a issue with Pandoc 2.5 and `latex-div.lua` - documents can now
be rendered as expected without error (thanks, @davidwales, #2121).
- Fix an issue with styling and code folding button behavior when
default is `code-folding: show`. The Button can now be correctly
style according to state as `aria-expanded` attributes is correctly
updated. Also, new classes has been added on the button to allow
styling during transition: `btn-collapsing` and `btn-expanding` are
respectively applied during transition Show to Hide and Hide to
Show. (This follow [Bootstrap behavior for the collapsible
block](https://getbootstrap.com/docs/3.4/javascript/#collapse))
(thanks, @steveharoz, #2085).
- Fix an issue with `citation_package` having no effect when using
`.md` file as input to `render()` with latex and PDF output formats
(thanks, @andrewheiss, #2113).
- A new internal option `rmarkdown.knit.ext` has been added to control
the extension of the intermediary knit output during a rendering. It
defaults to `md` to produce `*.knit.md`. Only useful for very
advanced usage (#2098).
- `render()` won't produce any `*.utf8.md` intermediary file
anymore. This was a leftover from previous versions of
**rmarkdown**. Since **knitr** 1.24 and **rmarkdown** 2.0, only
UTF-8 input files are allowed. (#2098).
- Fix an `Invalid cross-device link` error when `tempdir()` is used
for `intermediates_dir` in `render()` (thanks, @gorgitko, #2096).
- Fix a regression in HTML default template with floating toc
incorrectly placed on small size window (thanks, @grimbough, #2071)
- Provided a `runtime: shiny` fix for output formats that pass a
modified `bslib::bs_theme()` object to `html_document_base()`'s
`theme` (thanks, @cpsievert, #2049).
- Rendering using `runtime: shiny_prerendered` or `runtime: shinyrmd`
will now produce valid HTML by not inserting anymore the full
document as body in the resulting shiny apps (thanks, @dakep,
#1912). Header content usually containing html dependencies will be
inserted in the HTML document at the end of the head before
`</head>`, unless the rendered HTML contains `<!-- HEAD_CONTENT -->`
special comment (see `htmltools::renderDocument()`). A new Pandoc
variable is set in for shiny prerendered document to allow
conditional insertion of such content in the the HTML template using
`$if(shiny-prerendered)$`. This has been done in all HTML template
in this package. Users of custom template should make this change to
provide support for this runtime. See **rmarkdown** default template
(`default.html`) for an example (#2064).
- Added `tectonic` as a supported LaTeX engine for generating PDF
output (thanks, @dpryan79, #2078). You can specify to use this by
adding `engine: "tectonic"` to your output format in YAML, such as
`pdf_document`.
- When no `output_format` is provided in any way but an `output_file`
is provided in `render()`, the default format will be determined
based on the extension: `"pdf_document"` for `.pdf`, or
`"word_document"` for `.docx`. Otherwise, it will be
`"html_document"` as previous version (thanks, @pearsonca, #1569).
- Added a new global option `rmarkdown.render.message`. When set
`FALSE`, `render()` will not output the message starting by `Output
created: ` allowing RStudio IDE to open a preview of the
document. This is useful for package developers that would need to
emit there own output message for there custom format. See
`?render_site` for more info on this special message (#2092).
- Internal changes regarding Lua filters. They have now an explicit
Pandoc version minimal requirement: A filter will be skipped with a
warning printed by the Lua filter if this requirement is not
met. For now, all filters work for Pandoc 2.1 and above (thanks,
@atusy, #2088). There is also now a new mechanism to have a share
Lua filter script loadable by other Lua files: `render()` will set
the `RMARKDOWN_LUA_SHARED` env var to the path of Lua filter
`shared.lua` so that other filters can access functions defined in
it using `dofile(os.getenv 'RMARKDOWN_LUA_SHARED')`. This is for
internal usage only to avoid duplication (thanks, @tarleb, #2103).
- `html_document_base` gains a `css` argument, to which
`html_document`'s `css` argument is now passed. This also fix an
issue when `.sass` or `.scss` files are used with this `css`
argument when `self_contained: FALSE`. Moreover, **sass** caching
mechanism can now be used when passing `.sass` or `.scss` files to
the `css` argument (thanks, @cpsievert, #2095).
- The `fig_crop` option of PDF document formats (such as
`pdf_document` and `beamer_presentation`) supports the value
`"auto"` now, which means `fig_crop = TRUE` when figure cropping
tools `pdfcrop` and `ghostscript` are available.
- The default value of the `fig_crop` option of PDF output formats has
been changed from `TRUE` to `"auto"` (#2077).
- `rmarkdown::tufte_handout` has been deprecated and will be removed
in the future from this package. It has been moved to the **tufte**
package since **rmarkdown** 0.9.5 (released on 2016-02-22). Please
use `tufte::tufte_handout` instead.
rmarkdown 2.7
================================================================================
- `html_document` (and `html_document_base`)'s `theme` parameter now
understands `bslib::bs_theme()` objects/arguments, meaning that one
may opt-into Bootstrap 4 and more easily create custom themes. For
examples, see <https://github.com/rstudio/rmarkdown/pull/1706>, and
for context, see <https://rstudio.github.io/bslib/> (thanks,
@cpsievert, #1706).
- Files with `.scss`/`.sass` extension (i.e., Sass files) provided to
`html_document`'s `css` parameter are now compiled to CSS using the
`{sass}` package. Also, if `theme` is a `{bslib}` object, these Sass
files may utilize Sass code inside the `theme` (thanks, @cpsievert,
#1706).
- Fix an issue with line numbering in code chunks when `.numberlines`
with Pandoc's highlighting (thanks, @aosavi, #1876).
- Fix an issue with shiny runtime and `global.R` (thanks,
@liaojiahui-r, rstudio/flexdashboard#298).
- Accept `latex="{options}"`, `latex=1`, or `latex=true` for Latex
Divs.
- Add `output_format_filter` function to
`default_site_generator()`. Enables custom site generators to
customize or even entirely replace the output format right before
rendering of each page.
- Automatically exclude **renv** directory for `render_site()`
(thanks, @jmbuhr, #1996)
- Do not force `options(htmltools.preserve.raw = TRUE)` when this
option has been set, otherwise it is impossible for other packages
to turn this option off, e.g., yihui/xaringan#293.
- `knitr_options_pdf()` will now throw a warning when `fig_crop =
TRUE` but is disabled because required tools `pdfcrop` and/or
`ghostscript` are missing (thanks, @netique, #2016).
- Eliminated the unnecessary padding in code blocks in the
`html_document` output with Bootstrap 4 themes (thanks, @atusy,
#2019).
- `github_document()` will produce a working TOC even if some headers
start with number (#2039).
- Fix an issue with `knit_print.data.frame`. The `...` arguments are
no more passed to `print()` to avoid passing `knit_print()`
arguments `options` and `encoding` to custom `print()` methods
(#2047).
rmarkdown 2.6
================================================================================
- Encoding is correctly handled now in `html_vignette` when checking
for identical title and vignette index entry (thanks, @py-b, #1978).
- `clean_site()` now default to `preview = TRUE` and will no more
remove files without notice. This change will affect the "Clean All"
button in the "Build" pane for website project. `clean_site(preview
= FALSE)` must be run to effectively remove files (#1973).
- The intermediate `.tex` file is now correctly deleted if `keep_tex =
FALSE` when the R Markdown document is not rendered from the working
directory (thanks, @vqv, #1308).
- Fix a bug causing certain resources files to be deleted as
intermediate files when `intermediates_dir` is the same as the input
(thanks, @bellma-lilly, #1248).
- Fix issues with `anchor_sections = TRUE` and **learnr** (thanks,
@gadenbuie, #1938).
- Enable use of `server.R` and `global.R` alongside `runtime:
shinyrmd` documents.
- `pkg_file_lua()` now works with `devtools::load_all()` and
**testthat** when used in other packages.
- Fix `pandoc_convert(citeproc = TRUE)` not supressing the `--natbib`
or `--biblatex` options (thanks, @atusy, #1932).
- `pandoc-citeproc` is now activated if a `bibliography` field is
defined in another YAML block instead of the first YAML block
(thanks, @bwiernik, #1364).
- Specify that `htmltools::htmlPreserve()` should use the pandoc raw
attribute rather than preservation tokens when pandoc >= v2.0. Note
that this option will have the intended effect only for versions of
htmltools >= 0.5.0.9003.
- `anchor_sections` in `html_documents()` now defaults to `FALSE`. It
was introduced in previous version with a default to `TRUE`, but it
is reverted now after hearing feedbacks from the community (thank
you!). The `#` is still used as the character for the anchor but you
can easily change that using CSS rules. Examples have been added to
the help page `?html_document`.
- Using Pandoc's default for `--email-obfuscation` now. Previously, it
was set to `none` explicitly, which is the default for Pandoc
1.17.2+ anyway. Only users with a Pandoc version before 1.17.2 may
see a change in the content of the html source file produced if the
document contains email addresses. This change allows to pass the
Pandoc's command line flag if you want to set it to another value
(thanks,@seankross, #1969).
````yaml
output:
html_document:
pandoc_args: ["--email-obfuscation", "javascript"]
````
See [Pandoc's
manual](https://pandoc.org/MANUAL.html#option--email-obfuscation)
for the meaning of this option.
- Fix Fontawesome 5 icons in navbar by correctly handling new prefix
as `fa` has been deprecated in favor of `fas` or `fab` (#1967)
rmarkdown 2.5
================================================================================
- Tables without header rows (wich can be possible in Pandoc's [simple
table](https://pandoc.org/MANUAL.html#extension-simple_tables)) are
now formatted correctly when using `html_document()` format (thanks,
@fkohrt, #1893).
- `html_document()` gains the `anchor_sections` argument, which is
`TRUE` by default, so that readers can get links to section headers
easily---when you mouse over a section header, you will see a hash
symbol `#` at the end of the header, which contains the anchor link
to this header. You can click on this link and get the URL in the
addres bar of your web browser, or right-click on it and copy the
URL from the context menu. The hash symbol is defined by the CSS
rule `a.anchor-section::before {content: '#';}`. You can customize
it by overriding this rule (e.g., via the `css` argument of
`html_document`) and use any other symbols or icons, e.g., `content:
"\02AD8;"` (thanks, @atusy, #1884).
- `pkg_file_lua()` should have thrown an error if the expected Lua
file does not exist.
- Provide `files_dir` and `intermediates_dir` as attributes on return
from `render()` when `run_pandoc = FALSE`.
- Supports new Pandoc 2.11 `--citeproc` flags usage instead of
`pandoc-citeproc` external filter. `pandoc_convert()` and
`pandoc_citeproc_convert()` will now use the correct flags according
to the Pandoc version used. The logic is exported in
`pandoc_citeproc_args()`. See [Pandoc release
note](https://github.com/jgm/pandoc/releases/tag/2.11) for more
information about the new `citeproc` processing (#1916).
- Fixed the code highlighting when code block is hidden. Previous
version introduced a regression where non default code highlighting
was still shown when `code_folding` is activated and code block is
hidden (thanks, @matthewcarlucci, #1921).
- The minimal required version for the **xfun** package (v0.15) has
been specified for R Markdown Notebooks to work properly (thanks,
@jmcphers, #1923).
- Fixed a bug in `convert_ipynb()` when the language is not specified
in the `.ipynb` file (thanks, @acca3003, #1925).
- Introduce `runtime: shinyrmd` as a more user friendly alias for
`runtime: shiny_prerendered`.
rmarkdown 2.4
================================================================================
- Lua filters handling has been improved internally with some
- user-facing changes (#1899): New exported function
- `pandoc_lua_filter_args()` to return the Pandoc command-line
- argument to add a Lua filter. New argument `lua_filters` in
- `pandoc_options()` to pass the Lua filter paths to use with a
- format. This allow output format authors to add filters for a
- custom format using the `pandoc` argument of `output_format()`
- and to get filters from a format using `fmt$pandoc$lua_filters`.
- The Lua filters of an output format are now passed to Pandoc in
- `render()`. By default, they are passed to Pandoc before any
- other format-defined or user-defined Pandoc arguments (usually
- via the `pandoc_args` option of an output format). This ensures
- that filters of an output format are executed first. To change
- the default, you need to deal with it in a custom format (i.e.,
- modify the elements in `fmt$pandoc$lua_filters`, such as
- reordering them). New exported function `pkg_file_lua()` to get
- the full system path of a Lua filter included in a package
- source within the `inst/rmarkdown/lua` folder (thanks, @atusy,
- #1903).
- Fixed the path separators for the `css` parameter in YAML
frontmatter for HTML output files under Windows. Previously, forward
slashes in `css` paths were converted to backslashes (thanks,
@jonathan-g, #1862).
- Since **rmarkdown** 1.16, Pandoc's fenced `Div`'s are converted to
LaTeX environments when the output format is LaTeX, e.g., `:::
{.center data-latex=""}` is converted to `\begin{center}`. The
attribute `data-latex` of the `Div` was mandatory, even if it is
empty. In **rmarkdown** 2.2, we silently drop this requirement,
which means `::: {.center}` is converted to `\begin{center}`. This
turns out to be a bad idea, because users have no control over which
Div's to be converted to LaTeX environments. Previously, they could
opt-in by the `data-latex` attribute, but with **rmarkdown** 2.3,
all Div's are converted to LaTeX environments
unconditionally. What's more, this change led to bugs like
https://stackoverflow.com/q/62340425/559676 and
https://github.com/rstudio/bookdown/issues/883. Therefore the
`data-latex` attribute became mandatory again in this version. If
the LaTeX environment does not need arguments, you may use
`data-latex=""`.
- The two Lua fitlers `pagebreak.lua` and `latex-div.lua` (introduced
in **rmarkdown** 1.16) are also applied to the output format
`beamer_presentation` now (thanks, @XiangyunHuang, #1815).
- When customizing formats with the `output_format` function,
`pre_knit`, `opts_hooks`, and `knit_hooks` can now refer to
`rmarkdown::metadata`. Previously, `rmarkdown::metadata` returned
`list()` in these functions (thanks, @atusy, #1855).
- `rmarkdown::find_external_resources()` now discovers external
template files. This in turn fixes the rendering issue of
`html_document` with the `shiny` runtime and `intermediate_dir` set
(thanks, @atusy, @cderv, #1865).
- Added the `number_sections` argument to following formats:
`github_document`, `ioslides_presentation`, `md_document`,
`odt_document`, `powerpoint_presentation`, `rtf_document`,
`slidy_presentation`, `word_document`. These are powered by a Lua
filter and requires Pandoc > 2.0. It will silently have no effect
has before with previous pandoc version (thanks @atusy 1893).
Pandoc >= 2.10.1 adds `--number-sections` for docx format, and thus
`word_document` prefers the native feature to the Lua filter
(thanks, @jooyoungseo, #1869).
- For the output format `pdf_document`, the option `fig_crop` will not
be enabled unless both the programs `pdfcrop` and `ghostscript` are
found (thanks, @dalupus, yihui/knitr#954).
- Fixed a bug that a chunk with a class `fold-hide` hides the rest of
the chunks even the output format setting
`html_document(code_folding = "show")` (thanks, @atusy, #1906).
- Updated documentation for `render()` to make it clearer how options
are set for the `output_format` parameter (thanks, @jonathan-g,
#1907 and rstudio/bookdown#930).
- Ported some CSS styles (e.g., underlines, small caps, and
multi-column layouts) from the latest Pandoc's HTML template into
**rmarkdown**s HTML templates (thanks, @atusy, #1878, #1908).
|
Log message:
(textproc/R-rmarkdown) Updated 2.1 to 2.3
rmarkdown 2.3
================================================================================
- Addressed an accessibility issue in highlighted code blocks of HTML
output for screen reader users: screen readers no longer read out an
unnecessary code line id values (thanks, @jooyoungseo and @atusy,
#1833).
- Added `file_scope` option to output format definition. This enables
handling of duplicate numeric footnote identifiers (e.g. across
bookdown chapters) via the pandoc `--file-scope` option (#1837).
- Added the customizable `lang` atrribute to `ioslides_presentation`
output (thanks, @jooyoungseo, #1841).
- Added `publish_site()` function for "one-button" publishing of R
Markdown websites.
- When the `df_print` option is `kable` and the output format is not
HTML, `<div class="kable-table">` is no longer added to the
`kable()` output, because recent versions of Pandoc will convert the
`div` to a LaTeX environment when the output format is LaTeX
(thanks, Laurens, https://stackoverflow.com/q/62340425/559676).
- `html_vignette()` only warns against differences in the vignette
title and the vignette index entry for R >= 3.6.0 (thanks, @krlmlr,
#1832).
- `html_document()` can apply `code_folding` on any chunk engines if
the `foldable` class is added to a source code block via the chunk
options (`class.source` or `attr.source`). You may apply this
feature to all the source code blocks, for example, by setting
`knitr::opts_chunk$set(class.source = "foldable")` at the beginning
of your document (thanks, @atusy, #1835).
rmarkdown 2.2
================================================================================
- Exported the internal function `find_pandoc()`, and also added two
arguments, `dir` and `version`, so that users can provide a custom
directory under which this function may find Pandoc, as well as an
expected version of Pandoc to be found (thanks, @connorp, #1785).
- `pandoc_metadata_arg()` is a new Pandoc helper function to generate
`--metadata` argument for Pandoc command line (thanks, @cderv,
#1789).
- The output format `html_vignette()` now warns against differences in
the vignette title specified in the `title` field in the YAML
metadata and the one specified inside
`\VignetteIndexEntry{}`. Normally they are expected to be identical
(#1789).
- Fixed a bug with encoding when rendering `html_notebook` containing
HTML widgets (thanks, @cderv, #1799).
- TOC title can now be specified for `html_document` via the top-level
option `toc-title` in the YAML frontmatter (thanks, @atusy, #1771).
- Floating TOC can now distinguish upper/lower-cases (thanks, @atusy,
#1783).
- When `code_folding='show'` for the output format `html_document`,
code blocks can be individually hidden initially by specifying the
chunk option `class.source='fold-hide'` (thanks, @atusy, #1798).
- For LaTeX/PDF output formats `pdf_document`, `beamer_presentation`,
and `context_document`, the argument `citation_package = 'none'` was
deprecated, and `citation_package = 'default'` should be used
instead if citations are to be processed by `pandoc-citeproc`
(thanks, @njbart, rstudio/bookdown#754).
- `output_format()` can now inherit `keep_md` and `clean_supporting`
from `base_format` when `NULL` is passed to these
arguments. Previously, you must explicitly specify `keep_md` and/or
`clean_supporting` as `TRUE` or `FALSE` in `output_format()` since
they could not inherit the corresponding options of
`base_format`. This behavior was not consisent with other arguments
of `output_format()` (thanks, @atusy, #1823).
- The `smart` argument of most output formats has been removed,
because Pandoc's `smart` extension is enabled by default, and
setting `smart: false` for an output format did not really have any
effect (which could be considered a bug, but we want to get rid of
this option since it existed only for a historical reason for Pandoc
1.x, and Pandoc 2.x has been released for more than two years). If
you want to disable the `smart` extension, you can use the option
`md_extensions: -smart` of the output format (thanks, @atusy,
#1774).
- `pdf_document()` should not specify the `geometry` variable when the
`documentclass` variable is passed to Pandoc (thanks, @jpcirrus,
#1782).
- `render()` now respects the YAML metadata in the R script when
rendering the script with Pandoc 2.8 or later (thanks, @nsoranzo
#1740, @cderv #1741).
- For `pandoc_convert()`, when the argument `to = 'pdf'`, it will be
changed to `'latex'` internally (thanks, @JohannesFriedrich, #1802).
- `render(run_pandoc = FALSE)` no longer cleans up the Markdown file
(typically knitted from Rmd) (thanks, @BrianDiggs, #1812).
|