写在前面的碎碎念

磨磨蹭蹭的看了将近一个月的文档,也摸索尝试了一些指令之后,最终还是把把 blog 从 hexo 迁移到了hugo。关于 hugo 也不打算做过多的介绍,文档都很详细。这是使用 Golang 开发的一个静态网页生成工具,使用过程中发现有以下优点:

  • 升级简单,替换安装文件即可
  • 跨平台支持,windows、macos、linux、freeBSD ······
  • 编译速度快
  • 多设备移植方便,不像 hexo 不方便多 PC 操作,生成的网页直接 push 到服务器即可,不像 hexo 和 git 指令绑在一起

如人饮水,冷暖自知。好东西要自己用过了才知道。

安装

仅以 Windows 平台为例,下载安装包解压后将二进制文件放在自己认为合适的位置,然后将该路径配置在系统环境变量中,打开 CMD 输入

$hugo version

显示版本号即安装成功了。这里遇到设置环境变量指令仍然没有效果,尝试 cd 到二进制文件目录打开命令管理器,仍然是没有效果的,最后通过如下指令设置(二进制文件在 D:\Hugo\bin 路径):

$D:\Hugo\bin>set PATH=%PATH%;D:\Hugo\bin

新建站点文件

选取合适的路径,这里建议放在二进制文件父目录的子文件夹里,便于升级二进制文件时一起维护

$hugo new site otakupoi.com

生成的文件目录说明请查看文档,不多赘述。

新建文档

$hugo new post/2018-2-24.md

在 /content/post 路径下生成文档

实时预览

$ hugo server -t even --buildDrafts

打开相应本地网址后即可预览博客效果。参数说明: - -t:使用even主题渲染页面 - –buildDrafts:生成标志为草稿的页面

文档相关参数说明

  • date 自动增加时间标签
  • draft 设置为false的时候会被编译为HTML,true则不会编译和发表,在本地修改文章时候用true。
  • title 设置文章标题
  • tags 数组,可以设置多个标签,逗号隔开,hugo会自动在你博客主页下生成标签的子URL,通过这个URL可以看到所有具有该标签的文章。
  • categories 文章分类,跟Tag功能差不多,只能设置一个字符串。

编译站点文件

$hugo

在 /public 路径下生成网站文件,以 github pages 为例,push 到 github 上即可。

插入图片

使用本地相对路径按文档引用没有成功,暂时解决方案为用 MarkDown 语法引用网络 Url。可将图片上传至七牛云或者 github 仓库。

以上仅为使用过程中的部分操作,更多细节定制,如主题及站点文件配置请查看官方文档。