pdfroff - En ligne dans le Cloud

PROGRAMME:

Nom

pdfroff - créer des documents PDF en utilisant groff

SYNOPSIS

pdfroff [-abcegilpstzCEGNRSUVXZ] [-d cs] [-f fam] [-F dir] [-I dir] [-L arg] [-m prénom]
[-M dir] [-n num] [-o liste] [-P arg] [-r cn] [-T dev] [-w prénom] [-W prénom]
[--emit-ps] [--no-toc-déménagement] [--no-kill-null-pages] [--feuille de style=prénom]
[--no-pdf-sortie] [--pdf-sortie=prénom] [--no-dictionnaire-de-référence]
[--dictionnaire-de-référence=prénom] [--report-progression] [--keep-fichiers-temporaires] filet

pdfroff -h | --Aidez-moi
pdfroff -v | --version [option ]

DESCRIPTION

pdfroff est un programme wrapper pour le système de traitement de texte GNU, groff. Il en toute transparence
gère la mécanique des passes multiples groff traitement, lorsqu'il est appliqué sur des surfaces convenablement marquées
up groff les fichiers source, de sorte que les tables des matières et le corps du texte soient formatés
séparément, et sont ensuite combinés dans le bon ordre, pour la publication finale en tant que
document PDF unique. Une autre capacité facultative de « feuille de style » est fournie ; Ceci permet
pour la définition du contenu qui doit précéder la table des matières, dans le
document publié.

Pour chaque invocation de pdfroff, l'ultime groff le flux de sortie est post-traité par le
Interpréteur GhostScript, pour produire un document PDF fini.

pdfroff ne fait aucune supposition et n'impose aucune restriction quant à l'utilisation de tout groff
packages de macros que l'utilisateur peut choisir d'employer, afin d'obtenir un document souhaité
format; Cependant, il inclure un support spécifique intégré pour le marque pdf paquet de macros,
si l'utilisateur choisit de l'employer. Plus précisément, si le pdfhref macro, définie dans le
pdfmark.tmac package, est utilisé pour définir des marques de référence publiques, ou des liens dynamiques vers de telles
repères, puis pdfroff effectue autant de préformatage groff passe au besoin, jusqu'à
jusqu'à une limite maximale de quatre, afin de constituer un dictionnaire de référence documentaire, à
résoudre les références et étendre le contenu défini dynamiquement des liens.

UTILISATION

La ligne de commande est analysée conformément aux conventions GNU normales, mais avec un
exception — lors de la spécification d'une option de forme courte (c'est-à-dire une option à un seul caractère
introduit par un seul trait d'union), et si cette option attend un argument, alors elle doit be
spécifié indépendamment (c'est-à-dire qu'il peut pas être ajouté à n'importe quel groupe d'autres
options de forme abrégée de caractères).

Les noms d'options de forme longue (c'est-à-dire ceux introduits par un double trait d'union) peuvent être abrégés en
leur sous-chaîne initiale sans ambiguïté de longueur minimale.

Dans le cas contraire, pdfroff l'utilisation reflète étroitement celle de groff lui-même. En effet, à l'exception
des -h, -v et -T dev les options de forme courte et toutes les options de forme longue, qui sont analysées
en interne par pdfroff, toutes les options et arguments de nom de fichier spécifiés sur la ligne de commande
sont transmis à groff, pour contrôler le formatage du document PDF. Par conséquent,
pdfroff accepte toutes les options et tous les arguments, comme spécifié dans groff(1), qui peut aussi être
considérée comme la référence définitive pour toutes les normes pdfroff options et arguments
usage.

OPTIONS

