WebSVN – Applications.dictionnaire – Diff – /scripts/dictionnaire.js


/*
  Surligneur de mot (glossaire)
 
  0) tout d'abord la liste des mots est récupée (getMotsADefinitions) et stockée dans motsAyantDefinition
 
  1) chaque mot de la liste subie une transformation progressive en pattern:
  * les mots de moins de 3 caractères sont inchangés (exemple: "nu")
  * les mots finissant en "eux/euse" sont généricisés
  * les autres mots se voit ajoutée la possibilité de matcher sur \\w{0,2}
 
  2) puis plusieurs RegExp sont baties à partir de la liste de pattern préliminaires
  * regexp_complete permet d'assurer que le mot:
  ** commence en début de ligne
  ** suit un espace
  ** ne suit pas un caractère
  [ mais ne s'assure pas que le mot ne suit PAS un caractère accentué, cf notes à propos de \\b et l'UTF-8 ]
 
  * regexp_thin permet de s'assurer que le mot:
  ** ne se trouve pas déjà encapsulé dans un <span rel="" class="definition_term">X</span>
  ** ne se trouve pas comme attribut "rel" d'un <span rel="X" class="definition_term"></span>
  ** n'est pas directement précédé d'un accent (parmis ceux utilisés dans la BDD, cf exclureSpan)
  ** n'est pas directement précédé d'un caractère alphabétique
  Et tente d'extraire une partie de contexte significative (jusqu'à 24 caractère car initialement le
  test d'inclusion dans .definition_term était faire plus tardivement.
 
  3) remplacerDefinitions() prend la liste des nodes susceptibles de nécessiter un traitement
  et ignore ceux ayant déjà été traités [max_passages] fois (4 par défaut)
 
  4) pour chaque node:
  * le compteur de passage est incrémenté
  * necessiteSubstitution() est appellé
 
  == necessiteSubstitution() ==:
  ** Utilise regexp_thin pour extraire les mots restant à définir ainsi qu'une partie de leur contexte.
  ** Utilise regexp_complete pour extraire les mots au plus proche de leur bodures avec un moindre risque d'erreur
  ** exlue les faux positifs possibles de regexp_thin
  ** renvoi les matches de regexp_thin (qui présente plus de contexte)
  =============================
 
  * pour chaque correspondance retournée par necessiteSubstitution(),
  le mot d'origine (tel que dans motsAyantDefinition)
  est déterminé en utilisant le levenstein (un cache est mis en place, cf texte_to_mot() dans helpers.js).
 
  * rechercherEtRemplacerMotParDefinition() est appelée pour effectuer la substitution dans le node
 
 
  Contraintes rencontrées:
  1) exclure les mots déjà défini via la regexp général plutôt qu'au coup par coup.
  2) vérifier les bordures
  3) vérifier bordure d'accents:
  \\b(é) dans une regexp ne peut matcher une chaîne JS UTF-8
  http://stackoverflow.com/questions/2881445/utf-8-word-boundary-regex-in-javascript
*/
 
var dictionnaire = new Array();
var motsAyantDefinition = null;
var mouseX = null;
var mouseY = null;
var active = false;
var set = '#zone-droite p, #zone-droite span:not(.definition_term), #zone-droite td, #zone-droite pre, #zone-droite div, #zone-droite li';
var urlPage = window.location.href;
 
// Note: utiliser \\b plutôt que \\W pour matcher les bordures de mots
// en incluant début et fin de ligne
var regexp_complete = null;
var regexp_thin = null;
 
// nombre maximum de passages de la détection sur un node donné
var max_passages = 4;
 
// echo $(mysql<<<"SELECT cle FROM definitions"|tr "[a-z,-]" o|sed -e 's/o//g' -e "s/\(.\)/\1\n/g"|sort -u)
// ç é è ê î ï ô (2013/07/03)
// TODO: http://xregexp.com/plugins/
var	exclureSpan = '([^' +
	'(?:class="definition_term">)' + // mot contextualisé déjà dictionnarisé
	'(?:rel=")' + // la valeur du rel="" d'un mot déjà dictionnarisé
	'çéèêîïô' + // les accents, non-traités dans la regexp générale et qui ne doivent pas
	// être pris pour des bordures de mots
	'\\w' +
	']|^){1,24}';
 
// sert à filtrer plus rapidement les nodes inutiles pour l'application
// du dictionnaire
var exclureBlancs = new RegExp('^\\s*$');
 
