gropdf - En ligne dans le Cloud

PROGRAMME:

Nom

gropdf - pilote PDF pour groff

SYNOPSIS

gropdf [-délv] [-F dir] [-p taille de papier] [-y fonderie] [-u [fichier cmap]] [fichiers ]

Il est possible d'avoir un espace entre une option de ligne de commande et son paramètre.

DESCRIPTION

gropdf traduit la sortie de GNU trof en PDF. Normalement gropdf doit être invoqué par
en utilisant la commande groff avec un -Tpdf option. Si aucun fichier n'est fourni, gropdf lit le
entrée standard. Un nom de fichier de - provoque aussi gropdf pour lire l'entrée standard. PDF
la sortie est écrite sur la sortie standard. Lorsque gropdf est géré par groff les options peuvent être
transmis à gropdf en utilisant groff's -P option.

Voir section POLICE INSTALLATION ci-dessous pour un guide sur l'installation des polices pour gropdf.

OPTIONS

-d Incluez les informations de débogage sous forme de commentaires dans le PDF. Produit également un
PDF non compressé.

-e Forcer toutes les polices à être incorporées dans le PDF.

-Fdir Préfixer le répertoire dir/ devprénom au chemin de recherche de la police et de la description de l'appareil
fichiers; prénom est le nom de l'appareil, généralement pdf.

-l Imprimez le document au format paysage.

-ptaille de papier
Définir la dimension physique du support de sortie. Cela remplace le taille de papier,
longueur du papieret largeur du papier commandes dans le DESC déposer; il accepte la même chose
arguments en tant que taille de papier commander. Voir groff_font (5) pour en savoir plus.

-v Imprimez le numéro de version.

-yfonderie
Définissez la fonderie à utiliser pour sélectionner les polices du même nom.

-e Forces gropdf pour intégrer TOUTES les polices (même les 14 polices PDF de base).

-s Ajoutez une ligne de commentaire à la fin du PDF indiquant les statistiques, c'est-à-dire le nombre de pages dans
document. Ghostscript's ps2pdf se plaint de cette ligne si elle est incluse, mais
fonctionne de toute façon.

-u
-unomfichier cmap
Gropdf inclut normalement un ToUnicode CMap avec n'importe quelle police créée en utilisant texte.enc as
le fichier d'encodage, cela facilite la recherche de mots qui contiennent
ligatures. Vous pouvez inclure votre propre CMap en spécifiant un nomfichier cmap ou n'ont pas
CMap du tout en omettant l'argument.

UTILISATION

L'entrée à gropdf doit être au format de sortie trof(1). Ceci est décrit dans
groff_out (5).

De plus, les fichiers de description de l'appareil et de la police pour l'appareil utilisé doivent répondre à certaines
exigences : La résolution doit être un multiple entier de 72 fois la échelle de tailleL’
pdf l'appareil utilise une résolution de 72000 et une échelle de taille de 1000.

Le fichier de description de l'appareil doit contenir un format de papier valide ; voir groff_font(5) pour plus
</br>L’Information. gropdf utilise les mêmes polices Postscript Adobe Type 1 que le tâtons dispositif
conducteur. Bien que la norme PDF autorise l'utilisation d'autres types de polices (comme TrueType), cette
l'implémentation accepte uniquement la police Postscript Type 1. Moins de polices de type 1 sont prises en charge
nativement dans les documents PDF que les 35 polices standard prises en charge par tâtons et tout le post-scriptum
imprimantes, mais toutes les polices sont disponibles car celles qui ne sont pas prises en charge nativement sont
automatiquement intégré dans le PDF.

gropdf prend en charge le concept de fonderies, c'est-à-dire des versions différentes du même
Police de caractère. Lors de l'installation d'un Fonderie contrôle de fichier où les polices sont trouvées et construites groff polices
à partir des fichiers qu'il découvre sur votre système.

Chaque fichier de description de police doit contenir une commande

Nom interne nom de ps

qui dit que le nom PostScript de la police est nom de ps. Lignes commençant par # ainsi que
les lignes vides sont ignorées. Le code de chaque caractère donné dans le fichier de police doit
correspondent au code dans l'encodage par défaut de la police. Ce code peut être utilisé avec
le \N séquence d'échappement dans trof pour sélectionner le caractère, même si le caractère ne
avoir un nom de groff. Chaque caractère du fichier de police doit exister dans la police PostScript,
et les largeurs données dans le fichier de police doivent correspondre aux largeurs utilisées dans la police PostScript.

