Windows下githubio个人网站搭建

本文介绍如何在Windows下搭建。使用hugo框架搭建网站,主题采用MemE

安装hugo

由于MemE主题需要Sass/SCSS支持,故采用源码编译方式安装hugo

  1. go环境搭建 hugo在0.48版本后就采用go搭建。点击链接下载msi文件并安装,默认会讲安装目录下的bin目录添加到环境变量,如果没有自动添加,请自行添加。
  2. MinGW安装 使用go编译hugo是需要gcc支持,需要下载MinGW。大多数博客下载图中上红框的在线安装包,大概是网络问题,笔者在下载后遇到无法下载文件的问题,参考这篇博客,下载下红框的离线安装包。下载后解压并将目录下的bin目录添加到环境变量mingw
  3. 安装hugo 万事俱备,可以开始安装hugo了。按如下命令即可安装,需要注意的是切换国内代理,否则最后一步在下载时会因为网络问题报错。
1
2
3
4
5
6
cd anyDir  # 你想要安装的目录
git clone https://github.com/gohugoio/hugo.git
cd hugo
go env -w GOPROXY=https://goproxy.cn,direct  # 切换国内代理
# go install  # 不安装扩展,不支持笔者所用主题
CGO_ENABLED=1 go install --tags extended  # 安装扩展,推荐

创建本地网站工程

  1. 初始化网站目录 初始化网站目录,进入目录
1
2
hugo new site blog
cd blog
  1. 下载hugo主题 下载MemE主题
1
2
git init
git submodule add --depth 1 https://github.com/reuixiy/hugo-theme-meme.git themes/meme

将网站配置文件替换为主题的示例配置文件

1
rm config.toml && cp themes/meme/config-examples/en/config.toml config.toml

创建两个页面

1
2
hugo new "posts/hello-world.md"
hugo new "about/_index.md"

启动服务并打开下图红框网址测试

1
hugo server -D

hugo site

部署网站到github

  1. 创建网站 在github上新建一个仓库,仓库名为github的用户名.github.io,这个仓库名也会是后来我们发布的网站的地址。 githubio
  2. 打包网站 之前用hugo测试流程并没有把网站打包成一个项目,想要发布在github上,需要打包,默认输出位置为项目目录的public子目录。注意此处和多数教程不同,加了-D,否则不会把目录下的content子目录打包进工程,按其他教程发布的网站某些页面打不开可能也是这个原因。
1
hugo -D
  1. 推送至github仓 默认读者会用github且使用的主机公钥已上传至github
1
2
3
4
5
6
cd public
git init
git commit -m "first commit"
git branch -M main
git remote add origin git@github.com:xxx/username.github.io.git
git push -u origin main
  1. 打开 username.github.io,查看结果。

其他资料

MemE主题使用汇总

updatedupdated2022-02-202022-02-20