function afficherLienDefinitions() {
	html = '<div id="conteneur_activation_definition"><a href="#">rechercher les définitions</a></div>';
	$('#conteneur_activation_definition').live('click', function(event) {
		event.preventDefault();
		//supprimerToutesDefinitions();
		if(motsAyantDefinition == null) {
			getMotsADefinitions();
			ajouterListenerDefinitions();
		} else {
			$(set).remplacerDefinitions(motsAyantDefinition);
		}
	});
	$('body').append(html);
}
 
$.fn.remplacerDefinitions = function(mots) {
    this.each(function() {
        $(this).contents().filter(function() {
        	return (this.nodeType == 3 && ! (($(this).data("count") || 0) > max_passages));
        }).each(function() {
			// évite les nodes dont le texte est undefined (dumb example <script>)
			if(!$(this).text()) return true;
			// évite les nodes dont le texte est vide ou blanc
			ttexte = texte = $(this).text();
			if(exclureBlancs.test(texte)) return true;
 
			// incrémente le compteur de passage
			/* TODO: cette ligne cause un problème à IE-8
			   (peut-être uniquement relié au onChange() en cas de passage sur
			   des composants ajoutés postérieurement au chargement initial de la
			   page via AJAX. à tester. */
			$(this).data("count", ($(this).data("count") || 0) + 1);
 
 
			matches_list = necessiteSubstitution(texte)[0];
			if(!matches_list) return true; // TODO: data("count") = max_passages ?
 
			for(i in matches_list) {
				couple = matches_list[i];
				mot_contextualise = couple[2];
				cle = texte_to_mot(mot_contextualise);
 
				if(! (ttexte = rechercherEtRemplacerMotParDefinition(texte, cle, couple))) break;
				texte = ttexte;
			}
			$(this).replaceWith(texte);
		});
	});
	return this;
}
 
function rechercherEtRemplacerMotParDefinition(texte, mot, couple) {
	var full_contexte = couple[0],
	prefix_solo = couple[1],
	mot_contextualise = couple[2];
 
	// cf exclureSpan
	if(new RegExp('((?:class="definition_term">)|(?:rel=")|(?:[çéèêîïô]))(' + mot + "\\w{0,2}" + ')' + "\\b", "ig").test(full_contexte)) return;
 
	templateMotADefinition = formaterTemplateMotADefinition(mot_contextualise, mot);
	bloc_replace = full_contexte.replace(mot_contextualise, templateMotADefinition);
	return texte.replace(full_contexte, bloc_replace);
}
 
 
function necessiteSubstitution(texte) {
	var liste = [], liste_complete = [];
 
	// regexp d'extraction du contexte, sans limite aux bords de "mot",
	// peu amener des faux positifs, et notamment ne pas matcher au mieux.
	// Eg: subsessiles match "sessile" et non "subsessile".
	while( (matches_c = regexp_thin.exec(texte)) ) liste.push(matches_c);
	if(liste.length == 0) return [null];
 
	// regexp de validation des bordure de mots, ne conserve que des matches correct
	// vis-à-vis de la bordure gauche
	while( (matches_c = regexp_complete.exec(texte)) ) liste_complete.push(matches_c[1]);
 
	// si une match n'est pas dans le tableau des mots autorisés (indexOf)
	for(var i = 0; i < liste.length; i++) {
		if($.inArray(liste[i][2], liste_complete) == -1) liste.splice(i, 1);
	}
 
	return [liste, liste_complete]
}
 
function getMotsADefinitions() {
	$.ajax({
		url: URL_BASE_SERVICE+'mots/', // provient de dictionnaire.config.js
		success: function(data) {
			motsAyantDefinition = data;
			batirRegexp(motsAyantDefinition);
			$(set).remplacerDefinitions(motsAyantDefinition);
		},
		dataType: "JSON",
		global: false
	});
}
 
function getMotsADefinitionsEtRemplacer() {
	if(motsAyantDefinition == null) {
		getMotsADefinitions();
	} else {
		if(regexp_complete == null || regexp_thin == null) {
			batirRegexp(motsAyantDefinition);
		}
		$(set).remplacerDefinitions(motsAyantDefinition);
	}
}
 
