从 WordPress 到 Hugo：我的博客迁移全记录

WordPress (MySQL)
    ↓
导出 WXR XML（WordPress 导出工具）
    ↓
PHP 转换脚本（自定义 wp2hugo.php）
    ↓
Hugo Markdown 文件
    ↓
Hugo 构建
    ↓
静态 HTML（Nginx 托管）

[markup]
[markup.goldmark]
[markup.goldmark.renderer]
unsafe = true  # 允许 HTML

<?php
$xmlFile = '/path/to/wordpress-export.xml';
$outputDir = '/path/to/hugo/content/posts';

$xml = simplexml_load_file($xmlFile);
$namespaces = $xml->getNamespaces(true);

function yaml_escape($str) {
    $str = (string)$str;
    $str = str_replace('\\', '\\\\', $str);
    $str = str_replace('"', '\\"', $str);
    $str = str_replace("\n", '\\n', $str);
    return '"' . $str . '"';
}

$count = 0;
foreach ($xml->channel->item as $item) {
    $wp = $item->children($namespaces['wp']);
    $post_type = (string)$wp->post_type;
    $status = (string)$wp->status;
    
    // 只处理已发布的文章
    if ($post_type !== 'post' || $status !== 'publish') continue;
    
    $title = trim((string)$item->title);
    $pubDate = date('Y-m-d', strtotime((string)$item->pubDate));
    $slug = (string)$wp->post_name;
    $body = (string)$item->children($namespaces['content'])->encoded;
    
    // 提取分类和标签
    $categories = [];
    $tags = [];
    foreach ($item->category as $cat) {
        $domain = (string)$cat->attributes()['domain'];
        $name = trim((string)$cat);
        if ($domain === 'category') $categories[] = $name;
        elseif ($domain === 'post_tag') $tags[] = $name;
    }
    
    // 生成 Hugo front matter
    $fm = "---\n";
    $fm .= "title: " . yaml_escape($title) . "\n";
    $fm .= "date: " . $pubDate . "T00:00:00+08:00\n";
    $fm .= "draft: false\n";
    
    if ($categories) {
        $fm .= "categories:\n";
        foreach ($categories as $c) $fm .= "  - " . yaml_escape($c) . "\n";
    }
    if ($tags) {
        $fm .= "tags:\n";
        foreach ($tags as $t) $fm .= "  - " . yaml_escape($t) . "\n";
    }
    $fm .= "---\n\n";
    
    // 按年份分目录保存
    $yearDir = $outputDir . '/' . substr($pubDate, 0, 4);
    if (!is_dir($yearDir)) mkdir($yearDir, 0755, true);
    
    $filename = $yearDir . '/' . preg_replace('/[^a-z0-9-]/i', '-', $slug) . '.md';
    file_put_contents($filename, $fm . $body);
    $count++;
}
echo "Converted: $count posts\n";

php wp2hugo.php
# 输出: Converted: 282 posts

baseURL = 'https://zhaoyanblog.com/'
languageCode = 'zh-cn'
defaultContentLanguage = 'zh-cn'
title = '赵岩的技术笔记'
theme = 'PaperMod'

enableRobotsTXT = true

[pagination]
pagerSize = 15

[params]
env = 'production'
description = '记录学习、工作和思考'
defaultTheme = 'auto'
ShowReadingTime = true
ShowCodeCopyButtons = true
ShowBreadCrumbs = true

[taxonomies]
category = 'categories'
tag = 'tags'

[outputs]
home = ['HTML', 'RSS', 'JSON']

[markup]
[markup.goldmark]
[markup.goldmark.renderer]
unsafe = true  # 允许 HTML
[markup.highlight]
codeFences = true
guessSyntax = true
style = 'github'

cd /path/to/hugo
git clone https://github.com/adityatelange/hugo-PaperMod themes/PaperMod --depth=1

#!/bin/bash
cd /home/zhaoyan/zhaoyanblog/hugo
/usr/local/bin/hugo "$@"
cp public/index.json public/page/ 2>/dev/null

server {
    listen 443 ssl;
    server_name zhaoyanblog.com;
    
    ssl_certificate   cert/zhaoyanblog.com.pem;
    ssl_certificate_key  cert/zhaoyanblog.com.key;
    
    root /home/zhaoyan/zhaoyanblog/hugo/public;
    index index.html;
    
    location / {
        try_files $uri $uri/ =404;
    }
}

function yaml_escape($str) {
    $str = str_replace('\\', '\\\\', $str);
    $str = str_replace('"', '\\"', $str);
    $str = str_replace("\n", '\\n', $str);
    return '"' . $str . '"';
}

[markup.highlight]
codeFences = true
guessSyntax = true  # 自动检测语言
style = 'github'

```php
// 代码内容
```

---
title: "文章标题"
aliases:
  - /2024/01/hello-world/
---

总文章数：282
年份分布：
  2014: 146 篇
  2015: 82 篇
  2016: 21 篇
  2017: 14 篇
  2018: 8 篇
  2019: 4 篇
  2020: 3 篇
  2025: 1 篇
  2026: 3 篇（含本文）