# nodejs-i18n

> Minimalistic internationalization using gettext style for NodeJS

Latest version **2.4.0** (published 2020-05-24) · MIT license · 0 weekly downloads

## Install

```sh
npm install nodejs-i18n
pnpm add nodejs-i18n
yarn add nodejs-i18n
bun add nodejs-i18n
```

Provides the command `nodejs-i18n`.

## Health

**Score 30/100 (F)** — status: abandoned.

Positive: no vulnerabilities; high maintenance score.

Warnings: low downloads; no types; no esm support.

Negative: abandoned.

## Facts

| | |
|---|---|
| Version | 2.4.0 |
| Published | 2020-05-24 |
| First published | 2018-10-05 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=10 |
| Dependencies | 5 |
| Unpacked size | 12.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2 |
| Author | TiagoDanin |
| Maintainers | tiagodanin |
| Keywords | gettext, i18n, i18n-js, i18n-node, internationalization, javascript, nodejs, translations |

## Links

- npm: https://www.npmjs.com/package/nodejs-i18n
- Repository: https://github.com/TiagoDanin/NodeJS-i18n
- Homepage: https://tiagodanin.github.io/NodeJS-i18n
- Issues: https://github.com/TiagoDanin/NodeJS-i18n/issues
- npm.io page: https://npm.io/package/nodejs-i18n

## Dependencies (5)

