用R语言的Blogdown+Hugo+Netlify+Github建博客

目标

用R语言的blogdown + hugo + netlify + github搭建静态博客系统,用rstudio专注于写作。

优点

个性域名

免费,无限流量

静态网页,速度快

github保存内容,不需要搭建数据库,不需要备份

准备工作

软件准备

系统:本文以Windows操作系统为例来介绍安装和配置方法。其他操作系统是类似的。

安装R(https://www.r-project.org/)

安装rstudio(https://www.rstudio.com/)

安装git(https://git-scm.com/)

windows下安装很简单,就不描述了。

对于git,作为非程序猿的我,一直想学但是一直没学,直到打算用blogdown建个blog玩之后,就注册了github看看git是怎么玩的,不过我倒不是从命令行学起的(虽然我也玩linux),而是装了个GitKraKen来摸git是怎么玩的,然后再对应的学一点命令行的。其实只需要会add、commit、push、pull、merge就足够对付blogdown了。如果想用github对blogdown的主题启用一个转移魔法的话,可以看git-submodule(https://yihui.name/cn/2017/03/git-submodule/)。

我们这里并不需要安装GitKraKen,因为rstudio已经有git的gui功能了,所以上面提到的命令怎么打也不用学,直接在rstudio上点点点。

rstudio配置

安装好上述软件后,需要对rstudio进行一下简单配置:

这个是生成PDF文件用的,中文用户最好选择XeLaTeX

安装好git后,打开这里应该就可以看到git的路径了

建议选择一个距离你比较近的镜像,速度会快点。例如,国内用户可以选择一个 China 的镜像。

安装blogdown和hugo

安装blogdown:

install.packages('blogdown')

安装hugo

blogdown::install_hugo()

如果安装hugo的时候出现下面的错误(貌似有同志也有这个问题):

> blogdown::install_hugo()

The latest hugo version is 0.32.4

trying URL 'https://github.com/gohugoio/hugo/releases/download/v0.32.4/hugo_0.32.4_Windows-64bit.zip'

trying URL 'https://github.com/gohugoio/hugo/releases/download/v0.32.4/hugo_0.32.4_Windows-64bit.zip'

Error in download.file(url, ..., method = method, extra = extra) : cannot open URL 'https://github.com/gohugoio/hugo/releases/download/v0.32.4/hugo_0.32.4_Windows-64bit.zip'

In addition: Warning messages:

1: In download.file(url, ..., method = method, extra = extra) : InternetOpenUrl failed: ''

2: In download.file(url, ..., method = method, extra = extra) : InternetOpenUrl failed: ''

这个时候就直接安装开发版,就可以解决:

install.packages("devtools")

devtools::install_github("rstudio/blogdown")

如果安装了开发版的blogdown,还没有搞定,那么就把错误信息中的链接复制到浏览器直接下载,把文件解压发现里面就只有一个文件,Yihui选择hugo就是因为hugo只有一个文件,够简单,至于为什么我会知道Yihui选择hugo的原因?因为我读了blogdown故事(https://yihui.name/en/2017/12/blogdown-book/)。

把解压好的hugo.exe文件放在根目录下,然后输入下面代码安装hugo:

# 注意这里是三个冒号

blogdown:::install_hugo_bin("d:/hugo.exe")

安装成功。

不知道是不是网络国际出口的问题,最近从github下载文件都比较慢(浏览github网页倒没有问题),经常用安装包都不成功,就算用浏览器下载hugo也经常出现错误,估计这就是用安装不了的原因吧。

ok,我们来到这里,暂时离开一下rstudio,我们去弄弄github。

注册域名

怎么注册域名就不详说了,国内的有万网等,国外有GoDaddy之类的,选择国内服务商的话,域名要备案,国外就可以省略这个步骤。

下面的内容是针对已经申请个人域名来展示的。

用github创建repository

如图所示填写好repository name、Description,默认选择Public,可以选择复选框Initialize this repository with a README,选择吧,点击Create repository就可以创建好用于保存网站的repository。

这个repository name没有要求,随便起,不像github的pages服务要求名字和github的账号名称一样,建议起名domainname.com,当你有多个网站要管理的话,这样就可以一眼就可以看出是那个网站了,我自己当时就不知道可以用点,所以也不知道这样来起名字。

blogdown建站

创建项目

现在回到rstudio,,然后填写Repository URL:,应该自动就生成了,可以选择一个合适的文件夹存放,点击Create Project创建项目。

设置gitignore

打开rstudio右下角的标签,点击文件,改成下面这样吧(copy Yihui的):

.Rproj.user

.Rhistory

.RData

.Ruserdata

public

static/figures

blogdown

上面的文件或者目录就不会提交到github上。

如果对git命令不是很熟悉,建议在这个时候就把文件修改好的,因为在生成public文件夹之后(后面的步骤会生成public),再修改文件添加文件夹,那么标签那里还是不会把public文件夹忽略掉,要解决这个问题,可以按如下操作:

git rm -r --cached public

# 然后在.gitignore文件添加规则

public

这样下次的 git add .就不会把public加进去了。

初始化blogdown

打开:

因为我们已经安装了hugo,所以去掉hugo选项,Yihui是建议用hugo-xmin主题开始我们的blogdown之旅的,所以这里就选择了hugo-xmin。点击创建项目。

有人会疑问为什么要两次新建项目?这并不是必须,其实可以不做创建项目这一步,不过就要另外一个步骤,把本地项目同步到github仓库,可以按下面步骤处理(详细解释可以看这里):

cd

git init

git add .

git commit -m "first comment"

git remote add origin https://github.com//

git remote -v

git pull origin master --allow-unrelated-histories

git push -u origin master

本地运行网站

到这里,博客已经可以在本地运行,我们试试看吧,点击菜单下面的,如下图所示:

点击,可能会提示安装几个包例如shiny、miniUI等,点击yes安装就行了,其实点击这个跟在console里面输入是一样的,如果你还没有安装写轮眼xaringan(https://github.com/yihui/xaringan),会有下面的warning信息:

Warning message:

In eval(quote({ :

The xaringan package is not installed. LaTeX math may not work well.

我们乖乖的按照提示把写轮眼安装了吧(网页上的数学公式用的是MathJax.js实现):

install.packages("xaringan")

这个时候,已经可以在右下角标签看到网站的美貌了:

Keep it simple, but not simpler

我们也可以在浏览器输入来浏览。

写博客

又来点击菜单下面的,这次我们点击,就会弹出下面这个画面:

处会自动帮你填写为处的内容,和还是建议使用字母,尤其是,如果博文里面不需要用到R语言的代码计算结果生成图表的话,处就选择格式,这可以省去一些系统生成的步骤,ok,点击,就会在文件夹下面生成一个文件名为这样的文件了,content文件夹下面的文件就是博客的文章了。

这个时候就可以用markdown格式专注于写作了。

关于修改主题

如果你想修改主题,可以到https://themes.gohugo.io/找主题修改。

关于修改主题的非技术TIPS,可以看看下面两段话,引用自Yihui的blogdown使用文档**1.6 Other themes最下面引用的一段话:

If you choose to dig a rather deep hole, someday you will have no choice but keep on digging, even with tears. -— Liyun Chen13

Yihui是这样说的:

Another thing to keep in mind is that the more effort you make in a complicated theme, the more difficult it is to switch to other themes in the future, because you may have customized a lot of things that are not straightforward to port to another theme.

所以呢,可以先把hugo官网上面的主题都浏览一下,看看哪个合眼缘,挑好再改吧。

学习怎么修改主题的另外一个好去处是hugo-xmin的pull request。如果你有好的改进,也可以在这里提交pull request让别人学习。

看看下面的pull request图:

设置netlify

注册netlify

打开netlify(https://app.netlify.com/signup)主页就可以注册了,直接在Sign up with one of the following:下面选择GitHub就行了。

绑定github

然后按照下面的图填写就可以了:

因为hugo生成的文件夹是所以填public。

点击就可以生成网站了。

这个时候可以再去到一个叫的地方(如下图所示),确保选项选中的是,就是只deploy master分支。

设置个性二级域名

这个时候生成的网站网址是,点击导航栏的,再点击,就可以输入你的英文名字,这时就得到一个netlify的二级域名。

绑定个人域名

如果你不满足于netlify的二级域名,还可以选择绑定个人域名。

点击左边导航栏的,

然后点击,这个时候就可以输入你在域名提供商处注册的域名了。

修改域名服务器

添加域名后,点击如上图所示的小红点处,选择,然后就跳转到页面,这里应该是不用做操作的(我忘记了,应该是自动添加了的),如果没有记录,就点它添加吧,如下图所示:

上图的Nameservers部分有四条netlify的dns服务器域名,把他们添加到你注册域名的Nameservers就可以了,我在域名服务商里面的设置如下图所示:

到此,所有的基本设置都已经完成。

更新博客内容

  • 发表于:
  • 原文链接http://kuaibao.qq.com/s/20180204B0U8K800?refer=cp_1026
  • 腾讯「云+社区」是腾讯内容开放平台帐号(企鹅号)传播渠道之一,根据《腾讯内容开放平台服务协议》转载发布内容。

同媒体快讯

扫码关注云+社区

领取腾讯云代金券