Hugo是一种通用的静态网站生成器。静态网站则不需要在收到请求后生成页面，而是在整个网站建立起之前就将所有的页面全部生成，访问时直接返回现成的静态页面，不需要数据库的参与。维护简单，不用担心安全性的问题, 访问快速。因此，一旦网站有任何更改，需要重新生成所有的与更改相关的页面。

安装hugo

Windows安装

极简安装，只需要安装git，不安装Chocolatey等。

  • https://github.com/gohugoio/hugo/releases 下载需要的windows版本
  • 解压，新建文件夹hugo（任何名称都可以）
  • 将hugo.exe文件copy到新建文件夹hugo下
  • 用windows自带的powershell打开到该文件夹
  • ./hugo new site mysite 生成静态博客（不要忘记./因为我们没有设置环境变量所以需要地址）

安装主题

1
2
3

$ cd mysite
$ cd themes
$ git clone https://github.com/lgaida/mediumish-gohugo-theme
  • 官网 https://themes.gohugo.io/ 下载主题文件copy到themes文件夹下即可，有的主题文件下有exampleSite文件夹，将其中内容copy到mysite文件夹下，覆盖即可完成该主题设置，如果没有就需要手动设置config.toml配置文件。

开始写文章

  • 退回到mysite文件夹，这次是../两个点哦。
1

../hugo new /post/first.md
  • first.md为markdown规范，比如插入图片命令：
1

![提示文字](pic.jpg)
  • 该图片可以放在与first.md 文件同目录下的first文件夹内。

运行看渲染效果

1

../hugo server

其他命令

–theme=mediumish-gohugo-theme 用其他主题渲染，-D生成静态网页资源

1

../hugo server --theme=mediumish-gohugo-theme -D

利用github进行托管

  • github账号注册 username
  • 新建repository，命名为username.github.io，注意刚注册的相同。
  • 下载git
  • 打开gitbath（文件夹右键），按照提示输入，基本上就是回车。生成的秘钥id_rsa.pub用文本工具打开copy。 ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

  • 在github页面的右上角，单击您的个人资料照片，然后单击“设置”。在用户设置侧栏中，单击SSH和GPG密钥。将密钥粘贴到“密钥”字段中。单击“ 添加SSH密钥”。如果出现提示，请确认您的GitHub密码。

  • 登录github账户，直接创建分支username.github.io username为github的用户名，不需要初始化

  • 进入本地的blog主目录 cd /path/mysite，配置博客,把baseurl的值设置为 http://username.github.io/ ，保存 config.toml

  • 如需添加评论留言例如disqus，先注册，再修改config.toml中disqusShortname即可，注意是shortname不是注册号。

  • 重新生成静态博客，生成的内容在public文件夹下。

    1

    ../hugo -D

  • 上传public内的文件到username.github.io项目，注意替换username， 出现重复可以先删除 git remote rm origin

    1
2
3
4
5
6

    cd public
git init
git add .
git commit -m 'myblog'
git remote add origin git@github.com:username/username.github.io.git
git push -u origin master

    到这里，博客在github上的托管全部完成，等一小会，就可以用：http://username.github.io 来访问你的博客了。