INSTALL.txt dla Tux Paint 

Paint Tux - prosty program do rysowania dla dzieci.

Prawo autorskie Bill Kendrick 2002
bill@newbreedsoftware.com 
http://www.newbreedsoftware.com/tuxpaint/ 

27 czerwiec 2002 - 5 listopad 2002 


Wymagania:
------------- 
  Użytkownicy systemu Windows:
  -------------- 
    Wersja Tux Paint dla systemu Windows jest spakowana z koniecznym
    zestawem prekompilowanych bibliotek (w formie plików ".DLL"), więc dodatkowe 
    pobieranie innych plików jest niepotrzebne.
    
  libSDL 
  ------ 
    Paint Tux wymaga Simple Library Layer DirectMedia (libSDL), biblioteki
    Open Source używanej podczas programowania multimediów dostępnej na licencji 
    GNU Lesser General Public License (LGPL).

    Wraz z libSDL, Tux Paint zależy od kilku innych pomocniczych bibliotek SDL:
    SDL_Image (dla plików grafiki), SDL_TTF (dla czcionek TTF)
    i opcjonalnie, SDL_Mixer (dla efektów dźwiękowych).

    Uzytkownicy Linuksa / Uniksa:
    ----------------- 
      Biblioteki SDL są dostępne zarówno jako kod źródłowy, jak i pakiety RPM lub Deb 
      dla różnych dystrybucji Linuksa. Można je pobrać z:

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

      Są one również dostępne wraz z Twoją dystrybucją Linux 
      (np. na instalacyjnych CD lub dostępne przez program do update'u 
      oprogramowania taki jak np. "apt-get").

      ZAUWAŻ: Kiedy instalujesz program z pakietów, zainstaluj RÓWNIEŻ
      wersje "-devel" pakietów.  (Na przykład, zainstaluj oba pakiety 
      "SDL -1.2.4. rpm" i "SDL -1.2.4 - devel.rpm")

  Inne biblioteki:
  ---------------- 
    Tux Paint korzysta też z kilku innych 
    darmowych, bibliotek LGPL. Pod Linuksem, tak jak SDL, powinny 
    albo już być zainstalowane, albo gotowe do instalacji 
    jako część Twojej dystrybucji Linuksa.
    
    libPNG 
    ------ 
      Tux Paint używa PNG (Portable Graphics Network) - formatu dla jego 
      plików danych. SDL_image będzie wymagał zainstalowanej biblioteki libPNG.

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

    FreeType2 
    --------- 
      Tux Paint używa TTF (True Type Font) - czcionek do rysowania tekstu.
      SDL_ttf będzie wymagał biblioteki FreeType2.

        http://www.freetype.org/ 

    gettext 
    ------- 
      Tux Paint używa ustawień regionalnych Twojego systemu wraz z 
      biblioteką "gettext", by wspierać różne języki (np. hiszpański).
      Będziesz potrzebował zainstalowanej biblioteki gettext.

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

    Tools NetPBM  [OPCJONALNIE]
    ------------------------ 
      Pod Linuksem i Uniksem, narzędzia NetPBM są aktualnie 
      użyte do drukowania.  ( PNG jest generowany przez TuxPaint i konwertowany 
      do PostScript używając narzędzi NetPBM 'pngtopnm' i 'pnmtops'.)

        http://netpbm.sourceforge.net/ 
	

