-
-
Notifications
You must be signed in to change notification settings - Fork 2.5k
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
Help translate Iris into your language #796
Comments
Instructions can be found at: #796 written by @speedwheel
There's more english speaker in China than USA...I don't know where you found that small percentage oO. Either way, PRs are wellcome ;) |
@kataras I have a question My English need to use Google translate, please forgive me But I've been relatively familiar with IRIS and I can translate relatively authentic Chinese If there is a translated version of xxx.md, I suggest adding a link to xxx_ZH.md at the top of xxx.md |
Yes @Zeno-Code, Iris is just 1 and a half years, beego is 5 years I think and I don't know how many authors beego has but Iris has only one. Beside that fact, Iris is far better than beego or any alternatives for both performance and features, you should know this already, we have many old beego users using iris now... I'm doing my bests and sometimes I have help from people like you, especially on bug reports, translations and english grammar fixes and I am really very thanful for this. About the translation, yes I'll add these links for HISTORY_ZH.md (you've just created) and README_ZH.md (you've just updated) to the english README.md and HISTORY.md files as well, just tell me when you finish them, and yes you can remove any unnecessary parts from the original file, do it as much naturally as you want, it's totally fine with me! |
Hi Kataras, We are going to create a online training course how to develop web application using Iris Framework. Language will be Vietnamese. The course will be released partly in Feb 2018 and completed in April 2018. |
Hi @TechMaster, That is awesome! The whole community will be glad to help you, including me, if you need any help while creating the course. |
New Translations for README are required, the content has drammatically changed(got minified as the most content now lives inside its iris/wiki) as of Iris 11.2. Thanks for the support!
|
Hi Kataras,
But I also want to contribute translating the IRIS wiki: |
Hello @handuy, sorry for the delay. I did reply to the e-mail you sent me a week ago as well. Let me put it here for anyone who is looking to translate the wikis too. Github Wikis cannot render branches except Iris Wiki can be cloned, like any github repository: $ git clone https://github.com/kataras/iris.wiki.git
Looking forward for the Vietnamese READMEs and wiki!! I also posted the Video Course about Go and Iris you guys did on the "Thank you" page of the request iris book form.
Thanks, |
Hello @kataras, I can help with Spanish translation. :D |
Hello @1hitOVER, That's great news! Send me a message, if you need my assistance on anything. Wikis? new docs.iris-go.com subdomain for spanish? Anything. |
Hello @kataras |
Thank you @1hitOVER @jinil-ha, PRs accepted, good work! Thank you for your contribution to the community! |
thinking of working on the french translation, even if it's not on the todo list. |
Sure @Ynniss!! |
French translation added by @Natnatf, PR: #1501 |
www.studyiris.com 中文社区成立,提供完善的文档翻译。 |
Has anyone started translating into Indonesian? |
Instructions can be found at: kataras#796 written by @speedwheel Former-commit-id: e612ec2c42e09e10ad8bb17d164f7934bc4dca36
|
Hello @ahliweb , there is Indonesian video course on youtube with 23 parts covering the MVC features of Iris, however you must update the path and read the latest changelog. There are no documentation translations in Indonesian, as far as I am aware of. If you are going to do it please do it by cloning that repository instead, it's a live update of the new docs. |
@joewongex There is Chinese Iris wiki for v12.1.8 written by the amazing @snowlyg at: https://github.com/snowlyg/iris/wiki. Also there are some Iris articles at learnku.com, e.g.: https://learnku.com/articles/6020/from-php-laravel-to-go-iris-routing. And also I am preparing a new website for documentation translation and editing that will be available on v12.2.0 release (which requires new documentation). |
Dear fellow gophers, Iris users and lurkers, we are all lucky to be here and use this wonderful go framework called Iris.
I am glad to see that Iris has grown into a mature software that is used and trusted by many of us in our projects, from small individual developers to large teams.
There have been a lot of good changes lately that made Iris more powerful than ever before (and this is just the start), easy to use, but in the same time and with very good performance.
But in my opinion the most important thing what makes Iris truly different from other frameworks, is its documentation, which is very important for the our user base, especially for newcomers. And Iris docs are doing a tremendous job explaining all the aspects of the framework with it's documentation by using
a big variety of examples.
Now having all that said, let's move to the "issue" part for this ticket.
I already mentioned that the documentations are plain awesome, but only if you understand english!
Now let's point out the second most used spoken language by Golang devs, well I think you already know of whom I am talking about... you probably already guessed, it's the Chinese users!
I have also noticed myself that more and more Chinese users are opening different issues here and probably many of them looking around trying to grasp and get a hold of using Iris, but unfortunately the language barrier stops them from achieving that, since we all know that a very small percentage of China's population actually speaks english.
But we don't stop here! All Iris users from all over the world can give a hand by helping with translation in there native language!
So by all means I am making a call to all Iris users here that know English + different language and want to help and make Iris a more welcoming place for there fellow compatriots by translating as much as they can of the Iris project.
Now let's get down to business and see what exactly I mean by that. These are the main things that need to be translated, ordered by priority:
https://github.com/kataras/iris - there areo two .md files that need to be translated: README.md and HISTORY.md, please submit a PR for this with the following file naming: README_$LanguageCode.md and HISTORY_$LanguageCode.md (i.e. README_ZH.md, HISTORY_ZH.md a list of language codes by country );
https://github.com/kataras/iris/tree/master/_examples - there is one .md file here that needs to be translated, README.md, please submit a PR for this with the following file naming: README_$LanguageCode.md;
https://iris-go.com/ - here I decided to make a new website using the .cn TLD, so the final domain name will be "iris-go.cn", where we will be adding the same information from iris-go.com, but translated in Chinese.
Also a good thing to keep in mind if you want take part to this, is to check also the English version for mistakes doing the translation process.
Let's all build a better web together, that's what open-source it's all about!
Translations to do:
The text was updated successfully, but these errors were encountered: