groff - Online en la nube

PROGRAMA:

NOMBRE

groff: interfaz para el sistema de formato de documentos de groff

SINOPSIS

grof [-abcegijklpstzCEGNRSUVXZ] [-d cs] [-D arg] [-f hambre] [-F dir] [-I dir] [-K arg]
[-L arg] [-m nombre ] [-M dir] [-n número] [-o lista] [-P arg] [-r cn] [-T dev] [-w nombre ]
[-W nombre ] [presentar ...]
grof -h | --ayuda
grof -v | --versión [opción ...]

DESCRIPCIÓN

Este documento describe el grof programa, el front-end principal para el grof documento
sistema de formateo. los grof programa y macro suite es la implementación de un roff(7)
sistema dentro de la colección de software libre GNU ⟨http://www.gnu.org⟩. los grof sistema tiene
todas las características del clásico roff, pero agrega muchas extensiones.

El grof programa permite controlar todo grof sistema por opciones de línea de comando. Esta
es una gran simplificación en comparación con el caso clásico (que solo usa tuberías).

CAMPUS

La línea de comandos se analiza de acuerdo con la convención GNU habitual. El espacio en blanco entre
una opción de línea de comando y su argumento es opcional. Las opciones se pueden agrupar detrás de un
solo '-' (carácter menos). Un nombre de archivo de - (carácter menos) denota el estándar
entrada.

As grof es un programa contenedor para troff ambos programas comparten un conjunto de opciones. Pero el
grof El programa tiene algunas opciones nativas adicionales y le da un nuevo significado a algunos troff
opciones. Por otro lado, no todos troff las opciones se pueden introducir en grof.

Nativo grof Opciones
Las siguientes opciones no existen para troff o son interpretados de manera diferente por
grof.

-D arg Establecer la codificación de entrada predeterminada utilizada por preconv. a arg. Implica -k.

-e Preprocesar con eqn.

-g Preprocesar con grn.

-G Preprocesar con grap. Implica -p.

-h
--ayuda Imprime un mensaje de ayuda.

-I dir Esta opción se puede utilizar para especificar un directorio para buscar archivos (ambos en
la línea de comando y los nombrados en .psbb y .asi que solicitudes, y \ X'ps: importar' y
\ X'ps: expediente' escapa). El directorio actual siempre se busca primero. Esta
la opción se puede especificar más de una vez; los directorios se buscan en el orden
especificado. No se realiza ninguna búsqueda de directorio para los archivos especificados mediante un valor absoluto.
sendero. Esta opción implica la -s .

-j Preprocesar con química. Implica -p.

-k Preprocesar con preconv.. Esto se ejecuta antes que cualquier otro preprocesador. Consulte
a preconv.la página del manual para conocer su comportamiento si no -K (o -D) se especifica la opción.

-K arg Establecer la codificación de entrada utilizada por preconv. a arg. Implica -k.

-l Envíe la salida a un programa de cola para imprimir. El comando que debe usarse
porque esto está especificado por el Imprimir comando en el archivo de descripción del dispositivo, consulte
groff_font(5). Si este comando no está presente, la salida se canaliza al lpr(1)
programa por defecto. Ver opciones -L y -X.

-L arg Aprobado arg al programa spooler. Varios argumentos deben pasarse con un
opción -L separada cada uno. Tenga en cuenta que grof no antepone '-' (un signo menos) a
arg antes de pasarlo al programa spooler.

-N No permita nuevas líneas dentro eqn delimitadores. Este es el mismo que el -N en opción
eqn.

-p Preprocesar con foto.

-P -Opción
-P -Opción -P arg
Aprobado -Opción or -Opción arg al postprocesador. La opción debe especificarse
con el signo (s) menos previo necesario (s) '-' o '-' porque grof no
anteponga los guiones antes de pasarlo al postprocesador. Por ejemplo, para pasar un
título de la vistagxdit postprocesador, el comando de shell

groff -X -P -title -P 'groff it' foo

es equivalente a

gruñir -X -Z foo | gxditview -title 'groff it' -

-R Preprocesar con remitir. No se proporciona ningún mecanismo para pasar argumentos a remitir
porque la mayoría remitir las opciones tienen elementos de lenguaje equivalentes que se pueden especificar
dentro del documento. Ver remitir(1) para más detalles.

-s Preprocesar con solim.

-S Modo más seguro. Pasa el -S opción de foto y deshabilite lo siguiente troff peticiones:
abierto, .abre un, .pso, .syy .Pi. Por razones de seguridad, el modo más seguro está habilitado por
predeterminado.