Kompilowanie i instalacja:
--------------------------- 
  Tux Paint jest udostępniony pod licencją GNU General Public License (GPL)
  (zobacz "COPYING.txt" dla szczegółów) i dlatego 'kod źródłowy'
  programu jest zawarty razem z nim.

  Użytkownicy systemu Windows:
  -------------- 
    Kompilacja:
    ---------- 
      Tux Paint dla systemu Windows jest już skompilowany, więc żadna kompilacja nie jest 
      konieczna.  [Ostatecznie, informacja o przekompilowywaniu dla Windows 
      będzie umieszczony tutaj.  Tymczasem, jesteś skazany tylko na siebie.  Przepraszam!]

    Instalator:
    ---------- 
      Kliknij podwójnie na instalator Tux Paint (plik wykonywalny .EXE) i 
      wykonuj polecenia instalatora.

      Najpierw będziesz poproszony o zgodę co do licencji.
      (Jest to licencja GNU General Public License (GPL), która jest też 
      dostępna w "COPYING.txt".)

      Następnie będziesz spytany, czy chcesz zainstalować skróty 
      do Tux Paint w Twoim Menu Start Windows i na Twoim Pulpicie Windows.
      (Obie opcje są ustawione domyślnie.)

      Potem będziesz spytany, gdzie życzysz sobie zainstalować Tux Paint.
      Domyślne miejsce powinno być odpowiednie, o ile dostępna będzie odpowiednia ilość przestrzeni dyskowej.
      Jeżeli nie, wybierz inne miejsce.

      W tym momencie, możesz kliknąć Install, by zainstalować Tux Paint!

    Zmiana Ustawień przy użyciu Skrótu:
    ----------------------------------------- 
      Aby zmienić ustawienia programu, kliknij prawym klawiszem myszy na skrót TuxPaint 
      i wybierz 'Właściwości' (na dole).
       
      Upewnij się, czy jest wybrana zakładka Skrót w oknie, które 
      się ukazało i sprawdź pole 'Element docelowy'.  Powinieneś zobaczyć 
      coś podobnego do tego:

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

      Możesz teraz dodać opcje wiersza poleceń, które będą wykonane kiedy 
      klikniesz podwójnie na ikonę.
       
      Na przykład, aby ustawić uruchomianie gry w trybie pełnoekranowym,
      z prostymi kształtami (bez opcji rotacji) i w języku francuskim,
      dodaj opcje (po 'TuxPaint.exe'), takie jak:

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

      (Zobacz plik "README.txt", gdzie znajduje się pełna lista opcji wiersza poleceń.)
       
      Jeżeli pomylisz się albo wszystko zniknie, użyj kombinacji klawiszy Ctrl-Z, aby cofnąć lub
      naciśnij klawisz [ESC] i okno zamknie się bez żadnych zmian 
      (chyba, że nacisnąłeś przycisk "Zastosuj"!).
       
      Kiedy skończysz, kliknij "OK".

    Jeżeli coś pójdzie nie tak 
    ----------------------- 
      Jeżeli, kiedy podwójnie klikasz na skrót, by uruchomić grę,
      nic się nie dzieje, to jest prawdopodobne, że niektóre z tych opcji wiersza 
      poleceń są niewłaściwe. Otwórz Eksploratora jak przedtem i poszukaj pliku 
      nazwanego 'stderr.txt' w folderze TuxPaint.
	
      Plik ten zawiera opis co było nieprawidłowe. Zwykle jest to 
      spowodowane przez niepoprawną wielkość litery (duża litera 'Z' zamiast 
      małej 'z') albo brak (lub dodatkowy) znak '-' (minus, pozioma kreska).
  
  
  Użytkownicy Linuksa / Uniksa:
  ----------------- 
    Kompilacja:
    ---------- 
      Zauważ: Aktualnie, Tux Paint nie używa autoconf/automake, tak więc
      nie ma żadnego skryptu "./configure".  (Przykro mi!)  Kompilacja powiniena być 
      prosta - zakładając, że wszystko co Tux Paint potrzebuje jest zainstalowane.

      Aby skompilować program ze źródła, po prostu uruchom następujące polecenie
      z poziomu shell'a (np. "$"):

        $ make

    Wyłączanie dźwięku na czas kompilacji:
    -------------------------------- 
      Alternatywnie, jeżeli nie masz karty dźwiękowej lub wolisz skompilować 
      program bez wsparcia dźwięku (do tego SDL_mixer nie musi być 
      zainstalowany), możesz uruchomić polecenie "make" z "nosound":

        $ make nosound 


    Jeżeli otrzymasz błędy:
    ------------------ 
      Jeżeli otrzymujesz jakieś błędy podczas kompilacji - upewnij się, że masz zainstalowane
      odpowiednie biblioteki (zobacz powyżej). Jeżeli używasz spakowanych 
      wersji bibliotek (np. RPM w systemie RedHat albo DEB w systemie Debian),
      upewnij się, czy masz również odpowiednie pakiety "-dev" lub "-devel",
      inaczej nie będziesz w stanie skompilować Tux Paint (i innych programów)
      ze źródła!


    Instalowanie:
    ----------- 
      Zakładając, że żadne błędy krytyczne nie wystąpiły, możesz teraz zainstalować program, 
      po to aby mógł być uruchamiany przez użytkowników. Domyślnie, to musi 
      zostać zrobione przez użytkownika "root" ('superuser'). Przełącz się na użytkownika "root" 
      pisząc polecenie:

        $ su 

      Wpisz  hasło użytkownika "root".  Powinieneś teraz być użytkownikiem "root"
      (ze znakiem "#").  Aby zainstalować program i jego pliki danych, napisz:

        # make install

      Na końcu możesz przełączyć się z powrotem do Twojego regularnego użytkownika przez wyjście
      z trybu superużytkownika:

        # exit


      ZAUWAŻ: Domyślnie, wykonywalny program "tuxpaint" jest 
      umieszczony w katalogu "/usr/local/bin/". Pliki danych (obrazy, dźwięki, itd.)
      są umieszczone w katalogu "/usr/local/share/tuxpaint/".


      Zmiana miejsca zapisu plików
      ------------------------ 
        Możesz zmienić miejsce zapisu plików używając zmiennej 'prefix'
        w pliku Makefile. "PREFIX" wskazuje, gdzie wszystkie inne 
        pliki będą zapisane, domyślnie jest ustawione na katalog "/usr/local".

        Inne zmienne to:
          BIN_PREFIX 
	    Gdzie binaria "tuxpaint" będą zainstalowane.
	    (Ustawione domyślnie na "$(PREFIX)/bin" - np. "/usr/local/bin")
	  
	  DATA_PREFIX 
	    Gdzie pliki danych (dźwięk, grafika, pędzle, pieczątki, czcionki)
 	    będą zapisane i gdzie Tux Paint będzie ich szukał kiedy będzie uruchomiony.
	    (Ustwawione na "$(PREFIX)/share/tuxpaint")
	
	  DOC_PREFIX 
	    Gdzie pliki dokumentacji ( katalog "docs") będą zapisane.
	    (Ustawione na "$(PREFIX)/share/doc/tuxpaint")
	
	  MAN_PREFIX 
	    Gdzie pliki pomocy (manual) Tux Paint będą zapisane.
	    (Ustawione na "$(PREFIX)/share/man")
	
	  ICON_PREFIX                      $(PREFIX)/share/pixmaps 
	  X11_ICON_PREFIX                  $(PREFI)/X11R6/include/X11/pixmaps 
	  GNOME_PREFIX                     $(PREFIX)/share/gnome/apps/Graphics 
	  KDE_PREFIX                       $(PREFIX)/share/applnk/Graphics 
	    Gdzie ikony i odpalacze (dla GNOME i KDE) będą zapisane.
	
	  LOCALE_PREFIX 
	    Gdzie pliki z tłumaczeniem dla Tux Paint będą zapisane i gdzie 
	    Tux Paint będzie ich szukał.
	    (Ustawione na "$(PREFIX)/share/locale/")
	    (Ostateczne miejsce pliku z tłumaczeniem będzie 
	    w katalogu odpowiednim dla języka (np. "es" dla języka hiszpańskiego),
	    w podkatalogu "LC_MESSAGES".)
	
	
