lisan
v0.1.1
Published
Lisan - A Blazing fast i18n library
Downloads
113
Maintainers
Readme
Lisan
Lisan (Turkish: lee · sun) is an i18n (internationalization) library.
It provides all essential tooling to have multiple languages in your applications and format numbers, currencies, ordinals & dates based on locale.
Lisan's biggest difference compared to traditional i18n libraries is taking advantage of ES6 Template Literals and using them to generate functions to interpolate strings.
What is Lisan trying to solve?
Most of the i18n libraries are based on some sort of template engine to interpolate strings and these template engines use regex or loops under the hood to find & replace the placeholders.
However, using regex lookups or javascript loops decreases the performance significantly (especially on client-side) since find & replace is being done on runtime.
How lisan solves it?
Lisan adds an extra step to CI, but a giant performance gain to app kind!
Lisan introduces a Dictionary concept where a dictionary entry can be either just a string or a javascript function that interpolates placeholders and returns a string. Since there is no need finding & replacing placeholder templates, we can avoid using regex or loops.
It is that simple.
Of course, maintaining javascript files to store translations could be challenging and not ideal. Especially when using third-party software like transifex or crowdin.
That's why Lisan also provides a compiler and a command line tool to generate Dictionary objects from Translation JSON files. Dictionary objects are saved in javascript files.
Enriched with plugins
Also, you can use existing plugins or write your plugins to extend the capabilities of Lisan.
lisan-plugin-l10n
: adds localization formatters.lisan-plugin-loader
: adds loading methods to dynamically import javascript files.
Installation
You can install lisan from the sources below, as you see fit.
from npm
npm install lisan
from CDN
<script src="https://unpkg.com/lisan/dist/index.umd.js" type="text/javascript"></script>
After adding the script tag above, all public variables
will be accessible via window.lisanJS
variables.
Usage:
<script
src="https://unpkg.com/lisan/dist/index.umd.js"
type="text/javascript"
></script>
<script type="text/javascript">
(() => {
const { lisan, t, c, Lisan } = window.lisanJS;
})();
</script>
Compatibility
| Platform | IE | Edge | Firefox | Chrome | Nodejs | | -------- | --- | ---- | ------- | ------ | ------ | | Version | 8+ | All | All | All | 8+ |
License
This package is MIT licensed.