Notez que gropdf n'est actuellement capable d'afficher que les 256 premiers glyphes dans n'importe quelle police. Cette
la restriction sera levée dans une version ultérieure.

gropdf peut automatiquement inclure les polices téléchargeables nécessaires à l'impression du document.
Les polices peuvent être au format PFA ou PFB.

Toutes les polices téléchargeables qui devraient, le cas échéant, être incluses par gropdf doit être répertorié
dans le fichier /usr/share/groff/1.22.3/font/devpdf/download; cela devrait consister en des lignes de
la forme

fonderie fonte nom de fichier

De fonderie est le nom de la fonderie ou vide pour la fonderie par défaut. fonte est
le nom PostScript de la police, et nom de fichier est le nom du fichier contenant la police ;
lignes commençant par # et les lignes vides sont ignorées ; les champs doivent être séparés par des tabulations
(les espaces sont ne sauraient autorisé); nom de fichier est recherché en utilisant le même mécanisme que celui utilisé
pour les fichiers métriques de polices groff. Les download le fichier lui-même est également recherché à l'aide de ce
mécanisme; actuellement, seul le premier fichier trouvé dans le chemin de la police est utilisé. Noms de fonderie
sont généralement un seul caractère (comme « U » pour la fonderie URW) ou vide pour la valeur par défaut
fonderie. Cette valeur par défaut utilise les mêmes polices que script fantôme utilise lorsqu'il incorpore des polices dans un
Fichier PDF.

Dans la configuration par défaut, il existe des styles appelés R, I, Bet BI monté aux positions de police 1
à 4. Les polices sont regroupées en familles A, BM, C, H, HN, N, Pet T avoir des membres dans
chacun de ces styles :

AR AvantGarde-Livre
AI AvantGarde-BookOblique
AB AvantGarde-Demi
ABI AvantGarde-Demi-Oblique
BMR Bookman-Lumière
Test IMC - Calcul de votre index de masse corporelle Bookman-LightItalic
BMB Bookman-Demi
BMBI Bookman-demiitalique
CR Courrier
CI Courrier-Oblique
CB Courrier-Bold
CBI Courrier-BoldOblique
HR Helvetica
HI Helvetica-Oblique
HB Helvetica-Gras
HBI Helvetica-BoldOblique
HNR Helvetica-Étroit
HNI Helvetica-Étroit-Oblique
HNB Helvetica-étroit-gras
HNB Helvetica-Narrow-BoldOblique
NR NouveausiècleSchlbk-Roman
NI NewCenturySchlbk-italique
NB Nouveau siècleSchlbk-Bold
NBI NewCenturySchlbk-BoldItalic
PR Palatino-romain
PI Palatino-italique
PB Palatino-Gras
PBI Palatino-BoldItalique
TR Times-Romain
TI Temps-italique
TB Times-BOLD
TBI Times-GrasItalique

Il existe également la police suivante qui n'est pas membre d'une famille :

ZCMI ZapfChancery-MediumItalic

Il existe également des polices spéciales appelées S pour la police PS Symbol. Le grec minuscule
les caractères sont automatiquement inclinés (pour correspondre à la police SymbolSlanted (SS) disponible pour
postface). Zapf Dingbats est disponible en ZD, le glyphe "main pointant vers la gauche" (\[lh]) est
disponible puisqu'elle a été définie à l'aide de l'extension \X'pdf:xrev' qui inverse la
sens des lettres dans les mots.

La couleur par défaut pour \m ainsi que \M est noir; pour les couleurs définies dans l'espace colorimétrique 'rgb'
définir la couleur RVB est utilisé, pour 'cmy' et 'cmyk' setcmmykcolor, et pour "gris" setgris. Noter que
setcmmykcolor est une commande PostScript LanguageLevel 2 et n'est donc pas disponible sur certains anciens
imprimantes.

gropdf comprend certaines des commandes X produites à l'aide du \X séquences d'échappement prises en charge
by tâtons. Plus précisément, les éléments suivants sont pris en charge.

