使用Hugo搭建技术博客

Hugo简介

Hugo是go语音开发的静态网页生成工具,它在速度、易用性和可配置性方面进行了优化。Hugo获取一个包含内容和模板的目录,并将他们呈现为一个完整的HTML网站。

Hugo依赖具有前端内容的Markdown文件作为元数据,可以从任何目录运行Hugo。Hugo被设计成适用于任何类型的网站,包括博客、文档。

Hugo 初探

本地安装Hugo

Hugo Releases 下载对应的操作系统版本的Hugo二进制文件(hugo或者hugo.exe)

Mac下直接使用 Homebrew 安装:

brew install hugo

安装是否成功

通过版本号检查的方式,确认是否安装成功

hugo version
hugo v0.110.0+extended darwin/arm64 BuildDate=unknown

初始化网站

使用Hugo快速初始化网站,比如希望生产 到 /Users/xxx/Documents/site-name 目录

hugo new site /Users/xxx/Documents/site-name

进入网站目录:

cd /Users/xxx/Documents/site-name

选择Hugo主题进行配置

本次博客选择FixIt,因为它基于LoveIt 扩展很多功能

git init #如果是已经存在的git项目,这步可忽略
git submodule add https://github.com/hugo-fixit/FixIt.git themes/FixIt

运行Hugo

在你的网站根目录执行Hugo命令进行调试:

hugo server --theme=FixIt --buildDrafts

在构建网站时,你可以使用 –theme 选项设置主题。但是,建议你修改配置文件 (config.toml) 将本主题设置为默认主题。

创建第一篇文章

通过Hugo命令来创建第一篇文章的方法:

hugo new posts/使用Hugo搭建技术博客.md

通过添加一些示例内容并替换文件开头的标题,你可以随意编辑文章。

默认情况下,所有文章和页面均作为草稿创建。如果想要渲染这些页面,请从元数据中删除属性 draft: true, 设置属性 draft: false 或者为 hugo 命令添加 -D / –buildDrafts 参数。

启动本地服务器

启动 hugo 服务器,进入 http://localhost:1313/ 预览页面

hugo server -D

当你运行 hugo server 时,当文件内容更改时,页面会随着更改自动刷新。

构建静态网站

当你准备好部署你的网站时,运行以下命令:

hugo

会生成一个 public 目录,其中包含你网站的所有静态内容和资源。现在可以将其部署在任何 Web 服务器上。

0%