## About this project
Localizer is a tool to translate text using json files.
## Installing
Run the following command to add the package to your dependencies:
```bash
$ cargo add localizer-rs
...
```
### Git
To clone the repository locally using git run `git clone https://github.com/ElBe-Development/localizer-rs.git`.
## Usage
To use localizer-rs, you need a directory (eg. `translations`) with your translations files (eg. `en.json`). You then need to follow these steps:
1. Import the localizer-rs crate:
```rust,ignore
use localizer_rs;
```
2. Create a new config object:
```rust,ignore
let config = localizer_rs::Config::new("translations", "en");
```
3. Translate your text:
```rust,ignore
localizer_rs::t!(config, "key", "placeholder" ="value");
```
## Example
With the following `en.json` file.
```json
{
"error": "{{color.red}}{{bold}}Error:{{end}} Something went wrong: {{details}}."
}
```
And the following rust code.
```rust,ignore
use localizer_rs;
fn main() {
let config: localizer_rs::Config = localizer_rs::Config::new("translations", "en");
println!("{:}", localizer_rs::t!(config, "error", "details" = "Path not found"));
}
```
You will get the following output:
```bash
Error: Something went wrong: Path not found.
```
Where `Error:` is red and bold.
## Contact
To contact us, get help or just chat with others, you can visit [our discord server](https://discord.gg/JVyyDukQqV).