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

Translations Of The Site #24

Open
umutphp opened this issue Jan 30, 2021 · 9 comments
Open

Translations Of The Site #24

umutphp opened this issue Jan 30, 2021 · 9 comments

Comments

@umutphp
Copy link

umutphp commented Jan 30, 2021

What do you think about translating the site to the other languages? Do you have plan or direction for this? I really want to contribute by translating the site into Turkish.

@theicfire
Copy link
Owner

Oh I appreciate the offer! Hmm, the issue is I don't have any great immediate ideas on how to go about doing the translations. Some thoughts:

  • What happens if there are changes?
  • General infrastructure (i.e. letting users select their language, or using geolocation services to select languages)

Are there success stories you know of that talk about simple static website translations and maintenance?

@umutphp
Copy link
Author

umutphp commented Feb 16, 2021

Hi @theicfire,

I have already contributed the translations of some open source repositories . Let me answer you questions based on my experiences;

What happens if there are changes?
You can either have a manual process (I mean notifying maintainers on every update) or use a tool for this. I have used GitLocalize in some of the projects I involved in. This decision depends on the infrastructure decision.

General infrastructure
One way for managing translations is to ask people to use their forked repositories. You will link them form your main repository or from the site. They have to generate the static sites like you do in the main repository. In this way, handling changes are totally responsibility of the fork repository maintainers. This not the best way for me. For example, Hacker Laws repository manages some of the translations in this way. I am the one maintaining the Turkish repository and I can say that handling the changes are not easy in this way.

Second way is to create a language based folder structure on the main repository. Ask people to maintain the translations on the main repository. The localized static site is generated by you and linked directly from the site by letting user to select the language. For example, PHP - The Wrong Way is a good example for that.

I also involved the translation of Open Source Guides which has the second way infrastructure and it can be accepted as a success story. They generate the static site by using localized content from separate folders.

@theicfire
Copy link
Owner

Woah, GitLocalize sounds super useful. This may not be so hard with it :). I'll think about this more and maybe play around with GitLocalize this weekend, thank you

@gavinliu6
Copy link

The tutorial is awesome. And I've translated it into simplified Chinese, the link is https://makefiletutorial.vercel.app. Please help yourself if needed.

@crisjumbo
Copy link

@theicfire congratulations for the tutorial. It is just amazing !!
I would love also to contribute in the Spanish translation. Let me know :D

@klaygomes
Copy link

If this idea go ahead, I would like to maintain the Brazilian Portuguese version.

@BreakingLead
Copy link

The tutorial is awesome. And I've translated it into simplified Chinese, the link is https://makefiletutorial.vercel.app. Please help yourself if needed.

Haha, I'm a beginner and I've translated the tutorial in Chinese in halfway and you had done.xD.

1 similar comment
@BreakingLead
Copy link

The tutorial is awesome. And I've translated it into simplified Chinese, the link is https://makefiletutorial.vercel.app. Please help yourself if needed.

Haha, I'm a beginner and I've translated the tutorial in Chinese in halfway and you had done.xD.

@zhuzhzh
Copy link

zhuzhzh commented Sep 25, 2022

@gavinliu6   I don't know you've done it. I did it again.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

7 participants