How to use Hugo and Github Create Static Blog

post-thumb

Hugo & Github 搭建静态博客

操作前提: 1.安装Hugo 2.安装git及后续

下面分为两个部分

第一部分, 安装Hugo

使用Hugo建立本地网站,详细教程见官网: https://gohugo.io/getting-started/quick-start/

简单步骤:

1.下载—>解压—>在Hugo同级目录新建一个文件夹,比如sites, 用来保存网站内容:

Hugo and Github

2.将Hugo的安装目录加入到环境变量

3.初始化新网站内容

进入sites目录,【shift+右键】弹出右键菜单,选择“在此处打开命令窗口”,执行命令

【hugo new site websitename 】 websitename 是自定义的,建议设置为网站主域名,以免混淆

4.添加主题,到这里【https://themes.gohugo.io/】找一款自己喜欢的主题,找到其Github repo地址,命令行操作:

【git clone https://github.com/silvanocerza/spectrum.git 】 // 后面的主题是随便挑的

5.新建文章,命令行操作

【hugo new posts/xxxxxx.md】 // markdown 格式文档,以后可在别处写好.md格式的文档,然后直接放入public目录

6.修改网站config.toml配置文件

7.本地预览博客效果,【hugo server】

第二部分, 安装git及后续

将本地网站内容部署到github,Github Pages支持两种方式的网站部署,详细见官网介绍:https://pages.github.com

这里使用【用户或者组织网站】的方式进行部署

1.新建空仓库,仓库名称必须是username.github.io格式,【username必须是你个人github的账号名称】

2.复制仓库的git repo地址

3.此时操作命令行窗口,确保命令行当前是在网站的目录内,执行【hugo】,对就这么简单快速,此时你会看到网站根目录多了一个【public】

文件夹,这里面就是Hugo框架替你自动生成的网站内容了

4.进入【public】文件夹,右键选择打开git bash:

Hugo and Github

依次执行如下命令:

【git init】 // 初始化git

【git remote add origin https://github.com/xxx/xxx.github.io.git】 // 后面是上面新建的空白仓库地址

【git add .】 // 注意最后有个点,代表把当前目录内的所有文件加入到跟踪

【git commit -m “Initial”】 // 执行git commit 指令

【git push -u origin master】 // 推送到仓库,稍后提示成功

5.如果需要设置独立域名,记得在public文件夹下面建立一个CNAME文档,里面的内容只填写你的主域名,形如【www.xxxxx.com】 这种形式,不过github pages 现在很智能,等一段时间会自己建立CNAME文件,域名服务商里面的设置如下

Hugo and Github

打码处是你的github用户名。OK就这样

PS: 以后更新文章后,首先在网站目录内部执行【hugo】,进行发布 随后进入public目录,执行如下命令:

【git add .】

【git commit -m “add new”】

【git push -u origin master】