1.1 --- a/es/Leame.1st	Wed Dec 24 08:06:54 2008 -0500
     1.2 +++ b/es/Leame.1st	Wed Dec 24 12:40:20 2008 -0500
     1.3 @@ -105,7 +105,7 @@
     1.4  || intro.tex       || Igor Támara   ||	  100%	  || 08/11/2008	||  09/11/2008 ||
     1.5  || collab.tex      || Igor Támara   ||    100%    || 10/11/2008 ||  06/12/2008 ||
     1.6  || filenames.tex   || Javier Rojas  ||     72%    || 27/11/2008 ||             ||
     1.7 -|| hook.tex        || Javier Rojas  ||     48%    || 01/12/2008 ||             ||
     1.8 +|| hook.tex        || Javier Rojas  ||     53%    || 01/12/2008 ||             ||
     1.9  || mq.tex          || Igor Támara   ||    100%    || 06/12/2008 ||  13/12/2008 ||
    1.10  || hgext.tex       || Igor Támara   ||    100%    || 13/12/2008 ||  16/12/2008 ||
    1.11  || template.tex    || Igor Támara   ||            ||            ||             ||

     2.1 --- a/es/hook.tex	Wed Dec 24 08:06:54 2008 -0500
     2.2 +++ b/es/hook.tex	Wed Dec 24 12:40:20 2008 -0500
     2.3 @@ -728,67 +728,73 @@
     2.4    actualizar el estado del fallo 31337 a ``requiere pruebas''.
     2.5  \end{itemize}
     2.6  
     2.7 -\subsubsection{Configuring the \hook{bugzilla} hook}
     2.8 +\subsubsection{Configuración del gancho \hook{bugzilla}}
     2.9  \label{sec:hook:bugzilla:config}
    2.10  
    2.11 -You should configure this hook in your server's \hgrc\ as an
    2.12 -\hook{incoming} hook, for example as follows:
    2.13 +Usted debería configurar este gancho en el \hgrc\ de su servidor como
    2.14 +un gancho \hook{incoming}\footnote{Entrante.}, por ejemplo como sigue:
    2.15  \begin{codesample2}
    2.16    [hooks]
    2.17    incoming.bugzilla = python:hgext.bugzilla.hook
    2.18  \end{codesample2}
    2.19  
    2.20 -Because of the specialised nature of this hook, and because Bugzilla
    2.21 -was not written with this kind of integration in mind, configuring
    2.22 -this hook is a somewhat involved process.
    2.23 -
    2.24 -Before you begin, you must install the MySQL bindings for Python on
    2.25 -the host(s) where you'll be running the hook.  If this is not
    2.26 -available as a binary package for your system, you can download it
    2.27 -from~\cite{web:mysql-python}.
    2.28 -
    2.29 -Configuration information for this hook lives in the
    2.30 -\rcsection{bugzilla} section of your \hgrc.
    2.31 -\begin{itemize}
    2.32 -\item[\rcitem{bugzilla}{version}] The version of Bugzilla installed on
    2.33 -  the server.  The database schema that Bugzilla uses changes
    2.34 -  occasionally, so this hook has to know exactly which schema to use.
    2.35 -  At the moment, the only version supported is \texttt{2.16}.
    2.36 -\item[\rcitem{bugzilla}{host}] The hostname of the MySQL server that
    2.37 -  stores your Bugzilla data.  The database must be configured to allow
    2.38 -  connections from whatever host you are running the \hook{bugzilla}
    2.39 -  hook on.
    2.40 -\item[\rcitem{bugzilla}{user}] The username with which to connect to
    2.41 -  the MySQL server.  The database must be configured to allow this
    2.42 -  user to connect from whatever host you are running the
    2.43 -  \hook{bugzilla} hook on.  This user must be able to access and
    2.44 -  modify Bugzilla tables.  The default value of this item is
    2.45 -  \texttt{bugs}, which is the standard name of the Bugzilla user in a
    2.46 -  MySQL database.
    2.47 -\item[\rcitem{bugzilla}{password}] The MySQL password for the user you
    2.48 -  configured above.  This is stored as plain text, so you should make
    2.49 -  sure that unauthorised users cannot read the \hgrc\ file where you
    2.50 -  store this information.
    2.51 -\item[\rcitem{bugzilla}{db}] The name of the Bugzilla database on the
    2.52 -  MySQL server.  The default value of this item is \texttt{bugs},
    2.53 -  which is the standard name of the MySQL database where Bugzilla
    2.54 -  stores its data.
    2.55 -\item[\rcitem{bugzilla}{notify}] If you want Bugzilla to send out a
    2.56 -  notification email to subscribers after this hook has added a
    2.57 -  comment to a bug, you will need this hook to run a command whenever
    2.58 -  it updates the database.  The command to run depends on where you
    2.59 -  have installed Bugzilla, but it will typically look something like
    2.60 -  this, if you have Bugzilla installed in
    2.61 -  \dirname{/var/www/html/bugzilla}:
    2.62 +Debido a la naturaleza especializada de este gancho, y porque Bugzilla
    2.63 +no fue escrito con este tipo de integración en mente, configurar este
    2.64 +% TODO involved => complejo ? no intarwebs here :(
    2.65 +gancho es un proceso algo complejo.
    2.66 +
    2.67 +Antes de empezar, usted debe instalar la interfaz de Python para MySQL
    2.68 +en los sistemas en los que se vaya a ejecutar el gancho. Si no está
    2.69 +disponible como paquete binario para su sistema, usted puede descargar
    2.70 +el paquete desde~\cite{web:mysql-python}.
    2.71 +
    2.72 +La información para configurar este gancho se ubica en la sección 
    2.73 +\rcsection{bugzilla} de su \hgrc.
    2.74 +\begin{itemize}
    2.75 +\item[\rcitem{bugzilla}{version}] La versión de Bugzilla instalada en
    2.76 +  el servidor. El esquema de base de datos que Bugzilla usa cambia
    2.77 +  ocasionalmente, así que este gancho debe saber exactamente qué
    2.78 +  esquema usar. A la fecha, la única versión soportada es la
    2.79 +  \texttt{2.16}.
    2.80 +\item[\rcitem{bugzilla}{host}] El nombre de máquina (\emph{hostname})
    2.81 +  del servidor MySQL que almacena sus datos Bugzilla. La base de datos
    2.82 +  debe ser configurada para permitir conexiones desde las máquinas en
    2.83 +  las que usted ejecute el gancho \hook{bugzilla}.
    2.84 +\item[\rcitem{bugzilla}{user}] El nombre de usuario que se usará para
    2.85 +  conectarse al servidor MySQL. La base de datos debe ser configurada
    2.86 +  para permitir a dicho usuario conectarse desde cualquiera de las
    2.87 +  máquinas en las que se ejecute el gancho \hook{bugzilla}.  Este
    2.88 +  usuario debe tener acceso y poder modificar las tablas de Bugzilla.
    2.89 +  El valor por defecto para este ítem es \texttt{bugs}, que es el
    2.90 +  nombre estándar del usuario para Bugzilla en una base de datos
    2.91 +  MySQL.
    2.92 +\item[\rcitem{bugzilla}{password}] La contraseña MySQL para el usuario
    2.93 +  configurado anteriormente. Ésta es almacenada como texto plano, así
    2.94 +  que usted deberá asegurarse de que los usuarios no autorizados no
    2.95 +  puedan leer el fichero \hgrc\ en donde usted guarda esta
    2.96 +  información.
    2.97 +\item[\rcitem{bugzilla}{db}] El nombre de la base de datos Bugzilla en
    2.98 +  el servidor MySQL. El nombre por defecto para este ítem es
    2.99 +  \texttt{bugs}, que es el nombre estándar de la base de datos MySQL
   2.100 +  en donde Bugzilla almacena sus datos.
   2.101 +\item[\rcitem{bugzilla}{notify}] Si usted desea que Bugzilla envíe un
   2.102 +    %TODO suBscriptores?
   2.103 +  correo de notificación a los suscriptores después de que el gancho
   2.104 +  haya añadido un comentario a un fallo, necesitará que este gancho
   2.105 +  ejecute un comando siempre que actualice la base de datos. El
   2.106 +  comando que se ejecute depende de en dónde haya sido instalado
   2.107 +  Bugzilla, pero típicamente se verá así, si usted ha instalado
   2.108 +  Bugzilla en \dirname{/var/www/html/bugzilla}:
   2.109    \begin{codesample4}
   2.110      cd /var/www/html/bugzilla && ./processmail %s nobody@nowhere.com
   2.111    \end{codesample4}
   2.112 -  The Bugzilla \texttt{processmail} program expects to be given a
   2.113 -  bug~ID (the hook replaces ``\texttt{\%s}'' with the bug~ID) and an
   2.114 -  email address.  It also expects to be able to write to some files in
   2.115 -  the directory that it runs in.  If Bugzilla and this hook are not
   2.116 -  installed on the same machine, you will need to find a way to run
   2.117 -  \texttt{processmail} on the server where Bugzilla is installed.
   2.118 +  El programa \texttt{processmail} de Bugzilla espera recibir un ID de
   2.119 +  fallo (el gancho reemplaza ``\texttt{\%s}'' por el ID del fallo) y
   2.120 +  una dirección de correo. También espera poder escribir a ciertos
   2.121 +  ficheros en el directorio en que se ejecuta. Si Bugzilla y éste
   2.122 +  gancho no están instalados en la misma máquina, usted deberá
   2.123 +  encontrar una manera de ejecutar \texttt{processmail} en el servidor
   2.124 +  donde está instalado Bugzilla.
   2.125  \end{itemize}
   2.126  
   2.127  \subsubsection{Mapping committer names to Bugzilla user names}