前段时间使用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访问到静态网站了。
这个工具还有很多需要研究的地方,这里只是将简单的使用方法记录了一下,以后怎样使用才能使网站更加的方便,快捷、美观,还要花时间研究。有兴趣的小伙伴可以私信我一块研究。