1.1 --- a/es/hook.tex	Wed Dec 24 08:06:54 2008 -0500
     1.2 +++ b/es/hook.tex	Wed Dec 24 12:40:20 2008 -0500
     1.3 @@ -728,67 +728,73 @@
     1.4    actualizar el estado del fallo 31337 a ``requiere pruebas''.
     1.5  \end{itemize}
     1.6  
     1.7 -\subsubsection{Configuring the \hook{bugzilla} hook}
     1.8 +\subsubsection{Configuración del gancho \hook{bugzilla}}
     1.9  \label{sec:hook:bugzilla:config}
    1.10  
    1.11 -You should configure this hook in your server's \hgrc\ as an
    1.12 -\hook{incoming} hook, for example as follows:
    1.13 +Usted debería configurar este gancho en el \hgrc\ de su servidor como
    1.14 +un gancho \hook{incoming}\footnote{Entrante.}, por ejemplo como sigue:
    1.15  \begin{codesample2}
    1.16    [hooks]
    1.17    incoming.bugzilla = python:hgext.bugzilla.hook
    1.18  \end{codesample2}
    1.19  
    1.20 -Because of the specialised nature of this hook, and because Bugzilla
    1.21 -was not written with this kind of integration in mind, configuring
    1.22 -this hook is a somewhat involved process.
    1.23 -
    1.24 -Before you begin, you must install the MySQL bindings for Python on
    1.25 -the host(s) where you'll be running the hook.  If this is not
    1.26 -available as a binary package for your system, you can download it
    1.27 -from~\cite{web:mysql-python}.
    1.28 -
    1.29 -Configuration information for this hook lives in the
    1.30 -\rcsection{bugzilla} section of your \hgrc.
    1.31 -\begin{itemize}
    1.32 -\item[\rcitem{bugzilla}{version}] The version of Bugzilla installed on
    1.33 -  the server.  The database schema that Bugzilla uses changes
    1.34 -  occasionally, so this hook has to know exactly which schema to use.
    1.35 -  At the moment, the only version supported is \texttt{2.16}.
    1.36 -\item[\rcitem{bugzilla}{host}] The hostname of the MySQL server that
    1.37 -  stores your Bugzilla data.  The database must be configured to allow
    1.38 -  connections from whatever host you are running the \hook{bugzilla}
    1.39 -  hook on.
    1.40 -\item[\rcitem{bugzilla}{user}] The username with which to connect to
    1.41 -  the MySQL server.  The database must be configured to allow this
    1.42 -  user to connect from whatever host you are running the
    1.43 -  \hook{bugzilla} hook on.  This user must be able to access and
    1.44 -  modify Bugzilla tables.  The default value of this item is
    1.45 -  \texttt{bugs}, which is the standard name of the Bugzilla user in a
    1.46 -  MySQL database.
    1.47 -\item[\rcitem{bugzilla}{password}] The MySQL password for the user you
    1.48 -  configured above.  This is stored as plain text, so you should make
    1.49 -  sure that unauthorised users cannot read the \hgrc\ file where you
    1.50 -  store this information.
    1.51 -\item[\rcitem{bugzilla}{db}] The name of the Bugzilla database on the
    1.52 -  MySQL server.  The default value of this item is \texttt{bugs},
    1.53 -  which is the standard name of the MySQL database where Bugzilla
    1.54 -  stores its data.
    1.55 -\item[\rcitem{bugzilla}{notify}] If you want Bugzilla to send out a
    1.56 -  notification email to subscribers after this hook has added a
    1.57 -  comment to a bug, you will need this hook to run a command whenever
    1.58 -  it updates the database.  The command to run depends on where you
    1.59 -  have installed Bugzilla, but it will typically look something like
    1.60 -  this, if you have Bugzilla installed in
    1.61 -  \dirname{/var/www/html/bugzilla}:
    1.62 +Debido a la naturaleza especializada de este gancho, y porque Bugzilla
    1.63 +no fue escrito con este tipo de integración en mente, configurar este
    1.64 +% TODO involved => complejo ? no intarwebs here :(
    1.65 +gancho es un proceso algo complejo.
    1.66 +
    1.67 +Antes de empezar, usted debe instalar la interfaz de Python para MySQL
    1.68 +en los sistemas en los que se vaya a ejecutar el gancho. Si no está
    1.69 +disponible como paquete binario para su sistema, usted puede descargar
    1.70 +el paquete desde~\cite{web:mysql-python}.
    1.71 +
    1.72 +La información para configurar este gancho se ubica en la sección 
    1.73 +\rcsection{bugzilla} de su \hgrc.
    1.74 +\begin{itemize}
    1.75 +\item[\rcitem{bugzilla}{version}] La versión de Bugzilla instalada en
    1.76 +  el servidor. El esquema de base de datos que Bugzilla usa cambia
    1.77 +  ocasionalmente, así que este gancho debe saber exactamente qué
    1.78 +  esquema usar. A la fecha, la única versión soportada es la
    1.79 +  \texttt{2.16}.
    1.80 +\item[\rcitem{bugzilla}{host}] El nombre de máquina (\emph{hostname})
    1.81 +  del servidor MySQL que almacena sus datos Bugzilla. La base de datos
    1.82 +  debe ser configurada para permitir conexiones desde las máquinas en
    1.83 +  las que usted ejecute el gancho \hook{bugzilla}.
    1.84 +\item[\rcitem{bugzilla}{user}] El nombre de usuario que se usará para
    1.85 +  conectarse al servidor MySQL. La base de datos debe ser configurada
    1.86 +  para permitir a dicho usuario conectarse desde cualquiera de las
    1.87 +  máquinas en las que se ejecute el gancho \hook{bugzilla}.  Este
    1.88 +  usuario debe tener acceso y poder modificar las tablas de Bugzilla.
    1.89 +  El valor por defecto para este ítem es \texttt{bugs}, que es el
    1.90 +  nombre estándar del usuario para Bugzilla en una base de datos
    1.91 +  MySQL.
    1.92 +\item[\rcitem{bugzilla}{password}] La contraseña MySQL para el usuario
    1.93 +  configurado anteriormente. Ésta es almacenada como texto plano, así
    1.94 +  que usted deberá asegurarse de que los usuarios no autorizados no
    1.95 +  puedan leer el fichero \hgrc\ en donde usted guarda esta
    1.96 +  información.
    1.97 +\item[\rcitem{bugzilla}{db}] El nombre de la base de datos Bugzilla en
    1.98 +  el servidor MySQL. El nombre por defecto para este ítem es
    1.99 +  \texttt{bugs}, que es el nombre estándar de la base de datos MySQL
   1.100 +  en donde Bugzilla almacena sus datos.
   1.101 +\item[\rcitem{bugzilla}{notify}] Si usted desea que Bugzilla envíe un
   1.102 +    %TODO suBscriptores?
   1.103 +  correo de notificación a los suscriptores después de que el gancho
   1.104 +  haya añadido un comentario a un fallo, necesitará que este gancho
   1.105 +  ejecute un comando siempre que actualice la base de datos. El
   1.106 +  comando que se ejecute depende de en dónde haya sido instalado
   1.107 +  Bugzilla, pero típicamente se verá así, si usted ha instalado
   1.108 +  Bugzilla en \dirname{/var/www/html/bugzilla}:
   1.109    \begin{codesample4}
   1.110      cd /var/www/html/bugzilla && ./processmail %s nobody@nowhere.com
   1.111    \end{codesample4}
   1.112 -  The Bugzilla \texttt{processmail} program expects to be given a
   1.113 -  bug~ID (the hook replaces ``\texttt{\%s}'' with the bug~ID) and an
   1.114 -  email address.  It also expects to be able to write to some files in
   1.115 -  the directory that it runs in.  If Bugzilla and this hook are not
   1.116 -  installed on the same machine, you will need to find a way to run
   1.117 -  \texttt{processmail} on the server where Bugzilla is installed.
   1.118 +  El programa \texttt{processmail} de Bugzilla espera recibir un ID de
   1.119 +  fallo (el gancho reemplaza ``\texttt{\%s}'' por el ID del fallo) y
   1.120 +  una dirección de correo. También espera poder escribir a ciertos
   1.121 +  ficheros en el directorio en que se ejecuta. Si Bugzilla y éste
   1.122 +  gancho no están instalados en la misma máquina, usted deberá
   1.123 +  encontrar una manera de ejecutar \texttt{processmail} en el servidor
   1.124 +  donde está instalado Bugzilla.
   1.125  \end{itemize}
   1.126  
   1.127  \subsubsection{Mapping committer names to Bugzilla user names}