用 R 语言的 blogdown+hugo+netlify+github 建博客.docx
- 文档编号:5827352
- 上传时间:2023-01-01
- 格式:DOCX
- 页数:16
- 大小:863.33KB
用 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
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 语言的 blogdown+hugo+netlify+github 建博客 语言 blogdown hugo netlify github 博客