bundledoc - Online en la nube

PROGRAMA:

NOMBRE

bundledoc: agrupa todos los archivos que necesita un documento LaTeX

SINOPSIS

paquetedoc [--versión] [--ayuda] [--[no]verboso] [--archivo de texto=presentar] [--directorio=directorio]
[--[no]solo locales] [--excluir=cadena] [--incluir=especificaciónarchivo] [--manifiesto=presentar]
[--listdeps= [sí | no | solo | rel] ...] [--[no]mantener] [--config=presentar] .dep presentar

DESCRIPCIÓN

paquetedoc es un posprocesador para el instantánea paquete que agrupa todos los
clases, paquetes y archivos necesarios para construir un documento LaTeX dado. Lee el .dep
archivar eso instantánea produce, encuentra cada uno de los archivos mencionados en el mismo y los empaqueta
en un solo archivo de almacenamiento (por ejemplo, un .tar.gz archivo), adecuado para moverse entre sistemas,
transmitir a un colega, etc.

Como ejemplo más simple posible, considere un archivo LaTeX llamado, digamos, hola.tex:

\ RequirePackage {snapshot}% Necesario por bundledoc
\ documentclass [11pt] {artículo}

\ Begin {document}
Hola mundo
\ End {document}

El "\ RequirePackage {snapshot}" provoca un hola.dep archivo que se va a producir. Cuando paquetedoc is
luego, dado "hello.dep" como argumento, localiza los archivos dependientes - instantánea.sty,
artículo.clsy tamaño11.clo - y los agrupa en un solo archivo, junto con
hola.tex y MANIFIESTO archivo (descrito en "OPCIONES", a continuación).

CAMPUS

En las siguientes descripciones, somefile se refiere al nombre de su documento principal de LaTeX (no
extensión).

paquetedoc requiere el nombre del archivo de dependencia producido por instantánea (normalmente
algúnarchivo.dep). También se pueden ofrecer las siguientes opciones:

--versión
Salida del paquetedoc número de versión del script. Esto anula todo el resto
.

--ayuda
Da un breve mensaje de uso. Esto anula todas las opciones restantes.

--[no]verboso (predeterminado: "noverbose")
paquetedoc normalmente no genera nada excepto mensajes de error. Con "--verbose",
emite numerosos mensajes de estado.

--archivo de texto=principal .tex presentar (defecto: algúnarchivo.tex)
instantáneaEl archivo de dependencia no incluye el archivo principal de LaTeX (el que se pasa
a látex). Para poder paquetedoc para encontrar y empaquetar ese archivo, paquetedoc lo asume
tiene el mismo nombre que el instantánea archivo de dependencia pero con un .tex extensión. Si esto
no es el caso, entonces use "--texfile" para especificar el nombre de archivo correcto.

--directorio=Archivo directorio (defecto: somefile)
Cuándo paquetedoc crea un archivo (p. ej., un .alquitrán or .zip archivo) que contiene el
archivos del documento, los coloca todos en un directorio para evitar saturar los archivos
directorio con archivos. Si se llama al archivo de dependencia dado algúnarchivo.dep entonces el
archivo resultante almacenará, por defecto, todos los archivos dependientes en un somefile
directorio. Para cambiar el nombre del directorio, use la opción "--directory".

--[no]solo locales (predeterminado: "nolocalonly")
Aunque paquetedoc normalmente archiva todos los archivos nombrados en el .dep archivo, el
La opción "--localonly" indica paquetedoc para excluir todos los archivos ubicados en un directorio diferente
que la .tex directorio del archivo o uno de sus subdirectorios.

--excluir=cadena (defecto: ninguna)
Mientras que "--localonly" genera archivos fuera del .tex árbol de directorio del archivo
omitido del archivo, "--exclude" proporciona un control más detallado sobre los archivos para
omitir del archivo. La opción "--exclude", que se puede especificar repetidamente en
la línea de comando, hace que todos los archivos cuyo nombre contenga cadena ser omitido de la
archivo.

--incluir=especificaciónarchivo (defecto: ninguna)
La opción "--include", que se puede especificar repetidamente en la línea de comando,
instruye paquetedoc para incluir en el archivo todos los archivos que coincidan especificaciónarchivo, Incluso
si no se hace referencia a ellos en el .dep archivo.

--manifiesto=manifiesto presentar (defecto: MANIFIESTO)
Además de los archivos dependientes, paquetedoc incluye en el archivo de almacenamiento uno extra
archivo llamado, por defecto, ``MANIFIESTO''. MANIFIESTO es un archivo de texto que enumera los
nombres de archivo originales de todas las dependencias. Para cambiar el nombre del archivo de ''MANIFIESTO''
a otra cosa, use la opción "--manifest". Como caso especial, "--manifest =" ""
decirles paquetedoc no incluir un archivo de manifiesto en absoluto.

--listdeps= [sí | no | solo | rel] ...] (predeterminado: "no")
"--listdeps" acepta uno o más de "yes", "no", "only" o "rel" como un elemento separado por comas
lista. Siempre que "no" no aparezca en esta lista, paquetedoc salidas todas las principales
Dependencias del archivo LaTeX. Si la lista contiene "rel", entonces paquetedoc da salida al
lista de dependencias con nombres de ruta relativos. Si la lista contiene "solo", entonces
paquetedoc sale después de mostrar la lista, sin producir un archivo.

--[no]mantener (predeterminado: "nokeepdirs")
Normalmente, el archivo de almacenamiento que paquetedoc produce contiene un solo directorio - y
subdirectorios, si el documento se refiere explícitamente a ellos, en los que todos los
mienten archivos dependientes. Si se especifica "--keepdirs", todos los archivos dependientes se almacenan
con sus nombres de ruta originales. Por ejemplo, si algúnarchivo.tex depende
figuras / somefigure.eps, artículo.clsy instantánea.sty, Entonces el somefile archivo será
normalmente contienen los siguientes archivos:

