https://wlj.me/tags/hugo/Recent content in Hugo on Luca's BlogHugozhTue, 14 Apr 2026 20:44:10 +0800https://wlj.me/posts/wuwufu-wordpress-to-hugo/Tue, 14 Apr 2026 20:44:10 +0800https://wlj.me/posts/wuwufu-wordpress-to-hugo/<p>父亲从 2005 年开始在 WordPress.com 写博客，到 2025 年一共 786 篇文章、591 条评论、78 段视频。这几天把它整站搬到了 Hugo + Cloudflare Pages，托管在 <a href="https://wuwufu.com">wuwufu.com</a>。</p> <p>记录一下工具链和几个要留意的地方。</p> <h2 id="整体方案">整体方案</h2> <ul> <li>内容：wp2hugo 从 WordPress 导出的 WXR XML 转 Markdown</li> <li>主题：PaperMod，自定义布局模仿原站 Twenty Seventeen 的头图风格</li> <li>评论：REST API 抓回来，生成静态 HTML 嵌入每篇文章末尾</li> <li>视频：ffmpeg x265 2-pass 压缩，从 10.1GB 压到 587MB</li> <li>托管：Cloudflare Pages，DNS 也搬到 Cloudflare</li> </ul> <h2 id="内容转换wp2hugo">内容转换：wp2hugo</h2> <p>WordPress 后台导出 WXR XML（Tools → Export），然后跑 <a href="https://github.com/ashishb/wp2hugo">wp2hugo</a>，出来就是 Hugo 友好的目录结构：<code>content/posts/*.md</code> + <code>static/wp-content/uploads/</code>。</p> <p>转换后 Markdown 里会有一些残留的 WordPress shortcode（<code>[gallery]</code>、<code>[embed]</code> 这些），还有空标题、重复文章，写了几个清理脚本扫一遍。</p> <h2 id="评论自己抓嵌进去">评论：自己抓，嵌进去</h2> <p>WordPress.com 因为不是自托管，用不了评论迁移插件。但 20 年下来 591 条评论不能丢。</p> <p>好在 WordPress.com 开放了 REST API，按文章 ID 翻页抓：</p>https://wlj.me/posts/hugo-github-pages-to-cloudflare/Mon, 13 Apr 2026 13:00:00 +0800https://wlj.me/posts/hugo-github-pages-to-cloudflare/<p>这个博客之前用 GitHub Pages 托管，通过 GitHub Actions 构建 Hugo，推到 main 分支就自动部署。用了一段时间，没什么大问题，但 Cloudflare Pages 有几个吸引我的地方：构建速度更快，自带 CDN 和 DDoS 防护，DNS 和托管在同一个面板管理。</p> <p>迁移很简单，整个过程不到二十分钟。</p> <h2 id="cloudflare-pages-创建项目">Cloudflare Pages 创建项目</h2> <p>登录 Cloudflare Dashboard，进 Workers &amp; Pages，点 Create，选 Pages，连接 GitHub 仓库。</p> <p>构建配置：</p> <ul> <li>Framework preset：Hugo</li> <li>Build command：<code>hugo --gc --minify</code></li> <li>Build output directory：<code>public</code></li> </ul> <p>环境变量加一条：<code>HUGO_VERSION</code> = <code>0.159.2</code>（和原来 GitHub Actions 里保持一致）。Cloudflare 内置的 Hugo 版本比较旧，不设这个大概率构建失败。</p> <p>设好之后 Cloudflare 会立即触发一次构建，几十秒就能完成。构建成功后会分配一个 <code>xxx.pages.dev</code> 的临时域名，可以先打开看看效果对不对。</p> <h2 id="dns-迁移">DNS 迁移</h2> <p>在 Cloudflare 添加域名，它会给你两个 nameserver，类似 <code>alice.ns.cloudflare.com</code> 和 <code>bob.ns.cloudflare.com</code>。</p> <p>去域名注册商（或者原来用的 DNS 服务商，比如 DNSPod）把 nameserver 改成 Cloudflare 给的这两个。改完之后等 DNS 传播，通常几分钟到几小时。</p>