文章目录

Hugo

Hugo是一个用Go语言编写的静态网站生成器,它使用起来非常简单,相对于Jekyll复杂的安装设置来说,Hugo仅需要一个二进制文件hugo(hugo.exe)即可轻松用于本地调试和生成静态页面。

Hugo生成静态页面的效率很高,我的多篇博客文章生成几乎是瞬间完成的,而用Jekyll需要等待10秒左右。

Hugo自带watch的调试模式,可以在我修改MarkDown文章之后切换到浏览器,页面会检测到更新并且自动刷新,呈现出最终效果,能极大的提高博客书写效率。再加上Hugo是使用Go语言编写,已经没有任何理由不使用Hugo来代替Jekyll作为我的个人博客站点生成器了。

Usage

Demo: http://blog.mospan.cn/

界面参考 [http://cyrillschumacher.com/](http://cyrillschumacher.com/) 做了一些修改,并做了一个皮肤:panman。

源码

下载源码到本地。

$ git clone git@github.com:mospany/mospan-hugo-blog.git

记得把我的个人信息修改成自己的就行。

启动调试

本地调试

$ cd mospan-hugo-blog
$ ./debug.py

打开浏览器:http://localhost:1313

远程调试

$ cd mospan-hugo-blog
$ ./debug.py AA.BB.CC.DD

打开浏览器:http://AA.BB.CC.DD:1313 其中: AA.BB.CC.DD 为本机可访问IP地址。

创作

    现在的hugo可支持markdown与org-mode文件格式,分别对应create-md.py于create-org.py脚本。
  • 执行create-md.py或create-org.py。
  • 输入文件标题,最后不要有空格。
  • 它将根据themes/hugo-panman-theme/archetypes/default.[md|org]模板生成以日期+标题的文件。
  • 打开新生成文件进行编辑,记得修改头部的categories、keywords、tags、title进行归类区分。
  • 修改好后,通过push.py进行保存到github文件中。

部署

如果是第一次部署,执行:

$ ./deploy.py first

否则

$ ./deploy.py manual

即可

改进记录

缺陷

  • Hugo对org-mode渲染没有markdown好。
  • 文章标题还需更加美化。
  • 右边的导航栏在某些浏览器下点击无效。

参考资料

【01】 Gitment评论功能接入踩坑教程

【02】 Hugo 集成 Gitment 评论插件

【03】解决gitment无法登陆评论问题(Object ProgressEvent)

【04】更好的基于 github issues 的评论系统——utterances

微信扫一扫

作者:mospan
微信关注:墨斯潘園
本文出处:http://mospany.github.io/2019/02/02/mospan-hugo-blog-manual/
文章版权归本人所有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。