INSTALACION.txt de Tux Paint

Tux Paint - Un programa de dibujo simple para niños.

Copyright 2002 por Bill Kendrick
bill@newbreedsoftware.com
http://www.newbreedsoftware.com/tuxpaint/

27 de Junio de 2002 - 5 de Noviembre de 2002


Requerimientos:
---------------
  Usuarios de Windows:
  --------------------
    La versión Windows de Tux Paint viene pre-empacada con todas las
    bibliotecas necesarias pre-compiladas (en forma de ".DLL"), por lo
    tanto no se necesita bajar nada extra.
    
  libSDL
  ------
    Tux Paint requiere Simple DirectMedia Layer Library (libSDL),
    una biblioteca de programación multimedia de Código Abierto
    disponible bajo la licencia GNU Lesser General Public License (LGPL).

    Junto con libSDL, Tux Paint depende de una cantidad de otras bibliotecas
    de 'ayuda' de SDL:  SDL_Image (para archivos gráficos), SDL_TTF (para el
    soporte de Fuentes True Type) y, opcionalmente, SDL_Mixer (para efectos de
    sonido).

  Usuarios de Linux/Unix:
  -----------------------
      Las bibliotecas SDL están disponibles como código-fuente o como paquetes
      RPM o Debian para varias distribuciones de Linux.  Pueden ser bajadas
      desde:

        libSDL:      http://www.libsdl.org/
        SDL_Image:   http://www.libsdl.org/projects/SDL_image/
        SDL_TTF:     http://www.libsdl.org/projects/SDL_ttf/
        SDL_Mixer:   http://www.libsdl.org/projects/SDL_mixer/   [OPCIONAL]

      También suelen estar disponibles con tu distribución Linux
      (p.ej.: en uno de los CDs de instalación, o disponibles vía programas
      de mantenimiento de software como el "apt-get" de Debian).

      NOTA: Al instalar desde paquetes, asegúrate de instalar TAMBIÉN las
      versiones "-devel" de los paquetes.  (Por ejemplo, instala tanto
      "SDL-1.2.4.rpm" como "SDL-1.2.4-devel.rpm")

  Otras Bibliotecas:
  ------------------
    Tux Paint también saca partido de varias otras bibliotecas libres bajo
    licencia LGPL.  Bajo Linux, como en el caso de la SDL, ya deberían estar
    instaladas también, o deberán estar listas para su instalación como parte
    de tu distribución Linux.
    
    libPNG
    ------
      Tux Paint usa el formato PNG (Portable Network Graphics) para sus
      archivos de información.  SDL_image requiere que libPNG esté instalada.

        http://www.libpng.org/pub/png/libpng.html

    FreeType2
    ---------
      Tux Paint usa fuentes TTF (True Type Font) para dibujar texto.
      SDL_ttf requiere la biblioteca FreeType2.

        http://www.freetype.org/

    gettext
    -------
      Tux Paint utiliza las preferencias locales de tu sistema conjuntamente
      con la biblioteca "gettext" para soportar varios idiomas
      (p.ej: Español).  Necesitarás tener la biblioteca gettext instalada.

        http://www.gnu.org/software/gettext/

    Herramientas NetPBM [OPCIONAL]
    ------------------------------
      Bajo Linux y Unix, las herramientas NetPBM son las actualmente usadas
      para imprimir. (Una PNG es generada por TuxPaint y convertida a
      PostScript usando las herramientas de línea de comandos de NetPBM
      'pngtopnm' y 'pnmtops'.)

        http://netpbm.sourceforge.net/
	

