search

goatshriek / stumpless

a C logging library built for performance and features
https://goatshriek.github.io/stumpless
Apache License 2.0
448 stars 337 forks source link

add a new (spoken) language #117

Open goatshriek opened 4 years ago

goatshriek commented 4 years ago

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 commented 4 years ago

I would like to add a German translation ^^

goatshriek commented 4 years ago

@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 commented 3 years ago

I would like to add Slovak translation

goatshriek commented 3 years ago

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

taliezincho commented 3 years ago

I'll try to add Bulgarian :)

best regards

goatshriek commented 3 years ago

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

palike608 commented 3 years ago

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

goatshriek commented 3 years ago

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

goatshriek commented 3 years ago

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

gcotofernandez commented 3 years ago

Hi! I would like to add a Spanish translation

goatshriek commented 3 years ago

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 commented 3 years ago

I would like to add Polish translation?

goatshriek commented 3 years ago

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

SwoleDuck commented 2 years ago

Hello, could i add a greek translation?

goatshriek commented 2 years ago

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

lhardt commented 2 years ago

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

Could you add the tags for hacktoberfest on this?

goatshriek commented 2 years ago

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 commented 2 years ago

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

goatshriek commented 2 years ago

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 commented 2 years ago

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 commented 2 years ago

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

das-amit commented 2 years ago

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

m20027 commented 2 years ago

Japanese is not yet?

goatshriek commented 2 years ago

Hello @m20027, Japanese has not been added yet! I've created #301 if you would like to tackle this.

idpolik commented 1 year ago

I'd like to add Hungarian :)

goatshriek commented 1 year ago

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

goatshriek commented 1 year ago

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 commented 1 year ago

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

goatshriek commented 1 year ago

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

rishabhtomar800 commented 1 year ago

I would love to add Hindi.

goatshriek commented 1 year ago

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 commented 1 year ago

Hi!

i wouldnt mind doing some translation to danish :)

goatshriek commented 1 year ago

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

neversaynv3r commented 1 year ago

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

AssafBardugo commented 1 year ago

Hi, I would like to add a Hebrew translation

goatshriek commented 1 year ago

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

OsmanBuyuksar commented 1 year ago

Hi, i would like to add Turkish translation

goatshriek commented 1 year ago

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

AryasCodeTreks commented 8 months ago

Hello @goatshriek Have added Telugu Localization Please have a look https://github.com/goatshriek/stumpless/pull/407

goatshriek commented 1 month ago

Reopening (closed by accident).

pmj-chosim commented 1 month ago

Hello:) I want to add Korean translation

goatshriek commented 1 month ago

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 commented 1 month ago

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 commented 1 month ago

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!