<commit_before>---
{
  "name": "I18N with Aurelia",
  "culture": "en-US",
  "description": "Getting Started with I18N in your Aurelia App.",
  "engines" : { "aurelia-doc" : "^1.0.0" },
  "author": {
    "name": "<NAME>",
  	"url": "http://pragmatic-coder.net"
  },
  "contributors": [],
  "translators": [],
  "keywords": ["I18N", "L10N", "i18next", "JavaScript", "TypeScript"]
}
---

## [Introduction](aurelia-doc://section/1/version/1.0.0)

This documentation explains how to get up and running with Aurelia-I18N
in order to provide localization and internationalization features with your app.

Under the hood it uses [i18next](http://i18next.com/), which is a generalized
open source library with an extensive set of features. By building on top of it
not only can you reuse your work across various other platforms and frameworks
but you are able to use an extensive eco-system full of various packages.

## [Installing the Plugin](aurelia-doc://section/2/version/1.0.0)

There are various ways to setup your Aurelia app. It not only boils down
to the question whether you use JavaScript or TypeScript but also which module loader
and bundler is in use.

Aurelia-I18N is tested and optimized to support both JS and TS, as well as the following loader/bundler scenarios:

* Aurelia CLI
* JSPM
* Webpack

Please continue with the section which suites your setup. In addition to this, you must
pick your own backend service. For this guide we're going to leverage the [XHR backend plugin](https://github.com/i18next/i18next-xhr-backend),<commit_msg>doc(all): convert metadata to yaml and remove unneeded info<commit_after>---
name: I18N with Aurelia
description: Getting Started with I18N in your Aurelia App.
author: <NAME> (http://pragmatic-coder.net)
---

## [Introduction](aurelia-doc://section/1/version/1.0.0)

This documentation explains how to get up and running with Aurelia-I18N
in order to provide localization and internationalization features with your app.

Under the hood it uses [i18next](http://i18next.com/), which is a generalized
open source library with an extensive set of features. By building on top of it
not only can you reuse your work across various other platforms and frameworks
but you are able to use an extensive eco-system full of various packages.

## [Installing the Plugin](aurelia-doc://section/2/version/1.0.0)

There are various ways to setup your Aurelia app. It not only boils down
to the question whether you use JavaScript or TypeScript but also which module loader
and bundler is in use.

Aurelia-I18N is tested and optimized to support both JS and TS, as well as the following loader/bundler scenarios:

* Aurelia CLI
* JSPM
* Webpack

Please continue with the section which suites your setup. In addition to this, you must
pick your own backend service. For this guide we're going to leverage the [XHR backend plugin](https://github.com/i18next/i18next-xhr-backend),
{'fraction_non_alphanumeric': 0.09193825042881647, 'fraction_numerical': 0.01955403087478559, 'mean_word_length': 4.330895795246801, 'pattern_counts': {'":': 9, '<': 5, '<?xml version=': 0, '>': 5, 'https://': 2, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2541842', 'n_tokens_mistral': 893, 'n_tokens_neox': 841, 'n_words': 382}