<?xml version="1.0" encoding="ISO-8859-1" ?>
<!-- <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
                  "file:///usr/share/sgml/docbook/dtd/xml/4.1.2/docbookx.dtd"> -->

<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
       "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">

<article id="todo" lang="es">
  <artheader>
    <title>IPM, un gestor de tareas pendientes</title>
    <author>
      <firstname>Sergio</firstname>
      <surname>González González</surname>
      <affiliation>
				<orgname>Universidad de León, España</orgname>
				<address><email>sergio.gonzalez@hispalinux.es</email></address>
      </affiliation>
    </author>
    <date>24 de junio de 2002</date>
    <abstract>
      <para>
				IPM es un gestor de tareas pendientes con interfaz web. En este artículo aprenderemos a instalarlo y configurarlo.
      </para>
    </abstract>
  </artheader>
  
  <!-- Fin sección cabecera -->
  
  <sect1 id="introduccion">
    <title>Introducción</title>
    <para>
			<emphasis>IPM</emphasis> es una solución simple para la administración de tareas pendientes de un proyecto.
			Está hecho con <application>PHP4</application>
			y requiere <application>Apache 1.3.x</application> y <application>MySQL 3.2.x</application> para funcionar. Dentro de un proyecto,
			puedes añadir tareas y las horas estimadas para ejecutar dichas tareas.
			<emphasis>IPM</emphasis> mantiene una lista de las tareas pendientes así como las finalizadas.
    </para>
		<para>
		 	Se ha elegido esta aplicación por su sencillez de instalación, administración y gestión de tareas. Nos interesaba tener una
			herramienta para mantener las tareas por hacer y que fuese fácil de usar, para centrarnos en las tareas, no en el manejo del programa.
			Cabe indicar, que este gestor de tareas está indicado para proyectos pequeños y en el cual esté involucrada poca gente.
		</para>
  </sect1>

  <!-- Fin sección Introducción -->
 
	<sect1 id="instalacion-configuracion-prueba">
		<title>Instalación, configuración y prueba</title>
		<para>
			Antes de proceder a instalar el gestor de tareas pendientes, debemos asegurarnos de tener instalados los siguientes programas:
		</para>
		<itemizedlist>
			<listitem>
				<para>
					<application>Apache</application> con las extensiones <application>PHP4</application>
				</para>
			</listitem>
			<listitem>
				<para>
					<application>MySQL</application>
				</para>
			</listitem>
		</itemizedlist>
		<para>
	 		Como este programa no está incluído en Debian GNU/Linux, de momento ;-), tendremos que bajarlo de la
			<ulink url="http://udpviper.com/html/project.php?project=ipm">página principal del proyecto</ulink>. Para obtener la última
			versión disponible<footnote><para>En el momento de su instalación, era la verión 0.9</para></footnote>, teclearemos
			lo siguiente:				
		</para>
<screen><prompt># </prompt><userinput>wget http://udpviper.com/projects/ipm-0.9.tar.gz</userinput></screen>
		<para>
		 	Una vez bajado, lo descomprimiremos en cualquier directorio accesible vía web. En nuestro caso hemos elegido
			<filename class='directory'>/var/www/</filename>:
		</para>
<screen><prompt># </prompt><userinput>tar -xzvf ipm-0.9.tar.gz -C /var/www/</userinput></screen>
		<para>
		 	Editamos el fichero config.php y cambiaremos el valor de algunas variables que allí aparecen:
		</para>
		<itemizedlist>
			<listitem>
				<para>
					enviaremos las notificaciones al administrador del sistema: <programlisting>$ipmaddress="root";</programlisting>	
				</para>
			</listitem>
			<listitem>
				<para>
					introducimos un mensaje de error para cuando alguien teclea mal la clave: 
				</para>
<programlisting>$unauthorizedmessage="¡Has de teclear una clave que funcione, cucaracha!";</programlisting>
			</listitem>
			<listitem>
				<para>
					indicamos donde reside la base de datos MySQL: 
				</para>
