ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

从WordPress一键迁移到Leafpub:开源博客数据完整导入保姆级教程

从WordPress一键迁移到Leafpub:开源博客数据完整导入保姆级教程 从WordPress一键迁移到Leafpub开源博客数据完整导入保姆级教程【免费下载链接】leafpubSimple, beautiful, open source publishing.项目地址: https://gitcode.com/gh_mirrors/le/leafpubLeafpub 是一款简单、美观的开源发布系统Simple, beautiful, open source publishing内置强大的WordPress 迁移导入功能只需上传 WordPress 导出的 XML 文件就能把文章、标签、用户和媒体文件完整导入实现从 WordPress 一键迁移。 本文适合正在考虑换平台的新手读完即可独立完成 WordPress 到 Leafpub 的数据迁移。为什么选择 Leafpub 承接你的 WordPress 博客轻量简单基于 PHP 构建无需复杂依赖导入流程内嵌在后台无需第三方插件。数据完整文章、页面、分类、标签、作者、媒体附件均可导入。智能清洗自动清理 WordPress 短代码并改写旧的图片路径避免迁移后图片失效。事务保护导入在数据库事务中执行失败自动回滚不怕导一半。第一步从 WordPress 导出数据登录 WordPress 后台进入工具 → 导出Tools → Export。选择全部All content点击下载导出文件你会得到一个wordpress2026xxxx.xml文件。备份wp-content/uploads目录如果希望连图片一起迁移。安装并启动 Leafpub。若需获取源码执行git clone https://gitcode.com/gh_mirrors/le/leafpub将网站部署到 PHP 环境Apache/Nginx MySQL后访问后台完成初始化。第二步打开 Leafpub 导入页面登录 Leafpub 后台左侧菜单点击Import导入即可看到Welcome to the Leafpub importer欢迎页。该页面对应模板文件app/source/templates/import.hbs前端交互逻辑在app/source/scripts/import.js。页面上共有 4 个配置项下面逐个说明1️⃣ 选择博客平台Select blog platform勾选Wordpress系统同时支持 Ghost。这是单选按钮选中后才会激活 XML 上传区域。2️⃣ 上传 XML 文件点击选择要导入的 XML 文件选中上一步下载的wordpress2026xxxx.xml。文件会先上传到服务器的content/uploads/import.xml由 APIController 处理上传完成后右上角的Import按钮才会点亮。3️⃣ 四个关键选项怎么选选项作用新手建议Truncate tables清空数据表导入前清空现有文章、标签、媒体表新站/全新迁移 ✅ 勾选在已有关数据的站上慎选Import user导入用户保留 WordPress 的作者账号多作者博客 ✅ 勾选Use categories as tags分类转标签把 WordPress 分类当作 Leafpub 标签导入✅ 勾选信息不丢失媒体文件三选一不导入 / 从远程服务器下载 / 从本地服务器读取见下方说明媒体文件选项详解Dont import media只导入文字数据图片保留在旧服务器上旧站不能下线时可选。Import media from remote serverLeafpub 会自动从你旧 WordPress 站点的 URL 下载图片适合旧站还在线的情况。Import media from local server从本地服务器目录读取文件适合两台机器在同一台主机上的场景。4️⃣ 点击 Import等待完成点击Import按钮后页面顶部会出现进度条稍等片刻即可看到成功提示若有个别条目失败系统会弹窗列出失败原因方便你排查。幕后揭秘Leafpub 如何解析 WordPress XML了解原理能帮你更快处理迁移中的小问题。核心实现在 Wordpress 导入器app/source/classes/Importer/Dropins/Wordpress.php解析作者读取 XML 中的wp:author节点还原作者名、邮箱解析分类与标签wp:category、wp:tag分别映射为 Leafpub 的标签解析文章与页面post_type为post/page的条目转为 Leafpub 文章草稿状态也一并保留自定义文章类型按普通文章处理解析媒体附件attachment类型的条目转为媒体库文件内容清洗filterContent方法将正文中旧站的wp-content/uploads/年/月图片地址批量改写为 Leafpub 的/content/uploads/年/月路径去掉 WordPress 缩略图尺寸后缀如-300x200删除无法识别的 WordPress 短代码。整个导入由 ImportFactory 按平台分发到对应的 Dropin 类最终在 AbstractImporter 中统一写入数据库——用户 → 标签 → 文章 → 媒体任何一步出错都会整体回滚保证数据一致性。迁移常见问题FAQQ1导入后正文里的图片打不开怎么办优先选择从远程服务器导入媒体并确保旧 WordPress 站点仍在线可访问若旧站已下线可先把图片下载到本地服务器再选本地导入。Q2为什么会提示需要 simplexml 扩展WordPress 导入依赖 PHP 的simplexml扩展请确认服务器已安装绝大多数 PHP 环境默认启用。Q3能多次导入吗可以但重复导入会因文章 slug 相同而报错。建议先勾选清空数据表重新导入或先手动清理旧数据。Q4WordPress.com 免费站也能导吗可以导入器已针对 wordpress.com 的附件地址做了专门识别。写在最后整个过程只需三步WordPress 导出 XML → 上传到 Leafpub 导入页 → 点 Import。Leafpub 用简单、美观、开源发布的理念把最繁琐的数据迁移做成了开箱即用的一键功能。现在就去开启你的新博客吧【免费下载链接】leafpubSimple, beautiful, open source publishing.项目地址: https://gitcode.com/gh_mirrors/le/leafpub创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表