add a new (spoken) language

[goatshriek]

If you know a language other than English and you're looking for a way to contribute to a project without knowing much about coding, adding a new locale is a great place to start.

There is a detailed guide on how to go about adding a new language that you know in the localization documentation. If you're feeling up to it, go ahead and open a new issue with the language you would like to add, and go to it!

Is the language that you wanted already added? Look over the locale header for it anyway (in include/private/config/locale/); any strings added after it was initially added will still be English placeholders marked with a // todo translate comment. A contribution translating these is almost as important as the initial translation, and is a much simpler change. Rather than implementing a completely new set of headers, you will just change the placeholder strings to be locale-specific strings instead. If you want to see a list of what strings need translating by locale, you can also use grep to get a current list:

grep -r -c "// todo translate" include/private/config/locale/

# output looks like this:
# include/private/config/locale/bg-bg.h:28
# include/private/config/locale/cz-cz.h:15
# include/private/config/locale/de-de.h:36
# include/private/config/locale/el-gr.h:16
# include/private/config/locale/en-us.h:0
# include/private/config/locale/es-es.h:18
# include/private/config/locale/fr-fr.h:36
# include/private/config/locale/it-it.h:0
# include/private/config/locale/pl-pl.h:17
# include/private/config/locale/sk-sk.h:31
# include/private/config/locale/sv-se.h:36

If there aren't any for your language or you'd rather do something new, have a look in the l10n folder of the repository. This has localized documentation for the project, and there are lots of opportunities to add a paragraph or two of translation. Don't feel like you need to translate an entire file for this, just a few paragraphs is more than enough! The l10n/zh-cn folder is a good example of what this could look like as more translations are added.

[Lockna]

I would like to add a German translation ^^

[goatshriek]

@Lockna sounds good! I have created #121 for the specific locale. I also added a reference to a recent commit that has examples of a similar update recently, if you want a clean example to complete the documentation. Any suggestions on improvements to the documentation/process are also welcome!

[pepo939393]

I would like to add Slovak translation

[goatshriek]

@pepo939393 Awesome! I just created #137 for you, it has a reference to the most recent locale addition as an example.

[taliezincho]

I'll try to add Bulgarian :)

best regards

[goatshriek]

Sounds good! I created #174 for you with some references and an example commit.

[palike608]

Hi, i would like to add a Czech translation. Can i?

[goatshriek]

Absolutely! I will create an issue for it in the next 4 hours or so.

[goatshriek]

I've created #190 to track the Czech translation.

[gcotofernandez]

Hi! I would like to add a Spanish translation

[goatshriek]

Hi Gabriela! Thanks so much for reaching out! A spanish translation does exist already, but there are a few strings that have been added since then that need attention: check out include/private/config/locale/es-es.h to see what's there. I suspect you could make quick work of it!

If you are looking for something more substantial there will be an internationalization framework for the documentation soon, but it isn't in place just yet. I can accelerate that if it is something you are interested in - it would be on the scale of picking a function or two (or however much you want!) and providing a translation for that documentation.

[Marecek460]

I would like to add Polish translation?

[goatshriek]

Absolutely! I've created #199 to track this.

[SwoleDuck]

Hello, could i add a greek translation?

[goatshriek]

Hello @SwoleDuck, absolutely! I've created #240 to track that.

[lhardt]

Hello! I would like to add the Portuguese-Brazil translations!

Could you add the tags for hacktoberfest on this?

[goatshriek]

Absolutely @lhardt! I've created #275 to track this - once the PR is submitted and merged I'll add the tags to that so that you get credit.

[Santhusha-bit]

Hello! I would like to add the Sinhala(Sri Lanka) translations!
Could you add the tags for hacktoberfest on this?

[goatshriek]

Sure thing, @Santhusha-bit! I've created #283 to track this, and will add the tags to the PR once it is merged for hacktoberfest.

[viveknshah]

Hi @goatshriek , I have followed your guidance to create #284 and solve via #285 . Let me know if that works or any feedback since this is my first time in this space.

[goatshriek]

Awesome @viveknshah, thanks! I've left a review on the PR, once those changes are made you should be good to go.

[das-amit]

Hey @goatshriek , I've added Bengali Translations.
Have a look #291

[goatshriek]

Sure thing! I've added #315 to track that.

[goatshriek]

Sounds good! I created #316 to track Swahili, but have left out the language tag for you to fill in depending on the specifics of the locale, as the IANA registry has many different options for it.

[itlallou]

Hello can I contribute to this project by adding albanian translation?

[goatshriek]

Absolutely! I've created #324 to track the Albanian translation.

[rishabhtomar800]

I would love to add Hindi.

[goatshriek]

There is an existing Hindi translation at include/private/config/locale/hi-in.h, but it is missing a few translations. A pull request to translate the missing strings would be appreciated!

[LasseBuchAspIT]

Hi!

i wouldnt mind doing some translation to danish :)

[goatshriek]

Hello @LasseBuchAspIT that would be great! I have created #343 to track it.

[neversaynv3r]

hi! I would like to finish the spanish localization, I've seen there are still some strings left

[AssafBardugo]

Hi, I would like to add a Hebrew translation

[goatshriek]

Sounds good! I've added #350 to track the Hebrew translation.

[OsmanBuyuksar]

Hi, i would like to add Turkish translation

[goatshriek]

Sure thing, I've created #388 to track the Turkish localization.

[AryasCodeTreks]

Hello @goatshriek
Have added Telugu Localization
Please have a look #407

[goatshriek]

Reopening (closed by accident).

[pmj-chosim]

Hello:) I want to add Korean translation

[goatshriek]

Hello @pmj-chosim, thanks for reaching out!

There is an existing Korean translation used for localization at include/private/config/locale/ko-kr.h. There is one string that needs to be translated currently, and your contribution for that would be welcome!

If you'd like to do more than that one string, please have a look at the l10n/ko-kr. This is the localized documentation for the project, and is right now mostly empty. If you would like, you can rename the README file there and translate the key features and "what can it log to" sections. You can refer to l10n/zh-cn for an example of what this would look like.

[pmj-chosim]

Yes, thank you! I compared the en-us and ko-kr locale files (include/private/config/locale/~), but it was hard to find the specific string that needs to be translated. Could you give me some advice?
And I'm currently working on the |10n/ko-kr job(specificly: |10n/ko-kr/README.md). My translation isn't complete yet, but can I ask some questions about localization through the PR window?

[goatshriek]

To find strings that need to be translated you can do a search for "todo" in the ko-kr.h file. The string will have the English text instead of the Korean, so you would just change it directly in this file and be good to go.

Yes, feel free to open a PR and ask any questions there! Don't feel like you have to do the ENTIRE readme (it is quite long) but of course we will appreciate however much you can do!