gropdf - Online en la nube

PROGRAMA:

NOMBRE

gropdf - controlador PDF para groff

SINOPSIS

Gropdf [-delv] [-F dir] [-p Tamaño de papel] [-y fundición] [-u [archivo de mapa]] [archivos ...]

Es posible tener espacios en blanco entre una opción de línea de comando y su parámetro.

DESCRIPCIÓN

Gropdf traduce la salida de GNU troff a PDF. Normalmente Gropdf debe ser invocado por
usando el comando groff con un -Tpdf opción. Si no se dan archivos, Gropdf lee el
entrada estándar. Un nombre de archivo de - también causa Gropdf para leer la entrada estándar. PDF
la salida se escribe en la salida estándar. Cuando Gropdf está dirigido por grof las opciones pueden ser
pasó a Gropdf usando grof's -P .

Mira la sección FUENTE INSTALACIÓN a continuación para obtener una guía sobre cómo instalar fuentes para Gropdf.

CAMPUS

-d Incluya información de depuración como comentarios en el PDF. También produce un
PDF sin comprimir.

-e Obligue a que todas las fuentes se incrusten en el PDF.

-Fdir Anteponer directorio dir/ devnombre a la ruta de búsqueda de la fuente y la descripción del dispositivo
archivos; nombre es el nombre del dispositivo, normalmente pdf.

-l Imprima el documento en formato apaisado.

-pTamaño de papel
Establezca la dimensión física del medio de salida. Esto anula el Tamaño de papel,
longitud del papely ancho de papel comandos en el DESC expediente; acepta lo mismo
argumentos como el Tamaño de papel mando. Ver groff_font (5) para obtener más detalles.

-v Imprime el número de versión.

-yfundición
Configure la fundición que se utilizará para seleccionar fuentes del mismo nombre.

-e Fuerzas Gropdf para incrustar TODAS las fuentes (incluso las 14 fuentes PDF básicas).

-s Agregue una línea de comentario al final del PDF que muestre las estadísticas, es decir, el número de páginas en
documento. Ghostscript's ps2pdf se queja de esta línea si está incluida, pero
funciona de todos modos.

-u
-unombre de archivo cmap
Gropdf normalmente incluye un ToUnicode CMap con cualquier fuente creada usando texto.enc as
el archivo de codificación, esto facilita la búsqueda de palabras que contienen
ligaduras. Puede incluir su propio CMap especificando un nombre de archivo cmap o no tener
CMap en absoluto omitiendo el argumento.

USO

La entrada a Gropdf debe estar en el formato de salida por troff(1). Esto se describe en
groff_fuera(5).

Además, el dispositivo y los archivos de descripción de fuente para el dispositivo utilizado deben cumplir con ciertos
requisitos: La resolución debe ser un múltiplo entero de 72 veces el escala de tamaño.
pdf El dispositivo utiliza una resolución de 72000 y una escala de tamaño de 1000.

El archivo de descripción del dispositivo debe contener un tamaño de papel válido; ver groff_font(5) para más
información. Gropdf utiliza las mismas fuentes PostScript de Adobe Tipo 1 que tanteos dispositivo
conductor. Aunque el estándar PDF permite el uso de otros tipos de fuentes (como TrueType), esta
La implementación solo acepta la fuente PostScript Tipo 1. Se admiten menos fuentes Type 1
de forma nativa en documentos PDF que las 35 fuentes estándar admitidas por tanteos y toda la posdata
impresoras, pero todas las fuentes están disponibles, ya que las que no son compatibles de forma nativa son
incrustado automáticamente en el PDF.

Gropdf apoya el concepto de fundiciones, es decir, diferentes versiones de básicamente el mismo
fuente. Durante la instalación de un Fundición Controles de archivo dónde se encuentran y compila las fuentes. grof fuentes
de los archivos que descubre en su sistema.

Cada archivo de descripción de fuente debe contener un comando

nombreinterno psname

