如何用 Hugo 构建 GitHub Pages

2022-05-31  本文已影响0人  Sun东辉

Hugo + GitHub Pages = "我的世界"

不知道你有没有玩过《我的世界》这款游戏 —— 基于有限的规则,创造无限的世界。

预览效果

安装依赖

推荐使用 brew 进行安装

brew install hugo

当然,官网也有其他安装方式。

创建你的 GitHub Pages

首先,你需要一个 GihHub 账号,这没什么好说的,接着,按照以下步骤,创建你的 GitHub Pages:

  1. 新建仓库:仓库名格式须符合正则表达式 /**.github.io/,切记勾选 Add a README file
  2. 设置主题:点击 Settings 进入设置页面,点击 Pages,进入 GitHub Pages,选择 master 分支,点击按钮 Change theme,选择一个临时主题(这很重要),如果你有自己的域名,也可以在自定义域名处填写自己的域名,点击Save

看到 Your site is published at https://*** 了吗?稍等片刻后,你可以就可以看到自己的 GitHub Pages 了。

用 Hugo "重构"你的 GitHub Pages

作为一个有追求的人,官方简单的主题显然不能满足我们的需求,作为一个不重复造轮子的懒人(智者),推荐使用 Hugo,遵循以下步骤:

  1. 使用
hugo new site myBlog # myBlog 是你的目录名。

命令新建一个 Hugo 网站。

  1. 进入目录,创建 theme目录。
cd myBlog && mkdir -p themes
  1. 进入 themes 目录,克隆 Hugo Themes。
cd thems && git clone git@github.com:humrochagf/colordrop.git themes/colordrop # git@github.com:humrochagf/colordrop.git themes/colordrop 是所选主题的地址

4.编辑配置文件 config.yml,配置方式参考主题页面。

  1. 本地预览,实时编辑。
hugo server -D 
  1. 打包。
hugo # 默认将静态站点保存到 "public" 目录
  1. public 目录下的内容拷贝到你的 **.github.io 仓库下,提交观赏效果。

新增一篇文章的常用命令一般是

hugo new posts/<filename>.md

但也有不同,比如,我就是通过

hugo new post/<filename>.md.

来新增的。

我的代码仓,欢迎交流。

参考文章

上一篇 下一篇

猜你喜欢

热点阅读