-t Preprocesar con tbl.

-T dev Establecer el dispositivo de salida en dev. Para este dispositivo, troff genera el intermedio
salida; ver groff_fuera(5). Luego grof llama a un postprocesador para convertir troff's
intermedio salida a su formato final. Dispositivos reales en grof en

formato dvi TeX DVI (el posprocesador es Grodvi).

html
xhtml Salida HTML y XHTML (los preprocesadores son solim y pre-grohtml,
postprocesador es post-grohtml).

lbp Impresoras Canon CAPSL (impresoras láser de las series LBP-4 y LBP-8;
postprocesador es grolbp).

lj4 Impresoras compatibles con HP LaserJet4 (u otras impresoras compatibles con PCL5)
(el posprocesador es grolj4).

ps Salida PostScript (el postprocesador es tanteos).

pdf Salida en formato de documento portátil (PDF) (el posprocesador Gropdf).

Para los siguientes dispositivos de salida TTY (el posprocesador siempre sucio), -T selecciona
la codificación de salida:

ascii de 7 bits ASCII.

cp1047 Juego de caracteres Latin-1 para hosts EBCDIC.

latín1 ISO 8859-1.

utf8 Juego de caracteres Unicode en codificación UTF-8. Este modo tiene la mayor
fuentes útiles para el modo TTY, por lo que es el mejor modo para la salida TTY.

Los siguientes argumentos seleccionan vistagxdit como el 'postprocesador' (es más bien un
programa de visualización):

Resolución X75 de 75 ppp, fuente base de documentos de 10 puntos.

X75-12 Resolución de 75 ppp, fuente de base de documentos de 12 puntos.

Resolución X100 de 100 ppp, fuente base de documentos de 10 puntos.

X100-12
Resolución de 100 ppp, fuente base de documentos de 12 puntos.

El dispositivo predeterminado es ps.

-U Modo inseguro. Vuelve al (antiguo) comportamiento inseguro; ver opcion -S.

-v
--versión
Información de la versión de salida de grof y de todos los programas que ejecuta; ese
es decir, la línea de comando dada se analiza de la forma habitual, pasando -v para todos
subprogramas.

-V Salida de la tubería que sería ejecutada por grof (como un programa de envoltura) en el
salida estándar, pero no la ejecute. Si se dan más de una vez, los comandos se
ambos impresos en el error estándar y ejecutados.

-X Uso vistagxdit en lugar de usar el postprocesador habitual para (pre) ver un documento.
El comportamiento de la cola de impresión como se describe con las opciones -l y -L se traslada a
vistagxdit(1) determinando un argumento para la -comando de impresión opción de
vistagxdit(1). Esto establece el valor predeterminado Imprimir acción y la entrada de menú correspondiente
a ese valor. -X solo produce buenos resultados con -Tps, -TX75, -TX75-12, -TX100,
y -TX100-12. La resolución predeterminada para la vista previa -Tps la salida es de 75 ppp; esta
se puede cambiar pasando el -resolución opción de vistagxdit, Por ejemplo

groff -X -P-resolución -P100 -man foo.1

-z Suprime la salida generada por troff. Solo se imprimen los mensajes de error.

-Z No posprocesar automáticamente grof intermedio salida de la manera habitual.
Esto causará troff salida para aparecer en la salida estándar, reemplazando el habitual
salida del postprocesador; ver groff_fuera(5).

Transparente Opciones
Las siguientes opciones se entregan de forma transparente al programa formateador troff que sea
llamado por grof después. Estas opciones se describen con más detalle en troff(1).

-a Aproximación ASCII de salida.

-b Retroceda en caso de error o advertencia.

-c Desactiva la salida de color. Por favor consulte el sucio(1) página de manual para obtener más detalles.

-C Habilite el modo de compatibilidad.

-d cs
-d nombre =s
Definir cadena.

-E Deshabilitar troff error de mensajes.

-f hambre Establecer la familia de fuentes predeterminada.

-F dir Establezca la ruta para los archivos de fuente DESC.

-i Procesar la entrada estándar después de los archivos de entrada especificados.

-m nombre
Incluir archivo de macro nombre .tmac (o tmac.nombre ); ver también groff_tmac(5).

-M dir Ruta de los archivos de macros.

-n número Numere la primera página número.

-o lista
Salida solo páginas en lista.

-r cn
-r nombre =n
Establecer registro de número.

-w nombre
Habilitar advertencia nombre . Vea troff(1) para nombres.