que dice que el nombre PostScript de la fuente es psname. Líneas que comienzan con # y
las líneas en blanco se ignoran. El código para cada carácter dado en el archivo de fuentes debe
corresponden al código en la codificación predeterminada de la fuente. Este código se puede utilizar con
las \N secuencia de escape en troff para seleccionar el personaje, incluso si el personaje no
tener un nombre groff. Cada carácter del archivo de fuente debe existir en la fuente PostScript,
y los anchos indicados en el archivo de fuente deben coincidir con los anchos utilizados en la fuente PostScript.

Tenga en cuenta que Gropdf actualmente solo puede mostrar los primeros 256 glifos en cualquier fuente. Esta
la restricción se levantará en una versión posterior.

Gropdf puede incluir automáticamente las fuentes descargables necesarias para imprimir el documento.
Las fuentes pueden estar en formato PFA o PFB.

Cualquier fuente descargable que, cuando sea necesario, deba ser incluida por Gropdf debe estar listado
en el archivo /usr/share/groff/1.22.3/font/devpdf/download; esto debe consistir en líneas de
la forma

fundición fuente nombre de archivo

donde fundición es el nombre de la fundición o la pieza en blanco de la fundición predeterminada. fuente son los
Nombre PostScript de la fuente y nombre de archivo es el nombre del archivo que contiene la fuente;
líneas que comienzan con # y las líneas en blanco se ignoran; los campos deben estar separados por tabulaciones
(los espacios son no permitido); nombre de archivo se busca utilizando el mismo mecanismo que se utiliza
para archivos de métricas de fuentes de groff. los descargar El archivo en sí también se busca para usar este
mecanismo; actualmente, solo se utiliza el primer archivo encontrado en la ruta de la fuente. Nombres de fundición
suelen ser un solo carácter (como 'U' para URW Foundry) o en blanco para el valor predeterminado
fundición. Este valor predeterminado utiliza las mismas fuentes que ghostscript utiliza cuando incrusta fuentes en un
Archivo PDF.

En la configuración predeterminada hay estilos llamados R, I, By BI montado en las posiciones de fuente 1
a 4. Las fuentes se agrupan en familias A, BM, C, H, HN, N, Py T tener miembros en
cada uno de estos estilos:

AR AvantGarde-Libro
AI Avant-Garde-BookOblique
AB Avant-Garde-Demi
ABI Avant-Garde-DemiOblique
BMR Bookman-Luz
IMC (Índice de masa corporal); Bookman-LightItalic
BMB Bookman-Demi
BMBBI Bookman-Demicursiva
CR Mensajería
CI Mensajero oblicuo
CB Mensajero-Negrita
CBI Courier-BoldOblique
HR Helvetica
HI Helvética-Oblicua
HB Helvética-Negrita
HBI Helvética-BoldOblique
HNR Helvética-Estrecha
HNI Helvética-Estrecha-Oblicua
HNB Helvetica-Estrecho-Negrita
HNB Helvética-estrecha-negrita oblicua
NR NewCenturySchlbk-Romano
NI NewCenturySchlbk-cursiva
NB NewCenturySchlbk-Negrita
NBI NewCenturySchlbk-BoldItalic
PR Palatino-romano
PI Palatino-itálico
PB Palatino-Negrita
PBI Palatino-NegritaItalico
TR tiempos romanos
TI Veces-cursiva
TB Times-Negrita
TBI Times-BoldItalic

También existe la siguiente fuente que no es miembro de una familia:

ZCMI ZapfChancery-MediumItalic

También hay algunas fuentes especiales llamadas S para la fuente PS Symbol. El griego minúsculo
los caracteres se inclinan automáticamente (para coincidir con la fuente SymbolSlanted (SS) disponible para
posdata). Zapf Dingbats está disponible como ZD, el glifo "mano apuntando a la izquierda" (\ [lh]) es
disponible ya que se ha definido usando la extensión \ X'pdf: xrev 'que invierte la
dirección de las letras dentro de las palabras.

El color predeterminado para \m y \M es negro; para colores definidos en el espacio de color 'rgb'
setrgbcolor se usa, para 'cmy' y 'cmyk' establecercmykcolor, y para 'gris' gris. Tenga en cuenta que
establecercmykcolor es un comando PostScript LanguageLevel 2 y, por lo tanto, no está disponible en algunos
Las impresoras.

Gropdf comprende algunos de los comandos X producidos utilizando el \X secuencias de escape compatibles
by tanteos. Específicamente, se admite lo siguiente.

