Hugo 博客中文指南(基础教程)
1. 安装 Hugo
从 Hugo 项目主页下载 Releases 文件,解压 hugo.exe
文件到 C:\Windows\System32
目录下。
2. 创建站点
hugo new site mysite
新的站点文件夹 mysite 就自动生成到了当前目录下:
在执行完 hugo new site
命令后你会得到一个包含以下文件的目录。
.
├── archetypes/
├── config.toml
├── content/ # 储存网站的所有文章内容
├── data/
├── layouts/ # 全局样式,优先级高于主题下的 layouts 文件夹
├── static/ # 静态文件,优先级高于主题下的 static 文件夹
└── themes/ # 主题目录
3. 新建页面和文章
新建一个 about 页面:
hugo new about.md
about.md 自动生成到了 content/about.md,内容如下:
---
title: "About"
date: 2020-04-07T22:05:28+08:00
draft: true
---
创建第一篇文章,放到 post 目录:
hugo new post/myfirst.md
myfirst.md 自动生成到了 content/post/myfirst.md,内容如下:
---
title: "Myfirst"
date: 2020-04-07T22:05:28+08:00
draft: true
---
其中 draft: true 表示为草稿文件,正式发布前需将值修改为 false,或者直接删除 draft 整个参数,否则正式发布时不会生成文章。
4. 安装主题
到 Hugo 主题列表 或从 Github 下载一款主题,解压到 theme 目录下:
- 通过命令行的方式使用主题:hugo -t 主题目录名
- 通过在 config.toml 配置使用:theme = “主题目录名”
5. 编译输出(构建 Hugo 网站)
在 Hugo 网站文件夹的根目录下,执行 hugo
命令来构建。
hugo
编译输出的静态 HTML 文件,默认会保存到 public
目录。
6. 启动实时预览(本地预览网站效果)
写一篇文章生成一次会很繁琐,可以通过启动网站预览,实时监控页面的更改并刷新页面。
hugo server -D
参数: -D
输出包括标记为 draft: true 的草稿文章
默认地址为 http://localhost:1313
如果 1313 端口被占用,会随机使用其他空端口。
参考阅读
- Reset hugo 中文帮助文档:https://archive.is/nDLEl
- 使用 Hugo 来生成静态博客:https://archive.is/XV4vY
- 利用 hugo 制作静态网站:https://archive.is/WnfLR
- Hugo 生成静态网页有大量空行怎么办:https://archive.is/mwbv2