-W nombre
deshabilitar advertencia nombre . Vea troff(1) para nombres.

USO GROFF

El grof te implementa la infraestructura de roff clásico; ver roff(7) para una encuesta
sobre cómo un roff El sistema funciona en general. Debido a los programas de front-end disponibles en el
grof sistema, usando grof es mucho más fácil que clásico roff. Esta sección da una
resumen de las partes que constituyen el grof sistema. Complementa roff(7) con
grof-características específicas. Esta sección se puede considerar como una guía para la documentación.
alrededor del grof .

Papel Tamaño
El virtual tamaño de papel utilizado por troff para formatear la entrada se controla globalmente con el
solicitudes .correos, .ply .ll. Vea groff_tmac(5) para el paquete de macros 'tamaño de papel' que
proporciona una interfaz conveniente.

El los libros físicos el tamaño del papel, que da las dimensiones reales de las hojas de papel, está controlado
por dispositivos de salida como tanteos con las opciones de la línea de comando -p y -l. Vea groff_font(5)
y las páginas de manual de los dispositivos de salida para obtener más detalles. grof usa la línea de comando
opción -P para pasar opciones a los dispositivos de salida; por ejemplo, lo siguiente selecciona papel A4
en orientación horizontal para el dispositivo PS:

groff -Tps -P-pa4 -Pl ...

Frente termina
El grof programa es un envoltorio alrededor del troff(1) programa. Permite especificar el
preprocesadores por opciones de línea de comando y ejecuta automáticamente el postprocesador que es
apropiado para el dispositivo seleccionado. Al hacerlo, el a veces tedioso mecanismo de tuberías de
clásico roff(7) puede evitarse.

El ponche(1) programa se puede utilizar para adivinar la grof línea de comando para formatear un
archivo.

El Groffer(1) el programa es un visor completo para grof archivos y páginas de manual.

Preprocesadores
El grof Los preprocesadores son reimplementaciones de los preprocesadores clásicos con moderado
extensiones. Los preprocesadores estándar distribuidos con el grof paquete son

eqn(1) para fórmulas matemáticas,

grn(1) para incluir duendecillo(1) imágenes,

foto(1) para dibujar diagramas,

química(1)
para diagramas de estructura química,

remitir(1)
para referencias bibliográficas,

solim(1)
para incluir archivos de macros de ubicaciones estándar,

y

tbl(1) para mesas.

Un nuevo preprocesador no disponible en clásico troff is preconv.(1) que convierte varios
codificaciones de entrada a algo grof puedo entender. Siempre se ejecuta primero antes que cualquier
otro preprocesador.

Además de estos, hay algunos preprocesadores internos que se ejecutan automáticamente con algunos
dispositivos. Estos no son visibles para el usuario.

Macro Buceo y Alojamiento
Los paquetes de macros se pueden incluir opcionalmente -m. grof El sistema implementa y amplía todos
paquetes de macros clásicos de una manera compatible y agrega algunos paquetes propios. Realmente,
los siguientes paquetes de macros vienen con grof:

hombre El formato de página de manual tradicional; ver groff_man(7). Puede especificarse en el
línea de comando como -hombre or -m hombre.

mandoc El paquete general para páginas de manual; reconoce automáticamente si el
documentos utiliza el hombre o de mdoc formato y ramificaciones a la macro correspondiente
paquete. Se puede especificar en la línea de comando como -mandoc or -m mandoc.

mdoc El formato de página de manual de estilo BSD; ver groff_mdoc(7). Puede especificarse en el
línea de comando como -mdoc or -m mdoc.

me El clasico me formato de documento; ver groff_me(7). Puede especificarse en el
línea de comando como Me or -m me.

mm El clasico mm formato de documento; ver groff_mm(7). Puede especificarse en el
línea de comando como -mm or -m mm.

ms El clasico ms formato de documento; ver groff_ms(7). Puede especificarse en el
línea de comando como -em or -m ms.

www Macros similares a HTML para su inclusión en arbitrarias grof documentos; ver groff_www(7).

Los detalles sobre el nombre de los archivos de macros y su ubicación se pueden encontrar en groff_tmac(5);
esta página de manual también documenta algunos otros paquetes de macros auxiliares menores no mencionados
haga clic aquí

Programación Idioma
Conceptos generales comunes a todos roff Los lenguajes de programación se describen en roff(7).

El grof extensiones a lo clásico troff el idioma está documentado en groff_diff(7).

