@database ASokoban_SI.guide
@author "Damir Arh"
@(c) "Copyright (C) 1997 Autumn Design"
@$VER: ASokoban_SI.guide 3.0 (19.5.97)


@node Main "Dokumentacija ASokobana"

@{b}Dobrodošli v ASokobanu!@{ub}

To je različica znane skladiščne igre Sokoban. Vsebuje originalnih 90
stopenj iz UNIXove verzije, zato se bodo stopnje v ASokobanu vsem tistim,
ki ste že igrali originalno igro, zdele znane.

     @{"Pravne zadeve        " link Copyright}
     @{"Zahvale              " link Acknowledgements}
     @{b}----------------------@{ub}
     @{"Instalacija          " link Installation}
     @{"Sistemske zahteve    " link Requirements}
     @{"Odpravljanje težav   " link Troubleshooting)
     @{b}----------------------@{ub}
     @{"Igra                 " link Game}
     @{"Gumbi                " link Gadgets}
     @{"Meniji               " link Menu}
     @{"ARexx ukazi          " link ARexx}
     @{"Startni argumenti    " link Tooltypes}
     @{b}----------------------@{ub}
     @{"Zgodovina            " link History}
     @{"Načrti za prihodnost " link Future}
     @{b}----------------------@{ub}
     @{"Lokalizacija         " link Localization}
     @{"Kontaktiranje avtorja" link Address}

Če vam je ASokoban všeč, vas morda zanimajo tudi @{"drugi moji proizvodi" link Products}.

@endnode


@node Copyright "Pravne zadeve"

@{b}Avtorske pravice@{ub}
Igra ASokoban in vse datoteke v originalni distribuciji so, če ni povedano
drugače, last
(C) 1993 Panagiotis Christias,
(C) 1995-1996 Lorens Younes.

@{"ClassAct" link ClassAct} sistem grafičnih uporabniških vmesnikov je last (C) 1995 Phantom
Development.

@{b}Distribucija@{ub}
Ta program se sme javno distribuirati (ne v komercialne namene) dokler so v
nespremenjeni obliki vključene vse datoteke. Za vključitev v komercialen
paket je potrebno @{"avtorjevo" link Address} pisno dovoljenje. V primeru objave na disketah
v okviru revij, mora biti avtorjevo ime v reviji omenjeno.

@{b}Zanikanje odgovornosti@{ub}
TA PROGRAMSKA OPREMA JE NA VOLJO "KOT-JE". ZANJO NI NOBENIH GARANCIJ.
UPORABLJATE JO POPOLNOMA NA LASTNO ODGOVORNOST. AVTOR NE ODGOVARJA ZA
MOREBITNO NASTALO ŠKODO.

@endnode


@node ClassAct "Orodje ClassAct za oblikovanje grafičnih uporabniških vmesnikov"

ClassAct je komplet BOOPSI orodij in podob, namenjenih pospešitvi in
poenostavitvi razvoja aplikacij z grafičnim uporabniškim vmesnikom. Medtem
ko je ta uporabnikom aplikacij na voljo zastonj, potrebujejo programerji
komercialno licenco. S tem dobijo tudi programe za razvoj, podporo in
distribucijske pravice do ClassAct knjižnic. Za več informacij se obrnite
na

http://www.warped.com/~timmer/classact.html

ali pa pošljite elektronsko pošto na caldi@nai.net.

@endnode


@node Acknowledgements "Zahvale"

Mnogi so mi sporočili svoje mnenje o ASokobanu, le redki pa so mi poslali
tudi predloge in pripombe za izboljšanje igre ali mi celo pomagali pri delu.
Med temi sta tudi Nils Görs in Aris Basic.

Upam, da mi boste še vedno sporočali svoje mnenje o mojih izdelkih, saj je
le na ta način možno razvijati kvalitetno programsko opremo za Amigo.

Za konec pa bi se rad zahvalil še Panagiotisu Cristiasu, da mi je prepustil
ta svoj projekt. Brez njegovega originalnega dela ASokoban ne bi bil takšen,
kakršen je danes.

@endnode


@node Installation "Instalacija"

Najprej se prepričajte, da imate instalirane @{"ClassAct" link ClassAct} BOOPSI razrede. Če
hočete izvesti instalacijo od začetka ali pa le nadgraditi staro verzijo,
zaženite instalacijsko skripto. (Za zagon te skripte potrebujete
Commodorejev "Installer". Če ga nimate, ga lahko dobite na aminetu.)

Če boste instalirali ASokoban 3 na mesto, kjer ste že imeli starejšo verzijo
(na primer 2.x), se bo datoteka z vašimi rezultati ob prvem zagonu igre
preoblikovala in bo uporabna tudi v novi verziji.

