前言

写作是每个人都必备的技能,它可以帮你梳理逻辑,检查自己的思考过程。进入互联网时代后,手写文章的机会变得少了,使用网络博客的机会和场景变得多了起来,无论是自己做技术总结、公司写技术方案都需要博客,工具千千万,但是要想写的好文章却是要一直打磨。我从17年到今天之前我都是用的hexo搭建的博客,hexo是用javascript写的静态博客框架,使用起来也挺方便,但是安装过程和后续换电脑或者更新过后可能会遇到一些各种bug,后来被前辈老师朋友们安利hugo,它使用go写的,安装、运行都速度极快,对新手极为友好,故今天开始用它重新更新博客,并记录一下搭建的过程。

搭建博客站点

安装hugo

1
2
3
4
//mac 直接通过brew
brew install hugo
//Win10 通过安装包,并配置环境变量
//https://gohugo.io/getting-started/quick-start/

安装完后,检查一下hugo version

创建博客生成器

安装完之后,使用自带命令迅速生成博客站点hugo new site 你的博客名字,这里的博客名字替换成你想命名的英文名字,一般格式是用你的github名字.github.io-generator比较好,例如我github名字叫wushao666,就用hugo new site wushao666.github.io-generator。 执行完上述代码后,会在当前目录下生成一个以你的博客名字命名的目录。

添加基础主题

经过上述两步之后,我们已经有了基础的博客站点,但是目前还不能使用,我们需要安装一个基础主题ananke

1
2
3
4
cd 你的博客名字
git init
git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke
echo theme = \"ananke\" >> config.toml

创建博客

hugo new posts/my-first-post.md,其中my-first-post.md即要创建的博客名字,可随意替换(如果是even主题,用hugo new post/my-first-post.md) 此时我们的目录结构如下: 目录结构 此时打开刚才新建的文章,做一下小修改:

1
2
3
4
5
---
title: "My First Post"
date: 2019-03-26T08:47:11+01:00
draft: true //正式发布是需要改为false,这是草稿
---

小tips: 在hugo中插入图片,可以不借助在线图床,使用根目录下的static完成,例如我们在其目录下创建/images/createMd,那么文章中插入图片dir.png只需要用![](/images/createMd/dir.png)即可。


修改基本配置

项目根目录下config.toml修改一下baseURL languageCode

1
2
3
4
baseURL = 'http://wushao666.github.io/' //这里是你的github pages的URL或者你的个人域名
languageCode = 'zh-Hans' //中文汉字简体语言
title = '吴少林写字的地方'
theme = "ananke"

本地预览与打包发布

  • 本地预览,经过上述几步简单操作,此时我们的博客基本站点已经完成,并且有了一篇文章,我们通过命令hugo server -D进行本地预览一下,看看效果咋样再决定是否发布
  • 打包发布静态页面,如果上面预览没问题了,就打包静态文件,发布到网上hugo -D
  • 每次更新了新文章都要重新build,即每次都要执行hugo -D

最终我们发布到网上的是根目录下的public目录。

发布博客

以上我们只是创建完了本地博客,那么如何发布到github上呢,我们需要做两件事:

  1. 创建博客生成器仓库,该仓库用来生成博客,备份生成器文件。
  2. 创建博客静态页仓库,该仓库才是真正的博客地址。

创建博客生成器仓库

git init当前目录(即以你的博客站点名字命名的那个目录,在本文中即为图中的wushao666.github.io-generator目录)时,需要做如下两步操作:

  • 在根目录创建.gitignore文件,所有的命令如下:
1
2
3
touch .gitignore
vim .gitignore
//写入/public/

生成器仓库不需要存储静态文件

  • 清除掉下载的主题的.git目录,即rm -rf themes/ananke/.git

此时再执行初始化仓库,上传到github即可。

创建博客静态页仓库

该仓库命名必须叫你的github名字.github.io,例如本文中就叫wushao666.github.io 这个仓库我们只需要初始化pulic目录即可,git init完并上传到github后,还需要打开github Pages 打开githubpages

完成以上操作就能够在浏览器输入你的github名字.github.io,访问你的网站了,如果你有个人域名,通过你购买域名的服务商做相关域名解析,把你的github名字.github.io解析到你的域名上即可。