\ X'ps: invis '
Suprime la salida.

\ X'ps: endinvis '
Deje de suprimir la salida.

\ X'ps: ejecutivo gsave punto actual 2 copia la traducción n rotar negativo intercambiar negativo intercambiar traducir'
donde n es el ángulo de rotación. Esto es para apoyar el alinear comando en gpic.

\ X'ps: ejecutivo grestore '
Nuevamente usado por gpic para restaurar después de la rotación.

\ X'ps: ejecutivo n setlinejoin '
donde n puede ser uno de los siguientes valores.

0 = unión a inglete
1 = Unión redonda
2 = unión biselada

\ X'ps: ejecutivo n setlinecap '
donde n puede ser uno de los siguientes valores.

0 = tapón trasero
1 = Tapón redondo y
2 = Casquete cuadrado saliente

\ X'ps: ... pdfmark '
Todos los pdfmarca macros instaladas usando -m pdfmarca or -m mspdf (ver documentación
en 'pdfmark.pdf'). Un subconjunto de estas macros se instala automáticamente cuando
utilizan el -Tpdf por lo que no debería necesitar usar '-m pdfmark' para usar la mayor parte del PDF
funcionalidad

Todos los demás PS: las etiquetas se ignoran silenciosamente.

Un \X También se reconoce el especial utilizado por el controlador DVI:

\ X'papersize =Tamaño de papel'
donde el Tamaño de papel parámetro es el mismo que el Tamaño de papel mando. Ver
groff_font(5) para obtener más detalles. Esto significa que puede modificar el tamaño de la página a voluntad.
dentro del archivo PDF creado por Gropdf. Si quieres cambiar el papel
tamaño, debe hacerlo antes de comenzar a crear la página.

Además, Gropdf admite su propio conjunto de pdf: etiquetas. Las siguientes etiquetas son
apoyado:

\ X'pdf: pdfpic presentar alineación anchura altura Longitud de la línea'
Coloque una imagen del especificado anchura que contiene el dibujo PDF del archivo presentar of
deseado anchura y altura (Si altura falta o es cero, entonces está escalado
proporcionalmente). Si alineación is -L el dibujo está alineado a la izquierda. Si esto es -C or
-R a Longitud de la línea también se requiere mayor que el ancho del dibujo. Si
anchura se especifica como cero, entonces el ancho se escala en proporción a la altura.

\ X'pdf: xrev '
Esto cambia una bandera que invierte la dirección de impresión carta by carta,
es decir, se invierte cada letra por separado, no la palabra completa. Esto es útil para
invertir la dirección de los glifos en la fuente Dingbats. Para volver a la normalidad
imprimiendo repita el comando nuevamente.

\ X'pdf: inicio de marca /ANA definición'
Las macros que admiten marcadores PDF utilizan esta llamada internamente para iniciar la
definición de punto de acceso a marcadores (el usuario habrá llamado '.pdfhref L' con el texto
que se convertirá en la región del 'punto caliente'). Normalmente esto nunca se usa excepto de
dentro de las macros pdfmark.

\ X'pdf: markend '
Las macros que admiten marcadores PDF utilizan esta llamada internamente para detener la
definición de punto de acceso a marcadores (el usuario habrá llamado '.pdfhref L' con el texto
que se convertirá en la región del 'punto caliente'). Normalmente esto nunca se usa excepto de
dentro de las macros pdfmark.

\ X'pdf: markuspend '
\ X'pdf: markrestart '
Si está utilizando trampas de página para producir encabezados, pies de página, etc., debe usar
estos en caso de que un 'punto caliente' cruce el límite de una página, de lo contrario, cualquier salida de texto por
la macro de rumbo o pie se marcará como parte del "punto caliente". Para detener
esto sucede solo coloque '.pdfmarksuspend' y '.pdfmarkrestart' al principio y
final de la macro de captura de página, respectivamente. (Estas son solo macros de conveniencia que
Emite el código \ X. Estas macros solo deben usarse dentro de las capturas de página).

