使用 Hugo 搭建博客的一些小细节
Contents
写在前面的碎碎念
磨磨蹭蹭的看了将近一个月的文档,也摸索尝试了一些指令之后,最终还是把把 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 仓库。
以上仅为使用过程中的部分操作,更多细节定制,如主题及站点文件配置请查看官方文档。
Author artharyoung
LastMod 2018-02-24