texdoc / texfot / Ghostscript / dvisvgm

Además de compilar, una instalación de TeX incluye pequeñas utilidades que facilitan el trabajo diario: texdoc para abrir el manual de un paquete, texfot para reducir la salida de compilación a lo importante, Ghostscript para crear o reducir PDF, y dvisvgm para convertir la salida en SVG listo para la Web. Esta página es una referencia rápida de las cuatro.

Integrar las cuatro herramientas en el flujo de escritura

El objetivo de este capítulo no es memorizar cuatro comandos, sino saber qué herramienta usar en cada momento al escribir un documento. Antes de añadir un paquete, lea su manual con texdoc. Cuando la salida de compilación se vuelva ruidosa, use texfot para hacer visibles las advertencias. Si un PDF de entrega es demasiado grande, comprímalo con Ghostscript y luego revise los enlaces y las fuentes incrustadas. Para fórmulas o diagramas en la Web, exporte SVG con dvisvgm e inspecciónelo en un navegador con mucho zoom. Usadas en ese orden, investigación, escritura, acabado y publicación forman un solo flujo.

texdoc — abrir el manual de un paquete

La mayoría de los paquetes de CTAN incluyen un manual detallado (un PDF), y tras la instalación ya está en su máquina. Escriba texdoc PACKAGE y encontrará ese manual y lo abrirá en un visor, sin conexión y con el contenido correspondiente a la versión que realmente tiene instalada. Se incluye con TeX Live (originalmente por Manuel Pégourié-Gonnard); la misma base de datos también se puede consultar en texdoc.org.

texdoc booktabs      # booktabs の説明書を開く / open booktabs’ manual
texdoc -l siunitx    # 候補を一覧表示（開かない）/ list matches instead of opening

De forma predeterminada abre la mejor coincidencia. -l (--list) muestra una lista de candidatos para elegir en lugar de abrir uno. -s (--showall) amplía los resultados para incluir también coincidencias con menor puntuación. Al añadir un paquete a un informe o a un capítulo de tesis, use primero texdoc PACKAGE para identificar el comando de carga, el ejemplo canónico y las opciones importantes; después copie solo lo mínimo necesario en el preámbulo. Así la configuración no se descontrola.

texfot — solo los mensajes importantes

Una ejecución de TeX genera una avalancha de mensajes, y las advertencias o errores que realmente necesita pueden pasar de largo. texfot (un script Perl de dominio público de Karl Berry) ejecuta el motor y filtra la transcripción hasta dejar las líneas “interesantes”: errores, advertencias, cajas overfull/underfull, etc. Pasa el código de salida sin cambios, así que no rompe la comprobación de éxito de una herramienta de construcción.

texfot pdflatex document.tex     # 出力を要約しつつコンパイル / compile with a quiet, filtered log

Para usarlo con latexmk, envuelva la invocación del motor con texfot en el archivo de configuración:

# .latexmkrc
$pdflatex = 'texfot pdflatex %O %S';

Ghostscript — crear y reducir PDF

gs (Ghostscript) es el intérprete de PostScript/PDF; también es lo que ejecuta ps2pdf por debajo. Con -sDEVICE=pdfwrite escribe PDF, lo que permite convertir PS a PDF, combinar varios PDF y comprimir un PDF demasiado grande (reduciendo la resolución de sus imágenes). La calidad se elige con un preajuste -dPDFSETTINGS como /screen (revisión en pantalla), /ebook (medio), /printer (orientado a impresión) o /prepress (orientado a preprensa). Estos preajustes reconstruyen el PDF y pueden cambiar la entrada. Para entrega o impresión, revise siempre la legibilidad de las imágenes, las fuentes incrustadas, los enlaces y el tamaño de página después de comprimir.

gs -sDEVICE=pdfwrite -dPDFSETTINGS=/ebook -dNOPAUSE -dBATCH \
   -sOutputFile=small.pdf big.pdf

dvisvgm — DVI a SVG

dvisvgm (de Martin Gieseking) convierte DVI en SVG (gráficos vectoriales). También acepta EPS, y entrada PDF con --pdf. Es ideal cuando desea poner en la Web fórmulas o diagramas que sigan nítidos con cualquier zoom. Las fuentes se incrustan como SVG de forma predeterminada, pero --font-format=woff2 (o woff, ttf) permite cambiar a formatos de fuente web. Con entrada PDF, según la ruta de procesamiento, el texto puede convertirse en trazados en lugar de fuentes incrustadas; decida si va a convertir desde DVI o desde PDF y luego compruebe el renderizado real en el navegador. Use -p (--page) para seleccionar páginas.

latex equation.tex                       # → equation.dvi
dvisvgm --font-format=woff2 equation.dvi # → equation.svg
dvisvgm --pdf figure.pdf                 # PDF を入力にする / convert a PDF

Depurar fallos comunes

• Si texdoc abre el manual equivocado, ejecute texdoc -l PACKAGE, revise los candidatos y elija el PDF previsto por número.
• Si texfot no muestra nada pero el PDF sigue viéndose mal, quite texfot temporalmente y lea el registro sin filtrar para comprobar si se eliminó contexto útil.
• Si los enlaces o marcadores desaparecen tras comprimir con Ghostscript, la reconstrucción del PDF puede haber descartado información no visible. Compare el PDF original y el comprimido antes de la entrega.
• Si dvisvgm --pdf convierte el texto en trazados, el SVG no conservará texto buscable ni sustituible. Para figuras web editables, pruebe primero a convertir desde DVI.

Cuándo usar cada uno

• Consultar cómo funciona un paquete → texdoc PACKAGE.
• Silenciar un registro ruidoso → texfot (con latexmk).
• Un PDF es demasiado grande / convertir PS a PDF → Ghostscript (-dPDFSETTINGS).
• Poner fórmulas o figuras en la Web como SVG → dvisvgm.