@database ANetGUI.amigaguide
@author Wojciech Kocjan
@index "INDEX"
@wordwrap

@node "MAIN" "ANetGUI"
@{jcenter}
@{b}ANetGUI/II@{ub}

© 1997 Wojciech Kocjan

Data aktualizacji: 3.11.97

@{jleft}
Przejdś do:
· @{"             INDEKSU             " link "INDEX"}
· @{"       Informacji ogólnych       " link "introduction"}
· @{"      Informacji o autorze       " link "author"}
· @{"            Wymagaļ              " link "requirements"}
· @{"         Kwestie prawne          " link "legal"}

Opis programu:

· @{"     Opisu gīównego okienka      " link "main_window"}
· @{"     Opisu okienka szukania      " link "find_window"}
· @{" Opisu okienka zarzādzania listā " link "list_window"}
· @{"    Informacje o pliku INDEKSU   " link "indexfile"}

· @("              ARexx              " link "ARexx"}
· @{"       MagicUserInterface        " link "MUI"}
@endnode

@node "INDEX" "ANetGUI - indeks"

@{" gīówne okienko " link "main_window"}
·  @{" lista katalogów " link "lst_dirs"}
·  @{" lista plików " link "lst_files"}
·  @{" lista wybranych plików " link "lst_selected"}
·  @{" przyciski kontrolne " link "buttons"}

@{" szukanie plików " link "find_window"}
·	@{" wzór szukania " link "find_pattern"}

@{" zarzādzanie listā " link "list_window"}
@{" ARexx " link "ARexx"}
@{" Kwestie prawne " link "legal"}
@endnode

@node "legal" "Kwestie prawne ANetGUI/II"
ANetGUI/II jest @{i}freeware. @{ui}Moūe byź rozprowadzany w dowolnej iloōci kopii, jeōli tylko ūaden plik nie zostanie zmieniony.

Jednakūe jeōli Ci siė podoba, to moūesz (i powinieneō(aō) :-) napisaź o tym@{" autorowi " link "author"}.
@endnode

@node "ARexx" "ARexx commands"
Port ARexxa @{b}ANetGUI/II@{ub} to @{b}ANETGUI@{ub}.

Komenda:  @{b}Quit@{ub}
Wzór:     @{b}N/A@{ub}
Funkcja:  wychodzi z ANetGUI/II

Komenda:  @{b}New@{ub}
Wzór:     @{b}N/A@{ub}
Funkcja:  Kasuje listė wybranych

Komenda:  @{b}Load@{ub}
Wzór:     @{b}N/A@{ub}
Funkcja:  īaduje listė

Komenda:  @{b}Save@{ub}
Wzór:     @{b}N/A@{ub}
Funkcja:  zapisuje listė

Komenda:  @{b}SaveAs@{ub}
Wzór:     @{b}N/A@{ub}
Funkcja:  zapisuje listė jako

Komenda:  @{b}GetEntries@{ub}
Wzór:     @{b}N/A@{ub}
Funkcja:  pobiera iloōź

Komenda:  @{b}GetPath@{ub}
Wzór:     @{b}ENTRY/N/A@{ub}
Funkcja:  Zwraca ōcieūkė pozycji (np. @{i}util/boot/AStart21.lha @{ui})

Komenda:  @{b}GetDit@{ub}
Wzór:     @{b}ENTRY/N/A@{ub}
Funkcja:  Zwraca katalog pozycji (np. @{i}util/boot @{ui})

Komenda:  @{b}GetFile@{ub}
Wzór:     @{b}ENTRY/N/A@{ub}
Funkcja:  Zwraca nazwė pozycji (np. @{i}AStart21.lha @{ui})

Komenda:  @{b}GetSize@{ub}
Wzór:     @{b}ENTRY/N/A@{ub}
Funkcja:  Zwraca tekst dīugoōci pozycji (np. @{i}17K @{ui})

Komenda:  @{b}GetDesc@{ub}
Wzór:     @{b}ENTRY/N/A@{ub}
Funkcja:  Zwraca opis pozycji

Komenda:  @{b}ReqFile@{ub}
Wzór:     @{b}OLDFILE,TITLE,DIR/S,SAVEMODE/S@{ub}
Funkcja:  Otwiera requester pliku, zwraca nazwė pliku/katalogu, w RC czy uūytkownik poniechaī

