Skip to content

Commit

Permalink
Readme updated with usage examples
Browse files Browse the repository at this point in the history
  • Loading branch information
skip405 committed Dec 30, 2022
1 parent 218be82 commit 589e137
Showing 1 changed file with 45 additions and 1 deletion.
46 changes: 45 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1 +1,45 @@
Convert cyrillic Belarusian characters to Latin characters using transliteration. Can transliterate in accordance with the "Instruction on transliteration of geographical names" or in accordance with the rules of the Belarusian Latin alphabet (Łacinka). Can slugify the resulted transliterated string.
# belLit

Convert cyrillic Belarusian characters to Latin characters using transliteration. Can transliterate in accordance with the ["Instruction on transliteration of geographical names"](https://en.wikipedia.org/wiki/Instruction_on_transliteration_of_Belarusian_geographical_names_with_letters_of_Latin_script) or in accordance with the rules of the [Belarusian Latin alphabet (Łacinka)](https://en.wikipedia.org/wiki/Belarusian_Latin_alphabet). Can slugify the resulted transliterated string.

## Installation

```
npm i @skip405/bel-lat
```

## Usage

By default, the package transliterates in accordance with the Łacinka rules.

```javascript
import belLat from '@skip405/bel-lat';

belLat('Лацінка') // Łacinka
```

which is equivalent to:

```javascript
import belLat from '@skip405/bel-lat';

belLat('Лацінка', { style: 'lacinka' }) // Łacinka
```

You can specify conversion in accordance with the instruction for geographical names, e.g.

```javascript
import belLat from '@skip405/bel-lat';

belLat('Лацінка', { style: 'geographical' }) // Lacinka
```

## Testing

```
npm test
```

## License

The MIT License (MIT). Please see [License File](LICENSE) for more information.

0 comments on commit 589e137

Please sign in to comment.