A note from the authors: Some of the information and instructions in this book are now out of date because of changes to Hugo and the blogdown package. If you have suggestions for improving this book, please file an issue in our GitHub repository. Thanks for your patience while we work to update the book, and please stay tuned for the revised version!

In the meantime, you can find an introduction to the changes and new features in the v1.0 release blog post and this "Up & running with blogdown in 2021" blog post.

— Yihui, Amber, & Alison

1.1 Installation

We assume you have already installed:

If you are not using the RStudio IDE, please install Pandoc (http://pandoc.org). Instructions are available on the reference site (https://pandoc.org/installing.html).

The blogdown package is available on CRAN and you can install it with:

install.packages("blogdown")

1.1.1 Installation troubleshooting

Do you have an old version of blogdown? Compare your version against ours and upgrade if necessary.

packageVersion("blogdown")
## [1] '1.16'

To update blogdown, run install.packages('blogdown').

Do you have old versions of blogdown’s dependencies (such as rmarkdown)? If you are experiencing problems, you may first try to update all R packages:

update.packages(ask = FALSE, checkBuilt = TRUE)

If you are still experiencing issues with blogdown, you may try installing the development version from GitHub:

if (!requireNamespace("remotes")) install.packages("remotes")
remotes::install_github("rstudio/blogdown")

If you use RStudio, it will remind you of restarting R before installing or updating any packages currently in use. If you do not use RStudio, you may need to restart R by yourself.

References

R Core Team. 2022. R: A Language and Environment for Statistical Computing. Vienna, Austria: R Foundation for Statistical Computing. https://www.R-project.org/.