使用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 服务器上。
