Multi language support

[Lellansin]

It would be helpful to have multi language version 😄
Is there anything I can do? I'd like to contribute with it.

[begriffs]

This page says there are a few ways to do internationalization in Haskell. Maybe GNU gettext would make it easiest for non-Haskellers to contribute translations.

Which things do you want to translate - just the error messages? If we also translate the config file options that might require maintaining different documentation pages per language.

[begriffs]

Oops, I thought this issue was filed on the main project, but you're talking specifically about documentation...

If we offer docs translations then I definitely need somebody to commit to keeping them up to date. I feel like the docs do not even have enough information in English, so I'm concerned about slowing them down even more.

[Lellansin]

Um, I get interested in this, and I'd like to study it by translate the docs (to Chinese). Due to your concern, I think I could do this job just in my fork. Hope you can help me if I got problem ;) And while you think the English version has enough info, I'd like to start to PR. (feel free to close this)

[begriffs]

Thanks for volunteering to help!

It looks like the way to make a translation is to make a separate project on readthedocs.org, and then connect the main project to it. https://docs.readthedocs.io/en/latest/localization.html#project-with-multiple-translations

So you could make a project like "postgrest-cn" and I would link to you.

[Lellansin]

Yeah, that's clear. I've got it 🙆‍♂️

[begriffs]

Have you written a translation yet that you would like me to link?

[Lellansin]

@begriffs Sure, I did some translation but forget to commit. And I got some problem while try to publish on readthedocs today (https://readthedocs.org/projects/postgrest-docs-chinese/builds/5666814/). Well you reminder me, I'll keep on translate this in the several days 🚀 .

[Lellansin]

fixed encoding problem, link http://postgrest-docs-chinese.readthedocs.io/en/latest/

[begriffs]

Thank you, you rock! 🤘

I'm trying to set your project as a translation of mine, but Read The Docs says,

"Both projects have a language of en. Please choose one with another language"

Can you update the language in your project's settings?

[Lellansin]

done~ New link: http://postgrest-docs-chinese.readthedocs.io/zh/latest/

[begriffs]

That worked! It's now active at https://postgrest.com/zh/latest/index.html