Hexo-theme-next: Multilingual support

[S-W-K]

Add a multilingual button for switching the website into different language version(contents of different language must be separated).

[issue-label-bot[bot]]

Issue-Label Bot is automatically applying the label Feature Request to this issue, with a confidence of 0.99. Please mark this comment with :thumbsup: or :thumbsdown: to give our bot feedback!

Links: app homepage, dashboard and code for this bot.

[stevenjoezhang]

Added to v8.x roadmap

[stevenjoezhang]

See also https://github.com/iissnan/hexo-theme-next/issues/1680, https://github.com/hexojs/hexo/issues/3595

[jiangtj]

Multi-language support, need to consider how to implement 🤔
Some users use multiple hexo sites, and add those to the menu, like @Liam0205
https://liam.page/
Some add button to switch in post-meta, like me
https://www.dnocm.com/en/articles/beechnut/hexo-next-injects/

@S-W-K Which, or there are other ideas you prefer it?

[S-W-K]

@jiangtj
I prefer the former. But there's a problem that your Chinese posts and English posts are not totally separated. Both of those two kinds of posts will be archived and tagged together. This is my ideal design https://dengcb.com/zh/index.html

dengcb

dengcb

dengcb's open source code

[stevenjoezhang]

Does this plugin help: https://github.com/Jamling/hexo-generator-i18n

GitHub

Jamling/hexo-generator-i18n

Multi-languages generator for hexo. Contribute to Jamling/hexo-generator-i18n development by creating an account on GitHub.

[Gabirel]

@stevenjoezhang This plugin does not support the separation of contents of different languages. Also, it does not provide a language switcher button by default.

[stevenjoezhang]

There is no extra space in the header, and in the Gemini / Pisces scheme, the sidebar is hidden on mobile. Therefore, the footer may be the only place to put this multilingual button.

[stevenjoezhang]

However, multilingual processing still has difficulties: Hexo does not provide enough easy-to-use APIs. Multi-language on hexo.io relies on a custom helper instead of Hexo's built-in methods:
https://github.com/hexojs/site/blob/f205475980049069f768aca0ed13a2a3633f9189/scripts/helpers.js#L149-L152

See also https://github.com/hexojs/hexo/issues/1696

GitHub

hexojs/site

The website for Hexo. Contribute to hexojs/site development by creating an account on GitHub.

[stevenjoezhang]

Are you currently configuring multiple languages based on this document?
https://hexo.io/zh-cn/docs/internationalization

@S-W-K @Gabirel @njzjz

Checkout this PR: #1391

Hexo

国际化（i18n）

若要让您的网站以不同语言呈现，您可使用国际化（internationalization）功能。请先在 _config.yml 中调整 language 设定，这代表的是预设语言，您也可设定多个语言来调整预设语言的顺位。 language: zh-twlanguage: - zh-tw- en 语言文件语言文件可以使用 YAML 或 JSON 编写，并放在主题文件夹中的 languages 文件夹

[stevenjoezhang]

Both of those two kinds of posts will be archived and tagged together.

This plugin does not support the separation of contents of different languages.

This feature is not as easy to implement as imagined. hexo-generator-index does not generate separate homepages for articles in different languages, which means that you must modify the configuration and execute Hexo generate multiple times to correctly generate multilingual website, or use third-party plugins like hexo-generator-i18n.

1391 is all the features that theme NexT can implement now. If you would like to simplify the generation of multilingual websites, please ask Hexo for help: http://github.com/hexojs/hexo/issues

[stevenjoezhang]

Added in #1391

If you need full multi-language support, please submit an issue in Hexo's repository. Thanks!