将博客从halo迁移到hexo

谁践踏了优雅 2022-12-11 12:26 799阅读 0赞

![be6cb32419abf0306be25d63efd226da.png][]

> 今年年初由 wordpress 迁移到 halo，主要是觉得懂点 Java，有什么定制化的需求，自己改代码会方便一些。但是也没有什么特别的需求需要定制，反而被这种东西折腾得忘记了写博客的初心。技术博客就应该简简单单，只写技术，博客怎么好看、怎么炫酷，都不重要。

## 配置说明&前置条件 ##

*  在 Halo 中，数据库使用的是 MySQL 5.7，并将 halo 服务所用数据库，内容导入到本地的数据库中，这样速度会快一些。
 *  hexo 所用主题是 Icarus

## 编码 ##

总体思路：将 halo 的数据，导出成 hexo 所需要的格式。总体分为下面几个步骤：

1.  halo 字段与 hexo 字段对比  
    参考 [hexo 文档][hexo]，与之一一对应即可。后续根据 Icarus 的几个配置，又在 front-matter 里面添加了几个属性。

<table> 
 <thead> 
  <tr> 
   <th align="left">参数</th> 
   <th align="left">描述</th> 
   <th align="left">默认值</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left"><code>layout</code></td> 
   <td align="left">布局</td> 
   <td align="left"></td> 
  </tr> 
  <tr> 
   <td align="left"><code>title</code></td> 
   <td align="left">标题</td> 
   <td align="left">文章的文件名</td> 
  </tr> 
  <tr> 
   <td align="left"><code>date</code></td> 
   <td align="left">建立日期</td> 
   <td align="left">文件建立日期</td> 
  </tr> 
  <tr> 
   <td align="left"><code>updated</code></td> 
   <td align="left">更新日期</td> 
   <td align="left">文件更新日期</td> 
  </tr> 
  <tr> 
   <td align="left"><code>comments</code></td> 
   <td align="left">开启文章的评论功能</td> 
   <td align="left">true</td> 
  </tr> 
  <tr> 
   <td align="left"><code>tags</code></td> 
   <td align="left">标签（不适用于分页）</td> 
   <td align="left"></td> 
  </tr> 
  <tr> 
   <td align="left"><code>categories</code></td> 
   <td align="left">分类（不适用于分页）</td> 
   <td align="left"></td> 
  </tr> 
  <tr> 
   <td align="left"><code>permalink</code></td> 
   <td align="left">覆盖文章网址</td> 
   <td align="left"></td> 
  </tr> 
 </tbody> 
</table>

1.  将 halo 的 tags、categories 转化成 hexo 里面的 tags、categories  
    ![tag与post的关联关系][tag_post]  
    category 与 tag 类似，都是通过一个关联表，与 post 建立关联关系。转换的逻辑自然变成了：根据 post\_id 查 post\_tags 表中的关联关系，得到 tag\_id，再从 tag 表中获取 tag 的名称。
2.  转化文章预览  
    这部分不太好转，直接用 markdown 有些 markdown 的语法符号，没办法过滤掉、或者过滤起来很难受。这里的做法是这样的：

*  在 front-matter 中添加 excerpt 属性
 *  如果原文章(halo)中存在 summary，直接赋值给 excerpt
 *  没有 summary，则先将 markdown 转化成 HTML，然后获取 HTML 中的前几个 dom 元素。

文章属性

type Post struct {
        
    	Title      string
    	Content    string
    	Password   string
    	Date       string
    	Updated    string
    	Thumbnail  string
    	Tags       []string
    	Categories []string
    	Summary    string
    	Priority   string
    }

主流程