Komenda:  @{b}ReqChoice@{ub}
Wzór:     @{b}TITLE/A,BODY/A,GADGETS/A@{ub}
Funkcja:  Otwiera requester wyboru, zwraca wybór w RC 1,2,3,...,0

Komenda:  @{b}Rescan@{ub}
Wzór:     @{b}N/A@{ub}
Funkcja:  Odczytuje listė katalogów od nowa

Dla przykīadów zastosowania tych funkcji ARexxa, zobacz skrypty w katalogu @{i}rexx.@{ui}
@endnode

@node "author" "Autor programu"
@{jcenter}@{b}Autorem tego programu jest Wojciech Kocjan.@{ub}
@{jleft}
Witam. Nazywam siė Wojtek Kocjan i to ja jestem autorem tego programu. Mam 17 lat i jak narazie jestem uczniem II L.O. w Rybniku (byīe II L.O. im. Hanki Sawickiej, jesteōmy w trakcie zmiany nazwy). Urodziīem siė w Rybniku (woj. Katowickie, Polska) w dniu 21.10.1980, jeōli to kogoō interesuje. Jak narazie posiadam A1200 z twardym dyskiem.
Moja ksywa na IRC-u to @{i}zoro @{ui}(chyba, ūe ktoō juū uūywa tej ksywy, wtedy @{i}zoro_@{ui} ) i moūna mnie zastaź na @{i}#amigapl @{ui}lub @{i}#amisia.@{ui}

Mój @{b}e-mail@{ub} to @{u}kocjan@ka.onet.pl@{uu}.

Obecnie nie mam prywatnej @{b}strony WWW@{ub}, ale wkrótce chyba zaīoūė.

Mój numer telefonu @{i}(po 14:00 CET) @{ui}to @{b}+48 601 47 32 37@{ub}. Jest to komórka GSM zgodna ze standardem @{b}SMS@{ub}, wiėc moūna na niā przesīaź SMS-y (bramka e-mail -> SMS @{b}48601473237@text.plusgsm.pl@{ub} do 160 znaków).

Zajmujė siė mapkā zasiėgu telefonii GSM, wiėc jeōli to kogoō interesuje, oto adres: @{u}http://www.kacyko.com/mapka/@{uu}.

@endnode

@node "introduction" "Wstėp"
ANetGUI pozwala na przeglādanie Aminetu bez potrzeby īāczenia siė z internetem. Jest to metoda zwana @{i}off-line @{ui}i jest uūyteczna zwīaszcza dla posiadaczy modemów lub nie posiadajācych dostėpu do Internetu poprzez Amigė. 

Program ten wykorzystuje nowā moūliwoōź dla @{" MUI 3.1 " link "MUI"}, czyli @{b}Drag-N-Drop@{ub}. Dziėki temu jest bardzo prosty w obsīudze.

@{b}ANetGUI/II@{ub} pozwala na@{" szukanie plików " link "find_window"}speīniajācych odpowiednie kryteria. Jest to poūyteczna funkcja, gdyū moūna w ten sposób w spokoju poszukaź interesujācych nas plików.

Bardzo chciaīem, aby ANetGUI potrafiī generowaź skrypty FTP, lecz nie znalazīem nikogo, kto potrafi je pisaź.
@endnode

@node "requirements" "Wymagania"
ANetGUI/II wymaga:

· Workbencha 2.0 (V36)
· Kickstartu 2.04 (V37)
· @{" MUI3.1 " link "MUI"}
· @{" pliku INDEKSU" link "indexfile"}

Jeūeli posiadasz powyūsze rzeczy, to ANetGUI uruchomi siė.

Nie zaszkodzā mu nastėpujāce rzeczy:
· Workbench i Kickstart 3.0 (V39)
· zarejestrowana wersja MUI (lepiej wyglāda)
· dostėp do internetu i MountFTP
· szybki procesor i twardy dysk
· uruchomiony ARexx (dla skryptów ARexxa)

Jeūeli posiadasz powyūsze rzeczy, to ANetGUI bėdzie chodziī, jak marzenie.
@endnode

@node "main_window" "ANetGUI - gīówne okno"
Gīówne okno ANetGUI skīada siė z czterech rzeczy:
·  @{" lista katalogów " link "lst_dirs"}
·  @{" lista plików " link "lst_files"}
·  @{" lista wybranych plików " link "lst_selected"}
·  @{" przyciski kontrolne " link "buttons"}

