Este es el comando rubber que se puede ejecutar en el proveedor de alojamiento gratuito de OnWorks utilizando una de nuestras múltiples estaciones de trabajo en línea gratuitas, como Ubuntu Online, Fedora Online, emulador en línea de Windows o emulador en línea de MAC OS.
PROGRAMA:
NOMBRE
caucho: un sistema de construcción para documentos LaTeX
SINOPSIS
caucho [opciones] fuentes ...
tubería de goma [opciones]
DESCRIPCIÓN
El caucho es un envoltorio para LaTeX y programas complementarios. Su propósito es, dado un LaTeX
fuente al proceso, para compilarlo suficientes veces para resolver todas las referencias, posiblemente ejecutando
programas satelitales como BibTeX, makeindex, Metapost, etc. para producir datos apropiados
archivos.
El comando caucho construye los documentos especificados por completo. Los archivos de origen pueden ser
ya sea fuentes LaTeX (en cuyo caso se puede omitir el sufijo .tex) o documentos en un
formato Rubber sabe cómo traducir a LaTeX. Si una compilación falla, toda
el proceso se detiene, incluida la compilación de los siguientes documentos en la línea de comando, y
caucho devuelve un código de salida distinto de cero.
El comando tubería de goma hace lo mismo para un documento pero lee la fuente LaTeX de
entrada estándar y vuelca el documento compilado en la salida estándar.
Parte de la información no se puede extraer de las fuentes LaTeX. Este es el caso, para
ejemplo, con las rutas de búsqueda (que se pueden especificar en variables de entorno como
TEXINPUTS), o el estilo que se utilizará con Makeindex. Para abordar este problema, se puede agregar
información sobre el caucho en los comentarios de las fuentes de LaTeX, consulte la sección DIRECTIVAS.
OPCIONES
Las opciones se utilizan para elegir la acción a realizar o para configurar la
proceso de construcción. Son casi iguales en caucho y tubería de goma. Las opciones se analizan
utilizando las convenciones de GNU Getopt.
-B, --bzip2
Comprima el documento final (en bzip2 formato). Esto es equivalente a decir -o
bzip2 después de todas las demás opciones.
--limpio
Elimine todos los archivos producidos por la compilación, en lugar de crear el documento.
Esta opción está presente en caucho solamente. Se aplica a la compilación como lo haría
hacerse con las otras opciones de la línea de comando, es decir, diciendo "goma --limpiar
foo "no borrará foo.ps, mientras que decir" rubber --ps --clean foo "lo hará.
-C, --mando
Ejecuta el comando (o directiva) especificado antes analizar los archivos de entrada. Ver
. DIRECTIVAS para obtener más detalles.
-mi, --epílogo
Ejecuta el comando (o directiva) especificado después de analizar los archivos de entrada. Ver
. DIRECTIVAS para obtener más detalles.
-F, --fuerza
Fuerza al menos una compilación de la fuente. Esto puede resultar útil, por ejemplo, si
se modificó alguna dependencia inusual (por ejemplo, un paquete en un directorio del sistema). Esta
La opción es irrelevante en tubería de goma.
-z, --gzip
Comprima el documento final (en gzip formato). Esto es equivalente a decir -o gz
después de todas las demás opciones.
-h, --ayuda
Muestre la lista de todas las opciones disponibles y salga bien.
--en su lugar
Vaya al directorio de los archivos fuente antes de compilar, para que la compilación
los resultados están en el mismo lugar que sus fuentes.
--dentro
Vaya al directorio especificado antes de compilar, para que se produzcan todos los archivos
allí y no en el directorio actual.
--nombre del trabajo
Especifique un nombre de trabajo diferente al nombre del archivo base. Esto cambia el nombre de
archivos de salida y solo se aplica al primer destino.
-k, --guardar
Esta opción se utiliza en tubería de goma solamente. Con esta opción, los archivos temporales
no se eliminará después de compilar el documento y volcar los resultados en
salida estándar. El documento temporal se llama rubtmpX.tex, donde X es un número
de manera que inicialmente no exista ningún archivo con ese nombre.
-yo, --paisaje
Especifique que el documento final debe utilizar la orientación horizontal. Esto es relevante
solo cuando se usa dvips or dvipdfm.
-norte, --maxerr
Establezca el número máximo de errores mostrados. De forma predeterminada, se
informó, diciendo -n -1 muestra todos los errores.
-metro, --módulo [:]
Utilice el módulo especificado además de los paquetes del documento. Los argumentos pueden ser
pasados al paquete agregándolos después de dos puntos, corresponden al paquete
opciones en LaTeX. El módulo está cargado antes analizar las fuentes del documento.
--solo
Compile el documento parcialmente, incluyendo solo las fuentes especificadas. Esto funciona
insertando una llamada a \ includeonly en la línea de comando. El argumento es una coma
lista separada de nombres de archivos.
-Oh, --correo [:]
Utilice el módulo especificado como posprocesador. Esto es similar al -m opciones
excepto que el módulo está cargado después de analizar el documento.
-D, --pdf
Producir salida PDF. Cuando esta opción viene después --PD (por ejemplo en la forma
-pd) es sinónimo de -o ps2pdf, de lo contrario actúa como -m pdftex, para usar
pdfLaTeX en lugar de LaTeX.
-pag, --PD
Procesar el DVI producido por el proceso a través de dvips(1) para producir un PostScript
documento. Esta opción es sinónimo de -o dvips, no puede venir después --pdf.
-q, --tranquilo
Disminuye el nivel de verbosidad. Este es el reverso de -v.
-r, --leer
Leer directivas adicionales del archivo especificado (ver también la directiva "leer").
-S, --src-especiales
Habilite la generación de fuentes especiales si el compilador lo admite. Este es
equivalente a configurar la variable src-especiales a si.
-s, --pequeño
Muestra los mensajes de error de LaTeX en forma compacta (un error por línea).
-YO, --texpath
Agregue el directorio especificado a la ruta de búsqueda de TeX.
--synctex
Habilite la compatibilidad con SyncTeX en la ejecución de LaTeX.
--inseguro
Permita que el documento invoque programas externos arbitrarios. Esto es potencialmente
peligroso, use esta opción solo para documentos que provengan de una fuente confiable.
-v, --verboso
Incrementa el nivel de verbosidad. Existen niveles entre 0 y 4, el nivel predeterminado es 1
for caucho y 0 para tubería de goma. Cuidado, diciendo -vvv hace que Rubber hable mucho.
--versión
Imprima el número de versión y salga bien.
-W, --advertir
Informe información del tipo dado si no hubo ningún error durante la compilación. los
los tipos disponibles son: cajas (cajas llenas o insuficientemente llenas), refs (indefinido o
multiplicar referencias definidas), misceláneos (otras advertencias) y all para informar todas las advertencias.
MÓDULOS
La acción del caucho está influenciada por módulos. Los módulos se encargan de las características particulares de
paquetes y programas externos.
Paquetes
Para cada paquete que utiliza un documento, Rubber busca un módulo con el mismo nombre para
realizar las tareas que este paquete requiera además de la compilación por LaTeX.
Los módulos se pueden agregar a los proporcionados por defecto para incluir nuevas características (esta es la
punto del sistema de módulos). Los módulos estándar son los siguientes:
asíntota
Procesa los archivos .asy generados por el paquete LaTeX, luego activa un
recopilación.
beamer Este módulo maneja los archivos adicionales de Beamer de la misma manera que otras tablas de contenido.
babero, biblatex
Se encarga de procesar la bibliografía del documento con BibTeX cuando sea necesario. Esta
el módulo se carga automáticamente si el documento contiene la macro \ bibliografía
(ver también en DIRECTIVAS para opciones).
combinar
El paquete combinado se utiliza para reunir varios documentos LaTeX en uno solo,
y este módulo maneja las dependencias en este caso.
epsfig Este módulo maneja la inclusión de gráficos para los documentos que usan el estilo antiguo.
\ psfig macro. En realidad, es una interfaz para el módulo de gráficos, vea este
para obtener más detalles.
glosarios
Ejecute makeglossaries y vuelva a compilar cuando cambie el archivo .glo.
gráficos, gráficox
Estos módulos identifican los gráficos incluidos en el documento y los consideran como
dependencias para la compilación. También usan reglas estándar para construir estos archivos.
con programas externos. Consulte la documentación de información para obtener más detalles.
hiperref
Maneje los archivos adicionales que este paquete produce en algunos casos.
índice, hacer idx, nomenclatura
Procese los índices y nomenclaturas del documento con haceríndice(1) cuando sea necesario (ver
. DIRECTIVAS para opciones).
mesa ltx
Agregue dependencias para archivos insertados a través del paquete ltxtable LaTeX.
minitoc, minitoc-hiper
Al limpiar, elimine los archivos adicionales que se produjeron para hacer tablas parciales de
contenido.
más verbo literal
Agrega los archivos incluidos con \ verbatiminput y macros similares a la lista de
dependencias.
multibabero
Maneja las bibliografías adicionales que crea este paquete y elimina las
archivos sobre limpieza.
xr Agregue archivos .aux adicionales utilizados para referencias externas a la lista de dependencias,
por lo que la recompilación es automática cuando se cambia el documento referenciado.
Preprocesamiento
Los siguientes módulos se proporcionan para usar programas que generan una fuente LaTeX desde un
formato de archivo diferente:
webc El propósito de este módulo es ejecutar tejer(1) si es necesario antes del proceso de compilación para
producir la fuente LaTeX. Este módulo se carga automáticamente si el archivo
especificado en la línea de comando tiene .w como su sufijo.
lhs2TeX
Este módulo utiliza el lhs2TeX preprocesador para generar la fuente LaTeX a partir de un
Programa alfabetizado de Haskell. Se activa automáticamente si el nombre del archivo de entrada
termina con .lhs.
Postprocesamiento
Los siguientes módulos se proporcionan para admitir diferentes tipos de posprocesos. Nota
que el orden importa al usar estos módulos: si desea usar una cadena de procesamiento
como uno
foo.tex -> foo.dvi -> foo.ps -> foo.pdf -> foo.pdf.gz
tienes que cargar los módulos dvips, ps2pdf y gz en ese orden, por ejemplo, utilizando el
de línea de comandos
caucho -p -o ps2pdf -z foo.tex
bzip2 Producir una versión del archivo final comprimido con bzip2(1).
dvipdfm
Ron dvipdfm(1) al final de la compilación para producir un documento PDF.
dvips Ron dvips(1) al final de la compilación para producir un documento PostScript. Esta
El módulo también se carga mediante la opción de línea de comando --PD.
expandir Produzca una fuente LaTeX expandida reemplazando \ macros de entrada por archivos incluidos,
macros de bibliografía por la bibliografía producida por bibtex(1) y clases locales
y paquetes por su fuente. Si el archivo principal es foo.tex luego luego archivo expandido
será nombrado foo-final.tex. Consulte la documentación de información para obtener más detalles.
gz Producir una versión del archivo final comprimido con gzip(1).
ps2pdf Suponiendo que la compilación produce un documento PostScript (por ejemplo, utilizando
módulo dvips), convierta este documento a PDF usando ps2pdf(1).
Compilador manera?
Los siguientes módulos se utilizan para cambiar el compilador de LaTeX:
aleph Use el compilador Aleph en lugar de TeX, es decir, compila el documento usando cojo(1)
en lugar de látex.
omega Use el compilador Omega en lugar de TeX, es decir, compila el documento usando lambda(1)
en lugar de látex. Si el módulo dvips se usa también, usará odvips(1) a
traducir el archivo DVI. Tenga en cuenta que este módulo se activa automáticamente cuando el
documento usa el paquete omega.
pdftex Indica a Rubber que utilice pdflatex(1) en lugar de látex(1) para compilar el documento. Por
predeterminado, esto produce un archivo PDF en lugar de un DVI, pero al cargar el módulo
con la opción Dvi (por ejemplo diciendo -m pdftex: dvi) el documento está compilado
en DVI usando pdflatex. Este módulo también se carga mediante la opción de línea de comando
--pdf.
vórtice Indica a Rubber que utilice el compilador VTeX. Por defecto, esto usa látex como el
compilador para producir salida PDF. Con la opcion ps (p. ej., al decir "goma -m
vtex: ps foo.tex ") el compilador utilizado es vlatex y el resultado es un archivo PostScript.
xelatex
Indica a Rubber que utilice xelatex(1) en lugar de látex.
DIRECTIVAS
El comportamiento automático de Rubber se basa en la búsqueda de macros en las fuentes LaTeX.
Cuando esto no sea suficiente, se pueden agregar directivas en los comentarios de las fuentes. A
directiva es una línea como
% caucho: cmd argumentos
La línea debe comenzar con un "%", luego cualquier secuencia de signos y espacios "%", luego el texto
"caucho:" seguido de espacios y un nombre de comando, posiblemente seguido de espacios y
argumentos
General directivas
alias
Imagina que la macro LaTeX name1 es equivalente a name2. Esto puede resultar útil cuando
definir envoltorios alrededor de macros compatibles.
limpia
Indica que el archivo especificado debe eliminarse al limpiar con --limpio.
depender
Considere el archivo especificado como una dependencia, por lo que su tiempo de modificación será
comprobado.
make []
Declare que se debe generar el archivo especificado. Las opciones pueden especificar la forma
debe producirse, las opciones disponibles son obtenidos de para especificar la fuente
y con para especificar la regla de conversión. Por ejemplo, diciendo "make foo.pdf
from foo.eps "indica que foo.pdf debe ser producido a partir de foo.eps, con cualquier
regla de conversión que puede hacerlo. Consulte la documentación de información para obtener detalles en el archivo
conversión.
módulo []
Carga el módulo especificado, posiblemente con opciones. Esto es equivalente al
opción de línea de comandos --módulo.
en el cambio
Ejecute el comando de shell especificado después de compilar si el contenido del
el archivo especificado ha cambiado. El nombre del archivo termina en el primer espacio.
Especifique opciones relacionadas con el tamaño del papel. Actualmente se usan para regalar -t opciones
a dvips y -p opciones para dvipdfm.
camino
Agrega el directorio especificado a la ruta de búsqueda de TeX (y Rubber). El nombre de
el directorio es todo lo que sigue a los espacios después de "ruta".
producir
Declara que la ejecución de LaTeX creará o actualizará los archivos especificados.
read
Leer el archivo de directivas especificado. El archivo debe contener una directiva por
línea. Las líneas vacías y las que comienzan con "%" se ignoran.
reglas
Lea las reglas de conversión adicionales del archivo especificado. El formato de este archivo es
el mismo que el de reglas.ini, consulte la documentación de información para obtener más detalles.
para reinventar la industria logística y redefinir las soluciones ecológicas para reinventar la industria logística y redefinir las soluciones ecológicas.
Establece el valor de una variable como una cadena. Para obtener detalles sobre las variables existentes y
su significado, consulte la documentación de información.
setlist
Establezca el valor de una variable como una lista de cadenas (separada por espacios). Para obtener detalles sobre
las variables existentes y su significado, consulte la documentación de información.
shell_escape
Marque el documento como requiriendo programas externos (shell-escape o write18). Caucho
en realidad, no habilita esto a menos que se llame con la opción --unsafe.
sintex
Habilite la compatibilidad con SyncTeX en la ejecución de LaTeX.
reloj
Observe los cambios en el archivo especificado. Si el contenido de este archivo ha cambiado
después de una compilación, se activa otra compilación. Esto es útil en el
caso de tablas de contenido, por ejemplo.
Específico del módulo directivas
Si un comando tiene la forma foo.bar, se considera un comando de caramelos para el módulo foo. Si
este módulo no está registrado cuando se encuentra la directiva, entonces el comando es silenciosamente
ignorado. Para los módulos estándar, las directivas son las siguientes:
biblatex.ruta
Agrega el directorio especificado a la ruta de búsqueda de bases de datos BibTeX (archivos .bib).
bibtex.crossrefs
Establecer el número mínimo de referencia cruzada necesario para la inclusión automática de la
entrada referenciada en la lista de citas. Esto establece la opción -min-referencias cruzadas when
llamar bibtex(1).
bibtex.camino
Agrega el directorio especificado a la ruta de búsqueda de bases de datos BibTeX (archivos .bib).
bibtex.rutadeestilo
Agrega el directorio especificado a la ruta de búsqueda de estilos BibTeX (archivos .bst).
bibtex.herramienta
Utilice una herramienta de bibliografía diferente en lugar de BibTeX.
dvipdfm.opciones
Pase los modificadores de línea de comandos especificados a dvipdfm.
dvips.opciones
Pase los modificadores de línea de comandos especificados a dvips.
índice.herramienta (índice)
Especifica qué herramienta se utilizará para procesar el índice. El actualmente soportado
las herramientas son haceríndice(1) (la opción predeterminada) y xindy(1). El argumento índice is
opcional, puede usarse para especificar la lista de índices a los que se aplica el comando.
Cuando esté presente, debe ir entre paréntesis; la lista está separada por comas.
Cuando el argumento no está presente, el comando se aplica a todos los índices.
index.idioma (índice)
Selecciona el idioma utilizado para ordenar el índice. Esto solo se aplica cuando se usa
xindy(1) como herramienta de indexación. El argumento opcional tiene la misma semántica que
anterior.
módulos.índice (índice) ...
Especifique qué módulos utilizar al procesar un índice con xindy(1). El opcional
El argumento tiene la misma semántica que el anterior.
orden.index (índice)
Modifica las opciones de clasificación de los índices. Los argumentos son palabras (separadas
por espacios) entre estándar, alemán y carta. Esto solo se aplica cuando se usa
haceríndice(1). El argumento opcional tiene la misma semántica que el anterior.
index.ruta (índice)
Agrega el directorio especificado a la ruta de búsqueda de estilos de índice (archivos .ist). los
El argumento opcional tiene la misma semántica que el anterior.
índice.estilo (índice)
Especifica el estilo de índice que se utilizará. El argumento opcional tiene la misma semántica.
como anteriormente.
makeidx.idioma, .módulos, .pedido, .sendero, .estilo, .herramienta
Estas directivas son las mismas que para el índice módulo, excepto que no
acepta el argumento opcional.
multibib.referencias cruzadas, .sendero, .ruta de estilo, .herramienta
Estas directivas son las mismas que para el bibtex módulo pero se aplican a
bibliografías gestionadas por el multibabero paquete. Toman un primero opcional
argumento, con la misma convención que para las directivas del índice módulo, que
se puede utilizar para especificar la lista de bibliografías a las que se aplica el comando.
Utilice caucho en línea utilizando los servicios de onworks.net