RFC Multi-language site support

[epage]

Challenges / Requirements

Design

[pickfire]

GNU GetText style _ for i18n?

[ErichDonGubler]

@pickfire: That's definitely a necessary part of the complete picture!

Another thing that would be really important is to have a way of relating localizations of the same content to each other, with a default language as fallback for nonexistent localizations. Hugo does a good job presenting an end-user spec here: https://gohugo.io/content-management/multilingual/

Those are the two main parts needed to fulfill this use case for static sites. A little static JavaScript could be used in tandem with the aforementioned information to redirect users to the correct localization for a page -- not necessary, but an interesting feature to build on top of the previous two.

[Keats]

Note that I've written a RFC for i18n in Gutenberg: getzola/zola#111
Not implemented yet but is similar to the approach Hugo is using, which is quite good IMO

[pickfire]

@Keats The one I was talking about are most possible in the alternatives section though where we use one file to do multiple language, I didn't thought of separating the file though. So now I guess we have something like:

split

• hello.en.md - Hello, world!
• hello.zh_CN.md - 你好，世界！

share

• hello.md - { _hello }
• po/en.po - hello "Hello, world!"
• po/zh_CN.po - hello "你好，世界！"

[ErichDonGubler]

@Keats: I much appreciated the RFC for i18n support in Gutenberg! It seems well-designed, and where the inspiration came from seems well-proven. :)

[Keats]

There is no tool/library for i18n in pure Rust as far as I know though, there's a couple of gettext crate but nothing really good apparently.
The shared approach is interesting but then end users have to deal with gettext translations manually or upload them to some services like Transifex and it's not super user friendly (still need a way to deal with translations in templates though).

[ail3ngrimaldi]

I would really like to contribute, especially on this issue. Do you think you could guide me somehow? I'm a beginner in Rust.

[epage]

The problem is we first need to come up with a design

• We'd need an understanding of the requirements. What do people expect out of this? What assumptions can be made?
• It'd help to look at how other SSG's support multi-lingual sites (config fields, source layout, output layout) so we can learn from them. Even better to do a comparative analysis
• With the above two, we need at least one design proposal and to iterate on it.