环境准备

1. hugo环境

https://github.com/gohugoio/hugo/releases    
如上地址下载对系统所需要的二进制文件    
当然如果系统部署了包管理环境的话则可以直接使用工具安装

2. 配置系统环境变量（win）

将hugo.exe的路径放入系统环境变量的path中    
重新打开终端

站点创建操作

1. 定位目录

在终端中切换到需要生成站点的目录

2. 创建初始站点

hugo new site sitename

切换到sitename目录即可进行下一步操作

3. 选择主题文件并应用样式

https://themes.gohugo.io/
在官方主题站拉取主题到对应主题目录
复制主题exampleSite目录内的所有内容并覆盖到根目录
打开根目录的config.toml并根据需求修改内容即可修改完毕后在根目录使用

如：https://github.com/Track3/hermit

使用主题需要注意以下要点否则可能会导致主题在服务器端不生效

命令输入顺序如下：

cd sitename  
git init  
git submodule add https://github.com/Track3/hermit.git themes/hermit  
hugo -D  
hugo --theme=hermit --baseUrl='xxx.github.io' --buildDrafts (注意命令等号左右不加空格)

进入主题文件夹后将配置模板（一般在exampleSite文件夹中）的配置文件config.toml修改，备份主站点主目录的config.toml后贴上修改后的配置文件。
配置模板文件夹中的其他文件复制到主目录

# 编译  
hugo -D  
#测试  
hugo server

即可预览效果

4.部署到github

1.根目录

> hugo  
> ```  
> 即可生成需要推送到git的项目静态文件于public目录中    
  
> 2.切换到public目录    
> 在git已经配置好的情况下    
> 打开github并创建新仓库    
> 仓库名必须为： [当前用户名].github.io  
> ```bash  
> git init  
> git remote add origin [仓库地址].git  
> git add .  
> git commit -m '#'  
> git push -u origin master  
> ```  
  
之后即可访问https://[当前用户名].github.io  
  
---  
  
## 新文章创建  
1. hugo new post/content_name.md  
2. 直接于 根目录/content/post 中创建新的md文件即可  
3. 注意文章头部格式如本篇

echo +++ title = “Win10下用Hugo把博客搭建到gitpages上” tags = [“hugo”, “blog”] date = “2019-08-02T20:01:56+08:00” +++

   主题与主题使用的格式可能不相同  
  
   每次更改主题之后先hugo一下或者hugo server一下自动生成测试文章    
   之后参考测试模板文章更改文章头部信息即可  
4. 将更改推送到github

bash cd public git add . git commit -m ‘#’ git push -u origin master ``` 5. 刷新浏览器缓存即可见到新文章已经在站点中了

参考资料

 hugo中文资料网  https://www.gohugo.org/    
 官方主题列表  https://themes.gohugo.io/

STC214/用hugo把个人博客建立到gitpages上