Provided by: defoma_0.11.10-0.2ubuntu1_all bug

NOM

       Defoma::Subst  - module Defoma pour la gestion des caches et des règles
       de substitution.

SYNOPSIS

       use Defoma::Subst;

       $Sb = defoma_subst_open(
       rulename => nom_rgle,
       threshold => seuil,
       idobject => id_objet,
       private => drapeau_priv );

       defoma_subst_close( objet_subst );

       defoma_subst_register( objet_subst, police, nom_rel );

       defoma_subst_unregister( objet_subst, police nom_rel );

       defoma_subst_add_rule( objet_subst, id_requis, rgle... );

       defoma_subst_remove_rule( objet_subst, id_requis, rgle... );

DESCRIPTION

       Defoma::Subst est un module Defoma qui permet de gérer  les  caches  de
       substitution   (« subst-cache »)   et   les   règles   de  substitution
       (« subst-rule »). Lorsqu’un identifiant est requis, mais qu’il n’est ni
       fourni comme nom réel (RealName) ou Alias d’une police, les polices qui
       ont une apparence similaire et le même jeu  de  caractères  peuvent  se
       substituer  à cette police. Les identifiants requis et les informations
       concernant leur apparence et leur jeu de caractères sont  décrits  dans
       une  règle  de  substitution. Defoma::Subst compare ces règles 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  priorité  « Substituted »
       dans une base de référence à l’aide du module Defoma::Id.

       Les  règles  de  substitution sont en grande partie modifiables par les
       utilisateurs, ce qui signifie que les utilisateurs peuvent  éditer  les
       fichiers  de  règles  de substitution pour ajouter, retirer ou modifier
       les identifiants et  leurs  informations.  Cependant  certains  de  ces
       fichiers  ne  sont  pas  modifiables  et  sont gérés par les scripts de
       configuration Defoma. Ces premières règles de substitution  sont  dites
       publiques et ces dernières sont dites privées.

       Un  cache  de substitution contient les polices pouvant se substituer à
       l’identifiant  demandé.  Comme  indiqué  précédemment,  une  règle   de
       l’identifiant requis et les indications des polices sont comparées. Les
       indications ne sont pas stockées dans les  caches  de  substitution  et
       sont  donc  récupérées  dans  une  base  de  référence.  De  plus,  les
       identifiants requis et leur règle  sont  stockés  dans  des  règles  de
       substitution,   donc   les   caches  de  substitution,  les  règles  de
       substitution  et  les  bases  de  références   sont   fortement   liés.
       Particulièrement   les   caches   de  substitution  et  les  règles  de
       substitution, qui ne peuvent pas être séparées,  ce  qui  explique  que
       Defoma::Subst les manipule par l’intermédiaire d’un unique objet.

       defoma_subst_open permet d’ouvrir un cache de substitution et une règle
       de substitution tous deux spécifiés par nom_rgle. Elle prend également
       un  argument  drapeau_priv et retourne un objet_subst qui sera utilisé
       pour les opérations suivantes. Si la règle de substitution est  privée,
       drapeau_priv  doit  être  non  nul. Sinon, il peut être omis. La règle
       devient alors publique. id_objet doit être spécifié car les  caches  de
       substitution  et  les  règles de substitution sont fortement liés à une
       base de référence comme mentionné précédemment. Les  indications  d’une
       police  de  substitution  sont  récupérées  dans  la  base de référence
       id_objet,  et  les  identifiants  requis  décrits  dans  la  règle   de
       substitution  sont  enregistrés  dans  la  base  de référence. Le seuil
       permet d’empêcher les polices dont le  pourcentage  de  similitude  est
       trop  bas  d’être  enregistrées.  Si  un  identifiant  requis  est déjà
       enregistré dans la base de référence, les polices de substitution  dont
       le degré de similitude est plus faible ne sont pas enregistrées dans la
       base de référence.

       defoma_subst_close  permet  de  fermer  un  cache  et  une   règle   de
       substitution  donnés  par objet_subst. En interne, ceci permet d’écrire
       dans un fichier le contenu du cache et de la règle en mémoire.

       defoma_subst_register  permet  d’enregistrer  une  police  pouvant   se
       substituer  à  un  identifiant  requis  dans  le  cache de substitution
       spécifié par objet_subst. Le nom réel (« RealName ») de la police  doit
       être renseigné.

       defoma_subst_unregister  permet  de  retirer  une  police  du  cache de
       substitution objet_subst. Le nom réel (RealName) peut être omis.

       defoma_subst_add_rule permet d’ajouter  un  identifiant  requis  et  sa
       règle à la règle de substitution objet_subst.

       defoma_subst_remove_rule  permet de retirer un identifiant requis et sa
       règle de la règle de substitution objet_subst. Si la rgle  est  omise,
       toutes   les  règles  décrivant  l’identifiant  requis  id_requis  sont
       retirées de la règle de substitution. Sinon, seule une règle  spécifiée
       par rgle et id_requis est retirée.

EXEMPLES

       1. Ouverture d’une règle de substitution privée.

       $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_réel,
                          priority => $priorité,
                          hints => join(’ ’, @_));
       defoma_subst_register($Sb, $police, $nom_réel);

       3. Désenregistrement.

       defoma_subst_unregister($Id, $police);
       defoma_id_unregister($Id, ’real’, $police);

       4. Ajout d’une règle.

       defoma_subst_add_rule($Sb, ’Helvetica’, @indications);

       5. Retrait de toutes les règles pour Helvetica.

       defoma_subst_remove_rule($Sb, ’Helvetica’);

VOIR AUSSI

       defoma(1). Defoma::Id(1).

TRADUCTION

       Ce  document  est  une  traduction, réalisée par Nicolas François le 29
       juillet 2005 et mise à jour par Cyril Brulebois en janvier 2007.

       L’équipe de traduction a fait le maximum pour réaliser  une  adaptation
       française de qualité.

       La  version  anglaise  la  plus  à  jour  de  ce  document est toujours
       consultable en ajoutant l’option « -L C » à la commande man.

       N’hésitez pas à signaler  à  l’auteur  ou  à  la  liste  de  traduction
       <debian-l10n-french@lists.debian.org>,  selon le cas, toute erreur dans
       cette page de manuel.

                                  4 mars 2001               Defoma::Subst(3pm)