从其他博客框架迁移

AI 迁移助手

选择你的原始框架,复制提示词到 AI 助手中,快速完成迁移。

我正在将博客从 Hexo 迁移到 Valaxy。请帮我完成以下工作:

1. 将 Hexo source/_posts 中的 Markdown 文件迁移到 Valaxy pages/posts 目录
2. 转换 Hexo frontmatter 格式为 Valaxy 支持的格式(如 date、tags、categories)
3. 将 Hexo _config.yml 中的站点配置转换为 Valaxy 的 site.config.ts 和 valaxy.config.ts
4. 迁移静态资源(图片等)从 source 到 public 目录
5. 如果使用了 Hexo 特有的标签插件(tag plugins),转换为 Valaxy/Markdown 等效写法

从 Hexo 迁移至 Valaxy

迁移内容

Hexo 博客目录与 Valaxy 博客目录对应关系如下,将相关内容复制至对应文件夹即可。

譬如迁移文章,即将 Hexo source/_posts 目录下内容复制至 Valaxy pages/posts 目录下。

用途HexoValaxy
文章(Markdown 文件)source/_postspages/posts
页面(Markdown / Html)sourcepages
静态资源(*.js / *.css / CNAME etc.)sourcepublic

迁移配置

参考 Valaxy 配置文档 将 Hexo _config.yml 配置文件中的内容,迁移至 valaxy.config.ts 文件中。

配置示例:demo/yun/valaxy.config.tsyunyoujun.github.io/valaxy.config.tsvalaxy.config.ts 提供了完备的类型提示,这意味着你在 VSCode 中可以直接鼠标悬浮查看各参数注释。

示例

更复杂的迁移示例,您还可以对比 yunyoujun.github.io | GitHub 仓库 hexo 分支与 valaxy 的异同。

从其他任意博客框架迁移

  • 将你的文章(Markdown 文件)复制至 Valaxy pages/posts 目录下。
  • 将你的自定义页面(非文章的 Markdown/HTML 文件)复制至 Valaxy pages 目录下。
  • 将你的静态资源(图片等)复制至 Valaxy public 目录下。
  • 参考 配置 配置你的配置文件 valaxy.config.ts/site.config.ts

常见问题

摘要截断符

默认为 <!-- more -->more 前后需有空格。

Markdown 换行

Valaxy 的 Markdown 解析基于 markdown-it 实现。

没有换行

markdown-it 的策略在 Markdown 中换行后渲染的内容并没有换行:

md[object Promise]

第一行 没有换行


换行了

如果需要正常换行,需在末尾添加两个空格:

md[object Promise]

第一行(末尾有两个空格)
换行了

贡献者