概念
在本地设置一个 RStudio 项目
让我们来看看如何在本地设备上创建一个 RStudio 项目。
创建网站
RStudio 的新项目向导使得创建基于 Hugo 框架的 blogdown 网站变得非常简单。以下是创建我们网站的步骤:
- 启动 RStudio,并在 R 控制台中运行
install.packages("blogdown")安装blogdown包。 - 通过菜单:文件 > 新建项目 > 新建目录 > 使用 blogdown 创建网站,创建一个新的 RStudio 项目。
- 将网站配置为使用 Hugo Anatole 主题,将“Hugo 主题”字段设置为
lxndrblz/anatole。点击“创建项目”以生成网站。
我们可以参考以下幻灯片来直观了解操作步骤。
若想使用除 Anatole 以外的其他主题,请前往 Hugo 主题 页面查找并选择所需主题。在主题主页点击“下载”,查看 GitHub 上的源代码。复制 GitHub URL 中的 <username>/<theme-name> 部分,然后将其添加到网站配置中的 Hugo 主题参数里。例如,如果源代码位于 devcows/hugo-universal-theme 仓库中,可将该信息填入 Hugo 主题参数。
如何本地运行网站
blogdown 包提供了一个便捷函数 serve_site()。当加载了网站的 RStudio 项目后,在 R 控制台中运行此函数,即可在 RStudio 的“查看器”面板或浏览器中渲染出网站的本地副本。
该功能最出色之处在于:当我们对网站文件进行修改并保存后,本地预览会实时更新并即时反映更改。这一 blogdown 的特性被称为 LiveReload,它使用户能够在不离开 RStudio 环境的情况下测试想法并获得即时反馈。
在 RStudio 中启用文章插件
添加新文章最简便的方式是使用 RStudio 插件中的“新建文章”功能。请按以下步骤使用该方法创建新文章:
- 选择标记为“新建文章”的 RStudio 插件。
- 配置新文章,指定文章的“标题”、“作者”、“日期”、“子目录”和“格式”。此时暂不填写“标签”和“分类”。请确保将新文章放入 “post/” 子目录,并将“格式”设为 R Markdown(
.Rmd)。 - 更新(或创建)文章元数据中的参数,包括
title、author、summary、date、output、tags和categories。