\X'ps : invis'
Supprimer la sortie.

\X'ps : endinvis'
Arrêtez de supprimer la sortie.

\X'ps : exec gsave point actuel 2 copier traduire n tourner nég échanger nég échanger Traduire'
De n est l'angle de rotation. Il s'agit de soutenir le aligner commande dans gpic.

\X'ps : exec grestore'
Encore une fois utilisé par gpic à restaurer après rotation.

\X'ps : exec n setlinejoin'
De n peut être l'une des valeurs suivantes.

0 = jointure en onglet
1 = jointure ronde
2 = jointure en biseau

\X'ps : exec n setlinecap'
De n peut être l'une des valeurs suivantes.

0 = casquette
1 = Bouchon rond, et
2 = Bouchon carré en saillie

\X'ps : pdfmark'
Tous les marque pdf macros installées en utilisant -m marque pdf or -m mspdf (voir documentation
dans 'pdfmark.pdf'). Un sous-ensemble de ces macros est installé automatiquement lorsque vous
utilisé -Tpdf vous ne devriez donc pas avoir besoin d'utiliser '-m pdfmark' pour utiliser la plupart des PDF
Fonctionnalité.

Tous les autres ps: les balises sont ignorées en silence.

UN \X spécial utilisé par le pilote DVI est également reconnu :

\X'formatpapier=taille de papier'
où le taille de papier paramètre est le même que le taille de papier commander. Voir
groff_font(5) pour plus de détails. Cela signifie que vous pouvez modifier la taille de la page à volonté
dans le fichier PDF créé par gropdf. Si vous voulez changer le papier
taille, cela doit être fait avant de commencer à créer la page.

Par ailleurs, gropdf prend en charge sa propre suite de pdf: Mots clés. Les balises suivantes sont
prise en charge:

\X'pdf : pdfpic filet alignement largeur la taille longueur de la ligne'
Placer une image du spécifié largeur contenant le dessin PDF du fichier filet of
voulu largeur ainsi que la taille (si la taille est manquant ou nul alors il est mis à l'échelle
proportionnellement). Si alignement is -L le dessin est aligné à gauche. Si c'est -C or
-R a longueur de la ligne supérieur à la largeur du dessin est également requis. Si
largeur est spécifié comme zéro, la largeur est mise à l'échelle proportionnellement à la hauteur.

\X'pdf : xrev'
Cela bascule un drapeau qui inverse le sens d'impression lettre by lettre,
c'est-à-dire que chaque lettre séparée est inversée, pas le mot entier. Ceci est utile pour
inverser le sens des glyphes dans la police Dingbats. Pour revenir à la normale
impression répéter la commande à nouveau.

\X'pdf : début de marque /ANN définition'
Les macros qui prennent en charge les signets PDF utilisent cet appel en interne pour démarrer le
définition du hotspot du signet (l'utilisateur aura appelé '.pdfhref L' avec le texte
qui deviendra la région du « point chaud »). Normalement, cela n'est jamais utilisé, sauf à partir de
dans les macros pdfmark.

\X'pdf : marque'
Les macros qui prennent en charge les signets PDF utilisent cet appel en interne pour arrêter le
définition du hotspot du signet (l'utilisateur aura appelé '.pdfhref L' avec le texte
qui deviendra la région du « point chaud »). Normalement, cela n'est jamais utilisé, sauf à partir de
dans les macros pdfmark.

\X'pdf : suspension de marque'
\X'pdf : marquer le redémarrage'
Si vous utilisez des pièges de page pour produire des en-têtes, des bas de page, etc., vous devez utiliser
ceux-ci au cas où un "point chaud" traverse une limite de page, sinon tout texte sorti par
la macro de titre ou de pied sera marquée comme faisant partie du « point chaud ». Arrêter
cela se produit, placez simplement '.pdfmarksuspend' et '.pdfmarkrestart' au début et
fin de la macro d'interruption de page, respectivement. (Ce ne sont que des macros de commodité qui
émettre le code \X. Ces macros ne doivent être utilisées que dans les interruptions de page.)

