Key-Value Pairs

As expected, you declare your translations as key-value pairs:

{
  "hello_world": "Hello World!"
}

But there are additional rules you must follow in addition to those of the format you use.

Keys

Key names must be valid Rust identifier, with the exception of - that would be converted to _.

Same keys across files

The keys must be the same across all files, else the load_locales! macro will emit warnings. The difference in keys is based on the default locale.

Missing key

If a key is present in the default locale but not in another locale, the other locale will default it's value to the default locale one and emit a warning that a key is missing in that locale.

If you want to explicitly state that this value take the value of the default locale, you can declare it as null:

{
  "take_value_of_default": null
}

This will no longer trigger a warning for that key.

Surplus key

If a key is present in another locale but not in the default locale, this key will be ignored and a warning will be emitted.

Value Kinds

You can specify multiple kinds of values:

• Literals (String, Numbers, Boolean)
• Interpolated String
• Ranges
• Plurals

The next chapters of this section will cover them, apart for literals, those are self explanatory.