LANGUAGES.md

Table of Contents

• Forking Monkeytype
• Creating Languages
• Committing Languages
• Language Guidelines

Forking Monkeytype

First, you will have to make a personal copy of the Monkeytype repository, also known as "forking". Go to the Monkeytype repo and then click the "fork" button.

Creating Languages

Once you have forked the repository you can now add your language. Create a new JSON file in ./frontend/static/languages/, named as the language name and the number of words, e.g. language_1k.json. If there are less than 1,000 words, simply name the file after the language (e.g. language.json). Note that a minimum of 200 words are required.

The contents of the file should be as follows:

{
  "name": string,
  "rightToLeft": boolean,
  "ligatures": boolean,
  "bcp47": string,
  "words": string[]
}

It is recommended that you familiarize yourselves with JSON before adding a language. For the name field, put the name of your language. rightToLeft indicates how the language is written. If it is written right to left then put true, otherwise put false. ligatures A ligature occurs when multiple letters are joined together to form a character more details. If there's joining in the words, which is the case in languages like (Arabic, Malayalam, Persian, Sanskrit, Central_Kurdish... etc.), then set the value to true, otherwise set it to false. For bcp47 put your languages IETF language tag. Finally, add your list of words to the words field.

In addition to the language file, you need to add your language to the _groups.json and _list.json files in the same directory. Add the name of the language to the _groups.json file like so:

{
  "name": "spanish",
  "languages": ["spanish", "spanish_1k", "spanish_10k"]
},
{
  "name": "YOUR_LANGUAGE",
  "languages": ["YOUR_LANGUAGES"]
},
{
  "name": "french",
  "languages": ["french", "french_1k", "french_2k", "french_10k"]
},

The languages field is the list of files that you have created for your language (without the .json file extension). Make sure to add all your files if you have created multiple word lists of differing lengths in the same language.

Add your language lists to the _list.json file like so:

,"spanish"
,"spanish_1k"
,"spanish_10k"
,"YOUR_LANGUAGE"
,"french"
,"french_1k"
,"french_2k"

Committing Languages

Once you have created your language, you now need to create a pull request to the main Monkeytype repository. Go to the branch where you created your languages on GitHub. Then make sure your branch is up to date. Once it is up to date, click "contribute".

Update branch:

Create a pull request:

Language Guidelines

Make sure your language follows the language guidelines. Language guidelines