INSTALLERING.txt for Tux Paint

Tux Paint - eit enkelt teikneprogram for dei yngste.

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

27. juli 2002 - 28. september 2002


SYSTEMKRAV
----------
  Windows
  -------
    Windows-versjonen av Tux Paint inneheld alle dei ndvendige
    bibliotekfilene (i .DLL-format), s du treng ikkje lasta
    ned noko meir.

  libSDL
  ------
    Tux Paint brukar Simple DirectMedia Layer Library (libSDL),
    som er eit multimedieprogrammeringsbibliotek tilgjengeleg som
    open kjeldekode under GNU Lesser General Public License (LGPL).

    Tux Paint treng g fleire SDL-hjelpebibliotek:
    SDL_Image (for grafikk), SDL_TTF (for skriftsttte) og
    SDL_Mixer (valfritt - for lydeffektar).

    Linux/Unix
    ----------
      Kjeldekoden og RPM- og Debian-pakkar av SDL-biblioteka er tilgjengeleg.
      Du kan lasta ned alle filene fr:

        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/

      Dei flgjer g ofte med Linux-distribusjonar (enten p
      installasjons-CD-en eller gjennom pakkehandteringsprogramvare,
      som apt-get i Debian).

      Merk: Srg for  installera -devel-utgvene av pakkane du installerer,
      i tillegg til standardutgvene. Installer for eksempel bde
      SDL-1.2.4.rpm og SDL-1.2.4-devel.rpm.

  Andre bibliotek
  ---------------
    Tux Paint brukar g fleire andre frie LGPL-baserte bibliotek.
    Dei er vanlegvis allereie installert under Linux, eller enkelet
    tilgjengeleg fr distribusjonen du brukar.

    libPNG
    ------
      Tux Paint brukar PNG-formatet (Portable Network Graphics) for
      grafikkfiler. libPNG m vera installert for at SDL_image skal
      fungera.

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

    FreeType2
    ---------
      Tux Paint brukar skrifter i TTF-format (TrueType) for 
      skriva tekst.
      SDL_ttf treng FreeType2-biblioteket.

        http://www.freetype.org/

    docbook-to-man
    --------------
      man-sida til Tux Paint er skriven i DocBook-formatet (SGML).
      DocBook-fila blir konvertert til man-format med programmet
      docbook-to-man.

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

      Merk: docbook-to-man er ikkje strengt ndvendig. Viss programmet
      ikkje er installert, blir ikkje man-sidene bygd og installert,
      men alt anna vil fungera fint.

    gettext
    -------
      Tux Paint brukar lokaleinnstillingane saman med gettext-biblioteket
      for  visa brukargrensesnittet p fleire sprk. Du m ha gettext-
      biblioteket installert.

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

    NetPBM-verktya
    ---------------
      NetPBM-verktya blir brukt for utskrift under Linux og Unix.
      (Tux Paint lagar eit PNG-bilete, som s blir konvertert til
      PostScript-format ved hjelp av kommandolinjeprogramma pngtopnm
      og pnmtops.)

        http://netpbm.sourceforge.net/
	