Odinstalowywanie Tux Paint:
----------------------- 
  System Windows 
  ------- 
    Używając programu odinstalowującego
    --------------------- 
      Jeżeli zainstalowałeś skróty w Menu Start (domyślnie), przejdź do 
      folderu TuxPaint i wybierz "Uninstall". Pojawi się okienko z potwierdzeniem,
      czy napewno chcesz odinstalować Tux Paint, jeżeli jesteś pewny 
      że chcesz trwale usunąć Tux Paint, kliknij na przycisk Uninstall. 

      Kiedy wszystko się skończy, kliknij na przycisk zamknięcia.

      Jest również możliwe, by użyć wpisu "TuxPaint (remove only)" w 
      Panelu Sterowania w sekcji Dodaj/Usuń programy.

      ZAUWAŻ: z powodu obrazków, które są tworzone i zapisywane wewnątrz folderu Tux Paint,
      ten folder i folder 'userdata' wewnątrz niego NIE BĘDZIE usunięty.


  Linux 
  ----- 
    W katalogu, gdzie znajdują się źródła Tux Paint (gdzie kompilowałeś Tux Paint),
    możesz użyć 'Makefile', by go odinstalować.
    Domyślnie, musi to zostać zrobione przez użytkownika "root" (superużytkownik).
    (Zobacz instrukcje instalacji dla dalszych informacji.)

    Przełącz się na użytkownika "root" przez wpisanie polecenia:

      $ su 

    Wpisz hasło użytkownika "root". Powinieneś teraz być użytkownikiem "root".
    Aby odinstalować program i jego pliki danych 
    (domyślna gumka, pieczątka i obrazy, jeżeli jakieś są, też będą usunięte), napisz:

      # make uninstall 

    W końcu, możesz przełączyć z powrotem do Twojego regularnego użytkownika przez wyjście
    z trybu superużytkownika:

      # exit