languages4translatewiki
This a enlarger version of languages.js, for supporting all languages of translatewiki.net.
A basic and lightweight replacement for Globalize. Stores ISO 639 language database in a JSON object, accesible as node module or by browser javascript interpret. Without any dependencies.
Features
- The same file can be use from the server side in nodejs to the client side in javascript browser interpret.
- Also includes the json file for using in other languages, for example PHP.
- Supports 468 languages
- Lightweight, only 12K or 6K gzipped.
- Very basic too, but enough for a lot of projects: only return the ISO 639 language codes of supported languages, the nativeName and his own direction.
- Contain a build script which call translatewiki api page for languages support, minimizes the code with uglify, and compresses it with gzip.
Use
From javascript the JSON object is not accesible directly. You must use this public functions:
- languages.isValid(langcode): Return boolean value, true if langcode is supported.
- languages.getAllLanguageCode(): Return an array with all the language codes supported.
- languages.getLanguageInfo(langcode): Return object {"nativeName", "direction"}.
If langcode isn't supported return {}.
See the test folder for use examples:
From nodejs
var languages = require ('../languages.min.js');
var num_languages = 0;
var langscodes = languages.getAllLanguageCode();
for (num_languages=0; num_languages<langscodes.length; num_languages++) {
console.log(langscodes[num_languages]);
console.log(" "+JSON.stringify(languages.getLanguageInfo(langscodes[num_languages])));
}
console.log("Languages supported: "+num_languages);
console.log("¿isValid 'kaka' language code? "+languages.isValid('kaka'));
console.log("¿isValid 'es' language code? "+languages.isValid('es'));
From browser
<!doctype html>
<html>
<head>
<title>Test languages module</title>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=0">
<script src="../languages.min.js"></script>
<style>
body {
background-color: #eee;
}
.centrador {
width:700px;
margin:10px auto;
border:1px solid #ccc;
padding:20px;
background-color:#fff;
}
</style>
</head>
<body>
<div class="centrador">
<h1>Test languages module (Browser client side)</h1>
<hr />
<div id="test"></div>
</div>
<script>
var num_languages = 0,
text = '';
var langscodes = languages.getAllLanguageCode();
for (num_languages=0; num_languages<langscodes.length; num_languages++) {
var langcode = langscodes[num_languages];
text+='<b>'+langcode+'</b> '+JSON.stringify(languages.getLanguageInfo(langcode))+'<br />';
}
text = '<h2>Languages supported: '+num_languages+'</h2>'+text;
document.getElementById('test').innerHTML = text;
</script>
</body>
</html>
Build
To built a new version of languages4translatewiki, you need to install this node module:
npm install -g uglify-js
And then execute build/build.sh