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:
------------- 
  Uytkownicy systemu Windows:
  -------------- 
    Wersja Tux Paint dla systemu Windows jest spakowana z koniecznym
    zestawem prekompilowanych bibliotek (w formie plikw ".DLL"), wic dodatkowe 
    pobieranie innych plikw jest niepotrzebne.
    
  libSDL 
  ------ 
    Paint Tux wymaga Simple Library Layer DirectMedia (libSDL), biblioteki
    Open Source uywanej podczas programowania multimediw dostpnej na licencji 
    GNU Lesser General Public License (LGPL).

    Wraz z libSDL, Tux Paint zaley od kilku innych pomocniczych bibliotek SDL:
    SDL_Image (dla plikw grafiki), SDL_TTF (dla czcionek TTF)
    i opcjonalnie, SDL_Mixer (dla efektw dwikowych).

    Uzytkownicy Linuksa / Uniksa:
    ----------------- 
      Biblioteki SDL s dostpne zarwno jako kod rdowy, jak i pakiety RPM lub Deb 
      dla rnych dystrybucji Linuksa. Mona 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 rwnie dostpne wraz z Twoj dystrybucj Linux 
      (np. na instalacyjnych CD lub dostpne przez program do update'u 
      oprogramowania taki jak np. "apt-get").

      ZAUWA: Kiedy instalujesz program z pakietw, zainstaluj RWNIE
      wersje "-devel" pakietw.  (Na przykad, 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 uywa PNG (Portable Graphics Network) - formatu dla jego 
      plikw danych. SDL_image bdzie wymaga zainstalowanej biblioteki libPNG.

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

    FreeType2 
    --------- 
      Tux Paint uywa TTF (True Type Font) - czcionek do rysowania tekstu.
      SDL_ttf bdzie wymaga biblioteki FreeType2.

        http://www.freetype.org/ 

    gettext 
    ------- 
      Tux Paint uywa ustawie regionalnych Twojego systemu wraz z 
      bibliotek "gettext", by wspiera rne jzyki (np. hiszpaski).
      Bdziesz potrzebowa zainstalowanej biblioteki gettext.

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

    Tools NetPBM  [OPCJONALNIE]
    ------------------------ 
      Pod Linuksem i Uniksem, narzdzia NetPBM s aktualnie 
      uyte do drukowania.  ( PNG jest generowany przez TuxPaint i konwertowany 
      do PostScript uywajc narzdzi NetPBM 'pngtopnm' i 'pnmtops'.)

        http://netpbm.sourceforge.net/ 
	

Kompilowanie i instalacja:
--------------------------- 
  Tux Paint jest udostpniony pod licencj GNU General Public License (GPL)
  (zobacz "COPYING.txt" dla szczegw) i dlatego 'kod rdowy'
  programu jest zawarty razem z nim.

  Uytkownicy systemu Windows:
  -------------- 
    Kompilacja:
    ---------- 
      Tux Paint dla systemu Windows jest ju skompilowany, wic adna kompilacja nie jest 
      konieczna.  [Ostatecznie, informacja o przekompilowywaniu dla Windows 
      bdzie umieszczony tutaj.  Tymczasem, jeste skazany tylko na siebie.  Przepraszam!]

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

      Najpierw bdziesz poproszony o zgod co do licencji.
      (Jest to licencja GNU General Public License (GPL), ktra jest te 
      dostpna w "COPYING.txt".)

      Nastpnie bdziesz spytany, czy chcesz zainstalowa skrty 
      do Tux Paint w Twoim Menu Start Windows i na Twoim Pulpicie Windows.
      (Obie opcje s ustawione domylnie.)

      Potem bdziesz spytany, gdzie yczysz sobie zainstalowa Tux Paint.
      Domylne miejsce powinno by odpowiednie, o ile dostpna bdzie odpowiednia ilo przestrzeni dyskowej.
      Jeeli nie, wybierz inne miejsce.

      W tym momencie, moesz klikn Install, by zainstalowa Tux Paint!

    Zmiana Ustawie przy uyciu Skrtu:
    ----------------------------------------- 
      Aby zmieni ustawienia programu, kliknij prawym klawiszem myszy na skrt TuxPaint 
      i wybierz 'Waciwoci' (na dole).
       
      Upewnij si, czy jest wybrana zakadka Skrt w oknie, ktre 
      si ukazao i sprawd pole 'Element docelowy'.  Powiniene zobaczy 
      co podobnego do tego:

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

      Moesz teraz doda opcje wiersza polece, ktre bd wykonane kiedy 
      klikniesz podwjnie na ikon.
       
      Na przykad, aby ustawi uruchomianie gry w trybie penoekranowym,
      z prostymi ksztatami (bez opcji rotacji) i w jzyku 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 pena lista opcji wiersza polece.)
       
      Jeeli pomylisz si albo wszystko zniknie, uyj kombinacji klawiszy Ctrl-Z, aby cofn lub
      nacinij klawisz [ESC] i okno zamknie si bez adnych zmian 
      (chyba, e nacisne przycisk "Zastosuj"!).
       
      Kiedy skoczysz, kliknij "OK".

    Jeeli co pjdzie nie tak 
    ----------------------- 
      Jeeli, kiedy podwjnie klikasz na skrt, by uruchomi gr,
      nic si nie dzieje, to jest prawdopodobne, e niektre z tych opcji wiersza 
      polece s niewaciwe. Otwrz Eksploratora jak przedtem i poszukaj pliku 
      nazwanego 'stderr.txt' w folderze TuxPaint.
	
      Plik ten zawiera opis co byo nieprawidowe. Zwykle jest to 
      spowodowane przez niepoprawn wielko litery (dua litera 'Z' zamiast 
      maej 'z') albo brak (lub dodatkowy) znak '-' (minus, pozioma kreska).
  
  
  Uytkownicy Linuksa / Uniksa:
  ----------------- 
    Kompilacja:
    ---------- 
      Zauwa: Aktualnie, Tux Paint nie uywa autoconf/automake, tak wic
      nie ma adnego skryptu "./configure".  (Przykro mi!)  Kompilacja powiniena by 
      prosta - zakadajc, e wszystko co Tux Paint potrzebuje jest zainstalowane.

      Aby skompilowa program ze rda, po prostu uruchom nastpujce polecenie
      z poziomu shell'a (np. "$"):

        $ make

    Wyczanie dwiku na czas kompilacji:
    -------------------------------- 
      Alternatywnie, jeeli nie masz karty dwikowej lub wolisz skompilowa 
      program bez wsparcia dwiku (do tego SDL_mixer nie musi by 
      zainstalowany), moesz uruchomi polecenie "make" z "nosound":

        $ make nosound 


    Jeeli otrzymasz bdy:
    ------------------ 
      Jeeli otrzymujesz jakie bdy podczas kompilacji - upewnij si, e masz zainstalowane
      odpowiednie biblioteki (zobacz powyej). Jeeli uywasz spakowanych 
      wersji bibliotek (np. RPM w systemie RedHat albo DEB w systemie Debian),
      upewnij si, czy masz rwnie odpowiednie pakiety "-dev" lub "-devel",
      inaczej nie bdziesz w stanie skompilowa Tux Paint (i innych programw)
      ze rda!


    Instalowanie:
    ----------- 
      Zakadajc, e adne bdy krytyczne nie wystpiy, moesz teraz zainstalowa program, 
      po to aby mg by uruchamiany przez uytkownikw. Domylnie, to musi 
      zosta zrobione przez uytkownika "root" ('superuser'). Przecz si na uytkownika "root" 
      piszc polecenie:

        $ su 

      Wpisz  haso uytkownika "root".  Powiniene teraz by uytkownikiem "root"
      (ze znakiem "#").  Aby zainstalowa program i jego pliki danych, napisz:

        # make install

      Na kocu moesz przeczy si z powrotem do Twojego regularnego uytkownika przez wyjcie
      z trybu superuytkownika:

        # exit


      ZAUWA: Domylnie, wykonywalny program "tuxpaint" jest 
      umieszczony w katalogu "/usr/local/bin/". Pliki danych (obrazy, dwiki, itd.)
      s umieszczone w katalogu "/usr/local/share/tuxpaint/".


      Zmiana miejsca zapisu plikw
      ------------------------ 
        Moesz zmieni miejsce zapisu plikw uywajc zmiennej 'prefix'
        w pliku Makefile. "PREFIX" wskazuje, gdzie wszystkie inne 
        pliki bd zapisane, domylnie jest ustawione na katalog "/usr/local".

        Inne zmienne to:
          BIN_PREFIX 
	    Gdzie binaria "tuxpaint" bd zainstalowane.
	    (Ustawione domylnie na "$(PREFIX)/bin" - np. "/usr/local/bin")
	  
	  DATA_PREFIX 
	    Gdzie pliki danych (dwik, grafika, pdzle, piecztki, czcionki)
 	    bd zapisane i gdzie Tux Paint bdzie ich szuka kiedy bdzie uruchomiony.
	    (Ustwawione na "$(PREFIX)/share/tuxpaint")
	
	  DOC_PREFIX 
	    Gdzie pliki dokumentacji ( katalog "docs") bd zapisane.
	    (Ustawione na "$(PREFIX)/share/doc/tuxpaint")
	
	  MAN_PREFIX 
	    Gdzie pliki pomocy (manual) Tux Paint bd 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) bd zapisane.
	
	  LOCALE_PREFIX 
	    Gdzie pliki z tumaczeniem dla Tux Paint bd zapisane i gdzie 
	    Tux Paint bdzie ich szuka.
	    (Ustawione na "$(PREFIX)/share/locale/")
	    (Ostateczne miejsce pliku z tumaczeniem bdzie 
	    w katalogu odpowiednim dla jzyka (np. "es" dla jzyka hiszpaskiego),
	    w podkatalogu "LC_MESSAGES".)
	
	
