从其他博客框架迁移
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目录下内容复制至 Valaxypages/posts目录下。
| 用途 | Hexo | Valaxy |
|---|---|---|
| 文章(Markdown 文件) | source/_posts | pages/posts |
| 页面(Markdown / Html) | source | pages |
静态资源(*.js / *.css / CNAME etc.) | source | public |
迁移配置
参考 Valaxy 配置文档 将 Hexo _config.yml 配置文件中的内容,迁移至 valaxy.config.ts 文件中。
配置示例:demo/yun/valaxy.config.ts、yunyoujun.github.io/valaxy.config.ts
valaxy.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]
第一行(末尾有两个空格)
换行了