研究hugo+Github+Forestry

起因是看见这位博主提到的静态博客管理办法: https://blog.jxtsai.info/post/hugo-and-forestry/

静态博客发布和管理如果能做到随时随地的话确实很方便,因此对我的吸引力非常大。为了实现这一目标,我来努努力。

要搞定Forestry与GitHub的互通不难,稍微研究一下就能实现。我比较困惑的是本地与GitHub的通信,说白了是没有仔细系统的学习过git,因此,今天针对这一部分做一个学习。

首先来复习一下什么是git

维基百科:https://zh.wikipedia.org/wiki/Git

git是一个分布式版本控制软件,最初由林纳斯·托瓦兹创作,于2005年以GPL发布。最初目的是为更好地管理Linux内核开发而设计。应注意的是,这与GNU Interactive Tools(一个类似Norton Commander界面的文件管理器)不同。git最初的开发动力来自于BitKeeper和Monotone。git最初只是作为一个可以被其他前端(比如Cogito或Stgit)包装的后端而开发的,但后来git内核已经成熟到可以独立地用作版本控制。很多著名的软件都使用git进行版本控制,其中包括Linux内核、X.Org服务器和OLPC内核等项目的开发流程

关键词:分布式版本控制。

说白了就是需要本地静态博客与GitHub仓库保持同步,同时需要用Forestry管理GitHub仓库里面的文件。

那么,本地与GitHub之间同步的优雅姿势就比较重要了。我是使用的 VSCode 来编辑文件和管理GitHub与本地文件的。使用VSCode是因为日常编辑主题文件等习惯使用,另外它本身就集成了终端功能。只要你安装了git就可以使用,这里说明一下我的系统是Win 10。具体GitHub的操作方法可以参考这个页面:https://www.jianshu.com/p/662d9bb9cadc

静态博客托管到GitHub网上的教程很多,之所以今天再来复习一下git都是为了让它运行的更优雅,因为之前的操作都是按之前看到的教程按部就班,根本不明白仓库的操作原理。这里不放其它链接和运行命令的具体教程和解释了,很容易就搜索到了。

Github与Forestry互通

接下来就是搞定Github与Forestry互通,搞定后界面是这样的:

静态博客有了后台管理和创建文章是不是就方便多了?这样就能随时随地愉快的更新了哦。

设置方面需要注意的地方,Forestry:

GitHub有两个项目需要设置:

不出意外,搞定这些基本就能工作了,更多Forestry的用法看看设置里面的说明基本就能玩好了,比如:

我遇到了一个问题,Forestry修改编辑文章保存后,原始文档可以很顺利的推送到GitHub仓库,但Forestry后台并不hugo生成静态网页文件并推送过去。这就麻烦了,如果你是将博客直接托管在GitHub提供访问的话基本不可能。我看有些网友其实也并不是用GitHub提供访问的,毕竟国内很难用,应该有其它途径。我是直接用VPS提供访问的,需要用到webhook和在VPS服务器上安装运行hugo。

GitHub上配置webhook与VPS服务器互通

可以参考这个页面:https://dtz9.net/2019/11/4/

设置正确后,仓库有了新的更新动作服务器就会收到通知并拉取更新,这样就实现了互通了。由此,就可以很方便的保持本地、GitHub与Forestry三方文件同步,当然,本地与GitHub之间的同步并不是自动的需要手动拉取更新和提交更新。

到这里,其实只有本地能够运行hugo生成静态网页文件推送到GitHub,然后通知服务器拉取更新提供访问。如果是在Forestry上的编辑和修改,由于我测试中发现Forestry并不能生成静态网页文件推送过来,我的博客网页并不能体现这些编辑修改。

VPS服务器上运行hugo定时任务

并不清楚Forestry是否支持这一功能,但我想就算它支持我也是不敢依赖的,感觉不靠谱。解决办法很简单,在服务器上安装hugo并添加任务定时运行就可以了。虽然这样在Forestry上的修改并不能实时体现在网页上,但对于博客来说并不在乎那点时间,至少我不在乎。如果你有强迫症,服务器上手动运行一下就是,这样的话也不需要Forestry了,甚至本地都不需要,直接服务器上面运行hugo编辑文字岂不是更好?

Centos 7系统上安装运行hugo可以参考这个页面:https://www.jianshu.com/p/bb2d483f4caf

如果你会在本地比如 Win 系统上使用,那么在服务器上使用基本没什么区别了。

如果你不会,可以先学会在本地使用hugo,参考这个页面:https://dtz9.net/2019/08/5/

如果你跟我一样服务器上使用了宝塔面板,那添加一个定时任务也是so easy了。计划任务里面任务类型选择 shell脚本,脚本任务无非像这样:

 cd /www/wwwroot/dtz9.net 
 hugo 
 cd ~

执行周期您请随意,如果你的静态博客配置文件正确的话,这个任务就会很可靠的为你工作了。对于它来说,就是几秒钟的事情:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
Building sites … 
                   | ZH-CN  
+------------------+-------+
  Pages            |   385
  Paginator pages  |    71  
  Non-page files   |     0
  Static files     |    80
  Processed images |     0
  Aliases          |   148
  Sitemaps         |     1
  Cleaned          |     0

Total in 6202 ms

总结一下

我要的其实就是效率,不卡顿,至于推送拉取这些通信消耗的时间基本不在我的考虑范围,只要能稳定靠谱的完成它的任务就可以了。

优点:

  • 静态网页的读取效率更高,访问速度优秀
  • 基本没有网页安全性方面的忧虑(这都三方同步了...),更不会被代码注入,不依赖数据库

缺点:

  • 配置环境过于复杂,需要大量的时间弄懂才能上手

  • 没有动态博客的直观便捷

    这是肯定的,光弄明白hugo就需要大量的学习,我到现在都没搞懂。有舍有得,很正常的事情。花一点时间搞明白这些配置,剩下的时间才能安心的玩耍。动态看似简单,其实更复杂,依赖开发人员过多,靠人不如靠己。说这些还是为了效率,因为我不喜欢冲突。PHP里面很多开发人员各自为战,总能看见各种代码冲突,有的实际上是把简单的事情复杂化。

  • 没有好用的主题

    真的是这样,静态博客的用户群相对还是很少的,当然主题方面还需要自己动手丰衣足食。

如果你有学习精神,相信这些都难不倒你。最后,写这篇文字前顺手把主题换了,实在看腻了。简单一点比较好。

发布后更新:

2020-3-22

应该是我理解错了,这样使用Forestry并不能生成静态网页并推送到仓库,还是老老实实玩服务器更安全。

较早前

这篇文章我通过Forestry发布后经过观察,事实证明Forestry还是能够自动生成静态网页文件并推送出去的。由此可见,Forestry编辑文章发布依赖它的服务器,免费用户可能需要排队?因此,我的服务器上添加定时任务是正确的做法。

updatedupdated2020-03-222020-03-22
点击评论框“加入讨论”会显示名字邮箱网址选项,不一定需要登陆哦🙂