LaTeX: paquetes comunes y trucos

Ya hemos usado bastantes paquetes en los capítulos anteriores; este artículo hace un cierre sistemático: consulta rápida de paquetes, comandos personalizados, formato de código, proyectos de varios archivos, latexmk y métodos de depuración.

Si dominas este «kit de herramientas», evolucionarás de saber escribir LaTeX a saber gestionar proyectos LaTeX.


Consulta rápida de paquetes comunes

Los paquetes se cargan con \usepackage[opciones]{nombre_del_paquete}, todo en el preámbulo.

PaqueteUsoAparición en esta serie
geometryMárgenes de página y papelEstructura y composición de documentos LaTeX
fancyhdrEncabezados y pies de páginaEstructura y composición de documentos LaTeX
amsmath / amssymbAmpliación de fórmulas matemáticas / símbolos extendidosLaTeX: fundamentos de fórmulas matemáticas、LaTeX: matemáticas avanzadas
graphicxInserción de imágenesLaTeX: inserción de imágenes y tablas
booktabs / multirowTablas de tres líneas / fusión vertical de celdasLaTeX: inserción de imágenes y tablas
enumitemPersonalización de listasLaTeX: formato de texto y listas
xcolorDefinición de coloresIntroducido en este capítulo
listingsFormato de códigoIntroducido en este capítulo
hyperrefHiperenlaces y marcadoresLaTeX: referencias cruzadas y gestión de bibliografía
biblatexBibliografía (enfoque moderno)LaTeX: referencias cruzadas y gestión de bibliografía
floatPosicionamiento forzado de figuras y tablas [H]LaTeX: inserción de imágenes y tablas

Cuando el entorno local muestre File 'xxx.sty' not found, instálalo con tlmgr install xxx (TeX Live); MiKTeX lo descargará automáticamente. Overleaf incluye casi todos los paquetes, así que no tienes ese problema.


Comandos personalizados: \newcommand

Cuando hayas escrito el mismo contenido más de tres veces, es hora de definir un comando: \newcommand{\nombre_del_comando}[número_de_parámetros]{definición}.

{...}$ produce x_1, …, x_5

% Sin parámetros: abreviar un comando largo
\newcommand{\R}{\mathbb{R}}            % De ahora en adelante, escribir $\R$ equivale a $\mathbb{R}$

% Un parámetro: encapsular un formato fijo
\newcommand{\email}[1]{\texttt{#1}}   % #1 representa el primer parámetro

% Parámetro opcional con valor predeterminado: [número_de_parámetros][valor_predeterminado]
\newcommand{\vecn}[2][n]{x_1, \dots, x_#1}
% Uso: $\vecn{...}$ produce x_1, …, x_n
% $\vecn

\begin{document}
Definida en$\R$función sobre, vector$\vecn$y$\vecn[5]$,
Correo de contacto\email{service@example.com}。
\end{document
}
ComandoUsoNota
\newcommandDefinir un comando nuevoEl nombre del comando no debe entrar en conflicto con comandos existentes
\renewcommandRedefinir un comando existenteSe usa al modificar el estilo predeterminado; ten cuidado al cambiar comandos básicos
\newenvironmentDefinir un entorno nuevoSintaxis similar, proporciona el código de inicio y fin

Conozcamos también la sintaxis de los entornos personalizados:

Ejemplo: entorno personalizado «Nota»

\newenvironment{note}                 % Nombre del entorno
  {\par\medskip\noindent\textbf{Nota:}\itshape}  % Código de inicio
  {\par\medskip}                      % Código de fin

\begin{note}
El contenido aquí comenzará automáticamente con «Nota:» y se compondrá en cursiva.
\end{note
}

Formato de código: paquete listings

Para insertar código en documentos técnicos, usa el paquete listings; el resaltado de sintaxis, los números de línea y los bordes son automáticos.

Ejemplo: bloque de código con resaltado y números de línea

\documentclass{ctexart}
\usepackage{listings
}             % Paquete para formato de código
\usepackage{xcolor}               % Soporte de colores

\lstset{                          % Configuración global del estilo de código
  basicstyle=\ttfamily\small,     % Fuente monoespaciada, tamaño ligeramente menor
  keywordstyle=\color{blue},      % Palabras clave en azul
  commentstyle=\color{gray},      % Comentarios en gris
  stringstyle=\color{purple},     % Cadenas en púrpura
  numbers=left,                   % Números de línea a la izquierda
  numberstyle=\tiny\color{gray},
  showstringspaces=false,         % No mostrar marcadores de espacios dentro de las cadenas
  frame=single                    % Borde de una sola línea
}

\begin{document}

\begin{lstlisting}[language=Python, caption=Calcular la sucesión de Fibonacci]
# Calcula el n-ésimo número de Fibonacci (prueba de comentario en chino)
def fib(n):
    if n < 2:
        return n
    return fib(n - 1) + fib(n - 2)

print(fib(10)) # Salida 55
\end{lstlisting}

\end{document
}

listings 代码块的编译效果

lstlisting es un «entorno literal»: su contenido no recibe ninguna interpretación de LaTeX; & y % no necesitan escape. caption también se numera automáticamente (Listing 1). Los nombres de idioma comunes son Python, C, Java, HTML, SQL, bash, etc. Si no se especifica language, se colorea como texto plano.

El soporte de listings para chino UTF-8 depende del compilador: con XeLaTeX los comentarios en chino funcionan bien; con motores antiguos (latex/pdfLaTeX) aparecen caracteres corruptos. Para documentos en chino, usa siempre XeLaTeX.


Proyecto de varios archivos: \input e \include

Cuando el documento supera unos cientos de líneas, conviene dividirlo en archivos: main.tex solo sirve de esqueleto y el contenido se gestiona por partes.

Ejemplo: esqueleto de main.tex

\documentclass{ctexart}
\usepackage{amsmath, graphicx, booktabs, hyperref}

\begin{document}

\input{chapters/intro
}      % Introducción (el nombre de archivo sin .tex)
\input{chapters/method}     % Método
\input{chapters/experiment} % Experimentos
\input{chapters/conclusion} % Conclusiones

\bibliographystyle{plain}
\bibliography{refs}

\end{document
}

Los dos comandos parecen similares, pero sus comportamientos tienen funciones claramente diferenciadas.

Elemento de comparación\input{archivo}\include{archivo}
¿Se puede anidar?Sí (se puede usar \input dentro de un subarchivo)No
¿Fuerza salto de página?No salta de páginaFuerza \clearpage antes de cada archivo
Compatible con includeonlyNo compatibleSí, compila solo las secciones especificadas (acelera el proceso)
Granularidad de usoFragmentos arbitrarios (definiciones de macros, figuras, portadas)Contenido grande a nivel de capítulo

Error común: \include fuerza un salto de página; si lo usas para juntar «varias subsecciones en la misma página», verás saltos de página inexplicables: para fragmentos pequeños usa siempre \input.


latexmk: compilación con un clic

En el artículo 9, la cadena de compilación de cuatro pasos requería escribir cuatro comandos a mano, algo tedioso; latexmk lo hace todo automáticamente.

$ latexmk -xelatex main.tex     # XeLaTeX 引擎编译,自动跑满所有遍数
$ latexmk -xelatex -c main.tex  # 清理中间文件(保留 PDF)
$ latexmk -xelatex -C main.tex  # 连 PDF 一起清理

latexmk determina automáticamente: si hay .bib, ejecuta bibtex; si las referencias del índice cambian, compila varias veces hasta que todos los números se estabilicen. Configurar el «comando de compilación» como latexmk en el editor es la mejor práctica en el entorno local.


Métodos de depuración

Los mensajes de error de LaTeX comienzan con un signo de exclamación e incluyen el número de línea, con un formato fijo; basta con leer las primeras líneas.

! Undefined control sequence.
l.42 \secton{方法}

l.42 indica el número de línea del error: en este ejemplo, en la línea 42 se escribió \secton en lugar de \section. Al corregir esto, suele desaparecer toda la cascada de errores posteriores.

Mensaje de errorSignificadoSolución
Undefined control sequenceComando inexistente: error de escritura o falta un paqueteRevisa la ortografía con el número de línea; confirma que el paquete esté cargado
Missing $ insertedComando matemático usado en modo textoPon _ ^ \alpha etc. dentro de $ $
File 'xxx' not foundNo encuentra archivo o paqueteRevisa la ruta; tlmgr install xxx
Runaway argumentEntorno sin cerrar (falta \end)Añade \end{...} según el número de línea
LaTeX Error: Environment xxx undefinedSe usó un entorno no definidoRevisa la ortografía del entorno y el paquete
! Emergency stopCompilación detenida por completoBusca en el log el primer error
Reference undefined (advertencia)La referencia sale como ??Compila una vez más

Corrige siempre solo el primer error del log: los errores posteriores suelen ser consecuencias del primero. Después de corregir, recompila; es mucho más fiable que cambiar diez cosas de una vez.


Resumen

NecesidadSolución
Reducir la entrada repetitiva\newcommand define comandos y entornos
Insertar códigolistings + estilo global con \lstset
División de documentos grandes\input (fragmento) / \include (nivel de capítulo)
Compilación con un cliclatexmk -xelatex
Depuración de erroresLeer el número de línea del primer error `!` en el registro
Otras extensiones