Blogdown

一个开源（GPL-3）R 程序包，用于基于 R Markdown 和 Hugo 生成静态网站。你可以通过 CRAN 或 GitHub 安装程序包

## Install from CRAN
install.packages('blogdown')

## Or, install from GitHub
remotes::install_github('rstudio/blogdown')

你可以在 空 目录下通过函数 blogdown::new_site() 创建一个新网站。它将创建一个骨架网站，从 Github 下载一个 Hugo 主题，添加一些示例内容，启动一个 Web 浏览器，你将看到新网站。示例博客文章 hello-world.Rmd 应该会自动打开，你可以对其进行编辑。在你保存文件后，网站将自动重建，并且页面将刷新。

如果你使用 RStudio，你可以从菜单 文件 -> 新建项目 -> 新目录 -> 使用 blogdown 建立网站 创建一个新的 RStudio 项目，用于你的网站。

函数 blogdown::serve_site() 可能是在这个程序包中使用最频繁的函数。它构建网站，将其加载到你的 Web 浏览器中，并在你更新 Markdown 或 R Markdown 文件时自动刷新浏览器。不要使用命令行 hugo server 来构建或服务该网站。它只识得纯 Markdown 文件，无法构建 R Markdown。

你可能不会满意从 new_site() 创建的默认网站。在你的第一个成功的 blogdown 实验之后，有两件事你可能想要做

1. 从 https://themes.gohugo.com.cn 挑选一个你喜欢的 Hugo 主题。你只需要它的 Github 用户名和仓库名称，以便传递给 new_site() 的 theme 参数。
2. 添加更多内容（页面或文章），或迁移你现有网站。

完整的文档就是 blogdown 书籍，可免费获得，网址是 https://bookdown.org/yihui/blogdown/。我们希望你至少阅读第一章。欢迎你通过 Github 问题 向我们发送反馈，或在 StackOverflow 上使用 blogdown 标签提问。