pdfroff accepte toutes les options de forme courte (c'est-à-dire celles introduites par un seul tiret),
qui sont disponibles avec groff lui-même. Dans la plupart des cas, ceux-ci sont simplement transmis
de manière transparente à groff; les éléments suivants, cependant, sont traités spécialement par pdfroff.

-h Pareil que --Aidez-moi; voir ci-dessous.

-i Traiter l'entrée standard, après tous les autres fichiers d'entrée spécifiés. C'est passé
de manière transparente à groff, mais, si elle est regroupée avec d'autres options, elle doit être le premier à
le groupe. Le cacher dans un groupe interrompt le traitement d'entrée standard, dans le
passe multiple groff contexte de traitement de pdfroff.

-T dev Plus que -T ps est soutenu par pdfroff. Tenter de spécifier tout autre périphérique provoque
pdfroff avorter.

-v Pareil que --version; voir ci-dessous.

See groff(1) pour une description de toutes les autres options de forme abrégée, qui sont de manière transparente
traversé pdfroff à groff.

Toutes les options de forme longue (c'est-à-dire celles introduites par un double trait d'union) sont interprétées localement
by pdfroff; elles sont pas transmis à groff, sauf indication contraire ci-dessous.

--Aidez-moi Causes pdfroff pour afficher un résumé de sa syntaxe d'utilisation et des options prises en charge,
puis sortie.

--emit-ps
Supprime l'étape de conversion de sortie finale, provoquant pdfroff émettre du PostScript
sortie au lieu de PDF. Cela peut être utile pour capturer un PostScript intermédiaire
sortie, lors de l'utilisation d'un postprocesseur spécialisé, tel que gprésent par exemple, dans
lieu du défaut GhostScript Rédacteur PDF.

--keep-fichiers-temporaires
Supprime la suppression des fichiers temporaires, qui se produit normalement après pdfroff a
formatage du document PDF terminé ; cela peut être utile, lors du débogage du formatage
problèmes.

Voir section DES DOSSIERS, pour une description des fichiers temporaires utilisés par pdfroff.

--no-pdf-sortie
Peut être utilisé avec le --dictionnaire-de-référence=prénom option (décrite ci-dessous) pour
éliminer les frais généraux de formatage PDF, lors de l'exécution pdfroff créer un
dictionnaire de référence, à utiliser dans un autre document.

--no-dictionnaire-de-référence
Peut être utilisé pour éliminer la surcharge de création d'un dictionnaire de référence, lorsqu'il
est connu que le document PDF cible ne contient aucune référence publique, créée par le
pdfhref macro.

--no-toc-déménagement
Peut être utilisé pour éliminer le surplus groff passe de traitement, qui est nécessaire pour
générer une table des matières, et la déplacer au début du document PDF,
lors du traitement de tout document dépourvu d'un tableau des
Contenu.

--no-kill-null-pages
Lors de la préparation de la simulation de l'étape de collation manuelle, qui est traditionnellement
nécessaire de déménager d'un table of contenu au début d'un document, pdfroff
accumule un certain nombre de descriptions de pages vides dans l'intermédiaire PostScript
flux de sortie. Lors de l'étape de collation finale, ces pages vides sont normalement
éliminé du document fini ; cette option force pdfroff de les laisser en
place.

--pdf-sortie=prénom
Spécifie le nom à utiliser pour le document PDF résultant ; si non spécifié, le
La sortie PDF est écrite sur la sortie standard. Une future version de pdfroff peut utiliser ce
option, pour encoder le nom du document dans un dictionnaire de référence généré.

--dictionnaire-de-référence=prénom
Spécifie le nom à utiliser pour le fichier de dictionnaire de référence généré ; si
non spécifié, le dictionnaire de référence est créé dans un fichier temporaire, qui est
supprimé lorsque pdfroff termine le traitement du document en cours. Cette option
doit être spécifié, si l'on souhaite sauvegarder le dictionnaire de référence, pour une utilisation dans
références placées dans d'autres documents PDF.

--report-progression
Causes pdfroff pour afficher un message d'information sur l'erreur standard, au démarrage
de chaque groff passe de traitement.

--feuille de style=prénom
Spécifie le nom d'un contribution filet, à utiliser comme feuille de style pour le formatage de
contenu, qui doit être placé avant la table des matières, au format PDF
document.

--version
Causes pdfroff pour afficher un message d'identification de version. L'ensemble de la commande
la ligne est ensuite transmise de manière transparente à groff, dans un UN passer l'opération uniquement, En ordre
pour afficher les associés groff informations de version, avant de quitter.

ENVIRONNEMENT

Les variables d'environnement suivantes peuvent être définies et exportées pour modifier le comportement de
pdfroff.

PDFROFF_COLLATE
Spécifie le programme à utiliser pour l'assemblage du document PDF fini.

Cette étape de collation peut être nécessaire pour déplacer les tables of contenu au début de la
document PDF fini, lors du formatage avec des packages de macros traditionnels, qui impriment
eux à la fin. Cependant, les utilisateurs ne devraient normalement pas avoir besoin de spécifier
PDFROFF_COLLATE, (et en effet, ne sont pas encouragés à le faire). Si non spécifié,
pdfroff Usages sed(1) par défaut, ce qui suffit normalement.

If PDFROFF_COLLATE is spécifié, alors il doit agir comme un filtre, en acceptant une liste de
arguments de nom de fichier, et écrire sa sortie dans le Stdout ruisseau, d'où il est canalisé
à la PDFROFF_POSTPROCESSOR_COMMAND, pour produire la sortie PDF finie.

Lors de la spécification PDFROFF_COLLATE, il est normalement nécessaire de spécifier également
PDFROFF_KILL_NULL_PAGES.

PDFROFF_COLLATE est ignoré, si pdfroff est invoqué avec le --no-kill-null-pages
option.

PDFROFF_KILL_NULL_PAGES
Spécifie les options à transmettre au PDFROFF_COLLATE .

Il ne devrait normalement pas être nécessaire de spécifier PDFROFF_KILL_NULL_PAGESL’
par défaut interne est un sed(1) script, qui est destiné à supprimer complètement vide
pages du flux de sortie assemblé, et qui devrait être approprié dans la plupart des
applications de pdfroff. Cependant, si une alternative à sed(1) est spécifié pour
PDFROFF_COLLATE, alors il est probable qu'une spécification alternative correspondante
pour PDFROFF_KILL_NULL_PAGES est nécessaire.

Comme dans le cas de PDFROFF_COLLATE, PDFROFF_KILL_NULL_PAGES est ignoré, si pdfroff
est invoqué avec le --no-kill-null-pages option.

PDFROFF_POSTPROCESSOR_COMMAND
Spécifie la commande à utiliser pour la conversion finale du document à partir de PostScript
sortie intermédiaire au format PDF. Il doit se comporter comme un filtre, écrivant sa sortie dans le
Stdout et doit accepter un nombre arbitraire de fichiers arguments, avec le
cas particulier de - représentant le Stdin ruisseau.

Si non spécifié, PDFROFF_POSTPROCESSOR_COMMAND Par défaut

gs -dLOT -dCALME -dPAUSE -dSAFER -sDEVICE=pdfécrire -sFichierSortie=-

GROFF_TMPDIR
Identifie le répertoire dans lequel pdfroff devrait créer des fichiers temporaires. Si
GROFF_TMPDIR is pas spécifié, puis les variables TMPDIR, TMP ainsi que TEMP are
considérés à leur tour, comme d'éventuels référentiels de fichiers temporaires. Si aucun de ces éléments n'est
défini, les fichiers temporaires sont créés dans le répertoire courant.

GROFF_GHOSTSCRIPT_INTERPRETER
Spécifie le programme à appeler, lorsque pdfroff convertis groff Sortie PostScript
en PDF. Si PDFROFF_POSTPROCESSOR_COMMAND est spécifié, puis le nom de la commande il
spécifie est implicitement assigné à GROFF_GHOSTSCRIPT_INTERPRETER, annulant tout
paramètre explicite spécifié dans l'environnement. Si GROFF_GHOSTSCRIPT_INTERPRETER is
pas spécifié, alors pdfroff recherche le processus PATH, à la recherche d'un programme avec
l'un des noms bien connus de l'interpréteur GhostScript ; si pas de GhostScript
interprète peut être trouvé, pdfroff avorte.

GROFF_AWK_INTERPRÈTE
Spécifie le programme à appeler, lorsque pdfroff extrait la référence
entrées de dictionnaire d'un groff flux de messages intermédiaire. Si
GROFF_AWK_INTERPRÈTE n'est pas spécifié, alors pdfroff recherche le processus PATH,
rechercher l'un des programmes préférés, 'gawk', 'mawk', 'nawk' et awk', dans
cet ordre; si aucun de ceux-ci n'est trouvé, pdfroff émet un message d'avertissement et
continuer le traitement ; cependant, dans ce cas, aucun dictionnaire de référence n'est créé.

OSTYPE Généralement défini automatiquement par le système d'exploitation, OSTYPE est utilisé sur
Plateformes Microsoft Win32/MS-DOS uniquement, pour déduire la valeur par défaut CHEMIN_SEPARATEUR
caractère, qui est utilisé lors de l'analyse du processus PATH rechercher des externes
programmes d'aide.

CHEMIN_SEPARATEUR
Si défini, CHEMIN_SEPARATEUR remplace le caractère de séparation par défaut, (':' sur
Les systèmes POSIX/UNIX, déduits de OSTYPE sur Microsoft Win32/MS-DOS), qui est utilisé
lors de l'analyse du processus PATH pour rechercher des programmes d'aide externes.

SHOW_PROGRESS
S'il est défini sur une valeur non vide, alors pdfroff se comporte toujours comme si le
--report-progression option est spécifiée, sur la ligne de commande.

Utilisez pdfroff en ligne en utilisant les services onworks.net