发布一个博客, 总共分几步? 三步。创建博客站点,写博客,发出去。
- 博客站点就像是一个空壳博客,存在于我们的电脑上
- 我们需要在这个站点中写文章
- 写完了不能只有自己看呀, 就需要发布到网上
下面, 把这三步具像化一点~~
1. 【创建博客站点】:通过Hugo生成站点
Hugo 是一个静态网站生成器, 我们需要用它制作一个站点。
1.1 安装Hugo
这里记录下 Windows 和 MacOS 下的安装步骤
1.1.1 Windows
打开命令行, 输入:
winget install Hugo.Hugo.Extended
(待验证)
1.1.2 MacOS
安装:brew install hugo
验证: hugo version
看到输出类似这样的版本, 则表示成功:
hugo v0.128.1+extended darwin/arm64 BuildDate=2024-07-02T06:46:41Z VendorInfo=brew
1.2 初始化站点
hugo new site test # 新建一个站点
cd test # 进入站点目录
git init # 初始化git
git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke # 添加主题
echo "theme = 'ananke'" >> hugo.toml # 配置主题
hugo server # 启动服务
这时候会输出下面一堆, 主要是倒数第二行: 表示能看了, 给了咱一个地址, 直接浏览器打开它
# ... 略一些内容
Running in Fast Render Mode. For full rebuilds on change: hugo server --disableFastRender
Web Server is available at http://localhost:1313/ (bind address 127.0.0.1)
Press Ctrl+C to stop
2. 【写博客】
接下来, 让我们往博客里加一些内容
执行这行命令
hugo new content content/posts/my-first-post.md
hugo会创建一个 content/posts
文件夹, 打开它并编辑 my-first-post.md
文件, 内容如下:
+++
title = 'My First Post'
date = 2024-07-05T09:20:35+08:00
draft = true
+++
注意这里, draft = true
表示暂时还是个草稿, 等写完了, 就改成 draft = false
, 然后执行 hugo server
, 就可以看到这篇文章了。
在里面随便加点内容试试吧
3. 通过GitHub Pages发布站点
4. 映射到自己的域名
4.1 搞个域名
4.2 配置https
FAQ
1. 为什么启动后, 是空白页页面, 报错如下
WARN 2024/07/04 21:05:13 found no layout file for "HTML" for kind "page": You should create a template file which matches Hugo Layouts Lookup Rules for this combination.
这里是因为主题加载失败, 通常我们是通过submodule
加载的主题, 重新拉取主题即可
git submodule update --init --recursive