LEEDOM

Nov 02, 2018

Hugo主题使用

雕纹上色

其实选择hugo的原因之一就是主题比较好看,因此theme是很必要的。 在themes.gohugo.io中,选择自己喜欢中意的,一般点进入主题中都会进入到Github,里面也有作者写的使用教程,参考着应该没有多大问题。在Terminal中进入到刚刚创建的工程根目录,直接clone下来,这里以Even主题为例。

1
git clone https://github.com/olOwOlo/hugo-theme-even themes/even

然后将themes/even/example中的config.toml文件复制到自己的工程根目录覆盖。再根据Github中作者的介绍或者指导修改config.toml的对应属性即可。

最后键入hugo server -D命令启动hugo中内置的服务器,在浏览器中输入localhost:1313查看网站的效果。

板上钉钉

前面的步骤都是在本地运行的效果,要别人能够访问你的博客,肯定得部署到网络上,这里选择GitPages,不需要自己对后台服务器进行管理,比较省心。

首先在自己的github中新建一个仓库,仓库的名字为xxx.github.io,其中xxx替换为自己的github用户名。

然后在Teminal中打开本地的工程,执行hugo -d blog生成网站的网页内容。这里开始需要注意一下,一般会将hugo生成的内容提交到仓库的master分支,然后会将网站的源码提交到另一个分支。所以这里我是这样骚操作的。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
cd blog  #进入blog目录
git init #初始化git
git add -A
git commit -m "first commit"
git remote add origin git@github.com:RiceBrother/RiceBrother.github.io.git
git push -u origin master #提交到master分支
cd ../ #回到工程根目录
git init #再次初始化git
git checkout -b source #创建并切换到source分支
echo '/public/' >> .gitignore
sed -r -i '/^\/blog\/$/{$!d}' .gitignore #添加忽略文件,忽略掉blog文件夹
git add -A
git commit -m "commit sources"
git remote add origin git@github.com:RiceBrother/RiceBrother.github.io.git
git push -u origin master #提交到source分支

这样操作后在浏览器输入xxx.github.io应该就能看到效果了。

投入使用

如果每次新写了一篇文件,都需要手动的使用hugo -d blog然后提交到master分支,再回到根目录提交source分支,这个过程很繁琐,作为懒人的我第一时间是想到能不能使用脚本自动化,于是本着懒人的原则先google了一番,参考了几位仁兄的方案后,选择了使用Travis CI

第一步呢就是在Github个人的Setting中找到Developer setting,然后生成一个Personal assess tokens。然后到CI这个网站先注册一番,传送门在此,这个网站可以直接使用Github账号登录,非常方便。

同步

注册成功后同步自己的仓库,将对应的xxx.github.io仓库激活,并点击Setting设置。找到下面的Environment Variables添加刚刚在自己的Github生成的Token**Name**必须为GITHUB_TOKEN这个是网站的规则,不能是其他的值

仓库
增加变量

最后再返回到自己的github.io这个仓库,在source分支中添加一个.travis.yml,在里面输入以下脚本,Travis CI会自动检测哪个分支添加了这个文件并运行。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
# https://docs.travis-ci.com/user/deployment/pages/
# https://docs.travis-ci.com/user/languages/python/
language: python

python:
- "3.6"

install:
- uname -a
- wget https://github.com/gohugoio/hugo/releases/download/v0.42.2/hugo_0.42.2_Linux-64bit.deb
- sudo dpkg -i hugo*.deb
- hugo version
- rm -rf blog
- ls
- pwd

script:
- hugo -d blog
- echo 'Hugo build done!'
after_success:
- git config --global user.email "yangqing43352@163.com"
- git config --global user.name "griee"
- git clone https://$GITHUB_TOKEN@github.com/RiceBrother/RiceBrother.github.io.git container
- rm -rf container/blog
- cp -r blog/* container
- cd container
- ls
- git add .
- git commit -m 'Travis upate blog'
- git push -u origin master

这个时候切回到Travis CI网站查看脚本执行的日志,显示Done. Your build exited with 0.一般没有问题(如果有问题可以查看job log,有可能是git 提交失败),刷新自己的xxx.github.io看看效果,这样每次只需要修改自己的文章并提交到source分支,就会自动触发脚本生成blog目录并提交到master分支。

展示自我

正常情况下呢通过上面的步骤应该能正常访问到博客了,但是,你建立一个博客肯定不仅仅是给自己看的吧,所以要让别人在搜索引擎中能搜到自己,就需要做做下面的功夫了。

这里以Google搜索为例,在Google中输入site:https://ricebrother.github.io/提示查询不到相关内容,则说明你的站点并未被收录,所以别人也搜不到你的文章内容。

进入Google搜索文档地址,登录自己的账号,然后添加自己的网址,会有一个验证,将该html下载下来,上传到master分支就可以了。通过验证可以在控制台查看你的站点的访问量等等。

最后将https://xxx.github.io/sitemap.xml添加到Google站点地图就可以啦。

参考链接

< NEWER