Why Valaxy
What is Valaxy?
Valaxy aims to be a next generation of static blogging frameworks/generators.
什么是 Valaxy?
Valaxy 的目标是成为新一代的静态博客框架/生成器。
INFO信息
- V + galaxy = Valaxy
- V: it based on vue + vite
- galaxy: 我希望它可以像一个平台工具，承载每个人的博客，如同银河系一般美丽
我的博客此前构建于 Hexo 之上，但随着现代前端框架的不断进步，Hexo 的工作流与开发体验已开始落后。 因此我决定基于 Vue 与 Vite 构建新的 hexo-theme-yun。
此前我的目的是使用现代前端框架重构主题，但与 Hexo 的脱离也意味着我要重新完成 Hexo 本身做的一些渲染工作。 那么如果我这么做了，为什么不顺便开发一个专为博客打造的静态站点生成器呢？ 因此，我决定将其叫做 Valaxy。
这是重复造轮子吗？我认为不是。
INFO信息
- V + galaxy = Valaxy
- V: it based on vue + vite
- galaxy: I hope it can be like a platform tool, hosting everyone’s blog, as beautiful as the galaxy
My blog was previously built on Hexo, but as modern front-end frameworks continue to advance, Hexo’s workflow and development experience have begun to lag behind. So I decided to build a new hexo-theme-yun based on Vue and Vite.
My previous intention was to refactor the theme using a modern front-end framework, but the separation from Hexo also meant that I had to redo some of the rendering work that Hexo itself had done. So if I do that, why not develop a static site generator for blogs by the way? So I decided to call it Valaxy.
Is this a reinventing the wheel? I don’t think so.
为什么是 Valaxy?
构想新一代静态博客框架/生成器。
「告诉你两件好事吧」：
- 第一它与 Hexo 相比开发体验和速度上都更胜一筹
- 第二它与 VitePress/VuePress 相比拥有更多针对博客的集成功能，譬如文章列表钩子、自动路由与组件注册、可覆盖的布局与主题等。
我认为 Valaxy 最突出的优势在于它的热更新开发体验与可定制性，但你编写文章或博客配置时，你只需要保存，所有的变更将会即刻显示在页面上，几乎无需等待！
此外，Valaxy 的主题还较少，但以 valaxy-theme-yun 为例，你可以覆盖主题中的任何组件，来定制或编写你自己的主题。
一味地讲述 Valaxy 的优点似乎有些难以理解。
我将会把 Valaxy 与现有的 Hexo（流行的静态博客框架）与 VitePress/VuePress（流行的静态站点生成器）进行对比，并阐述 Valaxy 的优势。
Why Valaxy?
Next Generation Static Blog Framework/Generator
「Two things to tell you」, first, compared with Hexo, Valaxy is superior in both development experience and speed, second, compared with VitePress/VuePress, Valaxy has more integration features for blogs, such as article list hook, automatic routing and component registration, overlay layout and theme, etc.
It seems hard to understand the advantages of Valaxy.
I will compare Valaxy with the existing Hexo (popular static blog framework) and vitepress / vuepress (popular static site generator), and explain the advantages of Valaxy.
import type { UserConfig } from 'valaxy'
import type { UserThemeConfig } from 'valaxy-theme-yun'
export default defineValaxyConfig<ThemeConfig>({
theme: 'yun',
themeConfig: {
banner: {
enable: true,
title: '云游君的小站',
},
},
})Why not …?
为什么不是……？
Wordpress/Typecho 等是动态博客，因此不在考虑范围内。
Wordpress/Typecho are dynamic blogs and therefore are not considered.
Hexo/Hugo/Jekyll
我非常需要现代前端框架提供的开发热重载与 PJAX 体验，以及 TypeScript 的类型提示，但 Hexo 似乎已经有些积重难返，基于此来做一些工作将会束手束脚。
Hugo 也是很棒的静态站点生成器，但是我并没有使用 Go 的需求。当然在打包时所使用的 ESBuild 正是基于 Go 实现。但这并不需要我操心。
Jekyll 算是元老，但同样我并不使用 Ruby，且它似乎并不便捷，也同样存在一些开发体验的问题。 GitHub 为其提供了原生支持是一大优势，但我打算类似使用 GitHub Actions 来达成该方面近乎一致的体验。
I badly need the HMR and PJAX development experience that modern front-end frameworks provide, as well as TypeScript’s type hints, but Hexo seems to have gotten a little stuck in the past, and doing something based on it would be limiting.
Hugo is also a great static site generator, but I have no need to use Go. Of course, the ESBuild used in packaging is based on the Go implementation. But that’s not for me to worry about.
Jekyll is a bit of a veteran, but again I don’t use Ruby, and it doesn’t seem to be easy, and there are some issues with the development experience. The fact that GitHub has native support for it is a big advantage, but I intend to use GitHub Actions to achieve a nearly consistent experience in this regard.
VuePress/VitePress
VitePress 几乎已成为了 VuePress 的继任者。
但 VitePress 是一个很棒的静态站点生成器，它为文档打造，但缺少一些针对博客的定制便捷功能。 如：RSS、文件自动路由（vue-router）、插件（挂件）机制、文章列表/分类/标签钩子、自定义覆盖布局、覆盖组件、单页切换的 i18n、KaTeX 等。
VitePress is almost the successor to VuePress.
But VitePress is a great static site generator, which is built for documentation, but lacks some convenient customization features for blogs, such as RSS, file automatic routing (vue-router), plugin (widget) mechanism, article list/category/tag hooks, custom override layout, override components, single-page switching i18n, KaTeX, etc.
iles
iles 与 Valaxy 的一些基础结构功能很相似，它相比 Vitepress 拥有更多功能，也很适合写一个拥有更多交互的文档。
不过它的定位仍旧是静态站点生成器，这与 Valaxy 静态博客生成器的定位不同。
因为 Valaxy 除此之外，还会提供文章列表、分页、标签、分类等更多面向博客的功能，并支持扩展与自定义博客主题。
After completing the development of Valaxy’s basic structures, I learned about iles from my group friend, which is very similar to many features I have archieved.
It has more features than Vitepress and is also suitable for writing a document with more interaction.
However, its positioning is still static site generator, which is different from that of Valaxy static blog generator.
In addition, Valaxy also provides more blog oriented features such as article list, pagination, tag and category, and supports extension and customization of blog topics.
Thanks
💗 Valaxy 的实现基于或参考了以下项目：
The implementation of Valaxy is based on or referenced from the following projects:
To Be Continued.