INSTALL.txt di Tux Paint

Tux Paint - Un semplice programma di disegno per bambini.

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

June 27, 2002 - November 5, 2002

Traduzione a cura di Flavio `Iron Bishop' Pastore

Requisiti di sistema:
---------------------
  Utenti Windows:
  ---------------
    La versione di Tux  Paint per Widows  viene  distribuita in formato
    compatto precompilata e comprensiva di tutte le librerie necessarie
    al funzionamento (come ".DLL"),  quindi non sono necessari download
    aggiuntivi.
    
  libSDL
  ------
    Tux Paint  richiede la Simple  DirectMedia  Layer  Library (libSDL),
    una libreria multimediale open source  distribuita sotto licenza GNU
    Lesser General Public License (LGPL).

    Oltre a questa, Tux Paint dipende anche da altre librerie: SDL_Image
    (per i file  grafici), SDL_TTF  (per il supporto dei  caratteri True
    Type Font) e, opzionalmente, SDL_Mixer (per gli effetti sonori).

    Utenti GNU Linux/Unix:
    ----------------------
      Le librerie SDL sono disponibili  come codice sorgente, o come RMP 
      o pacchetti Debian per diverse distribuzioni GNU Linux.

     Di solito sono incluse nei paccheti disponibili all'interno delle
     distribuzioni (ad esempio nei CD di installazione, o via internet
     sui siti di riferimento della distribuzione).  Nondimeno, possono
     essere scaricate da:

        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/ [OPTIONAL]

      NOTA: Mentre si installano i pacchetti delle librerie,  accertarsi
      di installare  ANCHE  la versione "-devel"  (ad esempio installare 
      sia "SDL-1.2.4.rpm" sia "SDL-1.2.4-devel.rpm").

  Altre librerie:
  ---------------
    Tux Paint richiede anche altre librerie libere, sotto licenza LGPL.
    Su GNU Linux,  come con le SDL,  dovrebbero gia` essere installate,
    o comunque essere facilmente reperibili come parte integrante della
    distribuzione in uso.
    
    libPNG
    ------
      Tux Paint usa il formato PNG  (Portable  Network  Graphics) per i
      file grafici. SDL_image necessita della presenza di libPNG.

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

    FreeType2
    ---------
      Tux Paint usa i caratteri TTF  (True  Type  Font) per disegnare il
      testo; SDL_ttf necessita della presenza di FreeType2.

        http://www.freetype.org/

    gettext
    -------
      Tux Paint  segue le impostazioni di localizzazione del sistema con
      la libreria "gettext" per supportare vari ringuaggi  (per esempio, 
      Spagnolo e Italiano).  Per funzionare il programma necessita della 
      presenza di "gettext".

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

    NetPBM Tools  [OPTIONAL]
    ------------------------
      Sotto GNU Linux/Unix, per stampare vengono usate le "NetPBM tools"
      (Tux Paint genera file PNG e li converte in PostScript  usando gli
      strumenti "pngtopnm" e "pnmtops" di NetPBM).

        http://netpbm.sourceforge.net/
	

Compilare e installare:
-----------------------
  Tux Paint viene distribuito sotto la GNU General Public License (GPL)
  (si veda COPYING.it.txt  per maggiori dettagli),  e di conseguenza il
  codice sorgente del programma e` disponibile per tutti.

  Utenti Windows:
  --------------
    Compilare:
    ----------
      Tux Paint per Windows viene distribuito  precompilato, quindi non
      e` necessaria nessuna compilazione su questo sistema. Informazioni
      su come ricompilare Tux Paint su Windows potranno essere inserite
      in questa sezione. Per il momento, contate su voi stessi.

    Installare:
    -----------
      Fare doppio click sul file di installazione di Tux Paint (".EXE")
      e seguire le istruzioni.

      Per prima cosa, verra` chiesto di accettare la licenza (si tratta
      della GNU General Public License (GPL), disponibile anche nel file
      "COPYING.it.txt").

      Verra` data la possibilita` di scegliere se inserire collegamenti
      a Tux Paint nel menu` Start e/o sul desktop  (entrambe le opzioni
      sono selezionate, come impostazione predefinita).

      Dopodiche` verra` chiesto dove installare Tux Paint.  La cartella
      predefinita  dovrebbe andare bene,  a patto che sul disco  ci sia 
      spazio sufficiente. In caso contrario, comunque secondo preferenza,
      si puo` scegliere un'altra posizione.

      A questo punto,  si puo` fare click su  "Install"  per installare 
      Tux Paint!

    Cambiare le impostazioni usando i collegamenti:
    -----------------------------------------------
      Per cambiare le impostazioni del programma,  basta fare click col
      tasto destro del mouse sul collegamento a Tux Paint e selezionare
      "Proprieta`".

      Accertarsi di aver selezionato il tab "Collegamento"  e esaminare
      il campo "Percorso". Dovrebbe contenere qualcosa di simile a:

        "C:\Program Files\TuxPaint\TuxPaint.exe"

      E` possibile aggiungere parametri di riga di comando che verranno
      attivati al doppio click sul collegamento.
       
      Ad esempio,  per far partire il programma  in modalita` "a tutto 
      schermo", con l'opzione "forme semplici" (senza rotazione), e in
      Francese, basta aggiungere i rispettivi parametri, come segue:

        "C:\Program Files\TuxPaint\TuxPaint.exe" -f -s --lang french

      (Per un elenco completo dei parametri da riga di comando si veda
       il file "README.it.txt")
       
      In caso di errori  o se tutta la riga  scomparisse,  basta usare
      [CTRL+z] per annullare o [ESC] per chiudere il box senza  che le
      modifiche vengano salvate (a meno che si sia gia` fatto click sul
      tasto "Applica"!).
       
      Al termine dell'impostazione, fare click su "OK."

    If Something Goes Wrong
    -----------------------
      Se,  facendo click sul collegamento per far partire il programma,
      non accade nulla,  probabimente qualcuno  degli argomenti di riga
      di comando e` sbagliato. Si apra in "Esplora Risorse" la cartella
      principale di Tux Paint e si cerchi il file "stderr.txt".
	
      Tale file contiene  la descrizione di cosa non ha  funzionato nel
      programma. Solitamente sara` qualcosa come una maiuscola al posto
      di una minuscola, oppure un "-" di troppo (o di meno).
  
  
  Utenti GNU Linux/Unix:
  ----------------------
    Compilare:
    ----------
      Nota: attualmente Tux Paint non usa autoconf/automake, quindi non
      e` disponibile alcuno script di configurazione.  La  compilazione
      dovrebbe comunque andare a buon fine senza problemi, assumendo che 
      tutte le librerie necessarie a Tux Paint siano gia` installate.

      Per compilare il programma da una shell usare il comando:

        $ make


    Disabilitare il suono durante la compilazione:
    ----------------------------------------------
      Nel caso non sia disponibile  una scheda sonora,  o si preferisca
      non rendere disponibile il suono nel programma  (non c'e` bisogno
      di installare SDL_Mixer, quindi), si puo` usare questo comando:

        $ make nosound


    In caso di errori:
    ------------------
      Se si ricevono errori durante la compilazione, accertarsi di aver
      installato tutte le librerie necessarie (vedi sopra). Se si usano
      librerie  preinstallate,  accertarsi anche che siano installati i 
      corrispondenti pacchetti "-dev" o "-devel", in caso contrario non
      sara` possibile compilare Tux Paint (e altri programmi).


    Installare:
    -----------
      Se non si sono verificati errori,  ora e` possibile installare il
      programma  in modo tale che possa essere usato  dagli utenti  del
      sistema.  L'installazione deve essere fatta da  "root"  (l'utente 
      com privilegi di amministratore), quindi va usato il comando:

        $ su

      Inserite la password di "root". Il prompt dovrebbe diventare "#".
      Per installare il programma, usare il comando:

        # make install

      Infine, tornare all'utente normale:

        # exit


      NOTA: La cartella predefinita dove viene inserito "tuxpaint", il
      file eseguibile del programma,  e`  "/usr/local/bin/".  Per  gli
      altri file  (immagini, suoni, lingue diverse...)  la cartella e`
      "/usr/local/share/tuxpaint/".


      Cambiare le cartelle di destinazione
      ------------------------------------
        E` possibile cambiare le cartelle dove verranno  posizionati i
        file di Tux Paint durante l'installazione. Per farlo,  bisogna
        usare la variabile "PREFIX" nel makefile: si tratta della base
        della cartella dove vengono inseriti i file, ed inizialmente e`
        settata a "/usr/local".

        Altre variabili sono:
          BIN_PREFIX
	    La cartella dove viene installato il file "tuxpaint".
	    (Inizialmente e` "$(PREFIX)/bin" - es., "/usr/local/bin")
	  
	  DATA_PREFIX
	    La cartella degli altri file (suoni, grafica, lingue...).
	    (Inizialmente e` "$(PREFIX)/share/tuxpaint")
	
	  DOC_PREFIX
	    La cartella dove vengono inseriti i file di documentazione
	    (Inizialmente e` "$(PREFIX)/share/doc/tuxpaint")
	
	  MAN_PREFIX
	    La cartella dove viene inserita la pagina man di Tux Paint.
            (Inizialmente e` "$(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
	    Dove vengono inserite le icone e i collegamenti.
	
	  LOCALE_PREFIX
	    La cartella dei file di traduzione per le diverse lingue.
	    (Inizialmente e`  "$(PREFIX)/share/locale/"; 

             la locazione finale  di un file di traduzione  sara`
             all'interno  della cartella  relativa  alla nazione,
             nella sottocartella chiamata "LC_MESSAGES". Ad esempio:
             "usr/local/share/locale/it/LC_MESSAGES/tuxpaint.mo")
	
	
Disinstallare Tux Paint:
------------------------
  Utenti Windows
  --------------
    Usare l'Uninstaller
    -------------------
      Se avete installato la voce di menu` di Tux Paint all'interno del
      menu` Start, vi troverete il collegamento  chiamato  "Uninstall".
      Per procedere  alla  disinstallazione,  darne la conferma facendo 
      click su "Uninstall".

      Al termine dell'operazione, fare click sul pulsante "Close".

        Per disinstallare e` anche possibile usare la voce  "TuxPaint
        (remove only)" nel menu` di "Installazione Applicazioni"  del
        "Pannello di Controllo".

      NOTA:  all'interno della cartella  "userdata"  vengono salvati i
      disegni dell'utente: questa cartella NON viene cancellata durante
      la disinstallazione del programma.


  GNU Linux
  ---------
    All'interno della cartella che contiene il codice sorgente di Tux
    Paint  (quella dove avete compilato il programma),  e`  possibile
    usare il "makefile" per disinstallare Tux Paint.  Per farlo serve
    essere "root" (utente con privilegi di amministratore) (Per altre
    informazioni, si veda la sezione precedente di installazione).

    Per diventare "root" usare il comando:

      $ su

    Inserire la password di "root". Il prompt dovrebbe diventare "#".
    Per disinstallare Tux Paint, usare il comando:

      # make uninstall

    Infine, tornare all'utente normale:

      # exit

