Skip to content

blogdown 1.1

Compare
Choose a tag to compare
@yihui yihui released this 19 Jan 18:48

NEW FEATURES

  • Added new arguments args, baseURL, and relativeURLs to the hugo_build() function to allow users to pass more command-line arguments to Hugo and adjust the configurations baseURL and relativeURLs temporarily when building a site.

  • Added the ... argument to build_site(), to pass more arguments to the hugo_build() function, e.g., blogdown::build_site(relativeURLs = TRUE).

  • Added a global option blogdown.server.verbose to print the web server messages in real time when the server is running. Once enabled (via options(blogdown.server.verbose = TRUE)), you will see messages in the R console like "Change detected, rebuilding site" whenever you make changes to any files (thanks, @apreshill @cderv, #555).

  • Added a new global option blogdown.protect.math (defaults to TRUE) to control whether to protect LaTeX math expressions in a pair of backticks when the post output format is Markdown instead of HTML. The reason to protect math expressions is to avoid the Markdown renderer's treatment of the math content as normal Markdown content, which may mangle the math expressions. If the math expression is protected, it needs to be unprotected later. See https://yihui.org/en/2018/07/latex-math-markdown/ for more information. Note that this option is only relevant to those who use the source format .Rmarkdown or the build method options(blogdown.method = 'markdown') (thanks, @bensoltoff #466, @mrkaye97 #567).

BUG FIXES

  • bundle_site() also moves the .html output files and the *_files//*_cache/ directories associated with .Rmd source posts to page bundles. Previously, only .Rmd files are moved (thanks, @llrs, #568).

  • Fixed a bug of install_theme() when the theme archive contains theme files directly instead of a theme folder (thanks, Stefan Musch, https://stackoverflow.com/q/65702805/559676).

  • Fixed a bug that causes HTML widgets to fail to render in the Markdown output files with htmltools >= 0.5.1.

  • Fixed a bug on Windows that causes check_gitignore() to error when it shouldn't (#571).

MAJOR CHANGES

  • When the site is rendered via a call to rsconnect::deploySite() (e.g., when you call rmarkdown::publish_site(render = TRUE)), blogdown::build_site() will use the argument relativeURLs = TRUE, to make Hugo generate relative URLs that work with any base URL (note that this depends on how well a specific Hugo theme supports relative URLs).

MINOR CHANGES

  • check_netlify() and check_config() do not open files anymore in the IDE if no TODO items were found in them (#569).

  • The internal functions md5sum_filter() and timestamp_filter() have been removed. They were renamed to filter_md5sum() and filter_timestamp(), respectively, and exported in blogdown 1.0. Please use these exported functions instead if you relied on the internal functions previously.