Nom¶

afmtodit – Adaptation des fichiers de métriques de fonte d’Adobe pour une sortie PostScript et PDF de groff

Synopsis¶

Description¶

afmtodit génère un fichier de description de fonte pour une utilisation avec les dispositifs de sortie ps et pdf de groff(1) à partir d’un fichier de description de fonte d’Adobe, fichier_afm. fichier_mappage associe un caractère ordinaire ou spécial de groff avec un nom de glyphe de PostScript. La sortie est écrite au format de groff_font(5) dans fichier_description_fonte, un fichier nommé selon le nom de fonte de groff (mais voir l’option -o).

fichier_mappage doit contenir une séquence de lignes de la forme

glyphe_ps caractère_groff

Si un glyphe de PostScript n’est pas mentionné dans le fichier_mappage et qu’un nom de caractère de groff ne peut être déduit en utilisant la liste des glyphes d’Adobe (AGL — Adobe Glyph List, construite dans afmtodit), alors afmtodit met le glyphe de PostScript dans le fichier de description de fonte de groff sous forme de glyphe sans nom pouvant être utilisé à l’aide de la séquence d’échappement « \N » dans un document roff(7). Cela est vrai en particulier pour les variantes de glyphe nommées dans le style « toto.titi » ; tous les noms de glyphe contenant un ou plusieurs points sont mappés à des entités sans nom. À moins que l’option -e ne soit indiquée, l’encodage défini dans le fichier AFM (c’est-à-dire les entrées avec des codes non négatifs) est utilisée. Se référer à la section « Using Symbols » dans « Groff : The GNU Implementation of troff », le manuel Texinfo de groff ou le manuel de groff_char(7), qui décrivent comment les identificateurs de caractère de groff sont construits.

