Entornos

Una región encerrada entre \begin{...} y \end{...} se llama entorno. Sirve para delimitar una parte del documento y aplicar a todo su contenido un comportamiento o formato determinado; casi todas las estructuras de LaTeX (listas, ecuaciones en display, figuras, tablas, citas) tienen esta forma. Esta página cubre qué es un entorno, cómo se anidan, cuáles son los comunes y cómo definir uno propio.

Qué es un entorno

Un entorno es un bloque delimitado que empieza con \begin{name} y termina con \end{name}, aplicando algún efecto a su contenido. Un entorno center centra lo que contiene; un entorno itemize convierte su contenido en una lista con viñetas. La regla crucial es que el nombre del comienzo debe coincidir exactamente con el del final. No puedes abrir \begin{center} y cerrarlo con \end{flushleft}.

\begin{center}
この段落は中央に寄ります。
\end{center}

Igualmente importante: un entorno forma un grupo implícito, es decir, un ámbito local. Cualquier cambio de fuente o espaciado hecho dentro de él se deshace en \end{...} y no se filtra hacia fuera. Si un entorno quote cambia la sangría y los márgenes, el texto alrededor vuelve a la normalidad al salir. Piensa en un entorno como si tuviera el mismo alcance que un grupo entre llaves { ... }.

El documento mismo es, de hecho, un entorno: \begin{document} … \end{document}. De ahí se deriva directamente la regla básica de que todo el cuerpo del texto va dentro de document.

Cómo se anidan los entornos

Los entornos pueden anidarse, pero deben cerrarse en el orden inverso al que se abrieron. Si abres \begin{b} dentro de \begin{a}, primero cierras el interior con \end{b} y luego el exterior con \end{a}: \begin{a}\begin{b}...\end{b}\end{a}.

\begin{quote}
  引用の中に箇条書きを置く例：
  \begin{itemize}
    \item 一つ目
    \item 二つ目
  \end{itemize}
\end{quote}

En cambio, no puedes dejar que los rangos se solapen, como en \begin{a}\begin{b}...\end{a}\end{b}. Es uno de los errores más comunes de LaTeX y produce un mensaje como \begin{...} ended by \end{...}, porque el entorno abierto y el cerrado no coinciden. En documentos largos, indentar cada entorno para mostrar sus parejas ayuda a no olvidar ni confundir un \end.

Entornos comunes

LaTeX estándar ofrece muchos entornos agrupados por propósito. Abajo se listan los más representativos por función. Cada uno tiene su propia página para los detalles, pero todos comparten la misma forma \begin / \end.

quote y quotation sangran el material citado, pero quotation también sangra la primera línea de cada párrafo y conviene para citas largas de varios párrafos. El entorno verbatim imprime su contenido exactamente como se escribió en una fuente monoespaciada, tratando incluso caracteres especiales como \ y { de forma literal y no como comandos; es útil para mostrar código fuente.

Algunos entornos toman argumentos. tabular requiere una especificación de columnas: indicas la alineación de cada columna (c centro, l izquierda, r derecha) en el argumento que sigue a \begin{tabular}, como en \begin{tabular}{cc}. Dentro de la tabla, las columnas se separan con & y cada fila termina con \\.

\begin{tabular}{cc}
  名前 & 役割 \\
  TeX & 組版エンジン \\
  LaTeX & 文書フォーマット \\
\end{tabular}

Muchos entornos tienen también una forma con estrella, escrita con un * después del nombre. Por ejemplo, el entorno align numera cada línea, mientras que \begin{align*} … \end{align*} es la versión sin numerar. Del mismo modo, equation* produce una ecuación en display sin número.

Definir tu propio entorno

Si repites la misma combinación de formato en un documento, puedes definir tu propio entorno con \newenvironment. Una vez definido, lo llamas con \begin / \end bajo tu propio nombre. La sintaxis es la siguiente ([nargs] y [default] son opcionales):

\newenvironment{名前}[nargs][default]{開始時のコード}{終了時のコード}

• name — el nombre del nuevo entorno (sin barra invertida; no puede empezar por end).
• nargs — cuántos argumentos toma (0–9), referidos en el cuerpo como #1, #2, …
• default — al indicarlo, el primer argumento se vuelve opcional y este valor es su valor por defecto.
• begin-code — se ejecuta en \begin{name}; aquí se usan argumentos como #1.
• end-code — se ejecuta en \end{name}; aquí no se pueden usar argumentos como #1.

Como ejemplo, aquí hay un entorno important que resalta una nota en un recuadro. Permitimos pasar la palabra del encabezado como argumento opcional, con “Important” como valor por defecto. Como proporcionamos un default, #1 recibe ese argumento.

\newenvironment{important}[1][重要]{%
  \begin{quote}\noindent\textbf{#1：}\itshape
}{%
  \end{quote}%
}

% 使い方
\begin{important}
  締め切りは厳守してください。
\end{important}

\begin{important}[注意]
  バックアップを忘れずに。
\end{important}

El primer uso pone el valor por defecto “重要：” (Important:) en el encabezado; el segundo pasa [注意] para “注意：” (Note:). En ambos casos, el texto siguiente se compone en cursiva. Observa que el begin-code abre \begin{quote} y el end-code cierra el \end{quote} correspondiente. Como el entorno es en sí un grupo, el efecto de \itshape (cursiva) se deshace automáticamente en \end{important} y no llega al texto exterior.

Para redefinir un entorno existente, usa \renewenvironment. Su sintaxis coincide con \newenvironment, pero se aplica a un nombre que ya está definido (un nombre no definido es un error). A la inversa, \newenvironment da error si el nombre ya existe. Tanto \newenvironment como \renewenvironment tienen formas con estrella, que difieren en cómo tratan los espacios finales de los argumentos.

Escribir sin perder los cierres

En un documento largo, un error de entorno puede no aparecer donde lo cometiste; quizá surja páginas después, cerca de \end{document}. Acostúmbrate a escribir la línea de cierre justo después de abrir un entorno y luego rellenar el contenido. Indenta los bloques anidados con dos o cuatro espacios para que la fuente muestre qué está dentro de qué: un tabular dentro de un figure, un itemize dentro de un quote, etc.

\begin{figure}
  \centering
  \begin{tabular}{ll}
    入力 & 出力 \\
    source & PDF \\
  \end{tabular}
  \caption{処理の対応}
\end{figure}

Cuando aparezca un error, no te apoyes solo en la línea \begin{...} ended by \end{...} del log. Reduce el entorno que acabas de añadir a un ejemplo mínimo. Si una tabla, figura, ecuación o lista compila como fragmento pequeño antes de volver al archivo principal, puedes separar un \end faltante de un problema específico de un paquete.

Elegir entornos como partes semánticas

Un entorno no es solo una caja visual; nombra una parte del manuscrito. Usa quote para citas, itemize para listas con viñetas, tabular para la cuadrícula de una tabla, y figure o table para material flotante que necesitará leyendas, numeración, referencias y listas. Si eliges center solo por apariencia, o quote solo para conseguir más márgenes, el papel del bloque se vuelve poco claro en un documento largo.

• El bloque es una cita — usa quote o quotation y cita la fuente en el texto o en una nota al pie.
• El bloque es una lista lógica — usa itemize, enumerate o description; no finjas viñetas con \\.
• Una figura o tabla necesita numeración y referencias — coloca \caption y \label dentro de figure o table.
• Un bloque personalizado se repite a menudo — ponle nombre con \newenvironment en vez de copiar comandos locales de formato.