mirror of https://github.com/YunYouJun/valaxy
docs: add en translation to why.md (#348)
Co-authored-by: wuyu50 <wuyu50@meituan.com>
This commit is contained in:
parent
361600cfc6
commit
488a979da9
|
@ -24,6 +24,8 @@ Valaxy aims to be a next generation of static blogging frameworks/generators.
|
|||
Valaxy 的目标是成为新一代的静态博客框架/生成器。
|
||||
:::
|
||||
|
||||
<div lang="zh-CN">
|
||||
|
||||
::: info
|
||||
|
||||
- V + galaxy = Valaxy
|
||||
|
@ -41,6 +43,27 @@ Valaxy 的目标是成为新一代的静态博客框架/生成器。
|
|||
|
||||
这是重复造轮子吗?我认为不是。
|
||||
|
||||
</div>
|
||||
|
||||
<div lang="en">
|
||||
|
||||
::: 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](https://github.com/YunYouJun/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.
|
||||
|
||||
</div>
|
||||
|
||||
## 为什么是 Valaxy? {lang="zh-CN"}
|
||||
|
||||
::: zh-CN
|
||||
|
@ -99,10 +122,22 @@ export default defineValaxyConfig<ThemeConfig>({
|
|||
|
||||
## 为什么不是……? {lang="zh-CN"}
|
||||
|
||||
::: zh-CN
|
||||
|
||||
> Wordpress/Typecho 等是动态博客,因此不在考虑范围内。
|
||||
|
||||
:::
|
||||
|
||||
::: en
|
||||
|
||||
> Wordpress/Typecho are dynamic blogs and therefore are not considered.
|
||||
|
||||
:::
|
||||
|
||||
### [Hexo](https://hexo.io/)/[Hugo](https://gohugo.io/)/Jekyll
|
||||
|
||||
::: zh-CN
|
||||
|
||||
我非常需要现代前端框架提供的开发热重载与 PJAX 体验,以及 TypeScript 的类型提示,但 Hexo 似乎已经有些积重难返,基于此来做一些工作将会束手束脚。
|
||||
|
||||
Hugo 也是很棒的静态站点生成器,但是我并没有使用 Go 的需求。当然在打包时所使用的 ESBuild 正是基于 Go 实现。但这并不需要我操心。
|
||||
|
@ -110,6 +145,18 @@ Hugo 也是很棒的静态站点生成器,但是我并没有使用 Go 的需
|
|||
Jekyll 算是元老,但同样我并不使用 Ruby,且它似乎并不便捷,也同样存在一些开发体验的问题。
|
||||
GitHub 为其提供了原生支持是一大优势,但我打算类似使用 GitHub Actions 来达成该方面近乎一致的体验。
|
||||
|
||||
:::
|
||||
|
||||
::: en
|
||||
|
||||
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.
|
||||
|
||||
:::
|
||||
|
||||
<!-- 最后,我有一些尝试想要实现。见[重新构想博客框架(Todo)]。
|
||||
譬如,可以提供一种主题商店,用户仅需在 GitHub Repo 中存放自己的文章。
|
||||
在主题商店,填写自己的 Repo 地址,选中主题切换即可在线预览内容效果。(这完全可以做到,只需要动态纯前端获取 Markdown 内容并渲染即可)
|
||||
|
@ -117,11 +164,23 @@ GitHub 为其提供了原生支持是一大优势,但我打算类似使用 Git
|
|||
|
||||
### VuePress/VitePress
|
||||
|
||||
::: zh-CN
|
||||
|
||||
[VitePress](https://vitepress.dev/) 几乎已成为了 VuePress 的继任者。
|
||||
|
||||
但 VitePress 是一个很棒的静态站点生成器,它为文档打造,但缺少一些针对博客的定制便捷功能。
|
||||
如:RSS、文件自动路由(vue-router)、插件(挂件)机制、文章列表/分类/标签钩子、自定义覆盖布局、覆盖组件、单页切换的 i18n、KaTeX 等。
|
||||
|
||||
:::
|
||||
|
||||
::: en
|
||||
|
||||
[VitePress](https://vitepress.dev/) 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](https://github.com/ElMassimo/iles)
|
||||
|
||||
::: zh-CN
|
||||
|
@ -144,8 +203,18 @@ In addition, Valaxy also provides more blog oriented features such as article li
|
|||
|
||||
## Thanks
|
||||
|
||||
::: zh-CN
|
||||
|
||||
💗 Valaxy 的实现基于或参考了以下项目:
|
||||
|
||||
:::
|
||||
|
||||
::: en
|
||||
|
||||
The implementation of Valaxy is based on or referenced from the following projects:
|
||||
|
||||
:::
|
||||
|
||||
- [Vue](https://github.com/vuejs/core)
|
||||
- [VueUse](https://github.com/vueuse/vueuse)
|
||||
- [Vite](https://github.com/vitejs/vite)
|
||||
|
|
Loading…
Reference in New Issue