Importador gráficos
Gropdf solo admite la importación de otros archivos PDF como gráficos. Pero ese archivo PDF puede contener
cualquiera de los formatos gráficos admitidos por el estándar PDF (como JPEG, PNG, GIF, etc.).
Por tanto, cualquier aplicación que genere PDF se puede utilizar como un archivo incrustado en Gropdf. El PDF
El archivo que desea insertar debe ser de una sola página y el dibujo debe caber dentro del
tamaño multimedia del archivo PDF. Entonces, en Inkscape(1) o cañutillo(1) (por ejemplo) asegúrese de que
El tamaño del lienzo se ajusta a la imagen.

El analizador de PDF utilizado en Gropdf no se ha probado rigurosamente con todos los posibles
aplicaciones que producen archivos PDF. Si encuentra un PDF de una sola página que no se puede importar
correctamente, vale la pena ejecutarlo en el pdftk(1) programa emitiendo el comando:

pdftk archivoviejo.pdf salida nuevoarchivo.pdf

Usted puede encontrar que nuevoarchivo.pdf ahora se cargará correctamente.

TrueType y otros fuente formatos
Gropdf no admite otras fuentes, excepto Adobe Type 1 (PFA o PFB).

FUENTE INSTALACIÓN

Esta sección ofrece un resumen de las explicaciones anteriores; puede servir como un paso a paso
guía de instalación de fuentes para Gropdf.

· Convierte tu fuente en algo que entienda groff. Este es un PostScript Tipo 1
fuente en PFA o PFB, junto con un archivo AFM.

La primera línea de un archivo PFA / PFB contiene esto:

%! PS-AdobeFont-1.0:

Un archivo PFB tiene esto también en la primera línea, pero la cadena está precedida por algunos
bytes binarios.

· Convierta el archivo AFM en un archivo de descripción de fuente groff con el afmtodit(1) programa.
Un ejemplo de llamada es

afmtodit Foo-Bar-Bold.afm mapa / mapa de texto FBB

que convierte el archivo métrico 'Foo-Bar-Bold.afm' a la fuente groff 'FBB'. Si tu
tienen una familia de fuentes que viene con caras normales, negrita, cursiva y negrita cursiva, es
recomendado usar las letras R, B, Iy BI, respectivamente, como sufijos en el
nombres de fuentes de groff para que funcione la solicitud '.fam' de groff. Un ejemplo es el incorporado de groff
Fuente Times-Roman: El nombre de la familia de fuentes es T, y los nombres de las fuentes de groff son TR, TB, TI,
y TBI.

· Instale los archivos de descripción de fuentes groff y las fuentes en un subdirectorio 'devpdf'
de la ruta de la fuente que encuentra groff. Ver el MEDIO AMBIENTE sección en el troff(1) hombre
página que enumera el valor real de la ruta de la fuente. Tenga en cuenta que groff no usa el
Archivos AFM (pero es una buena idea almacenarlos de todos modos).

· Registre todas las fuentes que deben descargarse a la impresora en 'devpdf / download'
expediente. Solo se lee la primera aparición de este archivo en la ruta de la fuente. Esto significa
que debe copiar el archivo de 'descarga' predeterminado al primer directorio de su fuente
ruta y agregue sus fuentes allí. Para continuar con el ejemplo anterior, asumimos que el PS
El nombre de la fuente para Foo-Bar-Bold.pfa es 'XY-Foo-Bar-Bold' (el nombre de la fuente PS se almacena en el
nombreinterno campo en el archivo 'FBB') y pertenece a la fundición 'Fcq], por lo que lo siguiente
La línea debe agregarse a 'descargar':

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

Use un carácter de tabulación para separar los campos, y el campo 'fundición' debe ser nulo para
la fundición por defecto.

MEDIO AMBIENTE

GROFF_FONT_PATH
Una lista de directorios en los que buscar el devnombre directorio además de
los predeterminados. Si, en el archivo 'descargar', se ha especificado el archivo de fuente
con una ruta completa, no se buscan directorios. Ver troff(1) y groff_font(5) para
más detalles.

FUENTE_FECHA_EPOCH
Una marca de tiempo (expresada en segundos desde la época de Unix) para usar como creación
marca de tiempo en lugar de la hora actual.

Use gropdf en línea usando los servicios de onworks.net