静态网站生成工具-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 文件进行编辑，页面的配置项说明参见官网

执行下面命令

成功以后就可以访问就可以访问网站了。

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

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

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

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

利用GitHub-Actions将Hugo博客自动发布到GitHub和Gitee Pages

现在个人博客通常有比较多的选择，如果不想要自己购买服务器实现静态博客的发布，可以在、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，希望可以帮助大家快速构建自己的个人网站；后边我会继续完善我的第二大脑系统的构建思路和方法。

组件分享之后端组件——基于Go语言的HTML和CSS网站生成器Hugo

近期正在探索前端、后端、系统端各类常用组件与工具，对其一些常见的组件进行再次整理一下，形成标准化组件专题，后续该专题将包含各类语言中的一些常用组件。欢迎大家进行持续关注。

本节分享一个基于Go语言的HTML和CSS网站生成器 hugo ，它针对速度、易用性和可配置性进行了优化。Hugo 获取一个包含内容和模板的目录，并将它们呈现为一个完整的 HTML 网站。Hugo 依赖于 Markdown 文件和元数据的前端，你可以从任何目录运行 Hugo。这适用于您没有特权帐户的共享主机和其他系统。例如我们日常编写一些博客文章，进行快速生成一套静态页面进行分享时可以使用它来进行生成一套静态页面作为我们的博客部署基础。

它支持大量的主题模板，我们可以通过 进行选择相关的主题使用，有兴趣的小伙伴可以进行深入研究一下

当前文章：hugo需要go语言吗 go语言需要运行环境吗
转载源于：http://chengdu.cdxwcx.cn/article/dojpejj.html