Skip to content

Latest commit

 

History

History
81 lines (49 loc) · 5.44 KB

CONTRIBUTING.md

File metadata and controls

81 lines (49 loc) · 5.44 KB

Nice to see you want to contribute to this project! 👍 🎉 Please have a look at this guide to know what you are changing.

As I do not want to duplicate the instructions all over, please find the common contributors docs here: https://github.com/TinyWebEx/common/blob/master/CONTRIBUTING.md

Some links and potential special rules for this repo only are listed below.

Support us!

You like this add-on, but have no idea how to support us?

Here are some easy things you can always do:

  • Spread the word and recommend it to others! 🤗😍
  • Leave a rating at addons.mozilla.org if you like it! Also consider writing some text and not only leaving stars there. It's always nice to hear some warm words. ☺️
  • Star this project on GitHub by clicking the "star" icon!
  • Leave a review at alternativeto.net and click the like button there, if you want. (Also, you can obviously recommend this add-on as an alternative to other emoji pickers.)

Translations

It would be great if you can contribute your translations! You can either translate the JSON files directly or use this online translator service.

Manually: To translate it manually, go to src/_locales/en and copy the English (or any other existing language) messages.json file. (You could also use another source language if you want, but usually English is the best.) Create a new dir at src/_locales with the abbreviation of the language you want to translate.
Web-ext-translator: Go to this page and translate it online. Download the result by clicking on "Export to ZIP" at the bottom.

At the end, just submit a Pull Request with your changed files. Of course, you can (and should) improve existing translations.

For more details, see the official docs.

Other items to translate

For more information, see the whole contributing doc.

Translating emoji terms (categories, skin names etc.)

Big tip for translators: If you translate the emojiMart* entries, notice that you will likely find correct translations somewhere for these specific emoji terms.

Actually, it's standardized, because emojis are also standardized. It's Unicode, after all!

So the point to look for correct translations is the Unicode Common Locale Data Repository (CLDR, see their Wikipedia entry). You can download the data there and then try to find the correct term. (I did that, and I know it's hard to find, but yes, it must be somewhere in there!)

You can also try to use the survey tool and look in the section “Characters”:

sidebar: after units, there is an entry called characters, with sub-entries like category, smileys and emojis etc.

Related:

Coding

See the common guide on how to start coding and what rules to follow.

Attention: For this add-on, you need to execute scripts/downloadEmojiImages.sh to download the bundled emoji sheets if you use anything else than the "native emojis" ("emojis from your OS") in the settings of this add-on. The reason is just, that these big files are not bundled/distributed in this repo.

Tests

Need ideas?

Don't have any idea what to take up? Here you can find a list of good issues for starters, e.g. if you want to start with this project or a (programming) language in general. However, of course, feel free to take on any issue (that is not claimed or assigned to someone else).

Also, there are other add-on's, which are very similar and may also need work:

There is also an overview over all good first issues in other add-on repos. Also check out the libraries used by this project.