Importation graphique
gropdf prend uniquement en charge l'importation d'autres fichiers PDF en tant que graphiques. Mais ce fichier PDF peut contenir
l'un des formats graphiques pris en charge par la norme PDF (tels que JPEG, PNG, GIF, etc.).
Ainsi, toute application qui génère un PDF peut être utilisée comme fichier intégré dans gropdf. Le PDF
le fichier que vous souhaitez insérer doit être une seule page et le dessin doit juste tenir à l'intérieur du
la taille du support du fichier PDF. Alors, dans Inkscape(1) ou Gimp(1) (par exemple) assurez-vous que le
la taille de la toile correspond juste à l'image.

L'analyseur PDF utilisé dans gropdf n'a pas été rigoureusement testé avec toutes les
applications qui produisent des PDF. Si vous trouvez un PDF d'une seule page qui ne parvient pas à s'importer
correctement, cela vaut la peine de le parcourir pdftk(1) programmer en lançant la commande :

pdftk ancienfichier.pdf sortie nouveaufichier.pdf

Vous pouvez trouver que nouveaufichier.pdf va maintenant se charger avec succès.

TrueType ainsi que autre fonte formats
gropdf ne prend en charge aucune autre police que Adobe Type 1 (PFA ou PFB).

POLICE INSTALLATION

Cette section donne un résumé des explications ci-dessus; il peut servir d'étape par étape
guide d'installation des polices pour gropdf.

· Convertissez votre police en quelque chose que groff comprend. Il s'agit soit d'un PostScript Type 1
police au format PFA ou PFB, avec un fichier AFM.

La toute première ligne d'un fichier PFA/PFB contient ceci :

%!PS-AdobeFont-1.0 :

Un fichier PFB a également ceci dans la première ligne, mais la chaîne est précédée de quelques
octets binaires.

· Convertissez le fichier AFM en un fichier de description de police groff avec le afmtodit(1) programme.
Un exemple d'appel est

afmtodit Foo-Bar-Bold.afm map/textmap FBB

qui convertit le fichier métrique 'Foo-Bar-Bold.afm' en police groff 'FBB'. Si tu
avoir une famille de polices qui vient avec des polices normales, gras, italiques et gras italiques, c'est
recommandé d'utiliser les lettres R, B, Iet BI, respectivement, comme suffixes dans le
les noms de polices groff pour que la requête '.fam' de groff fonctionne. Un exemple est la fonction intégrée de groff
Police Times-Roman : le nom de la famille de police est T, et les noms de police groff sont TR, TB, TI,
ainsi que TBI.

· Installez à la fois les fichiers de description des polices groff et les polices dans un sous-répertoire 'devpdf'
du chemin de police que groff trouve. Voir le ENVIRONNEMENT section dans le trof(1) homme
page qui répertorie la valeur réelle du chemin de la police. Notez que groff n'utilise pas le
fichiers AFM (mais c'est quand même une bonne idée de les stocker).

· Enregistrez toutes les polices qui doivent être téléchargées sur l'imprimante dans le 'devpdf/download'
déposer. Seule la première occurrence de ce fichier dans le chemin de la police est lue. Ça signifie
que vous devez copier le fichier 'téléchargement' par défaut dans le premier répertoire de votre police
chemin et ajoutez vos polices là-bas. Pour continuer l'exemple ci-dessus, nous supposons que le PS
le nom de la police pour Foo-Bar-Bold.pfa est « XY-Foo-Bar-Bold » (le nom de la police PS est stocké dans le
Nom interne champ dans le fichier 'FBB') et appartient à la fonderie 'Fcq] donc ce qui suit
la ligne doit être ajoutée à « télécharger » :

F XY-Foo-Bar-Gras Foo-Bar-Bold.pfa

Utilisez un caractère de tabulation pour séparer les champs, et le champ "fonderie" doit être nul pour
la fonderie par défaut.

ENVIRONNEMENT

GROFF_FONT_PATH
Une liste de répertoires dans lesquels rechercher le devprénom répertoire en plus de
ceux par défaut. Si, dans le fichier 'télécharger', le fichier de police a été spécifié
avec un chemin complet, aucun répertoire n'est recherché. Voir trofde Géographie (1) et avec la groff_font(5) pour
plus de détails.

SOURCE_DATE_EPOCH
Un horodatage (exprimé en secondes depuis l'époque Unix) à utiliser comme création
horodatage à la place de l'heure actuelle.

Utilisez gropdf en ligne en utilisant les services onworks.net