Contributor's Guide: Adding Translations #4
Comments
|
Hi, I would like to help with the Spanish translation! |
|
@mariapaula9926 sounds good, and thanks! |
|
Hello, I think I could do the Italian translation! |
|
Hi, I'm ~half way through the French translation in https://github.com/nlehuen/maskmath/blob/master/index-fr.html. Will continue tomorrow! |
|
Hello!! I would like to contribute with a translation to Brazilian Portuguese :) |
|
Hello,
|
|
We have a fix in the works for this with #5 (as well as a fix for translating the titles and annotations for the two graphs). I'd suggest ignoring this for now and when you submit the pull request we can take care of it. |
Brilliant, thank you! |
|
Hi, I'm up for a translation to German. |
|
Hi there, |
|
Hi, I will start the Czech translation (cs). |
I would be happy to help translate or review the german translation. |
|
Hi, I saw this on @MinutePhysics; thanks for creating this! I would love to help with the Turkish translation (my native language) and would be able to finish by the end of this week. |
|
@pinardemetci (and everyone): That's great, go for it! Greatly appreciate your input! |
|
Hi, I would like to work on the Persian translation. |
|
Hello, I'd like work on traslating to Greek |
|
@aatishb , Greek is a gender specific language - I'm writing the credits - how do you prefer to be referenced? (He/Him, other?) |
|
Hi @pankgeorg, @aatishb, I just saw the 'minutephysics' video and I thought I could help you with the Greek translation, so we can save time, if you are not done already. If you are interested, e-mail me. |
|
@pankgeorg yes, he/him. Thanks for working on this! |
What is the current status of the German translation? |
|
@ToniDS see my fork https://github.com/tobiv/maskmath |
|
|
well, working on Bahasa Indonesia (id) translation. |
|
Added the Czech translation. I am new to GitHub so I am not sure if I did the pull request right. |
|
Hi Aatish |
|
Hey there! Cheers, |
|
@fbuters @Sunny121294 go for it! |
|
|
@aatishb, I'm on it. |
|
I'm working on the Polish translation. |
Is there any way I could help with the Polish translation? |
Oczywiście! I added you as a collaborator to my fork where I'm working on the translation. If you know how github works, feel free to comment on pull requests and add your translations. If not, let me know and we'll figure something out. |
|
I'll start work on a Danish translation :) |
|
Hey, I'm about to start a Serbian translation. |
|
I have started working on a Traditional Chinese translation at https://github.com/kisaragi-hiu/maskmath/tree/translation/zh-Hant. |
|
Hi, I'll start working on a Macedonian translation today. I have a team of scientists and teachers that will help out, so we should be done very quickly! BTW, is there a possibility to synchronize the MinutePhysics video in Macedonian as well, or at least add subtitles? |
|
@bojanastojanova Great! I don't know about adding subtitles to the MinutePhysics video, it used to be possible in the past for people to contribute translations to YouTube videos but unfortunately I think YouTube no longer allows this. |
|
@aatishb |
|
I would like to help with the Korean translation. Thank you for sharing. :) |
and others
Contributor's Guide: Adding Translations
Thanks for your interest in contributing translations to this interactive essay!
This step-by-step guide is written assuming that this may be your first time contributing on GitHub. If you have questions or concerns, you can leave a comment below, open a new issue, or send me an email. If you're familiar with Github, you can skim through this guide.
We encourage contributions of all kinds, including from first-time GitHub contributors, and are acknowledging all contributions on the Github Page using the All Contributors system.
The index.html page contains the entire text of the article in English. To add a translation, you'll need to make a copy of this file and then go through this document line by line and translate it.
Steps to Contribute a Translation
Sign up for a Github Account if you don't already have one.
So that we don't double our efforts, first check if anyone is already working on this translation in the comment thread below. If no one is translating to this language, leave a comment below letting us know that you would like to proceed with a translation (don't forget to include the language you're translating to!)
If someone else is already working on a translation for this language, we can still use your help in reviewing this translation. If the translation is already live and you want to make improvements (e.g. correct a typo or fix a broken link), you can do so by simply editing the file and submitting a Pull Request. If you have many edits, it's better that you follow the procedure below to combine your changes into a single Pull Request. If the translation is not yet live (i.e. someone is currently working on it), you can indicate your interest in collaborating on it or reviewing it with a comment below tagging whoever is working on it.
On the Github Page for maskmath, click the Fork button on the top right. This will create your own personal copy of the contents of this website (known as a fork), accessible at
https://github.com/your-username/maskmathNext, set up a live website for your fork. To do this, on your own fork of maskmath, click Settings on the top right.
Scroll down to GitHub Pages and select the master branch and click save.
This will let you view your local version of the website at
https://your-username.github.io/maskmath/. Check that this link works, you should see a copy of the original mask math essay.Next, make a copy of
index.htmlwith the two-letter language code of the language you are translating to. For example, if you are translating to Spanish, this file will be calledindex-es.htmlIf you're new to GitHub, here's how to go about doing this. First copy the contents ofindex.htmlto the clipboard. Then, on your fork of maskmath, click here to create a new file.Give this file the name
index-languagecode.htmlwherelanguagecodeis the two letter language code (e.g.index-es.html). Next, paste in the contents of the original index.html file and when you're done click Commit new file to save changes.If this worked, you should shortly be able to access this new page online at
https://your-username.github.io/maskmath/index-languagecode.htmlIn your fork, click on the
index-languagecode.htmlfile and press the edit button on the top right.In Line 3 of the this file which reads
<html lang="en">, replace the language codeenwith the language code that you are translating into.You can now go through this file line by line and translate all the English text. After you translate a section, press the commit changes button at the bottom of the page to save your changes.
It's better to do this in short stretches because then you can open the live website at
https://your-username.github.io/maskmath/index-languagecode.htmlto test and make sure the changes are working as expected. If you make a mistake, you can compare your changes against index.html to see what went wrong. (Click Commits on your fork to see a complete list of all your changes.)(More advanced) If you prefer to work locally on your computer instead of on the GitHub website, you can use the GitHub Desktop client and a text editor like Sublime Editor.
You're encouraged to add a line of credit to yourself in the translation. In the Credits & References section of
index-languagecode.htmlnext to the sentenceThis essay was created by Aatish Bhatia in collaboration with Henry Reich.For example, you can add a (translated) sentence likeIt was translated into [your-language] by [your-name].You can link your name to your website or social media profile.In your fork, click on the folder
js, and then click on the filevue-definitions.jsand press the edit button on the top right. Look for the section that lists all the translations (around line 250). Duplicate the last entry in this list, then edit it so that it points to the correct url and name of the language you are translating into, and save changes. If this worked correctly, you should shortly see your language listed in the header of the page. Confirm that this link works as expected.When you're done with the translation and have tested that that the website loads as expected, make a Pull Request to incorporate your changes into the original maskmath website. To do this, in your fork of maskmath, click the Pull request button, and then click Create pull request.
Add a title and description, and Create your pull request. You can add any relevant notes in here. Please keep the
Allow edits by maintainersbutton ticked as this will help me easily merge your changes.Your Pull Request will be reviewed and once accepted you will be added as a contributor.
Thank you so much for contributing!
The text was updated successfully, but these errors were encountered: