INSTALACION.txt de Tux Paint

Tux Paint - Un programa de dibujo simple para nios.

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

27 de Junio de 2002 - 18 de Setiembre de 2002


Requerimientos:
---------------
  Usuarios de Windows:
  --------------------
    La versin 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 programacin multimedia de Cdigo 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 grficos), SDL_TTF (para el
    soporte de Fuentes True Type) y, opcionalmente, SDL_Mixer (para efectos de
    sonido).

    Usuarios de Linux/Unix:
    -----------------------
      Las bibliotecas SDL estn disponibles como cdigo-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/

      Tambin suelen estar disponibles con tu distribucin Linux
      (p.ej.: en uno de los CDs de instalacin, o disponibles va programas
      de mantenimiento de software como el "apt-get" de Debian).

      NOTA: Al instalar desde paquetes, asegrate de instalar TAMBIN 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 tambin saca partido de varias otras bibliotecas libres bajo
    licencia LGPL.  Bajo Linux, como en el caso de la SDL, ya deberan estar
    instaladas tambin, o debern estar listas para su instalacin como parte
    de tu distribucin Linux.
    
    libPNG
    ------
      Tux Paint usa el formato PNG (Portable Network Graphics) para sus
      archivos de informacin.  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/

    docbook-to-man
    --------------
      La pgina de manual del Tux Paint est escrita en formato Docbook (SGML).
      El programa "docbook-to-man" es usado para convertir esto a formato
      pgina de manual.

        http://www.oasis-open.org/docbook/tools/dtm/

      Nota: docbook-to-man es opcional!  Si no estuviera instalado, la pgina
      de manual simplemente no ser generada ni instalada.

    gettext
    -------
      Tux Paint utiliza las preferencias locales de tu sistema conjuntamente
      con la biblioteca "gettext" para soportar varios idiomas
      (p.ej:, Espaol).  Necesitars tener la biblioteca gettext instalada.

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

    Herramientas NetPBM
    -------------------
      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 lnea de comandos de NetPBM
      'pngtopnm' y 'pnmtops'.)

        http://netpbm.sourceforge.net/
	

Compilacin e Instalacin:
--------------------------
  Tux Paint se entrega bajo la licencia GNU General Public License (GPL)
  (ver "COPYING.txt" por ms detalles) y por lo tanto el 'cdigo fuente'
  del programa est incluido.

  Usuarios Linux/Unix:
  --------------------
    Compilacin:
    ------------
      Para compilar el programa desde las fuentes, simplemente ejecuta el
      siguiente comando desde un prompt del shell (p.ej.: "$"):

        $ make

    Deshabilitando el Sonido al Compilar:
    -------------------------------------
      Alternativamente, si no tienes una tarjeta de sonido, o si prefieres
      compilar el programa sin soporte para sonido (por lo que SDL_mixer no
      tendra que ser instalada), puedes ejecutar "make" con "nosound" como
      'target':

        $ make nosound


    Instalacin:
    ------------
      Asumiendo que no hayan ocurrido errores fatales, puedes ahora instalar
      el programa para que pueda ser ejecutado por los usuarios del sistema.
      Por defecto, esto debe ser hecho por el usuario "root" ('superusuario').
      Cmbiate a "root" ingresando el comando:

        $ su

      Ingresa la clave de "root" cuando te sea solicitada.  Ahora deberas
      ser "root" (con un prompt as "#"). Para instalar el programa y sus
      archivos de datos, tipea:

        # make install

      Finalmente, puedes cambiarte de regreso a tu usuario regular saliendo
      del modo superusuario:

        # exit


      NOTA: Por defecto, "tuxpaint", el programa ejecutable, est ubicado
      en "/usr/local/bin/".  Los archivos de datos (imgenes, sonidos, etc.)
      estn 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 dems
        archivos irn, 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 irn los archivos de datos (sonido, grficos, pinceles,
            sellos, fuentes), y donde el Tux Paint los buscar al ejecutarse.
            (Fijado en "$(PREFIX)/share/tuxpaint")

          DOC_PREFIX
            Donde irn los los archivos de texto de la documentacin (el
            directorio "docs"). (Fijado en "$(PREFIX)/share/doc/tuxpaint")

          MAN_PREFIX
            Donde ir la pgina 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 irn los conos y lanzadores (para GNOME y KDE).

          LOCALE_PREFIX
            Donde irn los archivos de traduccin del Tux Paint, y donde
            Tux Paint los buscar.
            (Fijado en "$(PREFIX)/share/locale/") 
            (La ubicacin final de un archivo de traduccin ser bajo el
            directorio de la respectiva localizacin [p.ej.: "es" para
            Espaol] dentro del subdirectorio "LC_MESSAGES".)


  Usuarios de Windows:
  --------------------
    Compilacin:
    ------------
      Tux Paint viene pre-compilado para Windows, por lo tanto no se
      necesita compilacin.  [Eventualmente, pondremos aqu informacin
      acerca de como recompilar para Windows.  Entre tanto, ests por las
      tuyas. Lo siento!]

    Instalacin:
    -----------
      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 Pblica General de GNU (GPL), la cual tambin est
      disponible en el archivo "COPIADO.txt".)

      A continuacin se consultar si se desean instalar accesos directos a
      Tux Paint en el Men Inicio y en el Escritorio de Windows.
      (Ambas opciones estn habilitadas por defecto.)

      Luego se consultar sobre dnde se desea instalar el Tux Paint.
      La opcin por defecto debera ser apropiada, en tanto haya espacio
      disponible. En caso contrario, escoger una ubicacin diferente.

      En este punto, slo resta hacer clic en 'Install' para instalar Tux
      Paint!


    Antiguo Mtodo:
    ---------------
      A partir de mediados de Setiembre de 2002, Tux Paint para Windows se
      entrega como un ejecutable auto instalable.  Ver arriba.

      Las entregas ms antiguas de Tux Paint venan en formato ZIP.
      Simplemente bastaba descomprimir el archivo y ejecutar Tux paint desde
      dentro de su propia carpeta, haciendo doble clic en el cono del
      "tuxpaint.exe".

      Cmo crear un Acceso Directo:
      -----------------------------
        Es til crear un acceso directo al programa en el escritorio.
        Utilizar un acceso directo tambin facilita cambiar las opciones del
        mismo (utilizando las opciones de lnea-de-comandos descriptas en
        LEEME.txt)

        1) Abrir un explorador haciendo clic con el boton derecho sobre
           'Mi PC' y seleccionar 'Explorar'.
	
        2) Navegar hasta el disco y carpeta que contiene a 'TuxPaint.exe'
           (usualmente con el mismo nombre que el archivo ZIP).
	 
        3) Hacer clic sobre el cono de 'TuxPaint.exe' con el botn DERECHO
           del ratn, arrastrarlo hasta el escritorio y soltarlo.
	 
	   Un pequeo men emerger, selecciona 'Crear conos de acceso
           directo aqu'.
	 
        4) Renombra el acceso directo si lo deseas.


      Cambiando las preferencias Utilizando el Acceso Directo:
      --------------------------------------------------------
        Para cambiar las preferencias del programa, haz clic derecho sobre el
        acceso directo del TuxPaint y selecciona 'Propiedades' (abajo).
	
	Asegrate que la etiqueta 'Acceso directo' est seleccionada en la
	ventana que aparece y examina el campo 'Destino:'.  Deberas ver
	algo como esto:

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

        Ahora puedes agregar opciones de lnea de comando, las que entrarn
        en accin cuando tu hagas doble clic sobre el cono.
	
	Por ejemplo, para hacer que el juego funcione a pantalla completa,
	con figuras simplificadas (sin opcin de rotacin) y en Espaol,
	agrega 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 lnea de
        comando disponibles.)
	
        Si cometes un error o si todo desaparece utiliza Ctrl-Z para deshacer o
	simplemente presiona la tecla [ESC] y el dilogo se cerrar sin
        aplicar los cambios (a menos que hubieras presionado el botn
        "Aplicar"!).
	
	Cuando hayas terminado, haz 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
	lnea de comando estn mal. Abre un Explorador como antes y busca un
	archivo llamado 'stderr.txt' en la carpeta del TuxPaint.
	
	Contendr una descripcin de qu estuvo mal. Usualmente ser slo
	debido a una mayscula o minscula incorrecta ('Z' en vez de 'z')
	o un guin '-' de menos (o de ms).
	

Desinstalando Tux Paint:
------------------------
  Linux
  -----

  Windows
  -------
    Utilizando el Desinstalador
    ---------------------------

    Mtodo Antiguo
    --------------

