Hugo是由Go语言实现的静态网站生成器。简单、易用、高效、易扩展、快速部署。Hugo以速度快著称,号称是世界上最快的网站生成框架。下面操作环境:
操作系统:macOS Catalina 版本 10.15.3
Visual Studio Code
github.com
iTerm2
01 安装hugo
1.1 推荐使用 brew 进行安装
brew install hugo
1.2 安装完以后通过在编辑器输入
hugo version
1.3 验证是否安装成功
Hugo Static Site Generator v0.65.2/extended darwin/amd64 BuildDate: unknown
当出现上述版本提示,则表示安装已经完成。
02在本地创建一个属于自己的站点
2.1 这里的yourname应该是你在github的仓库名,用户名可以在github的profile看到,如果仓库名有大写,需要全部转化为小写,在后面加一个后缀比较好
hugo new site yourname.github.io-creator
2.2 第一步很快就会完成,接下来安装 主题,并将主题配置到站点,其他主题很容易出bug,先安装默认的,这个主题安装也需要一定时间,请耐心等待,接下来运行以下命令行
cd yourname.github.io-creator
git init
git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke
echo 'theme = "ananke"' >> config.toml
2.3 命令行输入code .打开VS Code,也可以把建立好的站点文件夹拖入VS Code,通过下面命令行,添加一个文档
code .
hugo new posts/我的一篇博客.md
下面的信息为文档信息,不能删除,(draft:true为草稿状态,如果需要公开,则把true值改为false),接下来就可以编辑自己的第一篇博客
---
title: "My First Post"
date: 2019-03-26T08:47:11+01:00
draft: true #默认为true
---
2.4 文章编辑完后,在终端的yourname.github.io-creator路径下中输入hugo -D,此时会,会出现一个httpsever,打开链接进入预览。(会出现Press Ctrl + C stop, 不要进行操作)
hugo -D
2.5 配置页面,在VS Code中,按command+p,调出命令框,输入config.toml,进入后,进行如下修改
baseURL = "https://example.org/"
languageCode = "zh-Hans" #改变语言
title = "My New Hugo Site" #设定自己的博客名称
theme = "ananke"
2.6 最后在yourname.github.io-creator路径输入hugo,这个时候会在站点根目录中创建一个“public”的文件夹,在创建一个gitignore文件,输入/public/,保存关闭文件。则本地配置完成。
hugo
03将站点发布至github远程仓库
3.1 在github上建立一个仓库,名字为yourblogname.github.io
3.2 在VS Code中新建一个终端,在public路径的命令行编辑器中,输入如下命令行,建立一个本地git
git init
git add .
git commit #弹出文档输入编辑信息
3.3 在新建的仓库里,复制如下命令行,(注意yourname/yourblogname需要替换自己),在终端public路径下进行粘贴,将本地git发布至github远程仓库,这个时候,站点就可以通过yourblogname.github.io进行访问,大功告成!
git remote add origin git@github.com:yourname/yourblogname.github.io.git
git push -u origin master