Les glyphes non encodés dans le fichier AFM (c’est-à-dire les entrées indexées sous forme « -1 » sont toujours disponibles dans groff ; ils obtiennent des valeurs d’index de glyphe supérieures à 255 (ou supérieures au plus grand code utilisé dans le fichier AFM dans le cas peu probable où cela est supérieur à 255) dans le fichier de description de fonte de groff. Les indices de glyphes non encodés n’ont pas de spécification particulière ; il est préférable d’y accéder seulement à travers des identificateurs spéciaux de caractères.

Si le fichier de fonte proprement dit (pas seulement ses métriques) est disponible, le lister dans les fichiers /usr/share/groff/1.24.2/font/devps/download et /usr/share/groff/1.24.2/font/devpdf/download permet de l’incorporer dans la sortie produite respectivement par grops(1) et gropdf(1).

Si l’option -i est utilisée, afmtodit génère automatiquement une correction d’italique, d’italique gauche ou d’indice pour chaque glyphe (leur signification est expliquée dans groff_font(5)). Elles peuvent être spécifiées pour des glyphes particuliers en ajoutant dans le fichier_afm des lignes telles que :

italicCorrection glyphe_ps n
leftItalicCorrection glyphe_ps n
subscriptCorrection glyphe_ps n

L’option -s doit être indiquée si la fonte est « spéciale », ce qui veut dire que groff doit la rechercher chaque fois qu’un glyphe n’est pas trouvé dans la fonte actuelle. Pour activer cela, fichier_description_fonte peut être listé comme argument de la directive fonts dans le fichier DESC du dispositif de sortie. D’une autre manière, un document peut désigner cette fonte avec la requête special. Si la fonte n’est pas spéciale, il n’est nul besoin de le faire puisque troff(1) l’incorporera automatiquement lors de la première utilisation.

Options¶

L’option --help affiche un message d’utilisation, tandis que les options -v et --version affichent une information de version ; après quoi le programme se termine.

-a inclinaison

Utilisation de inclinaison comme paramètre d’inclinaison (« angle ») dans le fichier de description de fonte. Il est utilisé par groff pour le positionnement des accents. Par défaut, afmtodit utilise la valeur négative de ItalicAngle spécifiée dans le fichier AFM ; avec les vraies fontes italiques, il est parfois préférable d’utiliser une inclinaison inférieure. S’il vous semble qu’une fonte italique place les accents au-dessus des glyphes de base un peu trop à droite, utilisez l’option -a pour indiquer une inclinaison moindre.

-c

Inclusion de commentaires dans le fichier de description de fonte identifiant la fonte PostScript.

-d fichier_description_dispositif

Le fichier de description de dispositif est fichier_description_dispositif au lieu du fichier par défaut DESC. S’il n’est pas trouvé dans le répertoire actuel, le sous-répertoire devps du répertoire de fontes par défaut est analysé (cela est vrai pour le fichier de description de fonte par défaut et un fichier indiqué avec l’option -d).

-e fichier_encodage

La fonte PostScript doit être réencodée pour utiliser l’encodage décrit dans fichier_encodage. Le format de fichier_encodage est décrit dans grops(1). S’il n’est pas trouvé dans le répertoire actuel, le sous-répertoire devps du répertoire de fontes par défaut est analysé.

-f nom_interne

Le nom interne de la fonte groff est défini à nom_interne.

-i facteur_correction_italique

Cette option génère une correction d’italique pour chaque glyphe de façon que sa largeur plus cette correction soit égale à facteur_correction_italique millièmes de cadratin (em) plus la distance entre le bord droit de la boite englobante du glyphe et la droite de son origine. Si cela conduit à une correction négative d’italique, utiliser plutôt zéro comme correction.

Cette option génère aussi une correction d’indice égale au produit de la tangente de l'inclinaison de la fonte et des quatre cinquièmes de la hauteur d’x (hauteur d’un x minuscule) de la fonte. Si cela devait entraîner une correction d’indice supérieure à la correction d’italique, utiliser plutôt une correction d’indice égale à la correction d’italique.

Cette option génère aussi une correction d’italique gauche pour chaque glyphe égale à facteur_correction_italique millièmes de cadratin (em) plus la distance entre le bord gauche de la boite englobante du glyphe et la gauche de son origine. La correction d’italique gauche peut être négative à moins que l’option -m ne soit indiquée.

Cette option n’est normalement nécessaire que pour les fontes italiques (ou obliques). Les fichiers de description des fontes distribuées avec groff ont été créés en utilisant une valeur d’option de 50 pour les fontes italiques.

-o fichier_sortie

Écriture dans fichier_sortie au lieu de fichier_description_fonte.

-k

Omission de toute donnée de crénage de fonte de groff. Utilisation seulement de fontes à chasse fixe (largeur constante).

-m

Empêchement des valeurs négatives de correction d’italique gauche. Les fichiers de description de fontes pour les styles latins distribués avec groff ont été créés avec « -i0 -m » pour améliorer l’espacement avec eqn(1).

-n

Empêchement de production d’une commande « ligatures » pour cette fonte. Cette option est à utiliser avec les fontes à chasse fixe (largeur constante).

-q

Suppression des avertissements de mappage en double ; voir la section « Diagnostics » ci-après.

-s

Ajout de la directive « special » au fichier de description de fonte.

-w écartement

Utilisation de écartement comme largeur d’espace inter-mots.

-x

Ne pas utiliser la liste interne de glyphes d’Adobe (AGL).

Code de retour¶

afmtodit quitte avec les codes de retour  0 en cas de succès de l’opération, 2 si le programme ne peut pas interpréter les arguments de ligne de commande et 1 si une erreur est rencontrée lors du traitement.

FICHIERS¶

/usr/share/groff/1.24.2/font/devps/DESC

Description du dispositif ps de sortie.

/usr/share/groff/1.24.2/font/devps/F

Description de fonte appelée F dans le dispositif ps.

/usr/share/groff/1.24.2/font/devps/download

Liste des fontes disponibles pour l’incorporation dans le document PostScript (ou téléchargée dans le dispositif).

/usr/share/groff/1.24.2/font/devps/generate/dingbats.map

/usr/share/groff/1.24.2/font/devps/generate/dingbats-reversed.map

/usr/share/groff/1.24.2/font/devps/generate/slanted-symbol.map

/usr/share/groff/1.24.2/font/devps/generate/symbol.map

/usr/share/groff/1.24.2/font/devps/generate/text.map

Fichiers de mappage de noms dans la liste des glyphes d’Adobe (AGL) vers les identificateurs de caractère spécial de groff pour les fontes Zapf Dingbats (ZD), Zapf Dingbats inversées (ZDR) et les fontes de symboles inclinées (SS), de symboles (S) et de texte, respectivement. Ces fichier_mappages produisent les fichiers de description de fonte fournis avec groff pour le dispositif de sortie grops.

Diagnostics¶

AGL name 'x' already mapped to groff name 'y';

ignoring AGL name 'uniXXXX'. Ce message peut être ignoré s’il est de la forme indiquée, où le nom AGL ignoré contient quatre chiffres hexadécimaux XXXX. AGL (Adobe Glyph List) possède ses propres noms pour les glyphes ; ils sont souvent différents des noms de caractère spécial de groff. afmtodit établit une correspondance entre les noms des caractères spéciaux de groff et les noms AGL ; il peut s'agir d'une correspondance biunivoque ou de plusieurs-à-un, mais une correspondance un-à-plusieurs ne fonctionnera pas, c'est pourquoi afmtodit élimine les mappages en excès. Par exemple, si x est Delta, y est *D et XXXX est 0394, afmtodit indique que la description de fonte de groff qu'il veut écrire ne peut mapper le caractère spécial de groff \[*D] aux glyphes AGL Delta et uni0394 en même temps.

Si ce message est reçu mais que vous n'êtes pas satisfait de la correspondance qui est ignorée, une solution est de créer un fichier_mappage de remplacement et de relancer afmtodit en l’utilisant.

Lorsque l’option -q est utilisée, ces messages sont supprimés et remplacés par une indication du nombre de messages qui auraient été émis si cette option n'avait pas été indiquée.

Voir aussi¶

Groff : The GNU Implementation of troff, de Trent A. Fisher et Werner Lemberg, le manuel de référence de groff. La section « Using Symbols » mérite un grand intérêt. Elle peut être parcourue interactivement à l’aide de « info '(groff)Using Symbols' ».

groff(1), gropdf(1), grops(1), groff_font(5)

TRADUCTION¶

La traduction française de cette page de manuel a été créée par Jean-Paul Guillonneau <guillonneau.jeanpaul@free.fr>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à debian-l10n-french@lists.debian.org.