Provided by:
defoma_0.11.12ubuntu1_all 
NOM
Defoma::Subst - module Defoma pour la gestion des caches et des regles
de substitution.
SYNOPSIS
use Defoma::Subst;
$Sb = defoma_subst_open(
rulename => nom_r`egle,
threshold => seuil,
idobject => id_objet,
private => drapeau_priv'e );
defoma_subst_close( objet_subst );
defoma_subst_register( objet_subst, police, nom_r'eel );
defoma_subst_unregister( objet_subst, police nom_r'eel );
defoma_subst_add_rule( objet_subst, id_requis, r`egle... );
defoma_subst_remove_rule( objet_subst, id_requis, r`egle... );
DESCRIPTION
Defoma::Subst est un module Defoma qui permet de gerer les caches de
substitution (<< subst-cache >>) et les regles de substitution
(<< subst-rule >>). Lorsqu'un identifiant est requis, mais qu'il n'est
ni fourni comme nom reel (RealName) ou Alias d'une police, les polices
qui ont une apparence similaire et le meme jeu de caracteres peuvent se
substituer a cette police. Les identifiants requis et les informations
concernant leur apparence et leur jeu de caracteres sont decrits dans
une regle de substitution. Defoma::Subst compare ces regles pour les
identifiants requis avec les indications d'une police de substitution
et calcule le pourcentage de similitude, il enregistre ensuite
l'identifiant requis et la police avec une priorite << Substituted >>
dans une base de reference a l'aide du module Defoma::Id.
Les regles de substitution sont en grande partie modifiables par les
utilisateurs, ce qui signifie que les utilisateurs peuvent editer les
fichiers de regles de substitution pour ajouter, retirer ou modifier
les identifiants et leurs informations. Cependant certains de ces
fichiers ne sont pas modifiables et sont geres par les scripts de
configuration Defoma. Ces premieres regles de substitution sont dites
publiques et ces dernieres sont dites priv'ees.
Un cache de substitution contient les polices pouvant se substituer a
l'identifiant demande. Comme indique precedemment, une regle de
l'identifiant requis et les indications des polices sont comparees. Les
indications ne sont pas stockees dans les caches de substitution et
sont donc recuperees dans une base de reference. De plus, les
identifiants requis et leur regle sont stockes dans des regles de
substitution, donc les caches de substitution, les regles de
substitution et les bases de references sont fortement lies.
Particulierement les caches de substitution et les regles de
substitution, qui ne peuvent pas etre separees, ce qui explique que
Defoma::Subst les manipule par l'intermediaire d'un unique objet.
defoma_subst_open permet d'ouvrir un cache de substitution et une regle
de substitution tous deux specifies par nom_r`egle. Elle prend egalement
un argument drapeau_priv'e et retourne un objet_subst qui sera utilise
pour les operations suivantes. Si la regle de substitution est privee,
drapeau_priv'e doit etre non nul. Sinon, il peut etre omis. La regle
devient alors publique. id_objet doit etre specifie car les caches de
substitution et les regles de substitution sont fortement lies a une
base de reference comme mentionne precedemment. Les indications d'une
police de substitution sont recuperees dans la base de reference
id_objet, et les identifiants requis decrits dans la regle de
substitution sont enregistres dans la base de reference. Le seuil
permet d'empecher les polices dont le pourcentage de similitude est
trop bas d'etre enregistrees. Si un identifiant requis est deja
enregistre dans la base de reference, les polices de substitution dont
le degre de similitude est plus faible ne sont pas enregistrees dans la
base de reference.
defoma_subst_close permet de fermer un cache et une regle de
substitution donnes par objet_subst. En interne, ceci permet d'ecrire
dans un fichier le contenu du cache et de la regle en memoire.
defoma_subst_register permet d'enregistrer une police pouvant se
substituer a un identifiant requis dans le cache de substitution
specifie par objet_subst. Le nom reel (<< RealName >>) de la police
doit etre renseigne.
defoma_subst_unregister permet de retirer une police du cache de
substitution objet_subst. Le nom reel (RealName) peut etre omis.
defoma_subst_add_rule permet d'ajouter un identifiant requis et sa
regle a la regle de substitution objet_subst.
defoma_subst_remove_rule permet de retirer un identifiant requis et sa
regle de la regle de substitution objet_subst. Si la r`egle est omise,
toutes les regles decrivant l'identifiant requis id_requis sont
retirees de la regle de substitution. Sinon, seule une regle specifiee
par r`egle et id_requis est retiree.
EXEMPLES
1. Ouverture d'une regle de substitution privee.
$Id = defoma_id_open();
$Sb = defoma_subst_open(rulename => 'subst1',
idobject => $Id);
2. Enregistrement d'une police de substitution.
defoma_id_register($Id, type => 'real',
font => $police,
id => $nom_reel,
priority => $priorite,
hints => join(' ', @_));
defoma_subst_register($Sb, $police, $nom_reel);
3. Desenregistrement.
defoma_subst_unregister($Id, $police);
defoma_id_unregister($Id, 'real', $police);
4. Ajout d'une regle.
defoma_subst_add_rule($Sb, 'Helvetica', @indications);
5. Retrait de toutes les regles pour Helvetica.
defoma_subst_remove_rule($Sb, 'Helvetica');
VOIR AUSSI
defoma(1). Defoma::Id(1).
TRADUCTION
Ce document est une traduction, realisee par Nicolas Francois le 29
juillet 2005 et mise a jour par Cyril Brulebois en janvier 2007.
L'equipe de traduction a fait le maximum pour realiser une adaptation
francaise de qualite.
La version anglaise la plus a jour de ce document est toujours
consultable en ajoutant l'option << -L C >> a la commande man.
N'hesitez pas a signaler a l'auteur ou a la liste de traduction
<debian-l10n-french@lists.debian.org>, selon le cas, toute erreur dans
cette page de manuel.
March 4, 2001 Defoma::Subst(3pm)