1rmarkdown 1.8 (unreleased) 2-------------------------------------------------------------------------------- 3 4## BUG FIXES 5 6* `render_site()` does not work with `_site.yml` that does not have the `output` setting (#1189). 7 8* The variables `input` and `output` do not work in Shiny R Markdown documents (#1193). 9 10* `ioslides_presentation` fails to embed images (#1197). 11 12* With Pandoc 2.x, `github_document()` generates the wrong filename extension `.gfm-ascii_identifiers` instead of `.md`, and line height of code blocks in the HTML preview is too big (#1200). 13 14rmarkdown 1.7 15-------------------------------------------------------------------------------- 16 17* Fixed an issue with `df_print: paged` where row names where not printed and 18 added support for `rownames.print` option to control when they print. 19 20* Add `smart` option for `word_document()` format. 21 22* Save render intermediates when generating beamer presentations (fixes #1106). 23 24* Fixed issues when specifying NULL/null/empty parameter values (#729 and #762). 25 26* Better error message when unable to prerender a document. (#1125) 27 28* `shiny::renderText()` does not work in Markdown section headings (#133). 29 30* The `value` argument of `pandoc_variable_arg()` can be missing now (#287). 31 32* Background colors and images are supported for ioslides presentations (#687). 33 34* HTML widgets in an Rmd document cannot be rendered if another Rmd document is 35 rendered via `rmarkdown::render()` in this document (#993). 36 37* Try harder to clean up temporary files created during `render()` (#820). 38 39* Wrong environment for evaluating R code chunks in Shiny R Markdown docs 40 (#1162, #1124). 41 42* Do not call `bibtex` to create the bibliography when there are no citations in 43 the document and the output format is `pdf_document()` with `citation_package 44 = 'natbib'` (#1113). 45 46* `render()` will stop if the output format is PDF but there are any errors 47 during building the index or bibliography (#1166). 48 49* `beamer_presentation()` doesn't work when `citation_package != 'none'` (#1161). 50 51* File-based inputs don't work in parameterized documents (#919). 52 53* rmarkdown is compatible with Pandoc 2.0 now (#1120). 54 55* `render()` with `intermediates_dir` fails with R plots (#500). 56 57* Added two new output formats `latex_document()` and `latex_fragment()` (#626). 58 59* Relative paths of images in HTML output should not be resolved to absolute 60 paths (#808). 61 62* `render_site()` does not support multiple output formats for a single Rmd (#793). 63 64* Unicode characters may be scrambled when downloading the Rmd source file using 65 the download button generated by `html_document(code_download = TRUE)` (#722). 66 67* Upgraded highlight.js from v1.1 to v9.12.0 (#988, #907). 68 69* The argument `keep_md = TRUE` actually preserves the Markdown output file from 70 `knitr::knit()` now (as documented). Previously, it generates a new Markdown 71 file by concatenating the YAML metadata (title, author, date) with the body of 72 the original Markdown output file (#450). 73 74* For `md_document()`, when `variant == 'markdown'` and `perserve_yaml = TRUE`, 75 the Pandoc argument `--standalone` should not be used (#656). 76 77rmarkdown 1.6 78-------------------------------------------------------------------------------- 79 80* Fixed an issue where headers with non-ASCII text would not be linked 81 to correctly in the table of contents. 82 83* Support code folding for bash, python, sql, Rcpp, and Stan chunks. 84 85* Provide rmarkdown.pandoc.id_prefix as Knit option 86 87* Fixed two issue with `df_print: paged`, one would prevent rendering data with 88 lists of lists and the other where the column type would get cut off. 89 90* Better support for `citation_package: biblatex` in `pdf_document()` (#1062). 91 92* On certain Windows platforms, compiling LaTeX to PDF may fail because 93 `system2(stdout = FALSE)` is not supported, in which case the default `system2()` 94 will be used (#1061). 95 96* Allow paged tables to render even when page load / visibility has a long delay 97 98 99rmarkdown 1.5 100-------------------------------------------------------------------------------- 101 102* Fixed an issue where code within Shiny pre-rendered documents was not 103 rendered correctly. 104 105* Add `includes` parameter to `html_fragment` format. 106 107* Use RStudio redirection URL to replace deprecated MathJax CDN 108 109 110rmarkdown 1.4 111-------------------------------------------------------------------------------- 112 113* `data.table` expressions involving `:=` are no longer automatically 114 printed within R Markdown documents. (#829) 115 116* Fix #910: the extra_dependencies argument of pdf_document() does not work when 117 no code chunks contain LaTeX dependencies. 118 119* The extra_dependencies of pdf_document() can also take a character vector of 120 LaTeX package names, or a named list of LaTeX package options (with names 121 being package names), which makes it much easier to express LaTeX dependencies 122 via YAML. 123 124* Automatically ignore packrat directory for render_site 125 126* Fix #943: escape end tags in shiny_prerendered code contexts 127 128* Add support for sticky tabs in html_document via tabset-sticky class 129 130* Process Rmd files with lowercase extension (.rmd) in render_site 131 132* Fix stack space consumption issues with large JS payloads in chunks 133 134* Add `section_divs` argument to html_document and html_fragment to control 135 generation of section tags/divs. 136 137* Remove data-context="(data|server|server-start)" chunks from HTML served 138 to client in shiny_prerendered 139 140 141rmarkdown 1.3 142-------------------------------------------------------------------------------- 143 144* Fix v1.2 regression in ordering of CSS for ioslides_presentation. 145 146* Fix rendering of pagedtables within html_notebook format. 147 148* Ensure that html_prerendered UI is never cached. 149 150* Add `citeproc` argument to YAML header; controls whether pandoc-citeproc is used (#831) 151 152 153rmarkdown 1.2 154-------------------------------------------------------------------------------- 155 156* Add support for df_print to handle additional dplyr classes: grouped_df, 157 rowwise_df and tbl_sql. 158 159* Add new `runtime: shiny_prerendered` mode for interactive documents. 160 161* Prepend "section-" to ids in runtime: shiny[_prerendered] to eliminate 162 potential conflicts with shiny output ids 163 164* Use html_dependencies for highlight.js, pagedtables, slidy, ioslides, 165 & navigation (improved dependency behavior for runtime: shiny[_prerendered]) 166 167* Serialize runtime: shiny[_prerendered] dependencies to JSON rather than .rds 168 169* ioslides: check for null before concatenating attr["class"] (#836) 170 171* Add rmarkdown.onKnit/onKnitCompleted package hooks 172 173* Non-ASCII keys in yaml file should be marked to UTF8 as well, when read 174 into R as the name of a list (#841) 175 176* Remove key-column special-case left alignment in pagedtables (#829) 177 178* Replace backslashes in floating TOC headings (#849) 179 180* Suggests rather than Imports for tibble (R 3.0 compatibility) 181 182* Add `paged_table` function for printing paged tables within HTML documents 183 184* Support `{.active}` attribute for setting initially active tab (#789) 185 186* Add `knit_root_dir` argument to `render()` and YAML header, a convenience 187 for setting knitr's root.dir option 188 189* Improve alignment of text in sub-topics for floating TOC 190 191* Bibliography file paths in YAML containing forward slashes could not be 192 rendered (#875) 193 194rmarkdown 1.1 195-------------------------------------------------------------------------------- 196 197* Fixed an issue where attempts to render an R Notebook could fail if the 198 path contained multibyte characters. 199 200* Fixed an issue where the default Beamer template did not provide vertical 201 padding between paragraphs with certain versions of pandoc (<= 1.17.2). 202 203* Try to install latexmk automatically on Windows 204 205* Added `df_print` option to html_document format for optionally printing data 206 frames using `knitr::kable`, the `tibble` package, or an arbitrary function 207 208* Fix for render_site not showing Chinese characters correctly 209 210* Fix for ignoring knit_meta that is explicitly passed to render 211 212* Parameter editing: don't allow NULL to overwrite previous state 213 214* Parameter editing: fix incorrect name for parameters with expressions 215 216* Parameter editing: allow multiple values when the parameter is configured 217 to use a "multiple" selector 218 219* Switched the order in which format dependencies are added for 220 `html_document` so that `extra_dependencies` are added at the end, after 221 bootstrap, etc. (#737) 222 223* `pdf_document(keep_tex = TRUE)` will generate the .tex document even if PDF 224 conversion fails (#779). 225 226* Move latex header includes to just before \begin{document} 227 228* Special 'global' chunk label for runtime: shiny which designates 229 a chunk to be run once and only once in the global environment 230 (startup performance improvement for multi-user shiny documents) 231 232* Ensure supporting files are writeable (#800) 233 234* Make the "show code" buttons more CSS-friendly (#795) 235 236* Exclude `output_dir` from site files (#803) 237 238* Export `navbar_html` and `yaml_front_matter` functions 239 240 241rmarkdown 1.0 242-------------------------------------------------------------------------------- 243 244* `toc_float` no longer automatically sets `toc = TRUE` 245 246* Added an argument `error` to `pandoc_available()` to signal an error when (if 247 `error = TRUE`) pandoc with the required version is not found. 248 249* Added `html_notebook` format for creating HTML documents that include source 250 code and output. 251 252* Added `resolve_output_format` function (useful for front ends that need to 253 mirror the default format resolution logic of `render`). 254 255* Added `code_download` option to `html_document` to provide an option to 256 embed a downloadable copy of the Rmd source code within the document. 257 258* Added `slide_level` option to ioslides_presentation to set the level of 259 heading used for individual slides. 260 261* Added `hard_line_breaks` option to `github_document` to deal with change 262 in behavior of GitHub's markdown renderer with respect to line breaks. 263 264* Use "markdown_strict" rather than "markdown" for `pandoc_self_contained_html` 265 when pandoc >= 1.17 (pandoc hanging bug was fixed in this version) 266 267* Default highlighting engine for `html_document` now highlights bash, c++, 268 css, ini, javascript, perl, python, r, ruby, scala, stan and xml 269 270* Added `print` sub-option to `toc_float` to control whether the table of 271 contents appears when user prints out the HTML page. 272 273* Added `readme` option to `html_vignette` which automatically creates a 274 package level README.md (for GitHub) in addition to rendering the vignette. 275 276* Support for `keep_md` in `html_vignette` format. 277 278* Try to install the latexmk package automatically on Windows if the executable 279 latexmk.exe exists. 280 281rmarkdown 0.9.6 282-------------------------------------------------------------------------------- 283 284* Ability to set `opts_hooks` in `knitr_options()` (#672) 285 286* Added `render_site` and related functions for rendering collections of 287 documents within a directory as a website. 288 289* Ability to define html_document navigation bar using simple yaml format. 290 291* Added `pre_knit` and `post_knit` hooks for output formats. 292 293* Discover `LaTeX` dependencies and add them to the `.tex` preamble (#647) 294 295* Added new `all_output_formats` function to enumerate all output 296 formats registered for an Rmd. 297 298* Change `fig_caption` default to TRUE for all formats 299 300* Change `fig_retina` to 2 for HTML formats (no longer contingent on `fig_caption`) 301 302* Ensure pandoc binary exists before binding to pandoc directory (#632) 303 304* Handle relative paths for 'default_output_format' (#638) 305 306* Eliminate duplicate viewport meta tag from html_document 307 308* Added biblatex biblio-style support to the LaTeX template for Pandoc 1.15.2 (#643) 309 310* Allow override of header font-size in html_document custom css (#652) 311 312* Fix for horizontal scrollbars appearing w/ code folding (#654) 313 314* Specifying `toc_float` in `html_document` now automatically sets `toc = TRUE` 315 316* Enable per-header opt-out of `toc-float` via {.toc-ignore} attribute 317 318* Correctly handle soft line breaks in ioslides_presentation (#661) 319 320* Don't use text-muted for code folding btns (text visibility in non-default themes) 321 322* Fix for rendering non-HTML formats from .md files (resolve runtime before knit) 323 324* `html_dependency_bootstrap` now accepts theme = "default" argument 325 326* Use pandoc 1.17.0.2 compatible LaTeX template when pandoc >= 1.17.0.2 327 328* Support custom template for `ioslides_presentation` 329 330* Added `analytics` option for `ioslides_presentation` for Google Analytics 331 332* Removed the extra tag `<p></p>` around HTML output (typically generated by htmltools) from code chunks, to avoid invalid HTML like `<p><div>...</div><p>` (#685) 333 334rmarkdown 0.9.5 335-------------------------------------------------------------------------------- 336 337* Added odt_document format for OpenDocument Text output 338 339* Added rtf_document format for Rich Text Format output 340 341* Added github_document format for GitHub Flavored Markdown output 342 343* Only apply white background for themed HTML documents (#588) 344 345* Added <meta name="viewport" content="width=device-width, initial-scale=1"> to 346 the default HTML template to make it work better with mobile browsers. (#589) 347 348* Specify --filter pandoc-citeproc after custom pandoc args 349 350* Long lines in code blocks will be wrapped in the `html_vignette()` output (#595) 351 352* Added new arguments `run_pandoc = TRUE` and `knit_meta = NULL` to `render()`. 353 See the help page of `render` for details. (#594) 354 355* The `tufte_handout` format now delegates to the `tufte` package and no longer 356 provides a base template. 357 358* Use pandoc 1.15.2 compatible LaTeX template when pandoc >= 1.15.2 359 360* Fix issue with Beamer template and pandoc 1.15.2 361 362* Updated embedded JQuery to v1.11.3 and Bootstrap to v3.3.5. 363 364* Expose core HTML dependencies for use by custom R Markdown formats. 365 366* New `html_document` themes: "lumen", "paper", "sandstone", "simplex", & "yeti". 367 368* Ability to include bootstrap navbar for multi-page `html_document` websites 369 370* Added support for `abstract` field to `html_document` format 371 372* Added support for floating table of contents (via tocify) to `html_document` 373 374* Added support for tabsets via use of {.tabset} class on top-level headings 375 376* Added support for folding/unfolding of R code chunks in `html_document` 377 378* Support `url` references in CSS files for `runtime: shiny` 379 380* Change name of common options file to `_output.yml` 381 382* Tweak pandoc conversion used in `pandoc_self_contained_html` to prevent 383 hanging with large script elements (use "markdown" rather than 384 "markdown-strict" as input format) 385 386* The filename extension .bib will be removed before bibliography files are 387 passed to Pandoc when the output is LaTeX/PDF and the citation package natbib 388 or biblatex is used on Windows. This is because bibtex in MikTeX will always 389 add the extension .bib to bibliography files, e.g. it treats foo.bib as 390 foo.bib.bib. (#623) 391 392* Render Shiny documents in a clean environment; fixes issue in which code in 393 Shiny documents could access internal R Markdown state 394 395 396rmarkdown 0.9.2 397-------------------------------------------------------------------------------- 398 399* Added a fix to #580 for Windows users. 400 401 402rmarkdown 0.9.1 403-------------------------------------------------------------------------------- 404 405* Fix for a bug causing certain files to be deleted as intermediate files. (#580) 406 407* PDF/LaTeX output no longer uses natbib as the citation package by default. If 408 you do want to use natbib or biblatex, you may still use the argument 409 citation_package = 'natbib' or 'biblatex'. (#577) 410 411rmarkdown 0.9 412-------------------------------------------------------------------------------- 413 414* Fix for JS exception in slidy_presentation when served from the filesystem 415 (don't call pushState for file:// urls) 416 417* Escape single quotes in file paths 418 419* Fix for missing resources when rendering a filename with shell characters 420 421* For PDF/LaTeX output, citations are processed via natbib or biblatex instead 422 of pandoc-citeproc. The ciation package natbib or biblatex can be chosen using 423 the argument `citation_package` in `pdf_document()`, `beamer_presentation()`, 424 and `tufte_handout()`. LaTeX is compiled to PDF via latexmk 425 (https://www.ctan.org/pkg/latexmk/); if it is not installed, a simple 426 emulation will be used (run pdflatex/xelatex/lualatex, bibtex, and makeindex 427 a few times). You are recommended to install latexmk, and please note latexmk 428 requires a Perl installation (this is important especially for Windows users). 429 430* Always use the graphics package for PDF output 431 432* Fix for the error "cannot change value of locked binding for 'metadata'" when 433 one call of rmarkdown::render() is nested in another one (#248) 434 435* Fix for an issue causing image paths to be rendered incorrectly in Windows 436 when rendering an `html_document` with `self_contained: false` and a path is 437 passed in argument `output_dir`. (#551) 438 439* Add always_allow_html option for preventing errors when html_dependencies are 440 rendered in non-HTML formats (e.g. pdf_document or word_document). 441 442* Fix for an issue causing resources not to be discovered in some documents 443 containing an empty quoted string (`""`) in an R chunk. 444 445 446rmarkdown 0.8.1 447-------------------------------------------------------------------------------- 448 449* Support for table of contents in word_document (requires pandoc >= 1.14) 450 451* Support for opts_template in knitr options 452 453* Don't implicitly discover directories when scanning for dependent resources 454 455* Fix for slide numbers not showing up in ioslides when served from 456 the filesystem (don't call pushState for file:// urls) 457 458* Remove inlining of bootstrap CSS (was workaround for bug now fixed in pandoc) 459 460* Allow specifying an R file in calls to find_all_resources 461 462rmarkdown 0.8 463-------------------------------------------------------------------------------- 464 465* Add support for keep_md to word_document 466 467* Increase pandoc stack size to 512M (often required for base64 encoding 468 e.g. larger embedded leaflet maps). Stack size can also be controlled 469 by the pandoc.stack.size option. 470 471* Allow YAML front matter to be terminated with ... 472 473* Automatically generate a user-interface (via a Shiny application) for 474 user specification of values in parameterized reports. 475 476* Add tightlist macro for compatibility with pandoc >= 1.14 477 478* Bugfix: Don't merge render params recursively with knit_params 479 480* Bugfix: Handle slashes correctly on Windows for slidy_presentation 481 when self_contained = FALSE 482 483 484rmarkdown 0.7 485-------------------------------------------------------------------------------- 486 487* Add latex_engine option to beamer_presentation format 488 489* Ensure that when LANG=en_US pandoc receives en_US.UTF-8 (prevent hang) 490 491* Generate MathJax compatible output when using html_fragment format. 492 493* Use pandoc built-in template for Beamer 494 495* Use pandoc 1.14 compatible LaTeX template when pandoc >= 1.14 496 497* Inline bootstrap.min.css to workaround pandoc 1.14 base64 encoding issue 498 499* Add support for discovering references to external resources when the 500 document output format is PDF 501 502* Fix several issues causing pandoc errors when an intermediates directory is 503 used, including during render for Shiny documents 504 505 506rmarkdown 0.6 507-------------------------------------------------------------------------------- 508 509* Support for parameterized reports. Parameter names and default values are 510 defined in YAML and can be specified via the 'params' argument to the 511 render function 512 513* 'md_extensions' option to enable/disable markdown extensions for input files 514 515* Automatically discover and include dependent resources (e.g. images, css, 516 etc.) for interactive documents. 517 518* Added pandoc_version function. 519 520* Use VignetteEncoding directive in html_vignette format 521 522* Fix issues related to use of non-ASCII characters in ioslides_presentation 523 524* Non-ASCII characters in the YAML data are not marked with the UTF-8 encoding 525 when they are read into R, so character strings in `rmarkdown::metadata` may 526 be displayed incorrectly (#420) 527 528* Various improvements to tufte_handout format 529 530 531rmarkdown 0.5.1 532-------------------------------------------------------------------------------- 533 534* Add 'dev' option to output formats to specify output device for figures 535 536* Enable use of footnotes in titles of LaTeX documents 537 538* Various improvements related to directory detection/handling on Windows 539 540 541rmarkdown 0.4.2 542-------------------------------------------------------------------------------- 543 544* Sync to the latest LaTeX and Beamer templates from pandoc-templates 545 546* Switched from the Bootstrap 2 web framework to Bootstrap 3. This is designed 547 to work with Shiny >= 0.10.3, which has made the same switch 548 549* Add CSS to restore responsive image behavior from Bootstrap 2 550 551* Use a more subtle treatment for inline code in Bootstrap themed documents 552 553* Improved support for multiple authors in ioslides 554 555* Workaround for poor rendering of ioslides multi-columns lists in Safari 8 556 557* Serve index.html as fallback default file for rmarkdown::run 558 559 560rmarkdown 0.3.11 561-------------------------------------------------------------------------------- 562 563Initial release to CRAN 564 565