Kompilering og installering
---------------------------
  D Tux Paint er gjeven ut under GNU General Public License (GPL)
  (sj COPYING.txt for meir informasjon), flgjer kjeldekoden med.

  Linux/Unix
  ----------
    Kompilering
    -----------
      Skriv flgjande fr kommandolinja for kompilera programmet:

        $ make

    Sl av lydsttta ved kompilering
    --------------------------------
      Viss du ikkje har noko lydkort, eller fretrekkjer  bruka programmet
      utan lyd (og utan SDL-mixer-biblioteket), kan du kjra make med
      mlet nosound:

        $ make nosound


    Installering
    ------------
      Viss ingen feil har oppsttt, kan du no installera programmet p
      systemet. Som standard m dette gjerast som rotbrukar (superuser).
      Byt til rotbrukar med kommandoen:

        $ su

      Skriv s inn passordet. Du er no rotbrukar (med ledeteksten #). Du
      kan s skriva flgjande for  installera programmet og datafilene:

        # make install

      Til slutt br du bytta tilbake til vanleg brukar:

        # exit


      Merk: Som standard blir kjrefila tuxpaint lagt i katalogen
      /usr/local/bin/. Datafilene (bilete, lydeffektar og liknande)
      blir lagt i katalogen /usr/local/share/tuxpaint/.


      Velja filplassering
      -------------------
        Du kan velja kor filene skal leggjast ved  bruka PREFIX-
        variablane i Makefile. PREFIX er grunnkatalogen som alle
        filene blir lagt under, og er som standard /usr/local.

        Andre variablar
        ---------------
        BIN_PREFIX
	    Katalogen til kjrefila tuxpaint.
	    (Standard: $(PREFIX)/bin, alts /usr/local/bin)
	
	  DATA_PREFIX
	    Katalogen til datafilene (lydeffektar, grafikk, penslar,
          stempel og skrifter).
	    (Standard: $(PREFIX)/share/tuxpaint)
	
	  DOC_PREFIX
	    Katalogen til dokumentasjonskatalogen (docs-katalogen).
	    (Standard: $(PREFIX)/share/doc/tuxpaint)
	
	  MAN_PREFIX
	    Katalogen til man-sida for Tux Paint.
	    (Standard: $(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
	    Katalogen til ikona og programstartarane (for GNOME og KDE).
	
	  LOCALE_PREFIX
	    Katalogen til omsetjingsfilene for Tux Paint.
	    (Standard: $(PREFIX)/share/locale/)
	    (Filene blir lagt i eigne katalogar for kvart lokale, i
          LC_MESSAGES under lokalekatalogane, som nn for
          nynorskomsetjinga.)


  Windows
  -------
    Kompilering
    -----------
      Tux Paint kjem ferdigkompliert for Windows, s du slepp  kompilera
      programmet p eiga hand. [Det vil komma informasjon om kompilering
      p Windows her - med tid og stunder. I mellomtida fr du prva 
      klara deg p sjlv.]

    Installering
    ------------
      Kjr installasjonsfila (.exe-fila) og flg instruksjonane.

      Frst m du godta lisensen. (Det er GNU General Public License (GPL),
      som g er tilgjengeleg i COPYING.txt.)

      Du blir s spurt om du vil installera snarvegar til Tux Paint i
      Start-menyen og p skrivebordet. (Dette blir gjort som standard.)

      S m du velja kor du vil leggja Tux Paint. Standardmappa er grei,
      s lenge du har nok diskplass.

      Til slutt trykkjer du berre p Install for  installera programmet!

      Endra p innstillingane fr snarvegen
      -------------------------------------
      Hgreklikk p Tux Paint-snarvegen, og vel Egenskapar nedst fr
      menyen som dukkar opp.
	
	Srg for at Snarvei-fanen er valt i dialogvindauget, sj p
      Mlmappe-feltet. Her skal det st noko liknande:

          C:\Programfiler\TuxPaint\TuxPaint.exe

      Du kan no leggja til kommandolinjeval som blir tatt i
      bruk nr du brukar ikonet.
	
	Eksempel: Viss du vil kjra programmet i fullskjerm, med enkle
      figurar (utan rotasjon) og p nynorsk, legg du til vala for dette
      (etter TuxPaint.exe):

          C:\Spel\tuxpaint-2002.07.31\TuxPaint.exe -f -s --lang nynorsk

      (Sj LESMEG.txt for ei oversikt over kommandolinjevala du kan bruka.)
	
      Viss du skrive noko galt, eller all teksten forsvinn, kan du angra
      med Ctrl + Z, eller bruka Escape-tasten til  lukka dialogvindauget
      utan  lagra endringane (med mindre du har trykt p Bruk-knappen!)
	
	Nr du er ferdig, trykkjer du OK.

      Viss noko gr galt
      ------------------
      Viss ingenting skjer nr du brukar snarvegen, er det sannsynlegvis
      fordi nokre av kommandolinjevala er feil. Opna eit Utforsker-vindauge
      som fr, og leit etter ei fil som heiter stderr.txt i mappa der
      Tux Paint-programmet ligg.
	
	Denne fila inneheld informasjon om kva som gjekk galt. Vanlegvis
      er berre store bokstavar nr du skulle brukt sm, eller ein
      manglande bindestrek (-).
	
	
Avinstallering
--------------
  Linux
  -----

  Windows
  -------
    Viss du installerte snarvegane i Start-menyen (standard), gr du berre
    til TuxPaint-mappa og vel Uninstall. Det dukkar opp eit dialogvindauge
    som ber deg stadfesta at du vil avinstallera Tux Paint. Viss du er sikker
    p at du vil fjerna programmet, trykkjer du p Uninstall-knappen.

    Nr avinstalleringa er fullfrt, trykkjer du p Close-knappen.

    Du kan g bruka oppfringa TuxPaint (remove only) i Legg til / fjern
    programmer i Kontrollpanel.

    Merk: D teikningar blir lagra i same mappe som Tux Paint-programmet er
    installert i, blir ikkje denne mappa og userdata-undermappa fjerna.