Jeūeli uūywasz tego programu poraz pierwszy, przejdś do@{" opcji listy " link "list_window"}, wskaū na @{" plik INDEKSU " link "indexfile"} i kliknij na dodaj do katalogów. Konwesja moūe potrwaź kilka minut, w zaleūnoōci od INDEKSU oraz procesora. Gdy program zakoļczy @{"konwersjė" link "index_to_dirs"}, lista katalogów powinna siė ukazaź po@{" lewej stronie okienka gīównego " link "lst_dirs"}.
@endnode

@node "indexfile" "Plik INDEKSU"
Pliki INDEKSU Aminetu sā to pliki ze spisem wszystkich plików na Aminecie lub plików znajdujācych siė na danej pīycie.

  @{b}Spis wszystkich plików na Aminecie@{ub}
Jeūeli masz szybki dostėp do Internetu, to proponujė Ci ōciāgnāź go z jednego z serwerów Aminetu (np. @{u}http://www.aminet.org/~aminet/INDEX@{uu}, lub @{u}INDEX.Z@{uu} - skompresowany GNU ZIP).
Jeōli nie, to moūesz zawsze skopiowaź go z dowolnej pīyty Aminet CD (np. AMINET20:Aminet/AMINET - AMINET, nie INDEX).

  @{b}Spis plików na danej pīycie Aminet CD@{ub}
Na kaūdej pīycie Aminet CD znajduje siė indeks plików znajdujācych siė na tej pīycie w katalogu Aminet, plik ten ma nazwė INDEX (np. AMINET19:Aminet/INDEX).

  @{b}Spis ostatnio przybyīych plików@{ub} @{i}(RECENT) @{ui}
Co tydzieļ aktualizowana jest lista nowych plików, nazywa siė RECENT (lub RECENT.Z - GNU ZIP). Moūna równieū "zapisaź siė" do automatycznego jej otrzymywania poprzez e-mail. Wiėcej informacji moūna znaleśź na stronach WWW Aminetu. Jeūeli otrzymujesz takā listė e-mailem, to wystarczy skopiowaź owā listė z nagīówkiem do jakiegokolwiek pliku.

Poniewaū aktualizowanie co tydzieļ spisu plików z Aminetu jest dla wielu ludzi nierealne, moūliwa jest aktualizacja wīaōnie poprzez pliki RECENT. Naleūy wskazaź na plik RECENT (lub tekst skopiowany z e-maila) i dodaź do listy. W tym wypadku niektóre pliki mogā znajdowaź siė dwa lub nawet trzy razy w liōcie. Poza tym niektóre aktualizacje usuwajā automatycznie poprzednie wersje (AStart21.lha usuwa AStart20.lha), dlatego zalecana jest aktualizacja listy od nowa co jakiō czas (np. co 2 miesiāce).
@endnode

@node "index_to_dirs" "Konwersja pliku INDEKSU"
Pliki indeksu posiadajā jednā wadė, która bardzo utrudnia pracė z nimi - wszystkie katalogi znajdujā siė w jednym pliku. Dlatego ANetGUI operuje na plikach z listā pojedynczych katalogów.

Gīównymi zaletami takiego pamiėtania plików sā:
· moūliwoōź dodawania plików do listy
· szybszy odczyt spisu katalogów
· szybszy odczyt spisu plików
· oszczėdnoōź miejsca na dysku (katalogu ANetGUI zajmujā mniej miejsca niū pliki INDEKSÓW)
@endnode

@node "lst_dirs" "ANetGUI - lista katalogów"
Jest to lista dostėpnych katalogów na Aminecie. Dwukliknij na jakimō katalogu, aby zobaczyź jego zawartoōź.

Jeōli w liōcie nie ma ūadnych katalogów, to zajrzyj@{" tu " link "main_window"}.
@endnode

@node "lst_files" "ANetGUI - lista plików"
Jest to lista dostėpnych w danym katalogu Aminetu plików. Aby lista ta nie byīa pusta, naleūy najpierw wybraź jakiō@{" katalog " link "lst_dirs"}.

Gdy lista ta nie jest pusta, aby dodaź do listy wybranych plików moūesz wykonaź jednā z poniūszych czynnoōci:
· dwukliknāź na jednā z pozycji
· zaznaczyź jednā lub kilka pozycji i przeciāgnāź je na listė wybranych pozycji
· zaznaczyź jednā lub kilka pozycji i kliknāź na przycisk "Dodaj do listy"
@endnode

@node "lst_selected" "ANetGUI - lista wybranych plików"
Jest to lista wybranych przez Ciebie plików z Aminetu.

Aby usunāź z listy moūna:
· dwukliknāź na jednā z pozycji
· zaznaczyź jednā lub kilka pozycji i kliknāź na przycisk "Usuļ z listy"

@{" Aby dodaź do listy " link "lst_files"}

Przeciāgajāc pozycje moūna je posortowaź.
@endnode

@node "buttons" "ANetGUI - przyciski"
Oto przyciski i ich funkcje:

@{b}Szukaj plików@{ub} - @{" szuka plików " link "find_window"}speīniajācych dane kryteria
@{b}Opcje listy@{ub} - @{" zarzādzanie listā plików " link list_window} (tworzenie spisu itp)
@{b}Dodaj do listy@{ub} - dodaje wybrane pozycje z listy plików do listy wybranych plików
@{b}Usuļ z listy@{ub} - usuwa wybrane pozycje z listy wybranych plików
@{b}Nowy@{ub} - usuwa wszystkie pozycje z listy wybranych plików
@{b}Īaduj@{ub} - īaduje listė wybranych plików (uprzednio jā czyszczāc)
@{b}Zapisz@{ub} - zapisuje listė wybranych plików
@{b}Zapisz jako@{ub} - zapisuje listė wybranych plików jako
@{b}Doīācz do listy@{ub} - īaduje listė wybranych plików (uprzednio jej nie czyszczāc)
@{b}Uruchom skrypt@{ub} - uruchamia skrypt ARexxa
@{b}Zakoļcz@{ub} - wychodzi z programu
@{b}O programie@{ub} - informacje o programie, wersja
@endnode

@node "find_window" "ANetGUI - szukanie plików"
Okno szukania plików skīada siė z czterech rzeczy:
· @{" wzory szukania nazwy, katalogu i opisu pliku " link "find_pattern"}
· wskaśnik wykonania
· przycisk szukania i czyszczenia listy/pozycji
· listė znalezionych plików

Wzory szukania okreōlajā, jakie wyrazy majā znajdowaź siė w danym polu lub jaki wzór ma mieź dane pole (patrz@{" wzór szukania " link "find_pattern"}).

Wskaśnik wykonania informuje procent wykonania szukania i obecnie przeszukiwany katalog.

Przycisk szukania rozpoczyna przeszukiwanie spisu.
@{b}UWAGA!@{ub} Szukania nie moūna przerwaź, dlatego zastanów siė, zanim je uruchomisz.

Przycisk czyszczenia listy usuwa wszystkie pozycje z listy znalezionych.
Przycisk czyszczenia pozycji usuwa tylko obecnie zaznaczone pozycje.

Lista znalezionych plików jest to lista bardzo podobna do listy plików. 

Gdy lista ta nie jest pusta, aby dodaź do listy wybranych plików moūesz wykonaź jednā z poniūszych czynnoōci:
· dwukliknāź na jednā z pozycji
· zaznaczyź jednā lub kilka pozycji i przeciāgnāź je na listė wybranych pozycji

Aby usunāź jakāō pozycjė, zaznacz jā (moūliwe jest zaznaczenie wielu) i kliknij na przycisk czyszczenia pozycji.
@endnode

@node "find_pattern" "ANetGUI - wzór szukania"
Wzór szukania okreōla kryteria akceptacji danego pola.

Sā dwa rodzaje wzorów:
· @{b}wzór systemu AmigaDOS@{ub} (np. "#?.lha") - ANetGUI/II korzysta z funkcji @{i}ParsePatternNoCase() @{ui}do sprawdzania prawdziwoōci tego wzoru. Jest on bardzo uūyteczny do podawania wzoru nazwy, gdyū pozwala na bardzo skomplikowane stwierdzenia. Oto niektóre z symboli:

@{b}#@{ub} - szuka iluō powtarzajācych siė znaków (np. #A bėdzie prawdziwe dla A AA AAA AaaAa, ale nie dla AbA)
@{b}?@{ub} - zastėpuje dowolny znak (np. AStart2?.lha bėdzie prawdziwe AStart20.lha, AStart21.lha, ale nie bėdzie prawdziwe dla AStart12.lha, #?x.lha bėdzie prawdziwe dla kaūdej nazwy koļczācej siė na x.lha - cxx.lha bėdzie prawdziwe, thanx.lha równieū, natomiast thanks.lha nie)
@{b}(xx|yy)@{ub} - nawiasy zwykīe, ten przykīad bėdzie prawdziwy dla @{b}xx@{ub} lub @{b}yy@{ub} (pozwala na dowolnā iloōź "@{b}|@{ub}", inne znaki specjalne i nawiasy w nawiasach (równieū nawiasy znakowe) - np. (music#?.lha|#?text#?.lha|wkUtils.lha) i (music#?|#?text#?|wkUtils).lha sā sobie równe
@{b}[]@{ub} - nawiasy znakowe, porównujā jeden znak, sā prawdziwe, gdy ten znak bėdzie jednym ze znaków w nawiasach (np. #?.[ace] jest prawdziwe dla kaūdego pliku o rozszerzeniu .a, .c lub .e)
@{b}a-e@{ub} - uūywany @{b}tylko@{ub} w nawiasach znakowych, zastėpuje znak od znaku "@{b}a@{ub}" do znaku "@{b}e@{ub}" (abcde), w-z zastėpuje "wxyz"
@{b}~@{ub} - zaprzeczenie, wyraūenie zaprzeczane musi znajdowaź siė w nawiasach - np. ~([a-y]#?.lha) bėdzie prawdā dla plików zaczynajācych siė na z lub cyfry

· @{b}wzór wielu sīów@{ub} jest prostszy od poprzedniego, opiera siė na ciāgu sīów oddzielonych spacjā. Jeōli chcemy aby sīowo zawieraīo spacjė (imiė i nazwisko np. "Wojciech Kocjan"), naleūy zapisaź je w nawiasach. Jeōli chcesz znaleśź sīowo zawierajāce cudzysīów, to nie znajdziesz :-(

Jeūeli we wzorze skorzystasz z @{b}#@{ub}, @{b}?@{ub}, @{b}~@{ub} lub @{b}|@{ub} to automatycznie zostanie to potraktowane jako wzór systemu AmigaDOS, jeūeli nie skorzystasz z ūadnego z tych znaków, to zostanie on potraktowany jako wzór wielu sīów.
@endnode

@node "list_window" "ANetGUI - zarzādzanie listā"
Z tym oknem jesteō zmuszony(a) zapoznaź siė juū za pierwszym razem. Okno to sīuūy do operowania na caīej liōcie, umoūliwia dodawanie nowych pozycji, odōwieūenie listy i jej wykasowanie.

@{b}Dodaj do katalogów@{ub} sīuūy do dodawania nowych wpisów do spisu. Najpierw naleūy wskazaź na@{" plik INDEKSU " link indexfile}, zazwyczaj jest to plik o nazwie INDEX (indeks caīego Aminetu z Internetu lub indeks pojedynczego CD na AminetCD), AMINET (indeks caīego aminetu, moūna znaleśź na AminetCD) lub RECENT (najnowsze).

@{b}Odczytaj listė katalogów@{ub} odōwieūa listė katalogów. Moūe siė czasami zdarzyź, ūe lista katalogów nie zgadza siė z prawdziwā listā. Wtedy kliknij na ten przycisk i program uaktualni listė.

@{b}Wyczyōź listė katalogów@{ub} @{b}usuwa@{ub} caīā listė katalogów. Proponujė uūywaź tej opcji bardzo ostroūnie. Przydatna, gdy chcesz zainstalowaź nowy spis.

Wskaśnik poniūej przycisków dziaīa tylko, gdy jest dodawany@{" plik INDESKU " link "indexfile"}.
@endnode

@node "MUI" "MagicUserInterface"

                          This application uses


                        MUI - MagicUserInterface

                (c) Copyright 1992-97 by Stefan Stuntz


MUI is a system to generate and maintain graphical user interfaces. With
the  aid  of  a  preferences program, the user of an application has the
ability to customize the outfit according to his personal taste.

MUI is distributed as shareware. To obtain a complete package containing
lots of examples and more information about registration please look for
a  file  called  "muiXXusr.lha"  (XX means the latest version number) on
your local bulletin boards or on public domain disks.

          If you want to register directly, feel free to send


                         DM 30.-  or  US$ 20.-

                                  to

                             Stefan Stuntz
                        Eduard-Spranger-Straße 7
                             80935 München
                                GERMANY



             Support and online registration is available at

                          http://www.sasg.com/


@endnode