- [argv](https://npm.io/package/argv.md) 0.0.2
- [tempy](https://npm.io/package/tempy.md) 0.5.0
- [esprima](https://npm.io/package/esprima.md) ^4.0.1
- [minimist](https://npm.io/package/minimist.md) ^1.2.5
- [gettext-parser](https://npm.io/package/gettext-parser.md) ^4.0.3

## Alternatives

- [messageformat](https://npm.io/package/messageformat.md) — 329.7K weekly downloads
- [@mintlify/scraping](https://npm.io/package/@mintlify/scraping.md) — 294.8K weekly downloads
- [@mintlify/previewing](https://npm.io/package/@mintlify/previewing.md) — 209.5K weekly downloads
- [@mintlify/prebuild](https://npm.io/package/@mintlify/prebuild.md) — 209.5K weekly downloads
- [@mintlify/link-rot](https://npm.io/package/@mintlify/link-rot.md) — 206.3K weekly downloads

## Recent versions

- 2.4.0 (latest) — 2020-05-24
- 2.3.0 — 2019-04-24
- 2.2.1 — 2019-04-06
- 2.2.0 — 2019-04-06
- 2.1.0 — 2019-02-10
- 2.0.0 — 2019-02-10
- 1.0.1 — 2018-10-14
- 1.0.0 — 2018-10-11
- 0.0.1 — 2018-10-05

## README

# NodeJS i18n

[![Travis](https://img.shields.io/travis/TiagoDanin/NodeJS-i18n.svg?branch=master&style=flat-square)](https://travis-ci.org/TiagoDanin/NodeJS-i18n) [![Downloads](https://img.shields.io/npm/dt/nodejs-i18n.svg?style=flat-square)](https://npmjs.org/package/nodejs-i18n) [![Node](https://img.shields.io/node/v/nodejs-i18n.svg?style=flat-square)](https://npmjs.org/package/nodejs-i18n) [![Version](https://img.shields.io/npm/v/nodejs-i18n.svg?style=flat-square)](https://npmjs.org/package/nodejs-i18n) 

Minimalistic internationalization using gettext style for NodeJS

## Features

- Gettext Style
- Easy Imprementation
- Create .po via CLI
- Select Lang per User

## Installation

Module available through the [npm registry](https://www.npmjs.com/). It can be installed using the [`npm`](https://docs.npmjs.com/getting-started/installing-npm-packages-locally) or [`yarn`](https://yarnpkg.com/en/) command line tool.

```sh
# Yarn (Recomend)
yarn global add nodejs-i18n
# NPM 
npm install nodejs-i18n --global
```

## Usage

```sh
# Create file
find . | grep .js | sort | nodejs-i18n > en.po

# Create file (all strings) [beta]
find . | grep .js | sort | nodejs-i18n --all > en.po

# Create file (get identifier value) [beta]
find . | grep .js | sort | nodejs-i18n --value > en.po
```

## Example

```js
const { Resources, Translation } = require('nodejs-i18n')

const resources = new Resources()
resources.load('pt', 'pt.po')

const user = new Translation('pt')

//i18n: My Hello World with NodeJs i18n
const world = user._`world` // Mundo
user._`Hello ${world}` // Olá mundo
```

## Documentation

### Options

#### Options :: Resources({})
- **lang** - String
> Lang id.</br>
> Default value: `en`

#### Options :: Resources({}).load(lang, file)
Load translation

- **lang** - String
> Lang id.</br>

- **file** - String
> File path

#### Options :: Resources({}).remove()
Remove translation.

- **lang** - String
> Lang id.</br>

#### Options :: Translation(lang)
Select translation.

- **lang** - String
> Lang id.</br>

#### Options :: Translation(lang).\_(string)
String translation.

- **String** - String

### CLI

Create en.po files with `nodejs-i18n`. Add in your package.json

```json
"scripts": {
	"i18n": "find . | grep .js | sort | nodejs-i18n > en.po"
}
```

and run `$ npm run i18n` or `$ yarn i18n`

## Tests

To run the test suite, first install the dependencies, then run `test`:

```sh
# Using Yarn
yarn test
```

## Dependencies

<details>
	<summary><a href="https://ghub.io/argv">argv</a>: CLI Argument Parser</summary>
	<b>Author</b>: Corey Hart</br>
	<b>License</b>: </br>
	<b>Version</b>: 0.0.2
</details>
<details>
	<summary><a href="https://ghub.io/esprima">esprima</a>: ECMAScript parsing infrastructure for multipurpose analysis</summary>
	<b>Author</b>: Ariya Hidayat</br>
	<b>License</b>: BSD-2-Clause</br>
	<b>Version</b>: ^4.0.1
</details>
<details>
	<summary><a href="https://ghub.io/gettext-parser">gettext-parser</a>: Parse and compile gettext po and mo files to/from json, nothing more, nothing less</summary>
	<b>Author</b>: Andris Reinman</br>
	<b>License</b>: MIT</br>
	<b>Version</b>: ^4.0.3
</details>
<details>
	<summary><a href="https://ghub.io/minimist">minimist</a>: parse argument options</summary>
	<b>Author</b>: James Halliday</br>
	<b>License</b>: MIT</br>
	<b>Version</b>: ^1.2.5
</details>
<details>
	<summary><a href="https://ghub.io/tempy">tempy</a>: Get a random temporary file or directory path</summary>
	<b>Author</b>: Sindre Sorhus</br>
	<b>License</b>: MIT</br>
	<b>Version</b>: 0.5.0
</details>

## Dev Dependency

<details>
	<summary><a href="https://ghub.io/mocha">mocha</a>: simple, flexible, fun test framework</summary>
	<b>Author</b>: TJ Holowaychuk</br>
	<b>License</b>: MIT</br>
	<b>Version</b>: 7.2.0
</details>

## Related

<details>
	<summary><a href="https://ghub.io/gettext-parser">gettext-parser</a>: Parse and compile gettext po and mo files to/from json, nothing more, nothing less</summary>
	<b>Author</b>: Andris Reinman</br>
	<b>License</b>: MIT
</details>

## Contributors

Pull requests and stars are always welcome. For bugs and feature requests, please [create an issue](https://github.com/TiagoDanin/NodeJS-i18n/issues). [List of all contributors](https://github.com/TiagoDanin/NodeJS-i18n/graphs/contributors).

## License

[MIT](LICENSE) © [TiagoDanin](https://TiagoDanin.github.io)

---
_Source: https://npm.io/package/nodejs-i18n · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._