This program is usefull only in Poland... so documentation and the program is in
polish only.

Wstep:

APLKonwerter to skrypt Arexx-a wykorzystujacy RxMUI. Sluzy on do konwersji
plikow tekstowych
pomiedzy roznymi formatami kodowania polskich znakow (AmigaPL, Windows, ISO
8859-2, Mazovia).
Program oferuje zamiane polskich liter wraz lub bez returnow na amigowe oraz
usuwanie polskich liter
przy konwersji (zamiana na odpowiedniki bez ogonkow).

Skrypt jest freeware, jednakze prosze nie rozpowszechniac zmodyfikowanego
skryptu bez mojego
pozwolenia!

Autor:

Mario (AMario At wp.pl - no spam please! bez spamu, prosze!)
Konstruktywne sugestie mailowe mile widziane. ;)

Instalacja:

Sciagnac i zainstalowac najnowsza wersje pakietu RxMUI stad:
http://web.tiscali.it/amiga/downloads/rxmui.lha
Jesli nie zawiera, to dodac takze biblioteke "rexxsupport.library"
(prawdopodobnie kazdy uzytkownik posiada ja juz w systemie ;) ).
Skopiowac AplKonwerter.rexx wraz z dokumentacja gdziekolwiek i uzywac do woli.
:)

Skrypt byl testowany tylko pod AmigaOS 3.9 jednak powinien byc kompatybilny z
poprzednimi
(i nastepnymi ;) ).

Uzytkowanie:

Po uruchomieniu programu nalezy podac pelna sciezke dostepu do pliku
wejsciowego, oraz
pliku wynikowego (docelowego) konwersji. Mozna skorzystac z listerow wyboru
pliku.
Nastepnie nalezy wybrac typ konwersji. Wystarczy okreslic jaki ma byc format
pliku
docelowego (program juz sam okresli w jakim formacie jest plik zrodlowy).
Wcisnac
przycisk "Start" i poczekac na zakonczenie konwersji. Konwersja bedzie
zakonczona kiedy
przycisk "Start" pojawi sie na nowo.
Przelacznik "Pokazuj przebieg" wlacza i wylacza wskaznik zaawansowania podczas
konwersji.
Niewidzialny wskaznik zaawansowania przyspiesza troche konwersje.
Dodatkowo mozna wybrac opcje "nie zamieniaj returnow", co oznacza, ze zamieniane
beda
tylko polskie litery, a znaki Cr i LF zostana pozostawione bez zmian.
Standardowo program zamienia returny pecetowe na amigowe przy konwersji na
AmigaPL lub ISO i z amigowych na pecetowe
przy konwersji na Windows lub Mazovia. "Zmieniaj tylko returny" oznacza
wylaczona konwersje
polskich liter. "Usuwaj polskie litery" zamieni w trakcie konwersji polskie
litery na ich odpowiedniki bez ogonkow.
Zawartosc pliku zrodlowego nie jest naruszana jesli podany plik docelowy rozni
sie od zrodlowego.
Jesli plik docelowy i plik zrodlowy to ten sam plik - wtedy plik zrodlowy
zostanie nadpisany po
konwersji (a w czasie jej trwania zostanie wykorzystany katalog T: na plik
tymczasowy).
W menu okna (prawy klawisz myszy) dostepne sa opcje konwersji dla schowka
systemowego (nr 0).
Mozna tam takze znalezc opcje analizy pliku zrodlowego/docelowego w celu
rozpoznania jakie
kodowanie polskich liter aktualnie zawiera (plik nie zostanie przy tym
naruszony).
Dodatkowo podawanie nazwy pliku ulatwiaja guziczki manipulacji nazwa, ktore moga
skopiowac
pole "plik zrodlowy" do pola "plik docelowy" i odwrotnie, a takze ustalic plik
docelowy jako plik
zrodlowy + odpowiednie zakonczenie ("Zak.").

Drag&Drop:

Do okna programu mozna "wrzucac" ikonki z WB.
Upuszczenie ikony na polu, w ktorym podaje sie nazwe pliku zrodlowego spowoduje
wpisanie
sie do tego pola pelnej sciezki dostepu do upuszcanego pliku.
Podobny efekt wywola upuszczenie ikony na pole pliku docelowego, z tym, ze
zmianie ulegnie
wlasnie to pole.
Wrzucenie ikonki pod oba pola (na grupy przelacznikow konwersji) spowoduje
automatyczne
uzupelnienie pol pliku zrodlowego i docelowego (plik docelowy bedzie plikiem
zrodlowym +
odpowiednie zakonczenie).

Uzytkowanie programu z poziomu CLI:

Program mozna takze uzywac z poziomu konsoli. Oto skladnia:

rx APLKonwerter.rexx APLNAWIN|WINNAAPL PlikWej PlikWyj [dodatkowe] [GUI] [HTML]

APLNAWIN lub WINNAAPL nalezy podac zawsze. Przelacznik ten oznacza "kierunek"
konwersji.

PlikWej to pelna sciezka dostepu do pliku zrodlowego
PlikWyj to pelna sciezka dostepu do pliku docelowego (jesli istnieje zostanie
nadpisany bez pytania!)
Oczywiscie jezeli sciezka dostepu do pliku zawiera spacje to nalezy umiescic ja
w cudzyslowiu.
PlikWej i PlikWyj moze byc tym samym plikiem.

"Dodatkowe" nie jest wymagane i jest to jeden wyraz z:
"BEZPL" - usuwa polskie litery podczas konwersji
"BEZRET" - nie zmienia returnow
"TYLKORET" - zmienia tylko returny zostawiajac polskie literki bez zmian

"GUI" - (opcjonalny przelacznik) pokazuje stopien zaawansowania konwersji w
dodatkowym
oknie MUI (co oznacza lekkie spowolnienie konwersji na wolniejszych maszynach).

"HTML" - (opcjonalny przelacznik) z tym pstrykiem program zamieni wewnatrz
konwertowanego
pliku HTML linijke odpowiedzialna za kodowanie na odpowiednia dla kodowania
docelowego.
Jezeli linijka taka nie zostanie znaleziona w konwertowanym pliku argument ten
nie da zadnego
rezultatu (linijka nie utworzy sie sama).

Przelacznik "ZNAK" nie jest juz rozpoznawany (od wersji 1.6)!

Lacznie do programu powinno uzywac sie zawsze (jak widac powyzej) od trzech do
szesciu
argumentow. Przyklady:
rx APLKonwerter.rexx APLNAWIN ram:PlikAmigaPL ram:PlikWindozy.txt
rx APLKonwerter.rexx WINNAAPL dh1:Startup.txt ram:StartupWAmigaPL gui
rx APLKonwerter.rexx WINNAAPL "dh1:Dokumenty/Plik Tekstowy" ram:Plik bezpl gui
rx APLKonwerter.rexx APLNAWIN "cd0:WWW/Strona.html" ram:Strona.html gui html
rx APLKonwerter.rexx APLNAWIN Amiga:pl Pecet:Plik.txt tylkoret gui
rx APLKonwerter.rexx APLNAWIN SYS:Plik.txt SYS:Plik.txt gui

Zycze milego uzytkowania! ;)

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                 2494    5557  44.9% -lh5- 82eb May 20  2005 APLKonwerter.readme
[generic]                 6954   30495  22.8% -lh5- 6fcd May 20  2005 APLKonwerter.rexx
[generic]                 1819    4737  38.4% -lh5- fd16 May  6  2005 APLKonwerter.rexx.info
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         3 files   11267   40789  27.6%            May 22  2005