使用 Hugo 搭建我的博客

0. Hugo 简介

官网：Hugo

1. 安装 Hugo

以ArchLinux为例：

$ sudo pacman -S hugo
...
$ hugo version  # 验证安装
Hugo Static Site Generator v0.54.0/extended linux/amd64 BuildDate: unknown
复制代码

其余操做系统请参考：Installing Hugo

2. 建立网站

$ hugo new site quickstart
Congratulations! Your new Hugo site is created in /xxx/xxx/quickstart.

Just a few more steps and you're ready to go: 1. Download a theme into the same-named folder. Choose a theme from https://themes.gohugo.io/, or create your own with the "hugo new theme <THEMENAME>" command. 2. Perhaps you want to add some content. You can add single files with "hugo new <SECTIONNAME>/<FILENAME>.<FORMAT>". 3. Start the built-in live server via "hugo server". Visit https://gohugo.io/ for quickstart guide and full documentation. 复制代码

3. 添加一个主题

所有主题见themes.gohugo.io，这里以Ananke主题为例：

$ cd quickstart
$ git init
$ git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke
$ cat config.toml
baseURL = "http://example.org/"
languageCode = "en-us"
title = "My New Hugo Site"
$ echo 'theme = "ananke"' >> config.toml
$ cat config.toml
baseURL = "http://example.org/"
languageCode = "en-us"
title = "My New Hugo Site"
theme = "ananke"
复制代码

4. 添加一些内容

$ hugo new posts/my-first-post.md
复制代码

而后在my-first-post.md中任意添加一些内容。

5. 启动 Hugo 服务

$ hugo server -D

                   | EN  
+------------------+----+
  Pages            | 10  
  Paginator pages  |  0  
  Non-page files   |  0  
  Static files     |  3  
  Processed images |  0  
  Aliases          |  1  
  Sitemaps         |  1  
  Cleaned          |  0  

Total in 12 ms
Watching for changes in /home/ronald/go/src/quickstart/{content,data,layouts,static,themes}
Watching for config changes in /home/ronald/go/src/quickstart/config.toml
Environment: "development"
Serving pages from memory
Running in Fast Render Mode. For full rebuilds on change: hugo server --disableFastRender
Web Server is available at http://localhost:1313/ (bind address 127.0.0.1)
Press Ctrl+C to stop
复制代码

而后打开http://localhost:1313/访问。

6. 自定义主题

详情请参考Theme Components。

-1. 迁移

先把blog仓库克隆下来，而后删除此仓库并重建此仓库，而后换一个目录将此仓库再克隆下来，而后讲原仓库的文件所有复制进新仓库。

而后：

$ cd blog
$ git submodule add https://github.com/aubm/hugo-code-editor-theme.git themes/code-editor
$ git submodule add -b master git@github.com:RonaldZhao/RonaldZhao.github.io.git public
复制代码

而后将public文件夹中除.git文件外所有删除，而后在blog文件夹中执行hugo -D。

最后分别在blog和public文件夹中push。