El grof el lenguaje en su conjunto se describe en el (todavía incompleto) grof info presentar; Un
Se puede encontrar una referencia breve (pero completa) en grof(7).

Formateadores
El central roff formateador dentro del grof sistema es troff(1). Proporciona las características
de ambos el clásico troff y nroff, Así como la grof extensiones. La linea de comando
opción -C interruptores troff dentro compatibilidad modo que intenta emular el clásico roff as
tanto como sea posible.

Hay un script de shell nroff(1) que emula el comportamiento de los clásicos nroff. Intenta
para seleccionar automáticamente la codificación de salida adecuada, de acuerdo con la configuración regional actual.

El programa formateador genera intermedio salida; ver groff_fuera(7).

Dispositivos
In roff, los objetivos de salida se llaman Médicos. Un dispositivo puede ser una pieza de hardware,
por ejemplo, una impresora o un formato de archivo de software. Un dispositivo se especifica mediante la opción -T.
grof los dispositivos son los siguientes.

ascii Salida de texto usando el ascii(7) juego de caracteres.

cp1047 Salida de texto utilizando la página de códigos EBCDIC IBM cp1047 (por ejemplo, OS / 390 Unix).

Dvi Formato TeX DVI.

html Salida HTML.

latin1 Salida de texto utilizando el conjunto de caracteres ISO Latin-1 (ISO 8859-1); ver iso_8859_1(7).

libra Salida para impresoras Canon CAPSL (impresoras láser de las series LBP-4 y LBP-8).

lj4 Impresoras compatibles con HP LaserJet4 (u otras impresoras compatibles con PCL5).

ps Salida PostScript; adecuado para impresoras y previsualizadores como gv(1).

pdf Archivos PDF; adecuado para ver con herramientas como mostrar(1) y flechas(1).

utf8 Salida de texto con el juego de caracteres Unicode (ISO 10646) con codificación UTF-8; ver
Unicode(7).

xhtml Salida XHTML.

X75 Salida del sistema X Window de 75 ppp adecuada para los espectadores xditview(1x) y
vistagxdit(1). Una variante para una fuente base de documentos de 12 puntos es X75-12.

X100 Salida del sistema X Window de 100 ppp adecuada para los espectadores xditview(1x) y
vistagxdit(1). Una variante para una fuente base de documentos de 12 puntos es X100-12.

El posprocesador que se utilizará para un dispositivo lo especifica el pospro comando en el
archivo de descripción de dispositivo; ver groff_font(5). Esto se puede anular con el -X .

El dispositivo predeterminado es ps.

Postprocesadores
grof proporciona 3 posprocesadores de hardware:

grolbp(1)
para algunas impresoras Canon,

grolj4(1)
para impresoras compatibles con HP LaserJet 4 y PCL5,

sucio(1)
para la salida de texto usando varias codificaciones, por ejemplo, en terminales orientados al texto o en línea
Las impresoras.

Hoy en día, la mayor parte del hardware de impresión o dibujo es manejado por el sistema operativo, por dispositivo.
controladores, o por interfaces de software, que generalmente aceptan PostScript. En consecuencia, hay
no es una necesidad urgente de más posprocesadores de dispositivos de hardware.

El grof Los dispositivos de software para la conversión a otros formatos de archivos de documentos son

Grodvi(1)
para el formato DVI,

Grohtml(1)
para formatos HTML y XHTML,

tanteos(1)
para PostScript.

Gropdf(1)
para PDF.

Combinado con las muchas herramientas de conversión gratuitas existentes, esto debería ser suficiente para convertir
a troff documento en prácticamente cualquier formato de datos existente.

Departamento de Servicios Públicos
Los siguientes programas de utilidad grof están disponibles.

agregar info(1)
Agregar información a troff archivos de descripción de fuente para usar con grof.

afmtodit(1)
Cree archivos de descripción de fuentes para dispositivos PostScript.

ecuación 2(1)
Convertir un eqn imagen en una imagen recortada.

gdiffmk(1)
Marque las diferencias entre grof, nroffo troff archivos.

grap2grafo(1)
Convertir un grap diagrama en una imagen de mapa de bits recortada.

Groffer(1)
Programa de visor general para grof archivos y páginas de manual.

vistagxdit(1)
El grof X viewer, la versión GNU de xditview.

hpfteditar(1)
Cree archivos de descripción de fuentes para el dispositivo lj4.

indxbib(1)
Hacer índice invertido para bases de datos bibliográficas.

bibib(1)
Búsqueda en bases de datos bibliográficas.