Še vedno lahko uporabljate stare shranjene pozicije, vendar pa jih je
verjetno najbolje preimenovati, saj imajo po novem ime enako igralcu.
Vse pozicije namestite v svoj @{"predal s shranjenimi pozicijami" link ToolTypes}.

@endnode


@node Requirements "Sistemske zahteve"

ASokoban bo tekel na vsaki Amigi z operacijskim sistemom 2.0 ali novejšim
(vsaj upam, da bo).

Če imate verzijo 2.1 ali višjo, bo ASokoban poskusil uporabiti @{"jezik" link Localization} , ki je
izbran v nastavitvah.

ASokoban potrebuje @{"ClassAct" link ClassAct} BOOPSI razrede.

@endnode


@node Troubleshooting "Odpravljanje tezav"

Pri pisanju programa se nisem trudil, da bi vgradil sporočila o napakah, ki
bi se pojavila, kadar gre kaj narobe. Če imate kakršnekoli težave z
zaganjanjem ASokobana @{"mi" link Address} to prosim sporočite.

@endnode


@node Game "Igra"

Sokoban pomeni v japonščini skladiščnik. Namen igre je, da pakete s
potiskanjem skozi labirint spravite na označeno pozicijo. Pakete lahko LE
potiskate - ne morete jih vleči, pobirati ali z njimi početi kaj drugega. Ko
so vsi paketi pospravljeni, napredujete na naslednjo stopnjo. Časovne
omejitve ni (za računalnikom lahko sedite ves dan in rešujete težavno
stopnjo). Tudi če ste stopnjo že rešili, lahko poskusite še enkrat - tokrat
z manj premiki in potiski (za vsako stopnjo obstaja lestvica najboljših
rezultatov).

Igrate lahko s kurzorskimi tipkami ali z miško. S pritiskom na levo tipko
miške spravite skladiščnika na kraj pritiska brez potiskanja paketov. S
pritiskom na desno tipko miške pa bo skladiščnik potisnil najbližji paket na
izbrano lokacijo. S pritiskom na srednjo tipko miške prekličete svojo zadnjo
potezo.

@endnode


@node Gadgets "Gumbi"

@{b}Nastavi stopnjo...@{ub}
Odprete okno, v katerem lahko izberete stopnjo, ki jo boste igrali.
Posamezno stopnjo lahko igrate le, če ste prejšnjo že opravili.

@{b}Ponovni začni@{ub}
Ponovno začnete s trenutno stopnjo.

@{b}Potezo nazaj@{ub}
Prekličete svojo zadnjo potezo. S to opcijo lahko prekličete kolikor potez
hočete (če imate dovolj spomina).

@{b}Potezo naprej@{ub}
Prekličete "Potezo nazaj".

@{b}Zavaruj@{ub}
Naredite začasen posnetek trenutne stopnje.

@{b}Prikliči nazaj@{ub}
Na zaslon prikličete zadnji posnetek, ki ste ga naredili.

@{b}Najboljši rezultati...@{ub}
Ogledate si lestvico najboljših rezultatov za trenutno stopnjo.

@{b}Več o...@{ub}
Prikličete podatke o verziji in @{"ARexx" link ARexx} portu.

@endnode

@node Menu "Meniji"

@{b}Igra@{ub}

     @{b}Nova...@{ub}
     Ustvarite novega igralca. Pojavi se okno, kamor morate vnesti njegovo
     ime.

     @{b}Naloži...@{ub}
     Naložite shranjenega igralca.

     @{b}Shrani@{ub}
     Shranite trenutnega igralca.

     @{b}Najboljši rezultati...@{ub}
     Ogledate si lestvico najboljših rezultatov za trenutno stopnjo.

     @{b}Več o...@{ub}
     Prikličete podatke o verziji in @{"ARexx" link ARexx} portu.

     @{b}Zapusti ASokoban...@{ub}
     Zapustite igro.

@{b}Makroji@{ub}

     @{b}Začni z učenjem@{ub}
     Začnete z zapisovanjem makroja. Vsako dejanje uporabnika ima svoj @{"ARexx" link ARexx}
     ukaz, ki se v tem primeru zapiše.

     @{b}Končaj z učenjem@{ub}
     Prekinete z zapisovanjem makroja.

     @{b}Shrani makro...@{ub}
     Trenutni makro shranite na disk.

@endnode


@node ARexx "ARexx ukazi "

@{b}WALKTO@{ub}
     ROW/N/A,COL=COLUMN/N/A
Premakne skladiščnika na dano lokacijo brez potiskanja.

