
igor@470: \chapter{Personalizar los mensajes de Mercurial}
igor@402: \label{chap:template}
igor@402: 
igor@470: Mercurial provee un poderoso mecanismo que permite controlar como
igor@470: despliega la información.  El mecanismo se basa en plantillas.  Puede
igor@470: usar plantillas para generar salida específica para una orden
igor@470: particular o para especificar la visualización completa de la interfaz
igor@470: web embebida.
igor@470: 
igor@470: \section{Usar estilos que vienen con Mercurial}
igor@402: \label{sec:style}
igor@402: 
igor@470: Hay ciertos estilos listos que vienen con Mercurial.  Un estilo es
igor@470: simplemente una plantilla predeterminada que alguien escribió e
igor@470: instaló en un sitio en el cual Mercurial puede encontrarla.
igor@470: 
igor@470: Antes de dar un vistazo a los estilos que trae Mercurial, revisemos su
igor@470: salida usual.
igor@402: 
igor@402: \interaction{template.simple.normal}
igor@402: 
igor@470: Es en cierta medida informativa, pero ocupa mucho espacio---cinco
igor@470: líneas de salida por cada conjunto de cambios.  El estilo
igor@470: \texttt{compact} lo reduce a tres líneas, presentadas de forma
igor@470: suscinta.
igor@402: 
igor@402: \interaction{template.simple.compact}
igor@402: 
igor@470: El estilo de la \texttt{bitácora de cambios} vislumbra el poder
igor@470: expresivo del sistema de plantillas de Mercurial.  Este estilo busca
igor@470: seguir los estándares de bitácora de cambios del proyecto
igor@470: GNU\cite{web:changelog}.
igor@402: 
igor@402: \interaction{template.simple.changelog}
igor@402: 
igor@470: No es una sorpresa que el estilo predeterminado de Mercurial se llame
igor@470: \texttt{default}\ndt{predeterminado}.
igor@470: 
igor@470: \subsection{Especificar un estilo predeterminado}
igor@470: 
igor@470: Puede modificar el estilo de presentación que Mercurial usará para
igor@470: toda orden vía el fichero \hgrc\, indicando el estilo que prefiere
igor@470: usar.
igor@402: 
igor@402: \begin{codesample2}
igor@402:   [ui]
igor@402:   style = compact
igor@402: \end{codesample2}
igor@402: 
igor@470: Si escribe un estilo, puede usarlo bien sea proveyendo la ruta a su
igor@470: fichero de estilo o copiando su fichero de estilo a un lugar en el
jerojasro@520: cual Mercurial pueda encontrarlo (típicamente el subdirectorio
igor@470: \texttt{templates} de su directorio de instalación de Mercurial).
igor@470: 
igor@470: \section{Órdenes que soportan estilos y plantillas}
igor@470: 
igor@470: Todas las órdenes de Mercurial``relacionadas con \texttt{log}'' le
igor@470: permiten usar estilos y plantillas: \hgcmd{incoming}, \hgcmd{log},
igor@470: \hgcmd{outgoing} y \hgcmd{tip}.
igor@470: 
igor@470: Al momento de la escritura del manual estas son las únicas órdenes que
igor@470: soportan estilos y plantillas.  Dado que son las órdenes más
igor@470: importantes que necesitan personalización, no ha habido muchas
igor@470: solicitudes desde la comunidad de usuarios de Mercurial para añadir
igor@470: soporte de plantillas y estilos a otras órdenes.
igor@470: 
igor@470: \section{Cuestiones básicas de plantillas}
igor@470: 
igor@470: Una plantilla de Mercurial es sencillamente una pieza de texto.
igor@470: Cierta porción nunca cambia, otras partes se \emph{expanden}, o
igor@470: reemplazan con texto nuevo cuando es necesario.
igor@470: 
igor@470: Antes de continuar, veamos de nuevo un ejemplo sencillo de la salida
igor@470: usual de Mercurial:
igor@402: 
igor@402: \interaction{template.simple.normal}
igor@402: 
igor@470: Ahora, ejecutemos la misma orden, pero usemos una plantilla para
igor@470: modificar su salida:
igor@402: 
igor@402: \interaction{template.simple.simplest}
igor@402: 
igor@470: El ejemplo anterior ilustra la plantilla más sencilla posible;  es
igor@470: solamente una porción estática de código que se imprime una vez por
igor@470: cada conjunto de cambios.  La opción \hgopt{log}{--template} de la
igor@470: orden \hgcmd{log} indica a Mercurial usar el texto dado como la
igor@470: plantilla cuando se imprime cada conjunto de cambios.
igor@470: 
igor@470: Observe que la cadena de plantilla anterior termina con el texto
igor@470: ``\Verb+\n+''.  Es una \emph{secuencia de control}, que le indica a
igor@470: Mercurial imprimira una nueva línea al final de cada objeto de la
igor@470: plantilla.  Si omite esta nueva línea, Mercurial colocará cada pieza
igor@470: de salida seguida.  Si desea más detalles acerca de secuencias de
igor@470: control, vea la sección~\ref{sec:template:escape}.
igor@470: 
igor@470: Una plantilla que imprime una cadena fija de texto siempre no es muy
igor@470: útil; intentemos algo un poco más complejo.
igor@402: 
igor@402: \interaction{template.simple.simplesub}
igor@402: 
igor@470: Como puede ver, la cadena ``\Verb+{desc}+'' en la plantilla ha sido
igor@470: reemplazada en la salida con la descricipción de cada conjunto de
igor@470: cambios.  Cada vez que Mercurial encuentra texto encerrado entre
jerojasro@520: corchetes (``\texttt{\{}'' y ``\texttt{\}}''), intentará reemplazar los
igor@470: corchetes y el texto con la expansión de lo que sea está adentro.
igor@470: Para imprimir un corchete de forma literal, debe escaparlo, como se
igor@470: describe en la sección~\ref{sec:template:escape}.
igor@470: 
igor@470: \section{Palabras claves más comunes en las plantillas}
igor@402: \label{sec:template:keyword}
igor@402: 
igor@470: Puede empezar a escribir plantillas sencillas rápidamente con las
igor@470: palabras claves descritas a continuación:
igor@470: 
igor@470: \begin{itemize}
igor@470: \item[\tplkword{author}] Cadena.  El autor NO modificado del conjunto
igor@470:   de cambios.
igor@470: \item[\tplkword{branches}] Cadena.  El nombre de la rama en la cual se
igor@470:   consignó el conjunto de cambios.  Será vacía si el nombre de la rama es
igor@402:   \texttt{default}.
igor@470: \item[\tplkword{date}] Información de fecha.  La fecha en la cual se
igor@470:   consignó el conjunto de cambios.  \emph{No} es legible por un
igor@470:   humano, debe pasarla por un firltro que la desplegará
igor@470:   apropiadamente.  En la sección~\ref{sec:template:filter} hay más
igor@470:   detalles acerca de filtros.  La fecha se expresa como un par de
igor@470:   números.  El primer número corresponde a una marca de tiempo UNIX
jerojasro@520:   UTC (segundos desde el primero de enero de 1970); la segunda es el
igor@470:   corrimiento horario de la zona horaria del UTC en la cual se encontraba
igor@470:   quien hizo la consignación, en segundos.
igor@470: \item[\tplkword{desc}] Cadena.  La descripción en texto del conjunto
igor@470:   de cambios.
igor@470: \item[\tplkword{files}] Lista de cadenas.  Todos los ficheros
igor@470:   modificados, adicionados o eliminados por este conjunto de cambios.
igor@470: \item[\tplkword{file\_adds}] Lista de cadenas.  Ficheros adicionados
igor@470:   por este conjunto de cambios.
igor@470: \item[\tplkword{file\_dels}] Lista de cadenas.  Ficheros eliminados
igor@470:   por este conjunto de cambios.
igor@470: \item[\tplkword{node}] Cadena.  El hash de identificación de este
igor@470:   conjunto de cambios como una cadena hexadecimal de 40 caracteres.
igor@470: \item[\tplkword{parents}] Lista de cadenas.  Los ancestros del
igor@470:   conjunto de cambios.
igor@470: \item[\tplkword{rev}] Entero.  El número de revisión del repositorio
igor@470:   local.
igor@470: \item[\tplkword{tags}] Lista de cadenas.  Todas las etiquetas
igor@470:   asociadas al conjunto de cambios.
igor@470: \end{itemize}
igor@470: 
igor@470: Unos experimentos sencillos nos mostrarán qué esperar cuando usamos
igor@470: estas palabras claves; puede ver los resultados en la
igor@470: figura~\ref{fig:template:keywords}.
igor@402: 
igor@402: \begin{figure}
igor@402:   \interaction{template.simple.keywords}
igor@402:   \caption{Template keywords in use}
igor@402:   \label{fig:template:keywords}
igor@402: \end{figure}
igor@402: 
igor@470: Como mencionamos anteriormente, la palabra clave de fecha no produce
igor@470: salida legible por un humano, debemos tratarla de forma especial.
igor@470: Esto involucra usar un \emph{filtro}, acerca de lo cual hay más en la
igor@470: sección~\ref{sec:template:filter}.
igor@402: 
igor@402: \interaction{template.simple.datekeyword}
igor@402: 
igor@470: \section{Secuencias de Control}
igor@402: \label{sec:template:escape}
igor@402: 
igor@470: El motor de plantillas de Mercurial reconoce las secuencias de control
igor@470: más comunmente usadas dentro de las cadenas.  Cuando ve un backslash
igor@470: (``\Verb+\+''), ve el caracter siguiente y sustituye los dos
igor@470: caracteres con un reemplazo sencillo, como se describe a continuación:
igor@402: 
igor@402: \begin{itemize}
igor@402: \item[\Verb+\textbackslash\textbackslash+] Backslash, ``\Verb+\+'',
igor@402:   ASCII~134.
igor@470: \item[\Verb+\textbackslash n+] Nueva línea, ASCII~12.
igor@470: \item[\Verb+\textbackslash r+] Cambio de línea, ASCII~15.
igor@402: \item[\Verb+\textbackslash t+] Tab, ASCII~11.
igor@470: \item[\Verb+\textbackslash v+] Tab Vertical, ASCII~13.
igor@470: \item[\Verb+\textbackslash \{+] Corchete abierto, ``\Verb+{+'', ASCII~173.
igor@470: \item[\Verb+\textbackslash \}+] Corchete cerrado, ``\Verb+}+'', ASCII~175.
igor@470: \end{itemize}
igor@470: 
igor@470: Como se indicó arriba, si desea que la expansión en una plantilla
igor@470: contenga un caracter literal ``\Verb+\+'', ``\Verb+{+'', o
igor@470:   ``\Verb+{+'', debe escaparlo.
igor@470: 
igor@470: \section{Uso de filtros con palabras claves}
igor@402: \label{sec:template:filter}
igor@402: 
igor@470: Algunos de los resultados de la expansión de la plantilla no son
igor@470: fáciles de usar de inmediato.  Mercurial le permite especificar una
igor@470: cadena de \emph{filtros} opcionales para modificar el resultado de
igor@470: expandir una palabra clave.  Ya ha visto el filtro usual
igor@470: \tplkwfilt{date}{isodate} en acción con anterioridad para hacer
igor@470: legible la fecha.
igor@470: 
igor@470: A continuación hay una lista de los filtros de Mercurial más
igor@470: comunmente usados.  Ciertos filtros pueden aplicarse a cualquier
igor@470: texto, otros pueden usarse únicamente en circunstancias específicas.
igor@470: El nombre de cada filtro está seguido de la indicación de dónde puede
igor@470: ser usado y una descripción de su efecto.
igor@470: 
igor@470: \begin{itemize}
igor@470: \item[\tplfilter{addbreaks}] Cualquier texto. Añade una etiqueta XHTML
igor@470:   ``\Verb+<br/>+'' antes del final de cada línea excepto en la final.
igor@470:   Por ejemplo, ``\Verb+foo\nbar+'' se convierte en ``\Verb+foo<br/>\nbar+''.
igor@470: \item[\tplkwfilt{date}{age}] palabra clave \tplkword{date}.  Muestra
igor@470:   la edad de la fecha, relativa al tiempo actual. Ofrece una cadena como
igor@402:   ``\Verb+10 minutes+''.
igor@470: \item[\tplfilter{basename}] Cualquier texto, pero de utilidad sobre
igor@470:   todo en palabras claves relativas a \tplkword{ficheros}.  Trata el
igor@470:   texto como una ruta, retornando el nombre base.  Por ejemplo,
igor@470:   ``\Verb+foo/bar/baz+'', se convierte en ``\Verb+baz+''.
igor@473: \item[\tplkwfilt{date}{date}] \tplkword{date} palabra clave.  Mostrar
igor@473:   la fecha en un formato similar a la orden \tplkword{date} de 
igor@473:   in a similar format to the Unix, pero con la zona horaria incluída.
igor@473:   Una cadena como ``\Verb+Mon Sep 04 15:13:13 2006 -0700+''.
igor@473: \item[\tplkwfilt{author}{domain}] Cualquier texto, pero de mayor
igor@473:   utilidad para la palabra clave \tplkword{author}.  Encuentra la
igor@473:   primera cadena que luce como una dirección de correo electrónico, y
igor@473:   extrae solamente el componente del dominio.  Por ejemplo, de 
igor@473:   ``\Verb+Bryan O'Sullivan <bos@serpentine.com>+'' se extrae
igor@402:   ``\Verb+serpentine.com+''.
igor@473: \item[\tplkwfilt{author}{email}] Cualquier texto, pero de mayor
igor@473:   utilidad para la palabra clave \tplkword{author}.  Extrae la primera
igor@473:   cadena que luce como una dirección de correo. Por ejemplo, de
igor@473:   ``\Verb+Bryan O'Sullivan <bos@serpentine.com>+'' extrae 
igor@402:   ``\Verb+bos@serpentine.com+''.
igor@473: \item[\tplfilter{escape}] Cualquier texto.  Reemplaza los caracteres
igor@473:   especiales de XML/XHTML: ``\Verb+&+'', ``\Verb+<+'' y ``\Verb+>+''
igor@473:   con las entidades XML.
jerojasro@525: \item[\tplfilter{fill68}] Cualquier texto. Lograr que el texto ocupe
igor@473:   las primeras 68 columnas.  Es útil emplearlo antes de pasar el texto
igor@473:   por el filtro \tplfilter{tabindent}, y queremos que aún quepa en una
igor@473:   ventana de fuente fija y 80 columnas.
igor@473: \item[\tplfilter{fill76}] Cualquier texto.  Lograr que el texto quepa
igor@473:   en 76 columnas.
igor@473: \item[\tplfilter{firstline}] Cualquier texto.  Mostrar la primera
igor@473:   línea de texto sin saltos de línea.
igor@473: \item[\tplkwfilt{date}{hgdate}] \tplkword{date} palabra clave.
igor@473:   Mostrar la fecha como un par de números legibles.  Muestra una
igor@473:   cadena como ``\Verb+1157407993 25200+''.
igor@473: \item[\tplkwfilt{date}{isodate}] \tplkword{date} palabra clave.
igor@473:   Mostrar la fecha como una cadena de texto en el formato.  Muestra
igor@473:   una cadena como ``\Verb+2006-09-04 15:13:13 -0700+''.
igor@473: \item[\tplfilter{obfuscate}] Cualquier texto, pero de mayor utilidad
igor@473:   para la palabra clave \tplkword{author}.  Muestra el campo de texto
igor@473:   como una secuencia de entidades XML.  Esto ayuda a eliminar ciertos
igor@473:   robots estúpidos de adquisición de correo.
igor@473: \item[\tplkwfilt{author}{person}] Cualquier texto, útil sobre todo
igor@473:   para la palabra clave \tplkword{author}.  Muestra el texto que hay
igor@473:   antes de la dirección de correo electrónico.  Por ejemplo,
igor@473:   ``\Verb+Bryan O'Sullivan <bos@serpentine.com>+'' mostraría
igor@473:   ``\Verb+Bryan O'Sullivan+''.
igor@473: \item[\tplkwfilt{date}{rfc822date}] \tplkword{date} palabra clave.
igor@473:   Muestra una fecha con el mismo formato que se usa en los encabezados
igor@473:   de correo.  Mostraría una cadena como
igor@473:  ``\Verb+Mon, 04 Sep 2006 15:13:13 -0700+''.
igor@473: \item[\tplkwfilt{node}{short}] Hash del conjunto de cambios.  Muestra
igor@473:   la forma corta de un hash de conjunto de cambios, 
igor@473:   of a changeset hash, p.e.~una cadena hexadecimal de 12 bytes.
igor@473: \item[\tplkwfilt{date}{shortdate}] \tplkword{date} palabra clave.
igor@473:   Mostrar año, mes y día de una fecha.  Muestrauna cadena como
igor@402:   ``\Verb+2006-09-04+''.
igor@473: \item[\tplfilter{strip}] Cualquier texto.  Elimina todos los espacios
igor@473:   en blanco al principio y al final de la cadena.
igor@473: \item[\tplfilter{tabindent}] Cualquier texto.  Muestra el texto con
igor@473:   todas las líneas excepto la primera que comience con el caracter tab.
igor@473: \item[\tplfilter{urlescape}] Cualquier texto.  Escapa todos los
igor@473:   caracteres que se consideren como ``especiales'' por los parsers de
igor@473:   URL.  Por ejemplo, \Verb+foo bar+ se convierte en \Verb+foo%20bar+.
igor@473: \item[\tplkwfilt{author}{user}] Cualquier texto, útil sobre todo para
igor@473:   la palabra clave \tplkword{author}.  Retorna el ``usuario'' de una
igor@473:   dirección de correo.  Por ejemplo, 
igor@473:   ``\Verb+Bryan O'Sullivan <bos@serpentine.com>+'' se convierte en 
igor@402:   ``\Verb+bos+''.
igor@402: \end{itemize}
igor@402: 
igor@402: \begin{figure}
igor@402:   \interaction{template.simple.manyfilters}
igor@473:   \caption{Filtros de plantilla en acción}
igor@402:   \label{fig:template:filters}
igor@402: \end{figure}
igor@402: 
igor@402: \begin{note}
igor@473:   Si trata de aplicar un filtro a una porción de datos que no puede
igor@473:   procesarse, Mercurial fallará e imprimirá una excepción de Python.
igor@473:   Por ejemplo, el tratar de usar la salida de la palabra clave
igor@473:   \tplkword{desc} con el filtro \tplkwfilt{date}{isodate} no resultará
igor@473:   algo útil.
igor@402: \end{note}
igor@402: 
igor@473: \subsection{Combinar filtros}
igor@473: 
igor@473: Combinar filtros es para generar una salida en la forma como usted lo
igor@473: desea es muy sencillo.  La cadena de filtros siguientes arman una
igor@473: descripción, después aseguran que cabe limpiamente en 68 columnas, y
igor@473: las indenta con 8~caracteres (por lo menos en sistemas tipo Unix, en
igor@473: los que el tab por convención se extiende en 8~caracteres).
igor@402: 
igor@402: \interaction{template.simple.combine}
igor@402: 
igor@473: Observe el uso de ``\Verb+\t+'' (un caracter tab) en la plantilla para
igor@473: forzar que la primera línea se indente; esto es necesario para lograr
igor@473: que la primera línea luzca indentada;  es necesario debido a que
igor@473: \tplkword{tabindent} indenta todas las líneas \emph{excepto} la primera.
igor@473: 
igor@473: Tenga en cuenta que el orden de los filtros importa.  El primer filtro
igor@473: se aplica primero al resultado de la palabra clave; el segundo al
igor@473: resultado de la aplicación del primer filtro y así sucesivamente.  Por
igor@473: ejemplo, usar \Verb+fill68|tabindent+ es muy distinto al resultado de
igor@473: usar \Verb+tabindent|fill68+.
igor@473: 
igor@473: 
igor@473: \section{De plantillas a estilos}
igor@473: 
igor@473: Una plantilla provee una forma rápida y sencilla para dar formato a
igor@473: una salida.  Las plantillas pueden volvers verbosas, y es útil poder
igor@473: darle un nombre a una plantilla.  Un fichero de estilo es una
igor@473: plantilla con un nombre, almacenado en un fichero.
igor@473: 
igor@473: Más aún, al usar un fichero de estilo se dispara el poder del motor de
igor@473: plantillas en un nivel imposible de alcanzar usando las opción
igor@473: \hgopt{log}{--template} desde la línea de órdenes.
igor@473: 
igor@473: 
igor@473: \subsection{Los ficheros de estilo más sencillos}
igor@473: 
igor@473: Nuestro fichero sencillo de estilo contiene una sola línea:
igor@402: 
igor@402: \interaction{template.simple.rev}
igor@402: 
igor@473: Se le indica a Mercurial, ``si está imprimiendo un conjunto de
igor@473: cambios, use el texto de la derecha como la plantilla''.
igor@473: 
igor@473: \subsection{Sintaxis de ficheros de estilo}
igor@473: 
igor@473: Las reglas de sintaxis para un fichero de estilo son sencillas:
igor@473: 
igor@473: \begin{itemize}
igor@473: \item El fichero se procesa línea por línea.
igor@473: 
igor@473: \item Se ignoran el espacio en blanco circundante.
igor@473: 
igor@473: \item Se omiten las líneas en blanco.
igor@473: 
igor@473: \item Si una línea comienza con los caracteres ``\texttt{\#}'' o
igor@473:   ``\texttt{;}'', la línea completa se trata como un comentario, y se
igor@473:   omite como si fuera vacía.
igor@473: 
igor@473: \item Una línea comienza con una palabra clave.  Esta debe comenzar
igor@473:   con una caracter alfabético o una raya al piso, y puede contener
igor@473:   subsecuentemente cualquier caracter alfanumérico o una raya al
igor@473:   piso.  (En notación de expresiones regulares debe coincidir con
igor@473:   \Verb+[A-Za-z_][A-Za-z0-9_]*+.)
igor@473: 
igor@473: \item El próximo elemento debe ser un caracter ``\texttt{=}'', que
igor@473:   puede estar precedido o seguido por una cantidad arbitraria de
igor@473:   espacio.
igor@473: 
igor@473: \item Si el resto de la línea comienza y termina con caracteres
jerojasro@520:   encerrados entre caracteres de comillas (bien sea sencillas o
igor@473:   dobles),  se trata como cuerpo de la plantilla.
igor@473: 
igor@473: \item Si el resto de la línea \emph{no} comienza con una comilla, se
igor@473:   trata como el nombre de un fichero; los contenidos de este fichero
igor@473:   se leerán y se usarán como cuerpo de la plantilla.
igor@473: \end{itemize}
igor@473: 
igor@473: \section{Ejemplos de ficheros de estilos}
igor@473: 
igor@473: Para ilustrar la creación de un fichero de estilo, construiremos
igor@473: algunos ejemplos.  En lugar de ofrecer un fichero completo de estilo y
igor@473: analizarlo, replicaremos el proceso usual de desarrollo de un fichero
igor@473: de estilo comenzando con algo muy sencillo, y avanzando por una serie
igor@473: de ejemplos sucesivos más completos.
igor@473: 
igor@473: \subsection{Identificar equivocaciones en ficheros de estilo}
igor@473: 
igor@473: Si Mercurial encuentra un problema en un fichero de estilo en el cual
igor@473: usted está trabajando, imprime un mensaje de error suscinto, cuando
igor@473: usted identifique lo que significa, resulta muy útil.
igor@402: 
igor@402: \interaction{template.svnstyle.syntax.input}
igor@402: 
igor@473: Tenga en cuenta que \filename{broken.style} trata de definir la
igor@473: palabra clave \texttt{changeset}, pero omite dar un contenido para esta.
igor@473: Cuando se le indica a Mercurial que use este fichero de estilo, se
igor@473: queja inmediatamente.
igor@402: 
igor@402: \interaction{template.svnstyle.syntax.error}
igor@402: 
igor@473: Este mensaje de error luce intimidante, pero no es muy difícil de
igor@473: seguir:
igor@473: 
igor@473: \begin{itemize}
igor@473: \item El primer componente es la forma como Mercurial dice ``me rindo''.
igor@402:   \begin{codesample4}
igor@402:     \textbf{abort:} broken.style:1: parse error
igor@402:   \end{codesample4}
igor@402: 
igor@473: \item A continuación viene el nombre del fichero que contiene el error.
igor@402:   \begin{codesample4}
igor@402:     abort: \textbf{broken.style}:1: parse error
igor@402:   \end{codesample4}
igor@402: 
igor@473: \item Siguendo el nombre del fichero viene el número de línea en la
igor@473:   que se encontró el error.
igor@402:   \begin{codesample4}
igor@402:     abort: broken.style:\textbf{1}: parse error
igor@402:   \end{codesample4}
igor@402: 
igor@473: \item Finalmente, la descripción de lo que falló.
igor@402:   \begin{codesample4}
igor@402:     abort: broken.style:1: \textbf{parse error}
igor@402:   \end{codesample4}
jerojasro@520:   La descripción del problema no siempre es clara (como en este caso),
igor@473:   pero aunque sea críptica, casi siempre es trivial la inspección
igor@473:   visual de la línea en el fichero de estilo y encontrar lo que está
igor@473:   mal.
igor@473: \end{itemize}
igor@473: 
igor@473: \subsection{Identificar de forma única un repositorio}
igor@473: 
igor@473: Si desea identificar un repositorio de Mercurial ``de forma única''
igor@473: con una cadena corta como identificador, puede usar la primera
igor@473: revisión en el repositorio.
igor@402: \interaction{template.svnstyle.id} 
igor@473: No es garantía de unicidad, pero no es útill en ciertos casos:
igor@402: many cases.
igor@402: \begin{itemize}
igor@473: \item No funcionará en un repositorio completamente vacío, porque un
igor@473:   repositorio así no tiene una revisión~zero.
jerojasro@520: \item Tampoco funcionará en caso (muy raro) cuando el repositorio sea
igor@473:   una fusión de dos repositorios independientes y tiene los dos
igor@473:   directorios por ahí.
igor@473: \end{itemize}
igor@473: Hay ciertos casos en los cuales podría colocar el identificador:
igor@473: \begin{itemize}
igor@473: \item Como una llave en la tabla de una base de datos que administra
igor@473:   repositorios en un servidor.
igor@473: \item Como una parte del par \{\emph{ID~repositorio}, \emph{ID~revisión}\}.
igor@473:   Almacene esta información de forma independiente cuando ejecute
igor@473:   construcciones automatizadas u otras actividades, de forma que pueda
igor@473:   ``reconstruir'' posteriormente en caso de ser necesario.
igor@473: \end{itemize}
igor@473: 
igor@473: \subsection{Mostrando salida parecida a Subversion}
igor@473: 
igor@473: Intentemos emular la salida usual que usa otro sistema de control de
igor@473: revisiones,  Subversion.
igor@402: \interaction{template.svnstyle.short}
igor@402: 
igor@473: Dado que la salida de Subversion es sencilla, es fácil copiar y pegar
igor@473: una porción de su salida en un fichero, y reemplazar el texto
igor@473: producido previamente por Subversion con valores base que quisiéramos
igor@473: ver expandidos.
igor@402: \interaction{template.svnstyle.template}
igor@402: 
igor@473: Esta plantilla difiere en algunos detalles de la salida producida por
igor@473: Subversion:
igor@473: \begin{itemize}
igor@473: \item Subversion imprime una fecha ``legible'' (el ``\texttt{Wed, 27 Sep
igor@473:     2006}'' en el ejemplo de salida anterior) en paréntesis.  El motor
igor@473:   de plantillas de Mercurial no ofrece una forma sencilla de desplegar
igor@473:   una fecha en este formato sin imprimir también la hora y la zona horaria.
igor@473: \item Emulamos las líneas de ``separación'' de subversion con caracteres
igor@473:   ``\texttt{-}'' en una línea.  Usamos la palabra clave
igor@473:   \tplkword{header} del motor de plantillas para imprimir una línea de
jerojasro@520:   separación como la primera línea de salida (ver más abajo), para
igor@473:   lograr una salida similara a la de Subversion.
igor@473: \item La salida de subversion incluye un conteo en el encabezado del
igor@473:   número de líneas en el mensaje de consinación.  No podemos
igor@473:   replicarlo en Mercurial; el motor de plantilla no ofrece en la
igor@473:   actualidad un filtro que cuente la cantidad de objetos que se le
igor@473:   pasen.
igor@473: \end{itemize}
igor@473: No me tomó más de un minuto o dos de trabajo para reemplazar texto
igor@473: literal de un ejemplo de salida de la salida de Subversion con ciertas
igor@473: palabras claves y filtros para ofrecer la plantilla anterior.  El
igor@473: fichero de estilo se refiere sencillamente a la plantilla.
igor@402: \interaction{template.svnstyle.style}
igor@402: 
igor@473: Podríamos haber incluído el texto del fichero plantilla directamente
igor@473: en el fichero de estilo encerrando entre comillas y reemplazando las
igor@473: nuevas líneas con secuencias ``\verb!\n!'', pero haría muy difícil de
jerojasro@516: leer el fichero de estilos.  La facilidad para leer es importante
igor@473: cuando está decidiendo si un texto pertenece a un fichero de estilo o
igor@473: a un fichero de plantilla incluído en el estilo.  Si el fichero de
igor@473: estilo luce muy grande o complicado, si inserta una pieza de texto
igor@473: literal, mejor colóquelo en una plantilla.
igor@402: 
igor@402: %%% Local Variables: 
igor@402: %%% mode: latex
igor@402: %%% TeX-master: "00book"
igor@402: %%% End: 




