Write the Code. Change the World.

8月 24

生成文档好帮手,Hugo

Hugo 是由 Go 语言实现的静态网站生成器。简单、易用、高效、易扩展、快速部署。

https://www.gohugo.org/

linux ,unix(mac)比较好装,这里尝试在 win10 上安装 hugo。

操作一波

折腾再折腾。

  1. 先安装 Chocolatey。
    我们借助的是 Chocolatey 这款软件包管理器。它事实上是为了习惯于 Linux 的程序员们准备的,因为在 Linux 中安装程序,通常都只需要一条安装命令就可以完成。
    Chocolatey 自身的安装很方便,一共有三步:

- 开始菜单中搜索 cmd,选择「命令提示符」
- 右键菜单或在右边菜单选择「以管理员身份运行」
- 复制下面这段内容,回车执行

@"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command "iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"
  1. 再安装 hugo
choco install hugo -confirm

Chocolatey 安装太慢怎么办,可以用 为屁嗯

生站点

安装好了 hugo 后,就可以开始生站点了。试试看。

cd test

# 这个时候就生成基本文件和目录,仅仅 config.toml(也可以改成config.yaml)有四行内容,其他文件夹是空的
hugo new site hugo.cn

cd hugo.cn

# 开始生了(虽然没有实际的文件),访问 http://localhost:1313,会是一个空白页面
hugo server

安装主题试试

cd themes

git clone https://github.com/spf13/hyde

接下来,我们需要对Site进行一些配置 tonybai.com/config.toml是Site的顶层配置文件,配置后的config.toml文件如下:

baseurl = "http://hugo.cn/"
languageCode = "en-us"
title = "just test hugo"
theme = "hyde"

[params]
    description = "测试博客"
    themeColor = "theme-base-08" # for hyde theme

其中,theme = “hyde” 指定站点使用Hyde主题;themeColor = “theme-base-08″ 指定了站点的主题颜色(默认是黑色的,这里改成一种红色)

再执行 hugo server 看看。页面是不是不再空着了。

hugo server -w 

# 加上 w 参数,可以动态执行生,也就是 content 里边改变或新加减少文件都能被感应到,并生成 html 文件。但 config.toml 改变是感应不到的,必须得手动再执行一次。

# 直接执行 hugo 则直接打包,生成 public 目录文件。自己去部署就可以了。
hugo

相关文章

https://gohugo.io/getting-started/installing/

https://www.gohugo.org/post/coderzh-hugo/

https://www.gohugo.org/theme/

https://sspai.com/post/55309

https://tonybai.com/2015/09/23/intro-of-gohugo/

后话

Chocolatey 和 Scoop 。