mirarbib(1)
Búsqueda interactiva en bases de datos bibliográficas.

pdfoff(1)
Cree documentos PDF usando grof.

pfbtops(1)
Traduzca una fuente PostScript en formato .pfb a ASCII.

pic2grafo(1)
Convertir un foto diagrama en una imagen recortada.

tfmtodit(1)
Cree archivos de descripción de fuentes para el dispositivo TeX DVI.

xditview(1x)
roff visor distribuido con ventana X.

xtotroff(1)
Convierta métricas de fuentes X en GNU troff métricas de fuentes.

MEDIO AMBIENTE

Normalmente, el separador de ruta en las siguientes variables de entorno son los dos puntos; esto puede
varían según el sistema operativo. Por ejemplo, DOS y Windows usan un punto y coma
preferiblemente.

GROFF_BIN_PATH
Esta ruta de búsqueda, seguida de $ RUTA, se usa para comandos que son ejecutados por
grof. Si no está configurado, entonces el directorio donde grof se instalaron binarios
se antepone a TRAYECTORIA.

GROFF_COMMAND_PREFIX
Cuando es necesario ejecutar diferentes roff implementaciones al mismo tiempo grof
proporciona la posibilidad de anteponer un prefijo a la mayoría de sus programas que podrían
provocar conflictos de nombres en tiempo de ejecución (el valor predeterminado es no tener ninguno). Históricamente, este
el prefijo era el personaje g, pero puede ser cualquier cosa. Por ejemplo, gtroff defender a
grof's troff, gbl para grof versión de tbl. Configurando GROFF_COMMAND_PREFIX
a diferentes valores, los diferentes roff las instalaciones se pueden abordar. Más
exactamente, si está configurado como prefijo xxx luego grof como un programa de envoltura internamente
llamadas xxxtroff en lugar de troff. Esto también se aplica a los preprocesadores. eqn, grn,
foto, remitir, tbl, solim, y a las utilidades indxbib y mirarbib. Esta característica
no se aplica a ningún programa diferente de los anteriores (más notablemente grof
en sí) ya que son exclusivos del grof paquete.

GROFF_ENCODIFICACIÓN
El valor de este valor de entorno se pasa al preconv. preprocesador para seleccionar
la codificación de archivos de entrada. Establecer esta opción implica groflínea de comando de
opción -k (esto es, grof en realidad siempre llama preconv.). Si se establece sin un valor,
grof llamadas preconv. sin argumentos. Un explícito -K opción de línea de comando
anula el valor de GROFF_ENCODIFICACIÓN. Vea preconv.(1) para obtener más detalles.

GROFF_FONT_PATH
Una lista de directorios en los que buscar el devnombre directorio además de
los predeterminados. Ver troff(1) y groff_font(5) para más detalles.

GROFF_TMAC_RUTA
Una lista de directorios en los que buscar archivos de macros además de los predeterminados
directorios. Ver troff(1) y groff_tmac(5) para más detalles.

GROFF_TMPDIR
El directorio en el que se crean los archivos temporales. Si esto no está configurado pero el
Variable ambiental TMPDIR en cambio, los archivos temporales se crean en el directorio
$ TMPDIR. En plataformas MS-DOS y Windows 32, las variables de entorno TMP y
TEMP (en ese orden) también se buscan, después de GROFF_TMPDIR y TMPDIR. De otra manera,
los archivos temporales se crean en / Tmp. remitir(1) Groffer(1) Grohtml(1), y
tanteos(1) los comandos utilizan archivos temporales.

GROFF_TYPESETER
Configura el dispositivo predeterminado. Si esto no está configurado ps dispositivo se utiliza por defecto.
Este nombre de dispositivo se sobrescribe con la opción -T.

EJEMPLOS

El siguiente ejemplo ilustra el poder del grof programa como envoltorio
troff.

Para procesar un roff archivo usando los preprocesadores tbl y foto y del me conjunto de macros, clásico
troff Tuvo que ser llamado por

pic foo.me | tbl | troff -me -Tlatin1 | sucio

Usar grof, esta tubería se puede acortar al comando equivalente

groff -p -t -me -T latin1 foo.me

Una forma aún más fácil de llamar a esto es usar ponche(1) para adivinar el preprocesador y la macro
opciones y ejecute el comando generado (utilizando comillas inversas para especificar el comando de shell
sustitución)

`grog -Tlatin1 foo.me`

La forma más sencilla es ver el contenido de forma automatizada llamando

groffer foo.me

Utilice groff en línea utilizando los servicios de onworks.net