afmtodit - créer des fichiers de polices à utiliser avec groff -Tps et -Tpdf
afmtodit [ -ckmnsx ] [ -a n ] [ -d desc-file ] [ -e enc-file ] [ -f internal-name ] [ -i n ] [ -o output-file ] afm-file map-file font afmtodit -v
afmtodit crée un fichier de polices à utiliser avec groff, grops et gropdf. afmtodit est écrit en Perl ; vous devez avoir Perl version 5.004 ou plus récente installée afin d'exécuter afmtodit.
afm-file est le fichier AFM (Adobe Font Metric) pour la police.
map-file est un fichier qui indique quels noms de caractères groff correspondent à chaque nom de caractère PostScript ; ce fichier doit contenir une séquence de lignes de la forme
ps-char groff-char
où ps-char est le nom PostScript du caractère et groff-char est le nom groff du caractère (tel qu'utilisé dans la police groff déposer). Le même ps-char peut apparaître plusieurs fois dans le fichier ; chaque groff-char doit apparaître au plus une fois. Les lignes commençant par "#" et les lignes vides sont ignorées. Si le fichier n'est pas trouvé dans le répertoire courant, il est recherché dans le sous-répertoire devps/generate du répertoire des polices par défaut.
Si un caractère PostScript n'est pas mentionné dans map-file, et qu'un nom de glyphe générique groff ne peut pas être déduit à l'aide de la liste de glyphes Adobe (AGL, intégrée à afmtodit), puis afmtodit place le caractère PostScript dans le fichier de police groff en tant que caractère sans nom accessible uniquement par la séquence d'échappement '\N' dans un document roff. En particulier, cela est vrai pour les variantes de glyphe nommées sous la forme « foo.bar » ; tous les noms de glyphes contenant un ou plusieurs points sont mappés sur des entités sans nom. Si l'option -e n'est pas spécifiée, le codage défini dans le fichier AFM (c'est-à-dire les entrées avec des codes de caractères non négatifs) est utilisé. Reportez-vous à la section "Utilisation des symboles" dans Groff : l'implémentation GNU de troff, le manuel groff Texinfo, qui décrit comment les noms de glyphes groff sont construits .
Les caractères non encodés dans le fichier AFM (c'est-à-dire les entrées qui ont "-1" comme code de caractère) sont toujours disponibles dans groff ; ils obtiennent des valeurs d'index de glyphe supérieures à 255 (ou supérieures au plus grand code de caractère utilisé dans le fichier AFM dans le cas peu probable où il est supérieur à 255) dans le fichier de police groff. Les indices de glyphe des caractères non codés n'ont pas d'ordre spécifique ; il est préférable d'y accéder uniquement avec des noms de glyphes.
Le fichier de police groff sera généré dans un fichier appelé font, à moins que l'option -o ne soit utilisée.
S'il existe un fichier de police téléchargeable pour la police, il peut être répertorié dans le fichier /usr/share/groff/1.22.4/font/devps/download ; voir groupes(1).
Si l'option -i est utilisée, afmtodit générera automatiquement une correction d'italique, une correction d'italique gauche et une correction d'indice pour chaque caractère (la signification de ces paramètres est expliquée dans groff_font(5)); ces paramètres peuvent être spécifiés pour des caractères individuels en ajoutant aux lignes afm-file du formulaire :
italicCorrection ps-char n leftItalicCorrection ps-char n subscriptCorrection ps-char n
où ps-char est le nom PostScript du caractère, et n est la valeur désirée du paramètre correspondant en millièmes d'em. Ces paramètres ne sont normalement nécessaires que pour les polices italiques (ou obliques).
Les espaces blancs sont autorisés entre une option de ligne de commande et son argument.
Utilisez n comme paramètre d'inclinaison dans le fichier de police ; ceci est utilisé par groff dans le positionnement des accents. Par défaut, afmtodit utilise le négatif de l'ItalicAngle spécifié dans le fichier AFM ; avec les vraies polices en italique, il est parfois souhaitable d'utiliser une inclinaison inférieure à cela. Si vous trouvez que les caractères d'une police en italique ont des accents placés trop à droite, utilisez l'option -a pour donner à la police une inclinaison plus petite.
Incluez des commentaires dans le fichier de police afin d'identifier la police PostScript.
Le fichier de description de l'appareil est desc-file plutôt que le DESC par défaut. S'il n'est pas trouvé dans le répertoire courant, le sous-répertoire devps du répertoire de polices par défaut est recherché (ceci est vrai à la fois pour le fichier de description de périphérique par défaut et un fichier donné avec l'option -d ).
La police PostScript doit être réencodée pour utiliser l'encodage décrit dans enc-file. Le format de enc-file est décrit dans grops(1). S'il n'est pas trouvé dans le répertoire courant, le sous-répertoire devps du répertoire de polices par défaut est recherché.
Le nom interne de la police groff est défini sur name.
Génère une correction d'italique pour chaque caractère de sorte que la largeur du caractère plus la correction d'italique du caractère soit égale à n millièmes d'un em plus le montant par lequel le bord droit de la boîte englobante du caractère est à droite de l'origine du personnage. Si cela entraînait une correction italique négative, utilisez plutôt une correction italique nulle.
Générez également une correction d'indice égale au produit de la tangente de l'inclinaison de la police et des quatre cinquièmes de la hauteur x de la police. Si cela entraînait une correction d'indice supérieure à la correction d'italique, utilisez plutôt une correction d'indice égale à la correction d'italique.
Générez également une correction italique gauche pour chaque caractère égale à n millièmes de em plus la quantité par laquelle le bord gauche de la boîte englobante du caractère est à gauche de l'origine du caractère. La correction italique gauche peut être négative à moins que l'option -m ne soit donnée.
Cette option n'est normalement nécessaire qu'avec les polices italiques (ou obliques). Les fichiers de polices distribués avec groff ont été créés en utilisant une option de -i50 pour les polices en italique.
Le fichier de sortie est output-file au lieu de font.
Omettez toutes les données de crénage de la police groff ; à utiliser uniquement pour les polices à espacement fixe (largeur constante).
Empêcher les valeurs négatives de correction de l'italique gauche. Les fichiers de police Roman distribués avec groff ont été créés avec -i0 -m pour améliorer l'espacement avec eqn(1).
N'affichez pas de commande ligatures pour cette police ; utiliser avec des polices à espacement fixe (largeur constante).
La police est spéciale. L'effet de cette option est d'ajouter la commande special au fichier de police.
Imprimer la version et quitter.
N'utilisez pas la liste de glyphes Adobe intégrée.
Fichier de description de l'appareil.
Fichier de description de police pour la police F.
Liste des polices téléchargeables.
Encodage utilisé pour les polices de texte.
Cartographie standard.
Groff: The GNU Implementation of troff, by Trent A. Fisher and Werner Lemberg, is the primary groff manual. Section “Using Symbols” may be of particular note. You can browse it interactively with “info '(groff)Using Symbols'”.
groff(1), gropdf(1), grops(1), groff_font(5), perl(1)