Short:        Converts files with Polish chars (RxMUI)
Author:       Mario (AMario At wp.pl)
Uploader:     Mario (AMario At wp pl)
Type:         text/misc
Architecture: generic

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! ;)