@{b}PUSHTO@{ub}
     ROW/N/A,COL=COLUMN/N/A
Potisne najbližji paket na dano lokacijo.

@{b}MOVE@{ub}
     UP/S,DOWN/S,LEFT/S,RIGHT/S
Premakne skladiščnika v dano smer.

@{b}SETLEVEL@{ub}
     /N
Nastavi trenutno stopnjo.

@{b}GETLEVEL@{ub}
     ,
Vrne številko trenutne stopnje.

@{b}RESTART@{ub}
     ,
Ponovno začne s trenutno stopnjo.

@{b}UNDO@{ub}
     /N
Prekliče zadnjo potezo (oziroma zadnjih n potez, če je podana številka).

@{b}REDO@{ub}
     /N
Prekliče preklic zadnje poteze (n-krat, če je podana številka).

@{b}BACKUP@{ub}
     ,
Naredi začasen posnetek trenutne stopnje.

@{b}RESTORE@{ub}
     ,
Na zaslon prikliče zadnji narejeni posnetek.

@endnode


@node ToolTypes "Startni argumenti"

ASokoban prepozna naslednje argumente in sicer kot CLI argumente ali kot
lastnosti ikon v Workbenchu.

@{b}PLAYER@{ub}
Ime igralca, ki naj se naloži ob zagonu.

@{b}LEVEL/N/K@{ub}
Začetna stopnja.

@{b}IMAGEPATH/K@{ub}
Predal, iz katerega naj ASokoban uporablja grafiko. Začetna nastavitev je
Images/original.

@{b}LEVELPATH/K@{ub}
Direktorij, iz katerega naj ASokoban nalaga stopnje. Začetna nastavitev je
Levels.

@{b}SAVEPATH/K@{ub}
Predal za shranjevanje pozicij.

@{b}PUBSCREEN/K@{ub}
Naslov zaslona, na katerem naj se odpre ASokoban.

@{b}LANGUAGE@{ub}
Jezik, v katerem naj se ASokoban odvija.

@endnode


@node History "Zgodovina"

(v1.0a - v1.1c so delo Panagiotis Christiasa)
1.0a    : Prva stabilna verzija. Dobili so jo le moji prijatelji za namene
          beta testiranja.

1.0b    : Prva javno izdana verzija.

1.1     : Prevedena z SAS C 6.1 z uporabo Reqtools.library 2.1. Odpravljen
          hrošč pri preklicu zadnje poteze (našel sem ga sam!). Ob izhodu
          zdaj ASokoban avtomatično shrani pozicijo (priporočilo Kritona
          Kyrimisa). Odpravljen je hrošč v 15. stopnji, zdaj ASokoban namreč
          za pospravljene pakete šteje tudi tiste, ki so tam že od samega
          začetka (tako kot je to v 15. stopnji). Napako je prvi
          odkril Carsten Steger. Pri nalaganju shranjene pozicije se
          maksimalna stopnja ne bo zmanjšala, če je v shranjeni poziciji
          ta nižja kot trenutno. Predlog Sebastiana Delmonta.

1.1c    : ASokoban je imel težave, če je bila stopnja končana z miško. Hrošč
          je odpravljen, ASokoban zdaj IDCMP sporočil ne izgublja več
          (odkril Markus Torpvret). Ta verzija ASokobana podpira vse vrste
          (in velikosti) fontov v naslovni vrstici. Priporočila Terence
          Russell in Ives Aerts (ASokoban sam žal še ne upošteva fontov...)

(Projekt je prevzel Lorens Younes)
v2.0  (08.02.95) ASokoban zdaj upošteva fonte (vrne se na topaz 8, če se
                 izbrani font ne ujema z grafiko).
                 Dodana je podpora za locale.library.
                 Gumbi so zdaj zamegljeni, če nimajo funkcije.
                 Dodana sta argumenta PUBSCREEN in DATAFILE.
                 Nova lestvica najboljših rezultatov (za vsako stopnjo svoja
                 lestvica namesto le skupnih najboljših desetih rezultatov).
                 Dokumentacija v AmigaGuide formatu.
                 Instalacijska skripta za Commodorejev Installer.
                 ReqTools.library ni več nujno potrebna (namesto nje se
                 uporablja asl okna).
v2.1  (25.02.95) ASokoban se ne bo več sesul, če bo število premikov
                 preseglo 9999 (odkril Jouni Jääskeläinen).
                 Povečava (ponovno) dodana na "zahtevo" Panagiotis
                 Christiasa ;-)
v2.2  (01.03.95) ASokoban zdaj pravilno ravno s prevedenimi napisi na
                 gumbih (odkril Uwe Röhm)
