Go Down

Topic: Is there Korean translation of arduino web site documentation? (Read 2352 times) previous topic - next topic

sebul

Hello. I'm a Korean.

When I saw
https://www.arduino.cc/en/Main/Documentation
I expected that
https://www.arduino.cc/ko/Main/Documentation
is exist.
But... I got 404 page not found.

I want put Korean translation of https://www.arduino.cc/en/Main/Documentation into
https://www.arduino.cc/ko/Main/Documentation.

Help me, please.

pert

https://www.arduino.cc/en/Main/Documentation is a super outdated page that I don't think is linked to from any other page on this website so there would be no benefit in translating it to other languages. Better would be for them to just delete that page.

Work is currently being done to translate the Language reference pages:
http://www.arduino.cc/reference
Including all the pages linked from that page, but not yet the Libraries pages or the Glossary.

Currently this is happening for the following languages:
https://github.com/arduino?q=reference
which don't include Korean.

If you are willing to do a significant amount of work toward translating all the Language Reference content to Korean I recommend as the first step to make a proposal in an issue report here:
https://github.com/arduino/reference-en/issues/new
Make sure to clearly state the level of commitment you are willing to make to the project as that could be a significant factor in the Arduino team's decision on whether to go ahead with your proposal.

I think this would be a very valuable contribution to the Arduino project.

You may already be aware, but there is also a Korean translation of the Arduino IDE. If you find any improvements that may be made to that translation you are welcome to contribute them here:
https://www.transifex.com/mbanzi/arduino-ide-15/

sebul

Thank you.

I want translate https://www.arduino.cc/reference/en/ into Korean.

How can make
https://www.arduino.cc/reference/kr/ and copy
https://www.arduino.cc/reference/en into
https://www.arduino.cc/reference/kr
and translate ?

pert

I see you have opened an issue in the arduino/reference-en repository:
https://github.com/arduino/reference-en/issues/227
so that's the first step.

From here the next steps are:
  • Wait to see how the Arduino web team will respond to your proposal. If they accept it then they will create a new repository on GitHub: arduino/reference-kr. This repository will initially contain a copy of arduino/reference-en, meaning all the pages will be in English.
  • Fork arduino/reference-kr. This will give you your own copy of the repository to edit (sebuls/reference-kr).
  • Clone your fork of arduino/reference-kr. This will put a copy of the repository on your computer. This step is actually optional as GitHub does allow you to edit from the website but it restricts you to only editing a single file per commit, which can sometimes be inconvenient, and you may prefer to work with the files with the software you have on your own computer, especially a decent text editor.
  • Create a branch in your repository to work on.
  • Edit the files with your translations.
  • Commit the edits you have made.
  • If you are working on a local clone, then push your commits to the remote. If you're editing directly from GitHub then this step is not necessary.
  • Submit a pull request to the arduino/reference-kr repository from the branch that contains your translations.
  • The Arduino team will review your proposed edits and may comment with requests for you to make changes to them, if so you will need to make the required changes and then commit (and push if working locally) them to the branch you submitted your pull request from, they will automatically be added to the pull request.
  • A member of the Arduino team will merge your pull request. Your commits are now in the arduino/reference-kr repository.
  • Once the translations of all the content is complete the Arduino web team will generate the arduino.cc web site content from the arduino/reference-kr repository and publish it to the web site.

pert

Your proposal has been accepted! They still haven't copied over the English language content so I guess we're at 1.5 on the list above but it's definitely progress.

sebul


sebul

I see you have opened an issue in the arduino/reference-en repository:
https://github.com/arduino/reference-en/issues/227
so that's the first step.

From here the next steps are:
  • Wait to see how the Arduino web team will respond to your proposal. If they accept it then they will create a new repository on GitHub: arduino/reference-kr. This repository will initially contain a copy of arduino/reference-en, meaning all the pages will be in English.
  • Fork arduino/reference-kr. This will give you your own copy of the repository to edit (sebuls/reference-kr).

Thanks. Step 1 was done.
arduino/reference-ko is created.
https://github.com/arduino/reference-en/issues/227
Now all contents of that is English.

How can I fork it ?

I found Fork button! It is on the upper right corner.
Thank you very much ! :)

Step2 is done.

pert

Glad to see the progress! Let me know if you have any questions. I may not know any Korean but I am familiar with GitHub and Git.

sebul

My first pull request.
https://github.com/arduino/reference-ko/pulls

Step 8 is done.

Thanks.

pert

Step 10 accomplished! Thanks so much for all your work to make Arduino accessible to more people.

There will be ongoing translation work available to keep all the translations of the Language Reference synced with the English version as we work to improve it. I believe they're working on a system to automatically generate issue reports in all the translation repositories whenever they go out of sync with reference-en but I don't know if that system is in place yet. So if you're interested in continuing with the project you might want to use GitHub's "Watch" feature on the reference-ko and/or reference-en repositories so that you will get a notification when that happens.

sebul

Thank you very much.

Go Up