[Request] Add translation to other languages.

good-labs / greater-good-affirmation

An affirmation that your open source community exists for the greater good.

https://good-labs.github.io/greater-good-affirmation/

21 stars 19 forks source link

[Request] Add translation to other languages. #27

Open DmitrijOkeanij opened 4 years ago

DmitrijOkeanij commented 4 years ago

I can make Russian translation, but need some project/site structure for it.

Thanks for awesome project!

vsoch commented 4 years ago

Fantastic! I was poking around GitHub for other projects that serve documents in different languages, and found the cncf code of conduct. I think it would be logical to have a "languages" folder, and then markdown files named based on the language abbreviation and then we can add a simple section to the readme, something like:

Languages

The Greater Good Affirmation is available in the following languages:

Russian

As for the web interface, after the first language is added I can think through this and get a rendered version working. What do you think?

DmitrijOkeanij commented 4 years ago

But if we have more then one file to translate we need no language file but entire language folder. And all languages folders will be the same structure on GitHub. What do you think?

vsoch commented 4 years ago

Yes I think that's what I said:

I think it would be logical to have a "languages" folder, and then markdown files named based on the language abbreviation and then we can add a simple section to the readme, something like:

If you inspect the markdown in the above, the link goes to languages/ru.md

DmitrijOkeanij commented 4 years ago

I mean other. One language has more then one file as I understand.

vsoch commented 4 years ago

Sorry I don't understand what you are trying to say.

DmitrijOkeanij commented 4 years ago

I mean that need translation of all data. Not only one readme file.

vsoch commented 4 years ago

Ah okay I think I understand. I was thinking that we would handle the affirmation file first, but it looks like you want to dive right into the web interface?

How about, in addition to the affirmation file, we put a subfolder under pages, here:

https://github.com/good-labs/greater-good-affirmation/tree/master/docs/pages

That corresponds to the language, and then includes the same FAQ and about in that language (e.g., pages/ru/faq.md pages/ru/about.md. When you open a PR for that, then I can add another page that will create a "Languages" tab. Is there a universal symbol or similar that we can use to indicate that the page will have different languages? Likely we could do something that has a picture of a flag, etc.

DmitrijOkeanij commented 4 years ago

Can we talk with skype or telegram tommorow or in some day? I need to clear some things about all of it, and if all clear and good to me, I can start. I have some thoughts about 1 paragraph of main affirmition text, and need to speak a little about it.

vsoch commented 4 years ago

It's the holidays here so I can't offer a skype / meeting, but if you want to hammer things out over chat here I can definitely add comments / discussion as needed!