package main
    
    import (
    	"fmt"
    	_ "github.com/go-sql-driver/mysql"
    	"github.com/gomarkdown/markdown"
    	"html"
    	"io/ioutil"
    	"path"
    	"regexp"
    	"strings"
    	"xorm.io/xorm"
    )
    
    func main() {
        
    	basePath := "/Users/akina/hexo-blog/source/_posts"
    	db, _ := xorm.NewEngine("mysql", "root:root@tcp(localhost:3306)/halodb-tmp")
    	db.ShowSQL(true)
    	queriedPosts, _ := db.Query("select * from posts")
    	for _, qp := range queriedPosts {
        
    		pid := qp["id"]
    		post := Post{
        
    			Title:     string(qp["title"]),
    			Content:   html.UnescapeString(string(qp["original_content"])),
    			Password:  string(qp["password"]),
    			Date:      string(qp["create_time"]),
    			Updated:   string(qp["update_time"]),
    			Thumbnail: string(qp["thumbnail"]),
    			Summary:   string(qp["summary"]),
    			Priority:  string(qp["top_priority"]),
    		}
    		// 处理标签
    		queriedTagIds, _ := db.Query("select tag_id from post_tags where post_id = " + string(pid))
    		if len(queriedTagIds) > 0 {
        
    			tagIds := make([]string, 0)
    			for _, tagId := range queriedTagIds {
        
    				tagIds = append(tagIds, string(tagId["tag_id"]))
    			}
    			queriedTagNames, _ := db.Query(fmt.Sprintf("select name from tags where id in (%s)", strings.Join(tagIds, ",")))
    			tagNames := make([]string, 0)
    			for _, tagName := range queriedTagNames {
        
    				tagNames = append(tagNames, string(tagName["name"]))
    			}
    			post.Tags = tagNames
    		}
    		// 处理分类
    		queriedCategoryIds, _ := db.Query("select category_id from post_categories where post_id = " + string(pid))
    		if len(queriedCategoryIds) > 0 {
        
    			categoryIds := make([]string, 0)
    			for _, categoryId := range queriedCategoryIds {
        
    				categoryIds = append(categoryIds, string(categoryId["category_id"]))
    			}
    			queriedCategoryNames, _ := db.Query(fmt.Sprintf("select name from categories where id in (%s)", strings.Join(categoryIds, ",")))
    			categoryNames := make([]string, 0)
    			for _, categoryName := range queriedCategoryNames {
        
    				categoryNames = append(categoryNames, "- ["+string(categoryName["name"])+"]")
    			}
    			post.Categories = categoryNames
    		}
    		// 写文件
    		postHexoData := strings.Join([]string{
        
    			"---",
    			"title: \"" + post.Title + "\"",
    			"date: " + post.Date,
    			"updated: " + post.Updated,
    			"tags: [" + strings.Join(post.Tags, ",") + "]",
    			"categories: \n" + strings.Join(post.Categories, "\n"),
    			"thumbnail: " + post.Thumbnail,
    			"password: " + post.Password,
    			"excerpt: \"" + getPostSummary(post) + "\"",
    			"top: " + post.Priority,
    			"toc: true",
    			"---",
    			post.Content,
    		}, "\n")
    		ioutil.WriteFile(path.Join(basePath, post.Title+".md"), []byte(postHexoData), 0666)
    	}
    }

获取文章的预览

func getPostSummary(post Post) string {
        
    	var res string
    	if post.Summary != "" {
        
    		res = post.Summary
    	} else {
        
    		htmlContent := string(markdown.ToHTML([]byte(post.Content), nil, nil))
    
    		for i := 1; i <= 4; i++ {
        
    			re := regexp.MustCompile("<.*?>.*?</.*?>")
    			label := string(re.Find([]byte(htmlContent)))
    			if label == "" {
        
    				break
    			}
    			res = res + label
    
    			htmlContent = strings.ReplaceAll(htmlContent, label, "")
    			if htmlContent == "" {
        
    				break
    			}
    		}
    	}
    
    	for _, ch := range []string{
        
    		"\n",
    	} {
        
    		res = strings.ReplaceAll(res, ch, " ")
    	}
    	res = strings.ReplaceAll(res, "\"", "'")
    	res = strings.TrimPrefix(res, " ")
    	res = strings.TrimSuffix(res, " ")
    
    	fmt.Println(res)
    
    	return res
    }

## Conclusion ##

后续有几个需要改一下预览的内容，貌似不能通过 `hexo g`，原因是转义符的问题、单、双引号的问题等，只有少量，手动改了改，还算可以接受。

[be6cb32419abf0306be25d63efd226da.png]: /images/20221123/1e080ccbe587497caaf9356aee5b8930.png
[hexo]: https://hexo.io/zh-cn/docs/front-matter
[tag_post]: /images/20221123/094f3f6d9dae4ffaa3660011c743f1ce.png