v2.3  (27.05.95) Preklic zadnje poteze nič več ne sesuje računalnika z
                 operacijskim sistemom 2.x (problem je prvi odkril Fredrik
                 Hällgren, ki ga je tudi rešil namesto mene).
                 Dodanih še pet stopenj iz xsokobana.
v2.4  (05.06.95) Hrošč, ki je povzročal, da se je na gumbu z imenom
                 pojavljal čuden tekst, je odpravljen (odkril Niels Knoop).
v2.5  (06.07.95) Dodan argument LANGUAGE (zahteva Nielsa Goersa).
v2.6  (17.07.95) Odpravljen hrošč, ki se je pojavil, če so bili uporabljeni
                 fonti, manjši od 8. (odkril Lauri Aalto).
v2.7b (??.08.95) Verzija namenjena le beta testerjem. Uporabljala je XPM
                 datoteke za barvno grafiko, a je bila zelo počasna!

v3.0  (11.08.96) Popolnoma na novo napisana verzija. Številne nove opcije so
                 Podpora ARexxa, zunanje grafične datoteke (XPM format),
                 zunanje datoteke s stopnjami (tekst), neskončni preklici
                 zadnjih potez, izboljšana podpora miške in izboljšano
                 ravnanje s shranjenimi pozicijami (igralci).
                 ASokoban zdaj uporablja tudi ClassAct komplet za
                 oblikovanje grafičnih uporabniških vmesnikov.

@endnode


@node Future "Načrti za prihodnost"

Pisanje več @{"katalogov" link Localization} (če mi boste pomagali).
Dodatek pomoči med igro.
Več ARexx ukazov.

@endnode


@node Localization "Lokalizacija"

ASokoban je lokaliziran, zato bo, če imate v2.1 ali višjo, poskušal
uporabljati jezik, ki ste ga izbrali v nastavitvah. Če za vaš jezik ni
kataloga, bo uporabljena angleščina.

Ker nisem dober v jezikih, sem napisal le en dodatni katalog (švedski).
Zato sem dodal nekaj datotek, ki bodo omogočile, da boste z lahkoto
omogočili ASokobanu, da bo podpiral tudi vaš jezik.

@endnode

@node Address "Kontaktiranje avtorja"

Če boste odkrili kakšen hrošč, me prosim obvestite. Tudi če imate
kakšne predloge za izboljšave, če ste napisali dodaten katalog ali pa
hočete le pohvaliti program, bi bil vesel vašega odziva.

Tu me lahko najdete:
   e-mail: d93-hyo@nada.kth.se
   naslov: Sandkullsvägen 16, 163 57 Spĺnga, Sweden

Dobrodošli ste tudi na moji domači strani na:
   http://www.student.nada.kth.se/~d93-hyo/
Tam lahko vedno najdete najnovejše verzije mojih programov.

@endnode

@node Products "Drugi proizvodi"

@{b}AS3Images@{ub}
Šest dodatnih kompletov grafike za uporabo v ASokobanu 3.

@{b}AS3Levels@{ub}
41 dodatnih stopenj za uporabo v ASokobanu 3.

@{b}LazyMines v3.1@{ub}
Najpopolnejša igra minskega polja za Amigo. Vsebuje
   - Čiščenje zaslona in čiščenje poti.
   - 3 različne zahtevnosti in določanje zahtevnosti z opcijami.
   - Opozorila.
   - Avtomatične zaključke.
   - Avtomatična odprtja (0-10%).
   - 10 najboljših rezultatov za vsako zahtevnost.
   - "Smiley" gumb za začetek nove igre.
   - Gumb za premor.
   - Grafiko spremenljive velikosti, ki se prilagaja fontom.
   - Amiga Guide dokumentacijo (v 3 jezikih).
   - Skripto za instalacijo (v 3 jezikih).
   - Podporo locale.library (vključenih 7 jezikov).
   - Možnost odprtja na vsakem zaslonu.
   - Ikone v MagicWB in klasičnem WB stilu.

@{b}NewMasterMind v1.1@{ub}
Barvita mastemind igra. Vsebuje:
   - Izbiro nasprotnika (človek ali računalnik)
   - Pravila za otroke in odrasle.
   - 4, 6 ali 8-barvne opeke.
   - Grafiko, ki se prilagaja fontom.
   - AmigaGuide dokumentacijo.
   - Skripto za instalacijo.
   - Podporo locale.library (vključenih 8 jezikov).
   - Možnost odprtja na vsakem zaslonu.
   - Ikone v MagicWB in klasičnem WB stilu.

@endnode