Migration from Other
从 Hexo 迁移至 Valaxy
Migrate from Hexo to Valaxy
迁移内容
Migrate Contents
Hexo 博客目录与 Valaxy 博客目录对应关系如下,将相关内容复制至对应文件夹即可。
譬如迁移文章,即将 Hexo
source/_posts目录下内容复制至 Valaxypages/posts目录下。
| 用途 | Hexo | Valaxy |
|---|---|---|
| 文章(Markdown 文件) | source/_posts | pages/posts |
| 页面(Markdown / Html) | source | pages |
静态资源(*.js / *.css / CNAME etc.) | source | public |
The relationship between Hexo blog directory and Valaxy blog directory is shown in the table below. Just copy the relevant contents to the corresponding folder.
For example: To migrate articles, just copy files from Hexo’s
source/_poststo Valaxy’spages/postsdirectory.
| Contents | Hexo | Valaxy |
|---|---|---|
| Posts (Markdown files) | source/_posts | pages/posts |
| Pages (Markdown / Html files) | source | pages |
Static assets (*.js / *.css / CNAME etc.) | source | public |
迁移配置
Migrate Configurations
参考 Valaxy 配置文档 将 Hexo _config.yml 配置文件中的内容,迁移至 valaxy.config.ts 文件中。
配置示例:demo/yun/valaxy.config.ts、yunyoujun.github.io/valaxy.config.ts
valaxy.config.ts提供了完备的类型提示,这意味着你在 VSCode 中可以直接鼠标悬浮查看各参数注释。
Refer to Valaxy Config to migrate configurations from Hexo’s _config.yml to Valaxy’s valaxy.config.ts.
Examples of configuration: demo/yun/valaxy.config.ts, yunyoujun.github.io/valaxy.config.ts.
valaxy.config.tsprovides a complete type prompt, which means that you can hover on configuration fields directly to view the comments in VSCode.
示例
Example
更复杂的迁移示例,您还可以对比 yunyoujun.github.io | GitHub 仓库 hexo 分支与 valaxy 的异同。
For more complex migration examples, you can also compare hexo branch and valaxy branch in yunyoujun.github.io | GitHub to see the similarities and differences.
从其他任意博客框架迁移
Migrate from any other blog framework
- 将你的文章(Markdown 文件)复制至 Valaxy
pages/posts目录下。 - 将你的自定义页面(非文章的 Markdown/HTML 文件)复制至 Valaxy
pages目录下。 - 将你的静态资源(图片等)复制至 Valaxy
public目录下。 - 参考 配置 配置你的配置文件
valaxy.config.ts/site.config.ts。
- Copy your posts (Markdown files) to the Valaxy
pages/postsdirectory. - Copy your custom pages (non-article Markdown/HTML files) to the Valaxy
pagesdirectory. - Copy your static resources (images, etc.) to the Valaxy
publicdirectory. - Configure your configuration file
valaxy.config.ts/site.config.tsby referring to configuration.
常见问题
Common Problems
摘要截断符
Read More Separator
默认为 <!-- more -->,more 前后需有空格。
Default to <-- More -->, there are spaces before and after more.
Markdown 换行
Newline in Markdown
Valaxy 的 Markdown 解析基于 markdown-it 实现。
没有换行
markdown-it 的策略在 Markdown 中换行后渲染的内容并没有换行:
第一行
没有换行第一行 没有换行
换行了
如果需要正常换行,需在末尾添加两个空格:
第一行(末尾有两个空格)
换行了第一行(末尾有两个空格)
换行了
Markdown rendering in Valaxy is based on markdown-it.
The default strategy of markdown-it does not wrap the rendered content when wrapping in Markdown:
first line
second line but not wrappedfirst line second line but not wrapped
If you want to move the second line to a new line, add two spaces at the end of the first line:
first line (with two spaces at the end)
second line got wrapped correntlyfirst line (with two spaces at the end)
second line got wrapped corrently