// update definitions set cle = trim(cle);
// select cle from definitions where cle like '%é' COLLATE 'utf8_bin';
// select cle from definitions where cle like '% ou %' COLLATE 'utf8_bin';
function batirRegexp(mots) {
	var restr = '';
	$.each(mots, function(index, mot) {
		if(restr != '') restr += '|';
 
		if(mot == 'ph') {
			restr += 'ph[^.]';
		}
		else if(mot.length < 3) {
			restr += mot;
		}
		// confluent => confluentes
		else if(mot.substr(-2) == 'ts') {
			restr += mot.slice(0, -1) + "e?s?";
		}
		else if(mot.substr(-3) == 'ore') {
			restr += mot + "s?";
		}
		// gestion masculin/féminin en "eux/euse"
		else if(mot.substr(-1) == 'x') {
			restr += mot.slice(0, -1) + "(?:x|se|ses)";
		}
		else if(mot.substr(-4) == 'euse') { // TODO: fix DB
			restr += mot.slice(0, -2) + "(?:x|se|ses)";
		}
		else if(mot.substr(-2) == 'ée') {
			restr += mot.slice(0, -1) + "e?s?";
		}
		else if(mot.substr(-1) == 'é') {
			restr += mot + "e?s?";
		}
		// verbe vs nom
		else if(mot.substr(-4) == 'orme') {
			restr += mot + "s?";
		}
		// verbe 3è p.pluriel en DB: ne devraient pas exister
		// mais rampant => rampante
		else if(mot.substr(-2) == 'nt') {
			restr += mot + "e?s?";
		}
		else {
			// moins de faux positifs:
			// restr += mot + "(?:[ées]){0,2}";
			// autrement:
			restr += mot + "\\w{0,2}";
		}
	});
 
	regexp_complete = new RegExp("(?:\\s|^|\\W)(" + restr + ")\\b", "ig"); // accents
	regexp_thin = new RegExp(exclureSpan + "(" + restr + ")\\b", "ig");
}
 
function formaterTemplateMotADefinition(motOriginal, motSimplifie) {
	definitionHtml = '<span rel="'+motSimplifie+'" class="definition_term">'
		+motOriginal+
		'</span>';
	return definitionHtml;
}
 
function ajouterListenerDefinitions() {
	$('.definition_term').live('mouseover mouseout', function(event) {
		if (event.type == 'mouseover') {
			event.preventDefault();
			afficherDefinition($(this));
		} else {
			cacherPopupsDefinitions();
		}
	});
}
 
function afficherDefinition(element) {
	mot = element.attr('rel');
	if(dictionnaire[mot] != null) {
		element.after(formaterDefinition(element));
		afficherPopupDefinition();
	} else {
		chargerDefinitionDistante(element);
	}
}
 
function chargerDefinitionDistante(element) {
	date = new Date();
	mot = element.attr('rel');
	$.ajax({
		url: URL_BASE_SERVICE+'def/'+mot, // provient de dictionnaire.config.js
		success: function(data) {
			retour = data;
			definition = retour.valeur;
			dictionnaire[mot] = definition;
			element.after(formaterDefinition(element));
			afficherPopupDefinition();
		},
		dataType: "JSON",
		global: false,
		async: false
	});
}
 
function afficherPopupDefinition() {
	$(".definition_container").css({'top':mouseY + 20,'left':mouseX - 10}).fadeIn('slow');
}
 
function cacherPopupsDefinitions() {
	$(".definition_container").remove();
}
 
function formaterDefinition(element) {	
	mot = element.attr('rel');
	data = dictionnaire[mot];
	defHtml = '<div class="definition_container">'+
		'<span class="definition_container_fleche"></span>'+
		'<span class="definition">'+data+'</span>'+
		'</div>';
	return defHtml;
}
 
function supprimerToutesDefinitions() {
	$('.definition_term').each(function() {
		$(this).replaceWith($(this).html());
	});
	cacherPopupsDefinitions();
}
 
$(document).bind('mousemove', function(e){
	mouseX = e.pageX;
    mouseY = e.pageY - $(window).scrollTop();
});
 
$(document).ajaxStop(function() {
	urlPage = $(this)[0].URL;
	getMotsADefinitionsEtRemplacer();
});
 
$(document).ready(function() {
	$.ajax({
		url: URL_BASE_SERVICE + "../../../scripts/helpers.js",
		dataType: "script",
		global: false
	});
	getMotsADefinitionsEtRemplacer();
	ajouterListenerDefinitions();
});

Subversion Repositories Applications.dictionnaire

(root)/scripts/dictionnaire.js @ 22 – Rev 19 → 20

