Provided by: defoma_0.11.12ubuntu1_all bug

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)