用 R 语言的 blogdown+hugo+netlify+github 建博客.docx
《用 R 语言的 blogdown+hugo+netlify+github 建博客.docx》由会员分享，可在线阅读，更多相关《用 R 语言的 blogdown+hugo+netlify+github 建博客.docx（16页珍藏版）》请在冰豆网上搜索。
用R语言的blogdown+hugo+netlify+github建博客
用R语言的blogdown+hugo+netlify+github建博客
目标
用R语言的blogdown+hugo+netlify+github搭建静态博客系统，用rstudio 专注于写作。
优点
∙个性域名
∙免费，无限流量
∙静态网页，速度快
∙github保存内容，不需要搭建数据库，不需要备份
准备工作
软件准备
系统：
本文以Windows操作系统为例来介绍安装和配置方法。
其他操作系统是类似的。
∙安装R，点此下载
∙安装rstudio，点此下载
∙安装git，点此下载
windows下安装很简单，就不描述了。
对于git，作为非程序猿的我，一直想学但是一直没学，直到打算用blogdown建个blog玩之后，就注册了github看看git是怎么玩的，不过我倒不是从命令行学起的（虽然我也玩linux），而是装了个 GitKraKen 来摸git是怎么玩的，然后再对应的学一点命令行的。
其实只需要会add、commit、push、pull、merge就足够对付blogdown了。
如果想用github对blogdown的主题启用一个转移魔法的话，可以看这里：
git-submodule
我们这里并不需要安装GitKraKen，因为 rstudio 已经有git的gui功能了，所以上面提到的命令怎么打也不用学，直接在rstudio上点点点。
rstudio配置
安装好上述软件后，需要对rstudio进行一下简单配置：
∙Tools->GlobalOptions->Sweave->WeaveRnwfilesusing:
knitr
∙Tools->GlobalOptions->Sweave->TypesetLaTexintoPDFusing:
XeLaTeX
o这个是生成PDF文件用的，中文用户最好选择XeLaTeX
∙Tools->GlobalOptions->Git/SVN->Gitexecutable:
o安装好git后，打开这里应该就可以看到git的路径了
∙Tools->GlobalOptions->Packages->CRANmirror:
o建议选择一个距离你比较近的镜像，速度会快点。
例如，国内用户可以选择一个China的镜像。
安装blogdown和hugo
安装blogdown：
install.packages（'blogdown'）
安装hugo
blogdown:
:
install_hugo（）
如果安装hugo的时候出现下面的错误（貌似有同志也有这个问题）：
>blogdown:
:
install_hugo（）
Thelatesthugoversionis0.32.4
tryingURL'
tryingURL'
Errorindownload.file（url,...,method=method,extra=extra）:
cannotopenURL'
Inaddition:
Warningmessages:
1:
Indownload.file（url,...,method=method,extra=extra）:
InternetOpenUrlfailed:
''
2:
Indownload.file（url,...,method=method,extra=extra）:
InternetOpenUrlfailed:
''
这个时候就直接安装开发版，就可以解决：
install.packages（"devtools"）
devtools:
:
install_github（"rstudio/blogdown"）
如果安装了开发版的blogdown，还没有搞定，那么就把错误信息中的链接复制到浏览器直接下载，把文件解压发现里面就只有一个文件，Yihui选择hugo就是因为hugo只有一个文件，够简单，至于为什么我会知道Yihui选择hugo的原因？
因为我读了 blogdown故事。
把解压好的hugo.exe文件放在d:
/根目录下，然后输入下面代码安装hugo：
#注意这里是三个冒号
blogdown:
:
:
install_hugo_bin（"d:
/hugo.exe"）
安装成功。
不知道是不是网络国际出口的问题，最近从github下载文件都比较慢（浏览github网页倒没有问题），经常用devtools:
:
install_github（）安装包都不成功，就算用浏览器下载hugo也经常出现错误，估计这就是用blogdown:
:
install_hugo（）安装不了的原因吧。
ok，我们来到这里，暂时离开一下rstudio，我们去弄弄github。
注册域名
虽然个人域名不是必须的（你可以直接使用netlify的二级域名，如），但是为了彰显个性，当然是注册个人域名啦。
怎么注册域名就不详说了，国内的有万网等，国外有GoDaddy之类的，选择国内服务商的话，域名要备案，国外就可以省略这个步骤。
还有第三个选择就是到 rbind.io 向 blogdown组织申请一个二级域名 yourname.rbind.io。
下面的内容是针对已经申请个人域名来展示的。
用github创建repository
如图所示填写好repositoryname、Description，默认选择Public，可以选择复选框InitializethisrepositorywithaREADME，add.gitignore选择R吧，点击 Createrepository 就可以创建好用于保存网站的repository。
这个repositoryname没有要求，随便起，不像github的pages服务要求名字和github的账号名称一样，建议起名，当你有多个网站要管理的话，这样就可以一眼就可以看出是那个网站了，我自己当时就不知道可以用点，所以也不知道这样来起名字。
blogdown建站
创建项目
现在回到rstudio，File->NewProject->VersionControl->Git，然后填写RepositoryURL:
directoryname应该自动就生成了，可以选择一个合适的文件夹存放，点击 CreateProject 创建项目。
设置gitignore
打开rstudio右下角的Files标签，点击.gitignore文件，改成下面这样吧（copyYihui的）：
.Rproj.user
.Rhistory
.RData
.Ruserdata
public
static/figures
blogdown
上面的文件或者目录就不会提交到github上。
如果对git命令不是很熟悉，建议在这个时候就把.gitignore文件修改好的，因为在生成public文件夹之后（后面的步骤会生成public），再修改.gitignore文件添加public文件夹，那么Git标签那里还是不会把public文件夹忽略掉，要解决这个问题，可以按如下操作：
gitrm-r--cachedpublic
#然后在.gitignore文件添加规则
public
这样下次的gitadd.就不会把public加进去了。
初始化blogdown
打开：
File->NewProject->NewDirectory->Websiteusingblogdown
因为我们已经安装了hugo，所以去掉hugo选项，Yihui是建议用 hugo-xmin 主题开始我们的blogdown之旅的，所以这里就选择了hugo-xmin。
点击CreateProject创建项目。
有人会疑问为什么要两次新建项目？
这并不是必须，其实可以不做创建项目这一步，不过就要另外一个步骤，把本地项目同步到github仓库，可以按下面步骤处理（详细解释可以看这里）：
cd<本地项目目录>
gitinit
gitadd.
gitcommit-m"firstcomment"
gitremoteaddorigin
gitremote-v
gitpulloriginmaster--allow-unrelated-histories
gitpush-uoriginmaster
本地运行网站
到这里，博客已经可以在本地运行，我们试试看吧，点击菜单Help下面的Addins，如下图所示：
点击ServeSite，可能会提示安装几个包例如shiny、miniUI等，点击yes安装就行了，其实点击这个跟在console里面输入blogdown:
:
serve_site（）是一样的，如果你还没有安装写轮眼xaringan，会有下面的warning信息：
Warningmessage:
Ineval（quote（{:
Thexaringanpackageisnotinstalled.LaTeXmathmaynotworkwell.
我们乖乖的按照提示把写轮眼安装了吧（网页上的数学公式用的是 MathJax.js 实现）：
install.packages（"xaringan"）
这个时候，已经可以在右下角Viewer标签看到网站的美貌了：
Keepitsimple,butnotsimpler
我们也可以在浏览器输入http:
//127.0.0.1:
4321/来浏览。
写博客
又来点击菜单Help下面的Addins，这次我们点击NewPost，就会弹出下面这个画面：
Filename处会自动帮你填写为Title处的内容，Filename和Slug还是建议使用字母，尤其是Filename，如果博文里面不需要用到R语言的代码计算结果生成图表的话，Format处就选择Markdown格式，这可以省去一些系统生成的步骤，ok，点击Done，就会在/content/post文件夹下面生成一个文件名为2000-01-01-my-first-blog.Rmd这样的文件了，content文件夹下面的文件就是博客的文章了。
这个时候就可以用markdown格式专注于写作了。
关于修改主题
如果你想修改主题，可以到这里找主题修改。
关于修改主题的非技术TIPS，可以看看下面两段话，引用自Yihui的blogdown使用文档 1.6Otherthemes 最下面引用的一段话：
原出处
Ifyouchoosetodigaratherdeephole,somedayyouwillhavenochoicebutkeepondigging,evenwithtears.-—LiyunChen13
Yihui是这样说的：
Anotherthingtokeepinmindisthatthemoreeffortyoumakeinacomplicatedtheme,themoredifficultitistoswitchtootherthemesinthefuture,becauseyoumayhavecustomizedalotofthingsthatarenotstraightforwardtoporttoanothertheme.
所以呢，可以先把hugo官网上面的主题都浏览一下，看看哪个合眼缘，挑好再改吧。
学习怎么修改主题的另外一个好去处是hugo-xmin的 pullrequest。
如果你有好的改进，也可以在这里提交pullrequest让别人学习。
看看下面的pullrequest图：
设置netlify
注册netlify
打开 netlify主页就可以注册了，直接在 Signupwithoneofthefollowing:
下面选择 GitHub 就行了。
绑定github
登录进netlify后，点击导航栏Sites，再点击右上角NewsitefromGit，再点击Github，如下图：
然后按照下面的图填写就可以了：
因为hugo生成的文件夹是public所以填public。
点击deploysite就可以生成网站了。
这个时候可以再去到一个叫deploysettings的地方（如下图所示），确保选项选中的是none，就是只deploymaster分支。
设置个性二级域名
这个时候生成的网站网址是<一串类似md5的字符串>，点击导航栏的Overview，再点击Sitesettings->Changesitename，就可以输入你的英文名字，这时就得到一个netlify的二级域名。
绑定个人域名
如果你不满足于netlify的二级域名，还可以选择绑定个人域名。
点击左边导航栏的Domainmanagement->Domains，
然后点击Addcustomdomain，这个时候就可以输入你在域名提供商处注册的域名了。
修改域名服务器
添加域名后，点击如上图所示的小红点处，选择GotoDNSpanel，然后就跳转到DNSsettings页面，这里应该是不用做Addnewrecord操作的（我忘记了，应该是自动添加了的），如果没有记录，就点它添加吧，如下图所示：
上图的 Nameservers 部分有四条netlify的dns服务器域名，把他们添加到你注册域名的Nameservers就可以了，我在域名服务商里面的设置如下图所示：
到此，所有的基本设置都已经完成。
更新博客内容
前面提到我们可以专注于写作，现在所有东西都准备好，就可以把写好的文章update到线上，点击右上角Git标签，点击commit（如下图所示），填写好commitmessage点击commit->push，这样就已经更新线上的博客，大概不用1分钟的时间，打开你的个人主页就可以看到最新的文章出现了。
至此，关于用R语言的blogdown+hugo+netlify+github搭建静态博客系统的介绍全部结束了，更多关于blogdown的魔法就等大家自己去挖掘了吧。
Go，用rstudio去写博客吧！
参考资料
1.blogdown:
CreatingWebsiteswithRMarkdown
2.Upandrunningwithblogdown
3.本站是如何建成的：
Rblogdown简介
4.Rblogdown科研网站的公式和参考文献
5.如何在Rmarkdown里输出rpi并前后加上小撇`
6.EnableCodefolding
7.MakingaWebsiteUsingblogdown,hugo,andGitHubpages
8.GettingStartedWithblogdown
9.rbindsupport
升级会员 