开发

Hugo 博客搭建

博客采用 Hugo 框架和 Stack 主题进行搭建，部署到 GitHub Pages 。

安装

快速启动

主题提供快速启动模板，点击 Use this template 并选择 Create a new repository 。

使用模板

如需启用 GitHub Pages 则要将仓库设为公开。

创建仓库

常规安装

如果是在本地使用，则需要安装 Git 、 Go 和 Hugo extended 。Scoop 是Windows平台的包管理器，可以选择使用它来进行安装。

1
2

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser #打开PowerShell远程权限
irm get.scoop.sh | iex #获取并安装Scoop

Scoop 使用示例：

  • scoop install hugo-extended 安装Hugo
  • scoop update hugo-extended 更新Hugo

创建站点并安装主题：

1
2
3

hugo new site Blog && cd Blog #新建站点并切换到该目录
git clone https://github.com/CaiJimmy/hugo-theme-stack/ themes/hugo-theme-stack #将主题下载到本地
git submodule add https://github.com/CaiJimmy/hugo-theme-stack/ themes/hugo-theme-stack #设置主题为Git子模块

配置

站点配置

配置文件为 /config/_default/ 目录下的文件，按需修改配置。

  • _languages.toml 多语言
  • config.toml 域名和语言
  • markup.toml Markdown渲染器
  • menu.toml 社交媒体
  • module.toml 引入模块
  • params.toml 常规配置
  • permalinks.toml 链接地址
  • related.toml 相关内容

修改FrontMatter

新建文件 /archetypes/default.md ，粘贴新建博文的配置到该文件：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

---
title: {{ replace .Name "-" " " | title }}
description: 
date: {{ .Date }}
categories: 
tags: ['']
image: 
slug: {{ substr (md5 (printf "%s%s" .Date (replace .TranslationBaseName "-" " " | title))) 4 8 }}
draft: true
---

使用

常用命令

  • hugo new post/1/index.md 新建文章
  • hugo server -D 运行本地服务器，-D表示包含草稿，-p可指定端口
  • hugo 生成静态文件，默认目录为public
  • hugo version 查看Hugo版本

部署

GitHub Pages

如果仓库名是 用户名.github.io ，会自动启用 GitHub Pages 。进入仓库将部署的分支改为 gh-pages ，然后等待自动部署完成即可。

修改分支

自定义域名

首先将域名 CNAME 解析到 GitHub Pages ：

解析域名

然后在仓库设置中绑定该域名并启用强制HTTPS：

绑定域名

参考