· somefile / somefile.tex

· somefile / figures / somefigure.eps

· somefile / article.cls

· somefile / snapshot.sty

· somefile / MANIFEST

Sin embargo, "--keepdirs" hará que somefile archivo para contener los siguientes tipos
de nombres de archivo en su lugar:

· inicio / me / mydocs / somefile.tex

· inicio / me / mydocs / figures / somefigure.eps

· usr / share / texmf / tex / latex / base / article.cls

· usr / share / texmf / tex / latex / snapshot / snapshot.sty

"--directory" no se utiliza cuando "--keepdirs" está en vigor. Además, ningún manifiesto
El archivo se escribe en el archivo de almacenamiento ya que contiene información redundante.

--config=configuración presentar (defecto: )
La opción "--config" se usa para señalar paquetedoc a la configuración apropiada
(.cfg) para su distribución y sistema operativo TeX. paquetedoc viene con un
pocos archivos de configuración y es fácil escribir más. Ver "ARCHIVOS DE CONFIGURACIÓN"
(a continuación) para obtener una descripción del formato del archivo de configuración.

CONFIGURACIÓN ARCHIVOS

Formato
Los archivos de configuración siguen un formato bastante simple. Las líneas que comienzan con "#" son comentarios.
Las líneas en blanco se ignoran. Todas las demás líneas tienen la forma:

valor variable

La versión actual de paquetedoc reconoce las siguientes variables:

liar
El comando que se utilizará para agrupar un conjunto de archivos en un solo archivo de almacenamiento

lavabo
El afijo de un comando para descartar su salida.

encontrar
El comando para buscar un archivo dentro de los árboles TeX.

Los valores que son demasiado largos para una línea se pueden dividir en varias líneas usando "\" como
el símbolo de continuación de línea.

Hay dos variables de entorno que paquetedoc pone a disposición para su uso por
comandos del archivo de configuración: "BDBASE", que se establece en somefile (como en "OPCIONES"), y
"BDINPUTS", que se establece en una lista de archivos separados por espacios que debe operar un comando
sobre. Es decir, cuando se ejecuta el comando asociado con "paquete", "BDINPUTS" contiene
la lista de todos los archivos que se van a archivar. En contraste, cuando el comando
asociado con "buscar" se está ejecutando, "BDINPUTS" contiene el nombre del archivo a buscar.

Ejemplos
El siguiente archivo de configuración es paralelo paquetedoclos valores predeterminados de los distintos
variables del archivo de configuración, que representa una distribución TeX basada en kpathsea que se ejecuta
en un sistema Unix genérico, que no necesariamente tiene ninguna de las herramientas GNU, como
gzip o GNU alquitrán:

# Archivo de configuración "predeterminado"
# Por Scott Pakin[email protected]>

paquete: (tar -cvf - $ BDINPUTS | comprimir> $ BDBASE.tar.Z)
sumidero:> / dev / null 2> & 1
buscar: kpsewhich -progname = latex $ BDINPUTS

Los paréntesis en la línea "bundle:" le dicen al shell de Unix que ejecute el comando en un
subshell. Esto es para que el afijo "sink:" funcione correctamente (es decir, para que no haya dos
">" está en el mismo comando).

Observe cómo los comandos tratan "BDBASE" y "BDINPUTS" como cualquier otra variable de entorno.
en un shell de Unix, usando "$" para tomar su valor. Otros sistemas operativos utilizan diferentes
convenciones para referirse a variables de entorno. Por ejemplo, un archivo de configuración
para una distribución TeX basada en Windows, se utilizaría "% BDBASE%" y "% BDINPUTS%" en su lugar.

El valor de "sumidero:" es específico de un sistema operativo. El valor de "buscar:" es
específico de una distribución TeX. "paquete:" es donde la mayor oportunidad de personalización
mentiras. Puede utilizar "paquete:" para especificar su formato de archivo favorito. Por ejemplo tu
puede producir un archivo shar en Unix con algo como:

paquete: (shar --archive-name = "$ BDBASE" $ BDINPUTS> $ BDBASE.sh)

o un archivo CAB en Microsoft Windows con algo como:

paquete: cabarc -r -p N% BDBASE% .cab% BDINPUTS%

EJEMPLOS

Asumir que miarchivo.dep fue producido a partir de miarchivo.tex siguiendo las instrucciones del
Sección de descripción. El siguiente comando produce un .zip archivo con el MikTeX TeX
distribución que se ejecuta en Microsoft Windows:

bundledoc --config = miktex.cfg myfile.dep

(En la práctica, probablemente sea necesario especificar "--config" la ruta completa a
paquetedoc's miktex.cfg archivo de configuración.)

Lo siguiente construye un .tar.gz archivo con la distribución TeX Live ejecutándose en Unix-
como sistema operativo. paquetedoc producirá una salida detallada que describe sus operaciones.
Todos los archivos que no están en el mismo árbol de directorios que miarchivo.tex y todos los archivos que contengan ".fd" o
".sty" en sus nombres se omiten. Sin embargo, todos .babero archivos en el directorio actual
incluirse en el archivo a pesar de que ninguno de ellos es referenciado por miarchivo.dep.
Finalmente, no MANIFIESTO Se producirá el archivo.

bundledoc --config = texlive-unix.cfg --verbose --localonly \
--exclude = .fd --exclude = .cfg --include = "*. bib" --manifest = "" \
miarchivo.dep

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