Compilación e Instalación:
--------------------------
  Tux Paint se entrega bajo la licencia GNU General Public License (GPL)
  (ver "COPYING.txt" por más detalles) y por lo tanto el 'código fuente'
  del programa está incluido.

  Usuarios de Windows:
  --------------------
    Compilación:
    ------------
      Tux Paint viene pre-compilado para Windows, por lo tanto no se
      necesita compilación.  [Eventualmente, pondremos aquí información
      acerca de como recompilar para Windows.  Mientras tanto, estás por
      las tuyas. ¡Lo sentimos!]

    Instalación:
    -----------
      Hacer doble clic sobre el ejecutable (archivo .EXE) del instalador del
      Tux Paint y seguir las instrucciones.

      En primer lugar se preguntará si se está de acuerdo con la licencia.
      (Es la Licencia Pública General de GNU (GPL), la cual también está
      disponible en el archivo "COPIADO.txt".)

      A continuación se consultará si se desean instalar accesos directos a
      Tux Paint en el Menú Inicio y en el Escritorio de Windows.
      (Ambas opciones están habilitadas por defecto.)

      Luego se consultará sobre dónde se desea instalar el Tux Paint.
      La opción por defecto debería ser apropiada, en tanto haya espacio
      disponible. En caso contrario, escoger una ubicación diferente.

      ¡En este punto, sólo resta hacer clic en 'Install' para instalar Tux
      Paint!

    Cambiando las preferencias Utilizando el Acceso Directo:
    --------------------------------------------------------
      Para cambiar las preferencias del programa, hacer clic derecho sobre el
      acceso directo del TuxPaint y seleccionar 'Propiedades' (abajo).
	
      Asegurarse de que la etiqueta 'Acceso directo' esté seleccionada en la
      ventana que aparece y examinar el campo 'Destino:'.  Se debería ver
      algo como esto:

        "C:\Archivos de Programa\Tuxpaint\TuxPaint.exe"

      Ahora es posible agregar opciones de línea de comando, las que entrarán
      en acción al hacer doble clic sobre el ícono.

      Por ejemplo, para hacer que el juego funcione a pantalla completa,
      con figuras simplificadas (sin opción de rotación) y en Español,
      agregar estas opciones (luego de 'TuxPaint.exe'):

        "C:\Archivos de Programa\Tuxpaint\TuxPaint.exe" -f -s --lang spanish

      (Ver "LEEME.txt" para una lista completa de las opciones de línea de
      comando disponibles.)
	
      Si se cometiera un error o si todo desapareciera, utilizar Ctrl-Z para
      deshacer o simplemente presionar la tecla [ESC] para cerrar el diálogo
      sin aplicar los cambios (¡a menos que se hubiera presionado el botón
      "Aplicar"!).
	
      Una vez finalizado, hecer clic en "Aceptar".


    Si Algo Sale Mal
    ----------------
      Si al hacer doble clic en el acceso directo para ejecutar el juego
      nada sucede, es probable que sea porque algunas de las opciones de
      línea de comando están mal. Abrir un Explorador como antes y buscar un
      archivo llamado 'stderr.txt' en la carpeta del TuxPaint.

      Este contendrá una descripción de lo que estuvo mal. Usualmente será
      sólo debido a una mayúscula o minúscula incorrecta ('Z' en vez de 'z')
      o un guión '-' de menos o de más.


  Usuarios Linux/Unix:
  --------------------
    Compilación:
    ------------
      Nota: Al presente, Tux Paint no utiliza autoconf/automake, por lo que
      no hay un guión "./configure" que ejecutar.  (¡Lo sentimos!)  Sin
      embargo compilarlo no debería presentar complicaciones, asumiendo que
      todo lo que el Tux Paint necesita esté instalado.

      Para compilar el programa desde las fuentes, simplemente ejecutar el
      siguiente comando desde un prompt del shell (p.ej.: "$"):

        $ make

    Deshabilitando el Sonido al Compilar:
    -------------------------------------
      Alternativamente, si no hubiera tarjeta de sonido, o si se prefieriera
      compilar el programa sin soporte para sonido (por lo que SDL_mixer no
      tendría que ser instalada), se puede ejecutar "make" con "nosound" como
      'target':

        $ make nosound


    Si aparecen errores:
    --------------------
      Si aparecen errores durante la compilación, asegurarse de tener
      instaladas las bibliotecas apropiadas (ver arriba).  Si se están
      utilizando versiones empacadas de las bibliotecas (p.ej: RPMs bajo
      RedHat o DEBs bajo Debian), asegurarse también de obtener los paquetes
      correspondientes "-dev" o "-devel", ¡de otro modo no será posible
      compilar Tux Paint (y otros programas) a partir del código fuente!


    Instalación:
    ------------
      Asumiendo que no hayan ocurrido errores fatales, ahora es posible
      instalar el programa para que pueda ser ejecutado por los usuarios del
      sistema. Por defecto, esto debe ser hecho por el usuario "root"
     ('superusuario'). Volverse "root" ingresando el comando:

        $ su

      Ingresar la clave de "root" cuando sea solicitada.  Ahora se debería
      estar en modo "root" (con un prompt así: #). Para instalar el programa
      y sus archivos de datos, tipear:

        # make install

      Finalmente, volver al usuario regular saliendo del modo
      superusuario:

        # exit


      NOTA: Por defecto, "tuxpaint", el programa ejecutable, está ubicado
      en "/usr/local/bin/".  Los archivos de datos (imágenes, sonidos, etc.)
      están ubicados en "/usr/local/share/tuxpaint/".


      Chambiando las Cosas de Lugar
      -----------------------------
        Es posible cambiar las cosas de lugar usando las variables 'prefix'
        al hacer Makefile.  "PREFIX" es la base de a donde todos los demás
        archivos irán, y está fijado por defecto en "/usr/local".

        Otras variables son:
          BIN_PREFIX    
            Donde será instalado el binario "tuxpaint".
            (Fijado por defecto en "$(PREFIX)/bin" - p.ej.: "/usr/local/bin")

          DATA_PREFIX
            Donde irán los archivos de datos (sonido, gráficos, pinceles,
            sellos, fuentes), y donde el Tux Paint los buscará al ejecutarse.
            (Fijado en "$(PREFIX)/share/tuxpaint")

          DOC_PREFIX
            Donde irán los los archivos de texto de la documentación (el
            directorio "docs"). (Fijado en "$(PREFIX)/share/doc/tuxpaint")

          MAN_PREFIX
            Donde irá la página de manual del Tux Paint.
            (Fijado en "$(PREFIX)/share/man")

          ICON_PREFIX                      $(PREFIX)/share/pixmaps
          X11_ICON_PREFIX                  $(PREFIX)/X11R6/include/X11/pixmaps
          GNOME_PREFIX                     $(PREFIX)/share/gnome/apps/Graphics
          KDE_PREFIX                       $(PREFIX)/share/applnk/Graphics
            Donde irán los íconos y lanzadores (para GNOME y KDE).

          LOCALE_PREFIX
            Donde irán los archivos de traducción del Tux Paint, y donde
            Tux Paint los buscará.
            (Fijado en "$(PREFIX)/share/locale/") 
            (La ubicación final de un archivo de traducción será bajo el
            directorio de la respectiva localización [p.ej.: "es" para
            Español] dentro del subdirectorio "LC_MESSAGES".)


Desinstalando Tux Paint:
------------------------
  Windows
  -------
    Utilizando el Desinstalador
    ---------------------------
      Si se instalaron los accesos directos del Menú Inicio (por defecto),
      entonces ir a la carpeta del TuxPaint y seleccionar "Uninstall".
      Un diálogo aparecerá que confirmará que se está a punto de desinstalar
      Tux Paint y consultará si se lo quiere remover permanentemente, hacer
      clic en el botón 'Uninstall'. 

      Una vez haya terminado, hacer clic en el botón Cerrar.

      También es posible utilizar la entrada "TuxPaint (remove only)" en la
      sección Agregar/Quitar Programas del Panel de Control.

      NOTA: Como las imágenes creadas con el programa se almacenan dentro de
      la carpeta del Tux Paint, ésta así como la sub-carpeta 'userdata' NO son
      removidas.


  Linux
  -----
    Dentro del directorio de fuentes del Tux Paint (donde se compiló el
    programa), es posible utilizar un 'target' de 'Makefile' para desinstalar
    Tux Paint. Por defecto, esto debe ser hecho por el usuario "root"
    ('superusuario').
    (Ver las instrucciones de instalación arriba por más información.)

    Volverse "root" tipeando el comando:

      $ su

    Ingresar la clave de "root" cuando sea solicitada.  Ahora se debería
    estar en modo "root" (con un prompt así: #).  Para desinstalar el programa
    y sus archivos de datos (las imágenes de los sellos incluidos, si hubiera,
    también serán removidas), tipear:

      # make uninstall

    Finalmente, volver al usuario regular saliendo del modo
    superusuario:

      # exit
