Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: add en translation to why.md #348

Merged
merged 1 commit into from
Feb 11, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
69 changes: 69 additions & 0 deletions docs/pages/guide/why.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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
Expand Down Expand Up @@ -99,29 +122,65 @@ 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 实现。但这并不需要我操心。

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 内容并渲染即可)
而用户想要应对 SEO 时,则可再将其渲染为静态页面。我也将会为此提供一个一键可用的 GitHub Actions 脚本。 -->

### 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
Expand All @@ -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)
Expand Down
Loading