html_paged()
and other formats using paged.js
now informs knitr that its JS and CSS dependencies will be loaded by setting the is.paged.js
global knit option. Use isTRUE(knitr::opts_knit$get("is.paged.js"))
to detect it (thanks, @sylvaine31, @davidgohel, #332).Set overflow-x: clip
in default.css
to fix an issue with paged.js rendering in recent browser (thanks, @jimjam-slam, #292, pagedjs/pagedjs#84).
chrome_print()
now attempts to remove the output file before printing to it and throws a clear error if it cannot be removed, as this is potential sign of a locked file, e.g a pdf opened in a PDF reader on Windows (thanks, @aito123, #124, #297).
Figure inserted using markdown syntax and having a caption with (#fig:lab)
are now correctly listed in the LOF (thanks, @adamvi, #283).
Fix an issue in jss_paged()
with Pandoc 2.17 and above.
Fix an issue in html_paged()
with LOT and LOF not showing anymore with Pandoc 2.17 and above (thanks, @adamvi, #280).
Document that the html_letter()
output format modifies the default value of the fig_caption
parameter and allow the user to change it (thanks, @NewGraphEnvironment, #234).
Created an option pagedown.chrome.log
to ease chrome_print()
debugging: when set to TRUE
, the logs of Chrome are saved in the working directory.
Added support for Sass files with .scss
and .sass
extension (thanks, @felipecrp, #244).
loft.lua
filter following changes in Pandoc 2.16 (#249).find_chrome()
now searches for Microsoft Edge on Windows. That allows chrome_print()
to work seamlessly with Microsoft Edge (thanks, @cderv, #160 and #225).chrome_print()
, when printing a document to PDF, the default transfer mode between Chrome and R now uses a stream when this option is available in Chrome. This change ensures that PDF files of any size can be generated (#206 and #224).knitr::kables()
are now vertically aligned by default in html_paged()
, thesis_paged()
and jss_paged()
output formats (thanks, @cderv and @andrew-fuller, #214).Fixed a bug introduced in html_paged()
by pagedown 0.14, the content of each link was lost if it was not textual (thanks, @mcanouil, #226).
Fixed figure and table numbering format in jss_paged()
(thanks, @gglee4ai, #184).
html_paged()
, added two new options lot-unlisted
and lof-unlisted
. If lot-unlisted
(resp. lof-unlisted
) is set to TRUE
in the YAML options, the list of tables (resp. figures) will not be included in a table of contents (thanks, @beatrizmilz, #221).In html_paged()
, links are now sanitized to avoid impossible line breaking of long URLs in a justified text (thanks, @julientaq).
In order to be compatible with the flextable package, pagedown::html_paged()
sets the value of the ft.shadow
chunk option to FALSE
by default (thanks, @tvroylandt and @davidgohel, #216).
The fig_caption
argument is no longer hard-coded to FALSE
in html_resume()
(thanks, @nplatonov, #208).
The multiple use of an abbreviation no longer ends up with duplicated entries in the list of abbreviations (thanks, @linogaliana, #218).
The default value of the counter-reset
CSS property is correctly set to 0 instead of 1 (see https://developer.mozilla.org/en-US/docs/Web/CSS/counter-reset). To reset a page
CSS counter to 1, the following declaration must be used: counter-reset: page 1
(#202).
Numbered example lists (https://pandoc.org/MANUAL.html#numbered-example-lists) are correctly numbered (thanks, @atusy, #122 and #202).
Periods are now supported in titles (thanks, @yves-amevoin and @martinschmelzer, #84, #185 and #202).
Parts titles in the table of contents no longer crash chrome_print()
.
chrome_print()
is now compatible with the stream transfer mode which can be used to generate large PDF files (#205).
chrome_print()
no longer ignores runtime exceptions in Chrome. An R warning is now raised when Chrome encounters a runtime exception (#203).
html_paged()
, the title of the list of abbreviations can now be modified with the loa-title
field in the YAML header (thanks, @jtrecenti, #199).The option anchor_sections
is disabled internally. This option is for rmarkdown::html_document()
to generate anchor links for sections and currently it does not work well for pagedown format for now (#195).
In chrome_print()
, fixed a bug when the R session temporary directory and the current directory are mounted on different Linux file systems. In that case, chrome_print()
failed to add an outline to the PDF and raised the warning cannot rename file ..., reason 'Invalid cross-device link'
(#193).
chrome_print()
no longer ignores the Chrome DevTools event Inspector.targetCrashed
. An R error is now raised when Chrome crashes (#190).chrome_print()
now has a new argument outline
, with which the user can generate the outline bookmarks for the PDF file. Note, this feature requires Ghostscript being installed and detected by tools::find_gs_cmd()
(thanks, @shrektan, #174 and #179).html_resume()
template, avoid page breaks after section titles and inside subsections (thanks, @kevinrue, #170).html_resume()
template, an icon inserted using inline HTML in a section title takes precedence over the default icon and the data-icon
property (thanks, @Tazinho, #168).In chrome_print()
, fixed some connection problems to headless Chrome: in some situations, the R session tries to connect to headless Chrome before a target is created. Now, chrome_print()
controls the target creation by connecting to the Browser
endpoint (thanks, @gershomtripp, #158).
In html_resume()
template, vertical space is removed when details are omitted (thanks, @mrajeev08, #161).
Added support for pagebreaks: in output formats which use paged.js, a pagebreak can be forced using the LaTeX commands \newpage
and \pagebreak
or using the CSS classes page-break-before
and page-break-after
.
reveal.js presentations can be printed to PDF using chrome_print()
.
Using RStudio, any R Markdown HTML output formats can be directly printed to PDF by adding the line "knit: pagedown::chrome_print"
to the YAML header: this line modifies the behavior of the "Knit" button of RStudio and produce both HTML and PDF documents.
chrome_print()
with async = FALSE
, the Chrome processes and the local web server are properly closed when the function exits. This regression was introduced in pagedown 0.6.Added support for MathJax in html_resume
output format (thanks, @ginolhac, #146).
The chrome_print()
function internally uses a private event loop provided by later
1.0.0 when async=FALSE
(thanks, @jcheng5, #127).
Added support for lines numbering in html_paged()
: lines can be numbered using the top-level YAML parameter number-lines
(thanks, @julientaq, #115 and #129).
Added support for covers images in html_paged()
: html_paged()
gains two arguments, front_cover
and back_cover
, to insert images in the front and back covers. Textual contents can also be added in the covers using two special divs of classes front-cover
and back-cover
(thanks, @atusy, #134, #136 and #137).
When chrome_print()
is used with verbose >= 1
, some auxiliary informations about Paged.js rendering are printed (number of pages and elapsed time).
Added a template
argument to the business_card()
output format for passing a custom Pandoc template (thanks, @mariakharitonova, #135).
Fixed several bugs related to MathJax: local version of MathJax is now used when the mathjax
parameter is set to "local"
and self contained documents are rendered by default with MathJax without throwing any warning (#130).
In html_paged
, the nodes tree is sanitized before Paged.js splits the content into pages. This should avoid duplicated content observed when break-after: avoid
and break-before: avoid
are used (#131).
Added an async
argument to chrome_print()
. When async = TRUE
, chrome_print()
returns a promises::promise
object. This allows chrome_print()
to be used inside a Shiny App (thanks, @ColinFay, #91).
Added the support for chapter prefix as in bookdown. Chapter of class chapter
are prefixed with the word Chapter
. This prefix can be changed for internationalization purpose (thanks, @brentthorne, #101 and #107).
Added the support for lists of abbreviations. If the document contains <abbr>
HTML elements, a list of abbreviations is automatically built (thanks, @brentthorne, #102 and #107).
Added the new thesis_paged
template (thanks, @brentthorne, #107).
pagedjs-
. For instance, --width
is replaced by --pagedjs-width
. Users' stylesheets that use Paged.js CSS variables need to be updated. Bleeds and crop marks are now supported. Several bugs are fixed.The default stylesheet of html_paged()
is updated to support the new argument clean_highlight_tags
of bookdown::html_document2()
introduced in bookdown 0.10 (thanks, @atusy, #100).
In chrome_print()
the connection between the R session and headless Chrome now uses the native websocket client provided by the websocket package. The previous workaround which used a websocket server, a websocket tunnel and a browser-based websocket client is removed (reverts #74). chrome_print()
runs faster due to this simplification.
browser is forced to redraw the document after Paged.js finished. This will fix wrong page references observed with Chrome and RStudio 1.2.xxxx (#35 and #46, thanks, @petermeissner).
jsonlite::toJSON()
is now used in chrome_print()
for building all the JSON messages sent to headless Chromium/Chrome: this guarantees that the JSON strings are valid (thanks, @ColinFay, #85 and @cderv, #88).
In uri-to-fn.lua
, use a shallow copy of PANDOC_VERSION
. This is required for Pandoc >= 2.7.3 which changes the type of PANDOC_VERSION
(thanks, @andreaphsz, #111).
Insert page numbers after page references (thanks @atusy, #120).
With Pandoc 2.7.3, page numbers wrongly appear in code blocks.
chrome_print()
has been significantly enhanced. Now it prints web pages and R Markdown documents to PDF through the Chrome DevTools Protocol instead of the simple command-line call (like in v0.1). It also supports capturing screenshots.