<programlisting>$db_servername="localhost";</programlisting>
			</listitem>
			<listitem>
				<para>
					añadimos el usuario<footnote><para>Previamente creado para tal efecto, en la base de datos MySQL</para></footnote> que se comunicará
					con la base de datos: 
				</para>
<programlisting>$db_username="ipm";</programlisting>
			</listitem>
			<listitem>
				<para>
					tecleamos su clave:
				</para>
<programlisting>$db_password="**********";</programlisting>
			</listitem>
		</itemizedlist>
		<para>
		  Creamos una nueva base de datos en <application>MySQL</application>	llamada <quote>IPM</quote>. Una vez creada, le añadiremos las
			tablas necesarias. Para ello entraremos en el directorio <filename class='directory'>sql/</filename> del programa
			<application>IPM</application>:
		</para>
<screen><prompt># </prompt><userinput>mysql -p IPM &lt; NEW-INSTALL.sql</userinput></screen>
		<para>
		 	El usuario y la clave por defecto es <quote>project</quote>-<quote>tracker</quote> (sin las comillas). Cámbialo enseguida.
		</para>
		<para>
		 	Ahora accede a tu gestor de tareas con cualquier navegador y comienza la gestión ;-)
		</para>
<screen><prompt>$ </prompt><userinput>links www.tudominio.com/ipm-0.9/</userinput></screen>
	</sect1> 
  
	<!-- Fin sección Instalación, configuración y prueba -->

	<sect1 id="capturas">
		<title>Capturas del programa</title>
		<para>
			A continuación se muestran un par de capturas del programa recien instalado:
		</para>
		<sect2>
			<title>Login</title>
      <informalfigure>
        <mediaobject>
          <imageobject>
            <imagedata fileref="./login.eps" align="center" format="EPS" scale="30"/>
          </imageobject>
          <imageobject>
            <imagedata fileref="./login.png" align="center" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Login de IPM</phrase>
          </textobject>
        </mediaobject>
      </informalfigure>
		</sect2>
    <sect2>
      <title>Página por defecto</title>
      <informalfigure>
        <mediaobject>
          <imageobject>
            <imagedata fileref="./pagina-defecto.eps" align="center" format="EPS" scale="30"/>
          </imageobject>
          <imageobject>
            <imagedata fileref="./pagina-defecto.png" align="center" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Login de IPM</phrase>
          </textobject>
        </mediaobject>
      </informalfigure>
    </sect2>
	</sect1>

	<sect1 id="mas_informacion">
		<title>Más información</title>
		<para>
			Este programa no tiene mucha dificultad, como se ha comprobado. La única documentación que hace falta está en el propio programa.
			De todas formas, se da por supuesto que se saben crear usuarios y bases de datos en <application>MySQL</application>, de no ser
			así, se recomienda la	consulta del manual que acompaña a la Base de Datos.
		</para>
	</sect1>

	<!-- Fin sección Más información  -->

 <sect1 id="este_documento">
   <title>Sobre este documento</title>
   <para>
   Se otorga permiso para copiar, distribuir y/o modificar este documento bajo los términos de la Licencia de 
   Documentación Libre GNU, versión 1.1 o cualquier versión posterior publicada por la Free Software 
   Foundation. Puedes consultar una copia de la licencia en <ulink url="http://www.gnu.org/copyleft/fdl.html">
   http://www.gnu.org/copyleft/fdl.html</ulink>  
   </para>
   <para>
   Este documento ha sido escrito en formato XML utilizando la DTD de <ulink url="http://www.docbook.org">DocBook</ulink>. Mediante 
   este sistema, puede ser fácilmente transformado a múltiples formatos (HTML, TXT, PDF, PostScript, LaTeX, DVI, ...). Se recomienda 
   su utilización como herramienta de documentación potente y libre.  
   </para>
 </sect1>
</article>
