README.md

Babel

Introduction :

Babel est un localizer libre, gratuit et opensource qui vise à faciliter la traduction des application Javascript. Il tire son nom de la tour éponyme dans le folklore Hébraique.

Quickstart

Avant toute chose, Babel n'est pas un package npm, juste un module node que vous pouvez à vos projets de bots discord et le require à partir de son chemin de fichier. Son utilisation est libre, et sa modification est permise, cependant merci de me créditer dans ce cas.

var Eaque = require('<path_to_file>/babel.js');

Il faut ensuite modifier les configurations de Babel afin d'ajouter les langages voulu, changer le langage par défaut et le chemin où se génèreront les fichiers de localisations.

static config = {
	langDirPath:  __dirname + '/',
	langages: [
		'fr_fr',
		'en_us'
	],
	defaultLang:  'en_us'
};

Pour initialiser le module afin qu'il génère ses fichiers il suffit d'utiliser la méthode statique Babel#genFiles, puis d'utiliser la méthode Babel#localize en passant comme argument le unlocalized string ainsi que le langage choisi pour qu'il retourne le texte que vous avez configuré dans le json correspondant. Vous trouverez ce json de traduction à l'endroit que vous avez indiqué dans Babel.config.langDirPath.

const Babel = require('./babel.js');

Babel.genFiles();

console.log(Babel.localize('text.hello', 'fr_fr'));
console.log(Babel.localize('text.hello', 'en_us'));

fr_fr.json :

{
	"text.hello" : "Bonjour !"
}

en_us.json :

{
	"text.hello" : "Hello !"
}

Ce qui donnera :

-> Bonjour !
-> Hello !

Vous pouvez également formater vos messages avec la méthode Babel#localizeFormated pour pouvoir remplacer les balises <nombre/> dans vos lignes de texte traduites, et donc simplifier la modification de vos messages.

let arg0 = "Finn";
let arg1 = "John";
let arg2 = "Peter";

console.log(Babel.localizeFormated('text.hello', 'fr_fr', arg0, arg1, arg2));

{
	"Hello <0/>, <1/> and <2/> !"
}

Ce qui renverra :

Hello Finn, John and Peter !