发布一个博客, 总共分几步? 三步。创建博客站点,写博客,发出去。

  • 博客站点就像是一个空壳博客,存在于我们的电脑上
  • 我们需要在这个站点中写文章
  • 写完了不能只有自己看呀, 就需要发布到网上

下面, 把这三步具像化一点~~

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