Odinstalowywanie Tux Paint:
----------------------- 
  System Windows 
  ------- 
    Uywajc programu odinstalowujcego
    --------------------- 
      Jeeli zainstalowae skrty w Menu Start (domylnie), przejd do 
      folderu TuxPaint i wybierz "Uninstall". Pojawi si okienko z potwierdzeniem,
      czy napewno chcesz odinstalowa Tux Paint, jeeli jeste pewny 
      e chcesz trwale usun Tux Paint, kliknij na przycisk Uninstall. 

      Kiedy wszystko si skoczy, kliknij na przycisk zamknicia.

      Jest rwnie moliwe, by uy wpisu "TuxPaint (remove only)" w 
      Panelu Sterowania w sekcji Dodaj/Usu programy.

      ZAUWA: z powodu obrazkw, ktre s tworzone i zapisywane wewntrz folderu Tux Paint,
      ten folder i folder 'userdata' wewntrz niego NIE BDZIE usunity.


  Linux 
  ----- 
    W katalogu, gdzie znajduj si rda Tux Paint (gdzie kompilowae Tux Paint),
    moesz uy 'Makefile', by go odinstalowa.
    Domylnie, musi to zosta zrobione przez uytkownika "root" (superuytkownik).
    (Zobacz instrukcje instalacji dla dalszych informacji.)

    Przecz si na uytkownika "root" przez wpisanie polecenia:

      $ su 

    Wpisz haso uytkownika "root". Powiniene teraz by uytkownikiem "root".
    Aby odinstalowa program i jego pliki danych 
    (domylna gumka, piecztka i obrazy, jeeli jakie s, te bd usunite), napisz:

      # make uninstall 

    W kocu, moesz przeczy z powrotem do Twojego regularnego uytkownika przez wyjcie
    z trybu superuytkownika:

      # exit