静态网站生成工具-hugo

前段时间使用docker搭建了一个wiki的网站，用于记录日常学习中的笔记，用了一段时间，功能很强大，但是编辑器不太熟悉，网站使用java开发的，功能很全面，插件多的时候就感觉越来越臃肿。曾经有段时间就不想使用它了，最近偶然发现一个静态网站的生成工具hugo，可以将markdown直接生成网站，部署到站点上作为自己的知识库或者博客，hugo是使用go语言开发的，使用起来非常方便，生成的网站可直接部署在Nginx、IIS等中间件上面供其他人访问,hugo还有很多漂亮的主题，大家可以选择自己喜欢的进行使用，下面介绍下 我安装使用hugo的经历和方法。

1）使用brew install命令安装

我的电脑是mac的，所以最方便的是直接用brew install hugo命令安装最为方便：

执行安装完成后执行hugo version 命令查看版本，确保安装成功

2）官网下载二进制包：解压后将二进制文件加入环境变量的方式安装。大家可以根据自己的操作系统，下载适合的安装包。

3）也可以下载源码 编译 运行，由于我本地的go版本是1.17的，而hugo的最新代码的最低要求是1.18，暂时还不想升级，所以源码编译的方式这里就不过多介绍，感兴趣的可以下载源码编译试试。

进入要创建网站的目录，执行一下命令

这样名称为test-blog的网站就建好了 ，

下载一个主题 可以在 官网上找到各种各样的主题

将主体添加至配置文件

打开content/posts目录下的index.md 文件进行编辑，页面的配置项说明参见官网

执行下面命令

成功以后就可以访问http://localhost:1313/就可以访问网站了。

执行命令hugo -D 即可生成一个public的文件夹，其下面的内容即为静态网站的所有文件

这里使用nginx的docker镜像 进行部署，执行以下命令：

执行成功后就能通过http:localhost访问到静态网站了。

这个工具还有很多需要研究的地方，这里只是将简单的使用方法记录了一下，以后怎样使用才能使网站更加的方便，快捷、美观，还要花时间研究。有兴趣的小伙伴可以私信我一块研究。

现在个人博客通常有比较多的选择，如果不想要自己购买服务器实现静态博客的发布，可以在、CSDN等平台建立自己的账号并发布，但是原始数据无法在本地管理；如果想要数据完全自己管理，可以使用GitHub或者Gitee Pages功能发布自己的博客，利用Hugo或Hexo等成熟的静态博客将md文件转换成静态网站文件进行快速发布。本文就用来记录如何快速将博客发布到、GitHub以及Gitee Pages三个平台。

我希望的流程当然是主要精力用在写文章，发布的流程最好完全不需要手动处理，但实际情况下手动发布博客的流程大体是：

之前有使用过Travis CI+GitHub+Hexo自动发布到GitHub Pages，但是GitHub的访问经常不那么靠谱，因此想着也能同步到Gitee，并且自动构建Hexo的速度受Nodejs环境部署影响，速度很慢，因此本次计划采用Hugo来构建网站文件，整体流程设计如下：

为了满足博客自动发布流程，首先需要在本地准备好生产环境，以满足快速发布，以此的复杂是为了长期的简单，因此在环境准备阶段我会把所有涉及的工具都记录下来，以方便大家使用以及后边自己回顾，环境准备包含：

Obsidian完成知识积累后，按照ZK->Project->Archive->Blog的流程发布Blog，但是Obsidian的文件相互关联，且附件如何快速复用，需要对Typora和Obsidian都进行简单的配置，确保后续Blog能够快速完成并发布，并且文件仍在Obsidian工程中正常显示；

Typora非常的简洁，而且可以实时预览，在写博客的时候经常会插入一些图片，截图后可以直接粘贴进去，图片也会自动保存在本地，这里需要注意图片的保存路径，在偏好设置里，设置插入图片时复制到指定路径（./resource/），这样复制的图片就会自动保存在当前文件夹下的resource文件夹里，方便后续管理与转移。

在.ssh文件生成id_rsa和id_rsa.pub两个文件；

Hugo 是一个基于Go语言开发的静态博客框架，号称世界上最快的构建网站工具；

命令为： hugo new site myblog

myblog为博客的目录名，可以修改为你自己想取的名字，生成的目录如下：

由于默认主题生成的文章页面有些功能是不需要的，因此需要对themes下文件进行修改：

将config、content和themes三个目录拷贝到新创建的站点目录，将content下替换为文章文件即可。

utterances 是一款基于Github Issue的Github工具，优点主要是无广告、加载快、配置简单，轻量开源。

由于 utterances 是一款Github App，因此 安装utterances 非常简单，只需要授权特定repo权限给 utterances 就可以了,注意一个点：授权的这个repo必须是public的，可以选择多个repo，但是建议选择一个就可以了，也比较安全。

这是当前最简单的配置方法， 也可以在 utterances官方 查看其他配置方法，以及详细的配置参数说明。

Obsidian的安装和使用可参考我的另一篇文章： Obsidian作为第二大脑工具的基本使用和配置

所有环境准备好后，终于要开始启动我们的自动化流程的实现了；

同之前步骤相同，将Gitee密码配置到GitHub Secrets，命名为：GITEE_PASSWORD，所有配置结果如下：

synctogitee.yml

需要绑定Gitee账号到微信公众号，否则最后一步reload pages自动部署Gitee Pages会登录失败，原因是需要短信验证；绑定公众号后则不需要短信验证；其他问题解决可以参考 gitee-pages-action

在Typora完成文章编写后，一键上传所有图片到Gitee图床，拷贝发布到，然后提交到GitHub repo master分支，即可自动部署到GitHub和Gitee Pages；

以上就是我利用GitHub-Actions将Hugo博客自动发布到GitHub和Gitee Pages，希望可以帮助大家快速构建自己的个人网站；后边我会继续完善我的第二大脑系统的构建思路和方法。

---