Hugo博客的搭建 – Tony's Tech Blog

折腾了一晚上，总算把hugo博客安装好并搬到github上了，记录一下艰辛过程。

第一步，找到hugo的官网：https://gohugo.io/，主页有个Quick Start的按钮，点击进入后发现文档还是很详细的，Ok，那就跟着文档走。

step1 安装hugo

mac用Homebrew安装hugo还是很方便的，运行命令

brew install

开始安装，这里brew updating经常会卡死，大家可以更新一下brew源

替换brew.git:
cd "$(brew --repo)"
git remote set-url origin https://mirrors.ustc.edu.cn/brew.git

替换homebrew-core.git:
cd "$(brew --repo)/Library/Taps/homebrew/homebrew-core"
git remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git

如过更新后还是卡，有个小技巧，按一下 crtl+c,记住，只要按一下就行，然后就会开始安装。安装完后，我们可以运行

hugo version

来检测是否安装完成，如果看见版本号，那就OK了。

step2 创建新站点

跟着官方文档在终端输入

hugo new site quickstart

这里请注意，如果未来你要把博客搬到github，那么这个命令要修改为

hugo new site 你的github的用户名.github.io-generator

这里要敲重点。

step3 添加主题

运行命令

cd 你的github的用户名.github.io-generator
git init
git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke

主题不喜欢以后可以修改

step4 撰写第一篇博客

运行命令

hugo new posts/my-first-post.md

这里的my-first-post可以改成任何名字，然后用编辑打开hugo所在目录，找到content文件夹，就能看到你的文章了，在里面写点什么把。写完后记得把顶部的

title: "My First Post"
date: 2019-03-26T08:47:11+01:00
draft: true

里面的draft的值改为false，这样就可以将文章发布了

step5 打开hugo server

运行命令

hugo server -D

然后你会看到如下指令，这就说明本地server开启成功


                   | EN
+------------------+----+
  Pages            | 10
  Paginator pages  |  0
  Non-page files   |  0
  Static files     |  3
  Processed images |  0
  Aliases          |  1
  Sitemaps         |  1
  Cleaned          |  0

Total in 11 ms
Watching for changes in /Users/bep/quickstart/{content,data,layouts,static,themes}
Watching for config changes in /Users/bep/quickstart/config.toml
Environment: "development"
Serving pages from memory
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

用浏览器打开http://localhost:1313/，你就可以看到你的博客和你发布的第一篇文章了，很有成就感吧。

step6 自定义主题

打开config.toml文件，编辑如下：

baseURL = "https://example.org/"
languageCode = "zh-Hans"
title = "自定义博客名称"
theme = "ananke"

step7 创建静态页面

运行命令

hugo -D

博客目录下会自动创建一个文件夹名为public，这里面都是build过的静态文件，也是是未来我们要上传到github的文件。

step8 上传文件到github

先在博客根目录下创建一个文件名为.gitignore, 里面输入/public/，这样可以提交源码时可以屏蔽public文件夹，public里面的文件我们是要单独提交到一个仓库的。
进入github，创建一个仓库，仓库名字很关键，一定要为 你的用户名.github.io
点击github仓库settings，下拉找到Github Pages，确认 User pages must be built from the master branch。
进入博客本地目录public文件夹，运行

git init
git add .
git commit -m "提交的名字"
git remote add origin git@github.com:你新建的仓库地址
git push -u origin master

这样你的hugo就被上传到github了，然后可以进入仓库settings页面在Github pages板块里查看你的博客访问页面地址，点击地址你就可以看见你的博客页面了。记录到此结束，至于更改主题，详见：https://themes.gohugo.io/。