- Added a global option
blogdown.hugo.args, which should be a character vector with additional flags to be passed to thehugosystem command viahugo_build(). For example,options(blogdown.hugo.args = '--minify')will use minification on the final rendered output. More available flags in the hugo documentation (thanks, @jozefhajnala, #382).
- When creating a post with a date in the future, a warning will be issued by default. To turn off this warning (if you are aware of the consequences of future dates), set
options(blogdown.warn.future = FALSE)(thanks, @Chucheria on Twitter, #377).
- Added a global option
blogdown.filename.pre_processor, which can be a function with a single argument (the post title) that returns a pre-processed string to be used to generate the post filename. For example, if you setoptions(blogdown.filename.pre_processor = function(x) stringi::stri_trans_general(x, "any-latin; nfd; [:nonspacing mark:] remove; nfc")), Cyrillic characters in a post title can be converted to ASCII, and the result string will be used for generating the post filename (thanks, @novica, #349).
- When previewing a blogdown website with Hugo on the RStudio Server, the Hugo configuration
relativeURLswill be set totrueautomatically (thanks, @nwstephens, #124).
- Added support to install the extended version of Hugo and enabled it as default via
install_hugo(..., extended = TRUE)(thanks, @rgaiacs, #363).
-
The
slugfield in the "New Post" RStudio addin will no longer be automatically changed if the user has manually changed it once (thanks, @eliocamp, #347). -
Added multilingual support in the "New post" RStudio addin (thanks, @novica #344, @Guilz #323).
-
You can create a new post as the index file of a Hugo page bundle via
blogdown::new_post()or the RStudio addin "New Post" if you setoptions(blogdown.new_bundle = TRUE). One benefit of using a page bundle instead of a normal page is that you can put resource files associated with the post (such as images) under the same directory of the post itself. This means you no longer have to put them under thestatic/directory, which has been quite confusing to Hugo beginners (thanks, @DavisVaughan @romainfrancois @apreshill, #351). -
Added an argument
empty_dirstonew_site()so that you can preserve the empty directories viablogdown::new_site(empty_dirs = TRUE). By default, empty directories will be deleted when a new site is created (thanks, @apreshill, rstudio-education/arm-workshop-rsc2019#8). -
Added a global option
blogdown.files_filterto allow users to decide which Rmd files to be rebuilt (this option can be set in.Rprofile). The default filter isblogdown:::timestamp_filter, i.e., only Rmd files which are older than their output files will be recompiled when rebuilding a site. You can setoptions(blogdown.files_filter = blogdown:::md5sum_filter)to use a different filter based on MD5 checksums, i.e., only rebuild an Rmd file if its MD5 checksum has changed. The checksums of Rmd files are saved in the fileblogdown/md5sum.txtunder the website root directory (thanks, @jonathan-g, #341).
- The default value of the argument
kindofnew_post()has been changed from'default'to'', which means this function will respect Hugo's default order of looking for the archetype. TheArchetypedropdown menu of the RStudio addin "New Post" was changed accordingly, and this menu will also list archetypes in themes (thanks, David Daza, https://stackoverflow.com/questions/53309582/53341795#comment93989876_53341795).
- Added an option in the "Update Metadata" addin to rename the post filename accordingly when the date is updated, e.g., when the date is changed from
2018-07-23to2018-07-28, the post file2018-07-23-hello-world.mdcan be renamed to2018-07-28-hello-world.md.
- A bug was introduced when implementing #305: should append
draft: yesto YAML only whenoptions(blogdown.draft.output = TRUE)is set (thanks, @ConorIA, #312).
-
Added a new RStudio addin "Touch File" to update the modification time of a file, which can be useful when you want to force rebuilding a certain Rmd post after running
serve_site()(#294). -
Added an RStudio addin "Quote Poem" to quote a poem using the Markdown syntax (https://yihui.name/en/2018/06/quote-poem-blogdown/).
-
Added a new function
shortcodes(), which is a vectorized version ofshortcode(). For example, you can embed multiple tweets (thanks, @maelle, #307). -
Added an argument
ignoretobuild_dir()to ignore output filenames when testing if the Rmd file is newer than its possible output files. By default,*.Rprojfiles are ignored (thanks, @chepec, #308). -
Added a global option
blogdown.draft.output. Ifoptions(blogdown.draft.output = TRUE)is set, a fielddraft: yeswill be appended to the YAML metadata of the HTML output file from an Rmd post, unless the Rmd post has already set thedraftoption. This means the output files are always drafts unless you explicitly setdraft: noin the YAML metadata of Rmd posts (thanks, @mwaldstein, #305).
-
Applied a workaround for the bug in the
Rscriptcommand: https://stat.ethz.ch/pipermail/r-devel/2018-April/075897.html (reported from https://stackoverflow.com/q/50077412). -
The TOML metadata in new posts may fail to be converted to YAML (thanks, @apreshill, #301).
-
When editing the
config.tomlfile on Windows,serve_site()could fail with an error message'---did you forget a '#'? at line 1>seImpl(path.expand(input), verbose, fromFile): Unidentified trailing character'(thanks, @rhobis, #302).
-
Added a
title_caseargument to thenew_post()function; ifTRUE, the post title will be converted to title case. See?blogdown::new_postfor details. -
Added a
hostnameargument toinstall_theme()andnew_site(), as a complement to thethemeargument. The defaulthostnameis'github.com'; if you have access to GitHub Enterprise, you can use this to specify it instead (thanks, @ijlyttle, #264). -
The
new_postaddin now lets you choose an archetype. See https://gohugo.io/content-management/archetypes/ for more details (thanks, @lcolladotor, #173). -
Added a new RStudio addin (
insert_image) for inserting external images into blog posts (thanks, @lcolladotor, #269). If you useoptions(blogdown.insertimage.usebaseurl = TRUE), it adds the baseurl so that RSS feeds will include the images and be properly displayed in websites such as RBloggers (#275). You will need to publish the images so that they are displayed in a local preview and will need to keep in mind some drawbacks discussed in rstudio#275. -
The
themeargument ofinstall_theme()andnew_site()now accepts a full URL to a theme's repository zip file. This can be used to install themes from other web-based git hosts, like GitLab and Bitbucket (thanks, @gadenbuie, #271). -
You may download the zip archive or tarball of the Hugo installer from Github by yourself, and pass the path to
install_hugo()to install it, e.g.,blogdown::install_hugo('hugo_0.38_Windows-64bit.zip')(thanks, @shrektan, #288).
- The
kindargument (i.e., the archetype) ofnew_content()now works with files that end in.Rmdand.Rmarkdown. The archetype still has to end in.mdfor Hugo to work with it (thanks, @lcolladotor, #261).
- The Github repo
yihui/hugo-lithium-themewas renamed toyihui/hugo-lithium, and the defaultthemeargument value was changed accordingly (thanks, @rorynolan, #291).
- The bug #233 still exists on Windows (thanks, Sheng Luan).
-
install_theme()may signal the error "The theme already exists" by mistake (thanks, @YizhouZheng, #230). -
A warning will be issued if two versions of Hugo are found (thanks, @mingsnu, #235).
-
Plots are missing if a post filename contains multibyte characters (thanks, @dongzhuoer, #233).
- The later package is a required dependency on Windows for
blogdown::serve_site()now (#169).
-
serve_site()failed to parsebaseurlin config.toml when it contains comments (thanks, @ummel, rbind/support#62). -
Three dashes in the beginning and/or end of config.yaml are ignored (thanks, @andrewheiss, #194).
-
The R startup profile
.Rprofileunder the website project root directory should be respected when building R Markdown posts (thanks, @eisioriginal, #222).
- The first CRAN release. For full documentation, please see the blogdown book: https://bookdown.org/yihui/blogdown.