Rev 19		Rev 20
1	`/*`	1	`/*`
2	`Surligneur de mot (glossaire)`	2	`Surligneur de mot (glossaire)`
3		3
4	`0) tout d'abord la liste des mots est récupée (getMotsADefinitions) et stockée dans motsAyantDefinition`	4	`0) tout d'abord la liste des mots est récupée (getMotsADefinitions) et stockée dans motsAyantDefinition`
5		5
6	`1) chaque mot de la liste subie une transformation progressive en pattern:`	6	`1) chaque mot de la liste subie une transformation progressive en pattern:`
7	`* les mots de moins de 3 caractères sont inchangés (exemple: "nu")`	7	`* les mots de moins de 3 caractères sont inchangés (exemple: "nu")`
8	`* les mots finissant en "eux/euse" sont généricisés`	8	`* les mots finissant en "eux/euse" sont généricisés`
9	`* les autres mots se voit ajoutée la possibilité de matcher sur \\w{0,2}`	9	`* les autres mots se voit ajoutée la possibilité de matcher sur \\w{0,2}`
10		10
11	`2) puis plusieurs RegExp sont baties à partir de la liste de pattern préliminaires`	11	`2) puis plusieurs RegExp sont baties à partir de la liste de pattern préliminaires`
12	`* regexp_complete permet d'assurer que le mot:`	12	`* regexp_complete permet d'assurer que le mot:`
13	`** commence en début de ligne`	13	`** commence en début de ligne`
14	`** suit un espace`	14	`** suit un espace`
15	`** ne suit pas un caractère`	15	`** ne suit pas un caractère`
16	`[ mais ne s'assure pas que le mot ne suit PAS un caractère accentué, cf notes à propos de \\b et l'UTF-8 ]`	16	`[ mais ne s'assure pas que le mot ne suit PAS un caractère accentué, cf notes à propos de \\b et l'UTF-8 ]`
17		17
18	`* regexp_thin permet de s'assurer que le mot:`	18	`* regexp_thin permet de s'assurer que le mot:`
19	`** ne se trouve pas déjà encapsulé dans un <span rel="" class="definition_term">X</span>`	19	`** ne se trouve pas déjà encapsulé dans un <span rel="" class="definition_term">X</span>`
20	`** ne se trouve pas comme attribut "rel" d'un <span rel="X" class="definition_term"></span>`	20	`** ne se trouve pas comme attribut "rel" d'un <span rel="X" class="definition_term"></span>`
21	`** n'est pas directement précédé d'un accent (parmis ceux utilisés dans la BDD, cf exclureSpan)`	21	`** n'est pas directement précédé d'un accent (parmis ceux utilisés dans la BDD, cf exclureSpan)`
22	`** n'est pas directement précédé d'un caractère alphabétique`	22	`** n'est pas directement précédé d'un caractère alphabétique`
23	`Et tente d'extraire une partie de contexte significative (jusqu'à 24 caractère car initialement le`	23	`Et tente d'extraire une partie de contexte significative (jusqu'à 24 caractère car initialement le`
24	`test d'inclusion dans .definition_term était faire plus tardivement.`	24	`test d'inclusion dans .definition_term était faire plus tardivement.`
25		25
26	`3) remplacerDefinitions() prend la liste des nodes susceptibles de nécessiter un traitement`	26	`3) remplacerDefinitions() prend la liste des nodes susceptibles de nécessiter un traitement`
27	`et ignore ceux ayant déjà été traités [max_passages] fois (4 par défaut)`	27	`et ignore ceux ayant déjà été traités [max_passages] fois (4 par défaut)`
28		28
29	`4) pour chaque node:`	29	`4) pour chaque node:`
30	`* le compteur de passage est incrémenté`	30	`* le compteur de passage est incrémenté`
31	`* necessiteSubstitution() est appellé`	31	`* necessiteSubstitution() est appellé`
32		32
33	`== necessiteSubstitution() ==:`	33	`== necessiteSubstitution() ==:`
34	`** Utilise regexp_thin pour extraire les mots restant à définir ainsi qu'une partie de leur contexte.`	34	`** Utilise regexp_thin pour extraire les mots restant à définir ainsi qu'une partie de leur contexte.`
35	`** Utilise regexp_complete pour extraire les mots au plus proche de leur bodures avec un moindre risque d'erreur`	35	`** Utilise regexp_complete pour extraire les mots au plus proche de leur bodures avec un moindre risque d'erreur`
36	`** exlue les faux positifs possibles de regexp_thin`	36	`** exlue les faux positifs possibles de regexp_thin`
37	`** renvoi les matches de regexp_thin (qui présente plus de contexte)`	37	`** renvoi les matches de regexp_thin (qui présente plus de contexte)`
38	`=============================`	38	`=============================`
39		39
40	`* pour chaque correspondance retournée par necessiteSubstitution(),`	40	`* pour chaque correspondance retournée par necessiteSubstitution(),`