引言

终于还是受不了 Octopress 了，准备迁移到 Hugo，受不了 Octopress 是因为：

  • markdown code 语法支持不好，很多时候莫名其妙的 Build 失败，让人抓狂。（最主要原因）
  • 生成速度太慢，目前生成一次要2分多钟了
  • Octopress 项目已经没人维护了

安装 Hugo

如果是 Mac 的话直接：

1
2
3
4
5
6

brew install hugo
hugo new site blog
cd blog
git init
git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke
echo 'theme = "ananke"' >> config.toml

然后就可以用下面命令生成文章了：

1

hugo new posts/my-first-post.md

开启服务

1

hugo server -D

然后访问 http://localhost:1313/ 就可以看到你的 Hugo 博客了。

迁移文章

官方有迁移指南，Octopress 迁移到 Hugo 官方推荐使用 octohug，但是我使用下来发现不好用，迁移完之后有小问题。于是我找了一篇文章，结合文章给的代码，自己完善了功能，终于达到我要的效果，参考代码如下：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

package main

import (
	"flag"
	"fmt"
	"io/ioutil"
	"os"
	"regexp"
	"strings"
)

func main() {
	var src, dst string
	flag.StringVar(&src, "src", "", "source")
	flag.StringVar(&dst, "dst", "", "destination")
	flag.Parse()

	if _, err := os.Stat(src); os.IsNotExist(err) {
		panic("source directory does not exist")
	}

	if _, err := os.Stat(dst); os.IsNotExist(err) {
		if err := os.Mkdir(dst, os.ModePerm); err != nil {
			panic(err)
		}
	}

	files, err := ioutil.ReadDir(src)
	if err != nil {
		panic(err)
	}

	for _, file := range files {
		filename := file.Name()
		re := regexp.MustCompile(`^\d{4}-\d{2}-\d{2}-(.*).m(arkdown|d)`)
		// Ignore non-matching filenames (i.e. do no dereference nil)
		if matches := re.FindStringSubmatch(filename); matches == nil {
			continue
		}

		in := fmt.Sprintf("%s%s", src, filename)
		data, err := ioutil.ReadFile(in)
		if err != nil {
			panic(err)
		}

		re = regexp.MustCompile(`(\d{4}-\d{2}-\d{2})-(.*)`)
		newFilename := re.ReplaceAllString(filename, "$2")

		re = regexp.MustCompile(`---\n([\s\S]*)---\n([\s\S]*)`)
		matches := re.FindSubmatch(data)
		header := string(matches[1])
		body := string(matches[2])
		draftline := "draft: false\n"

		// date
		re = regexp.MustCompile(`date: (\d{4}-\d{2}-\d{2}) (\d{2}:\d{2}).*\n`)
		header = re.ReplaceAllString(header, `date: ${1}T$2:00+08:00`+"\n")

		// layout
		re = regexp.MustCompile(`layout: .*\n`)
		header = re.ReplaceAllString(header, "")

		// comments
		re = regexp.MustCompile(`comments: .*\n`)
		header = re.ReplaceAllString(header, "")

		// categories
		re = regexp.MustCompile(`categories: (.*)\n`)
		matches = re.FindSubmatch([]byte(header))
		if categories := string(matches[1]); categories != "" {
			tags := strings.ReplaceAll(categories, " ", "\", \"")
			header = re.ReplaceAllString(header, fmt.Sprintf("tags: [\"%s\"] \n", tags))
		}

		more := "toc: true\n"
		header = fmt.Sprintf("%s%s%s", header, draftline, more)

		content := fmt.Sprintf("---\n%s---\n%s", header, body)

		// toc
		toc := "* list element with functor item\n{:toc}\n"
		content = strings.ReplaceAll(content, toc, "")

		content = strings.ReplaceAll(content, "{{ .Site.BaseURL }}", "{{ .Site.BaseURL }}")

		out := dst + newFilename
		fmt.Printf("%s -> %s\n", in, out)

		if err := ioutil.WriteFile(out, []byte(content), 0644); err != nil {
			panic(err)
		}
	}
}

使用方式

在 Octopress 博客根目录下新建一个 main.go 文件，然后把上面代码拷贝进去，然后执行下面代码完成迁移：

1

go run main.go -src octopress-blog/blog/_posts/ -dst hugo-blog/content/posts/

最后

这篇文章主要是分享 Octopress 迁移 Hugo 文章的经验，上面的迁移代码不复杂，有一点点 Golang 经验应该是看得懂的，你可以根据自己的需求修改代码。

使用感受对比

博客源码结构

Hugo 的目录结构要比 Octopress 简单的多。主题有一个专门的文件夹存放，这样使得博客源码显得干净整洁。

CI 时间

同样都配置了 CI ，使用 Travis-CI 自动生成静态文件，自动更新博客。但是身为 Golang 开发的 Hugo，明显要比基于 Ruby 开发的 Octopress 要快的多，之前要2分多钟，现在只要1分钟左右就可以了。

KPA3Wt

功能

Octopress 我已经很久没完了，但是最近我自己写了一个 Hugo 主题，明显感觉到 Hugo 要比 Octopress 功能多。官方也有一个基础的 templates

总结

这次迁移总的来说 Hugo 各方面基本上都完胜 Octopress，就着这次迁移博客的时候顺便做了以下几件事情：

  • 把所有 URL 都转为小写了（虽然以前的部分 URL 可能会收到影响）
  • 放弃通过分类来管理文章，只使用标签来管理（虽然一篇文章分类也允许有多个）。
  • 自己写了一个 Hugo 主题，通过写这个主题实现了几个自己一直想要的功能：
    • 优化了 SEO，现在分享我的文章到 Twitter 上会显示卡片模式链接
    • 文章详情会自动列出相关文章（Hugo 自带这个功能，太棒了）
    • 通过给文章打特定的标签，实现热门文章列表

参考链接