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+
+'' antes del final de cada línea excepto en la final. igor@470: Por ejemplo, ``\Verb+foo\nbar+'' se convierte en ``\Verb+foo
\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 +'' 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 +'' 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 +'' 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 +'' 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: