Text Converter wersja 1.0¢ -------------------------¢ Modu zewn❎trzny dla¢ DOS Control v2.x¢¢ Kodowanie Jager/Dial¢¢ Wprowadzenie¢¢ Przgl⇧daj⇧c rənego rodzaju doku-¢ mentacje, do③⇨ cz❎sto trafiamy na tek-¢ sty stworzone na innych komputerach.¢ Jeəeli s⇧ one w j❎zyku innym niə pol-¢ ski to jeszcze da rad❎ je odczyta⇨¢ (cho⇨ i w tym wypadku jest to niewy-¢ godne i uci⇧əliwe), gdy jednak zawie-¢ raj⇧ one polskie literki to juə jest¢ powaəny kopot!¢¢ Na Atari powstao sporo rənego ro-¢ dzaju konwenterw tekstu, ale wi❎k-¢ szo③⇨ z nich umoəliwia tylko zmian❎¢ znakw koca linii (EOL) i z tego teə¢ powodu uəywanie ich do konwersji pol-¢ skich tekstw jest raczej bezcelowe.¢ Kilka lat temu Szymon/Dial stworzy¢ (pierwszy?) program umoəliwiaj⇧cy kon-¢ wersj❎ takəe polskich znakw. Obsugi-¢ wa on kilka formatw (np. AmigaPL,¢ Mazovia, Latin2). Wad⇧ programu byo¢ to iə nie usuwa (lub nie dodawa)¢ EOL'a (chodzi oczywi③cie o teksty¢ z PC, gdzie koniec linii oznaczony¢ jest dwoma znakami o kodach 13, 10¢ (CR, LF). Znacznie p♪niej powsta¢ D-Trans (Dial), ktry posiada opcj❎¢ konwersji tekstu zawieraj⇧cego polskie¢ znaki. Niestety, takəe i w tym wypadku¢ EOL'e nie byy poprawnie konwenterowa-¢ ne.¢¢ Text Converter dla DC pozbawiony¢ jest opisywanej wady! Oprcz tego po-¢ siada kilka opcji pomocnych podczas¢ konwersji np. usuwanie znakw wi❎k-¢ szych od 127, konwersj❎ znakw spec-¢ jalnych (okre③lonych przez uəytkowni-¢ ka) oraz usuni❎cie inwersji (gwnie¢ dla tekstw napisanych na Atari).¢ O dziaaniu tych opcji decyduje oczy-¢ wi③cie uəytkownik! Kolejn⇧ zalet⇧¢ programu jest to iə dane nie s⇧ bufo-¢ rowane, a to umoəliwia konwersj❎ pli-¢ kw o dowolnej dugo③ci (dane odczyty-¢ wane s⇧ z urz⇧dzenia ♪rdowego do bu-¢ fora roboczego, konwenterowane i auto-¢ matycznie zapisywane na urz⇧dzeniu do-¢ celowym). Program potrafi obsuəy⇨¢ KA⑧DY standard polskich znakw! Wszys-¢ tkie standardy aktualnie obsugiwane¢ zawarte s⇧ w pliku TXTCNV.CFG (jest on¢ odczytywany podczas uruchomienia prog-¢ ramu). Dodatkowe standardy moəna dopi-¢ sa⇨ przy pomocy dowolnego edytora tek-¢ stu zapisuj⇧cego plik w formacie¢ ATASCII (np. Panther lub Notebook¢ z DC). Maksymalnie moəna zdefiniowa⇨¢ 62 standardy!¢¢ Informacje podstawowe¢¢ Text Converter (w skrcie TC) b❎-¢ dzie poprawnie pracowa tylko pod DOS¢ Control'em wersja 2.x! MemLo nie po-¢ winno przekracza⇨ $2800.¢¢ Przed uruchomieniem programu odczy-¢ tywany jest plik konfiguracyjny¢ TXTCNV.CFG (opis formatu tego pliku¢ znajdziesz w dalszej cz❎③ci dokumen-¢ tacji). Jeəeli TC nie znajdzie tego¢ pliku lub wyst⇧pi b⇧d podczas jego¢ odczytu to na ekranie ukaəe si❎ infor-¢ macja o tym i zostan⇧ ustawione forma-¢ ty standardowe. Po uruchomieniu na ek-¢ ranie ukaəe si❎ okno robocze programu.¢ Podzielone ono zostao na kilka mniej-¢ szych okienek. Patrz⇧c od gry widzi-¢ my:¢¢ SOURCE - znajduj⇧ si❎ tutaj informacje¢ o urz⇧dzeniu, nazwie pliku oraz forma-¢ cie tekstu ♪rdowego.¢¢ DESTINATION - znajduj⇧ si❎ tutaj in-¢ formacje o urz⇧dzeniu, nazwie pliku¢ oraz formacie tekstu docelowego.¢¢ Pod oknem SOURCE znajduje si❎¢ okienko z dost❎pnymi formatami, a po-¢ niəej znajduje si❎ informacja o ich¢ ilo③ci (FORMATS: xx).¢ Pod oknem DESTINATION znajduje si❎¢ gwne menu programu.¢¢ Menu¢¢ Opcje z menu wybieramy przy pomocy¢ klawiszy '', 'RETURN' uruchamia dan⇧¢ opcj❎, a 'ESC' umoəliwia powrt do DOS¢ Control. Przy pomocy klawisza '' mo-¢ əemy przej③⇨ do okienka z dost❎pnymi¢ formatami (aby np. zobaczy⇨ co mamy¢ zdefiniowane). Dodatkowo ZAWSZE aktyw-¢ ny jest klawisz 'TAB', ktry umoəliwia¢ podgl⇧d gwnego ekranu DOS Control.¢ Po jego wybraniu okno TC zostaje scho-¢ wane i program oczekuje na naci③ni❎cie¢ dowolnego klawisza. Oto dost❎pne op-¢ cje:¢¢ CONVERSION (Konwersja)¢ ----------------------¢ Umoəliwia rozpocz❎cie konwersji.¢ W przypadku wyst⇧pienia b❎du operacja¢ ta zostaje przerwana, a na ekranie¢ ukaəe si❎ jego numer. Jak wspomniaem¢ wcze③niej, TC potrafi skonwenterowa⇨¢ plik o dowolnej dugo③ci (ograniczenie¢ to jedynie pojemno③⇨ no③nika). Jeəeli¢ konwenterujemy tekst przy pomocy jed-¢ nego urz⇧dzenia (np. "D1:") to naleəy¢ pami❎ta⇨ o tym aby zmieni⇨ nazw❎ pliku¢ docelowego, gdyə zostanie on stworzony¢ na dysku z ktrego odczytywany by¢ plik ♪rdowy (nie ma moəliwo③ci zmia-¢ ny dysku).¢¢ CHANGE FILENAMES (Zmiana nazwy plikw)¢ --------------------------------------¢ Normalnie po uruchomieniu programu,¢ informacje o urz⇧dzeniu i nazwie pliku¢ ♪rdowego pobierane s⇧ z panelu DOS¢ Control, w ktrym si❎ znajdowali③my¢ uruchamiaj⇧c TC (pod③wietleniem naleəy¢ wskaza⇨ nazw❎ pliku). Urz⇧dzenie doce-¢ lowe okre③la drugi panel DC (nazwa¢ pliku pozostaje bez zmian). Przy pomo-¢ cy tej opcji moəemy zmieni⇨ (lub poda⇨¢ nowe) urz⇧dzenie oraz nazw❎ pliku. Po¢ jej wybraniu w okienku SOURCE ukaəe¢ si❎ kursor. Teraz moəemy dokona⇨¢ zmian. Klawisze funkcyjne to (^ ozna-¢ cza 'CONTROL', ! oznacza 'SHIFT'):¢¢ 'ESC' - przerwanie tej operacji¢ (zostanie przywrcona po-¢ przednia nazwa i nast⇧pi¢ powrt do menu)¢ 'RETURN' - akceptacja i przej③cie do¢ okna DESTINATION.¢ '^','^' - kursor lewo/prawo¢ 'DELETE' - skasowanie poprzedniego¢ znaku¢ '!DELETE' - skasowanie caego pola¢ (moəna takəe nacisn⇧⇨¢ '^DELETE').¢ 'TAB' - podgl⇧d ekranu DOS Control¢¢ W okienku DESTINATION post❎pujemy¢ identycznie. Tu jednak klawisz¢ 'RETURN' koczy edycj❎ (nast❎puje po-¢ wrt do menu). Jeəeli odrazu chcesz¢ przej③⇨ do okna DESTINATION to przed¢ wybraniem opcji CHANGE FILENAMES na-¢ ci③nij 'BREAK'.¢¢ SOURCE FORMAT (Format ♪rdowy)¢ -------------------------------¢ Przy pomocy tej opcji okre③lamy¢ standard tekstu ♪rdowego. Po wybra-¢ niu przenosimy si❎ do okna ze zdefi-¢ niowanymi standardami. Przy pomocy¢ klawiszy kursora (gra/d) wybieramy¢ interesuj⇧cy nas format i naciskamy¢ 'RETURN'. Klawisz 'ESC' umoəliwia po-¢ wrt do menu bez zmiany formatu.¢ Aktywny jest takəe klawisz 'TAB'.¢¢ DESTINATION FORMAT (Format docelowy)¢ ------------------------------------¢ Tu okre③lamy standard docelowy. Po-¢ st❎pujemy tak jak przy wyborze formatu¢ ♪rdowego.¢¢ SCREEN OFF-WRITE (Wy⇧czenie ekranu)¢ ------------------------------------¢ Jeəeli jest zaznaczona [x] to pod-¢ czas zapisu ekran zostanie wy⇧czony.¢ Oczywi③cie w przypadku b❎dw lub za-¢ koczeniu tej operacji zostanie on po-¢ nownie w⇧czony.¢¢ POLISH CHARS (Polskie znaki)¢ ----------------------------¢ Jeəeli jest zaznaczona [x] to TC¢ b❎dzie konwenterowa polskie znaki.¢ Jeəeli b❎dzie wy⇧czona to konwersji¢ ulegn⇧ tylko znaki koca linii (EOL).¢¢ SPECIAL CHARS (Znaki specjalne)¢ -------------------------------¢ Jeəeli jest zaznaczona [x] to TC¢ b❎dzie je bra pod uwag❎ podczas kon-¢ wersji. Standardowo, w pliku do⇧czo-¢ nym do TC podane s⇧ znaki:¢¢ dla Atari (PANTHER):¢ minus "-" ($2d)¢ nawias kwadratowy "[" ($5b)¢ nawias kwadratowy "]" ($5d)¢¢ dla pozostaych (np. AMIGAPL):¢ tylda ($7e)¢ nawias klamrowy otwieraj⇧cy ($7b)¢ nawias klamrowy zamykaj⇧cy ($7d)¢¢ Tak wi❎c np. podczas konwersji¢ z AmigaPL na Panther, wszystkie tyldy¢ oraz nawiasy klamrowe zostan⇧ zast⇧-¢ pione minusem oraz nawiasami kwadrato-¢ wymi. Pomys zaczerpni❎ty zosta z ar-¢ tykuu Dracon'a zamieszczonego w ¢ Syzygy #7.¢ Oczywi③cie uəytkownik moəe dowolnie¢ zmienia⇨ te znaki w pliku konfigura-¢ cyjnym.¢¢ UNINVERSE (Usu inwersj❎)¢ -------------------------¢ Jeəeli jest zaznaczona [x] to TC¢ b❎dzie usuwa inwersj❎ (kasowany b❎-¢ dzie 7 bit kaədego znaku). Opcja prze-¢ znaczona jest gwnie dla tekstw na-¢ pisanych na Atari.¢¢ REMOVE >127 (usu znaki >127)¢ -----------------------------¢ Jeəeli jest zaznaczona [x] to TC¢ b❎dzie usuwa wszystkie znaki, ktrych¢ kody s⇧ wi❎ksze od 127. Operacja ta¢ jest wykonywana po konwersji polskich¢ znakw, a wi❎c nie zostan⇧ one usuni❎-¢ te (o ile nie s⇧ w inwersji - chodzi¢ o teksty z Atari)! Opcja przeznaczona¢ jest gwnie dla tekstw napisanych na¢ innych komputerach niə Atari i umoəli-¢ wia usuni❎cie rənych "③mieci" z tek-¢ stu.¢¢ UWAGA! Operacja usuwania inwersji wy-¢ konywana jest przed t⇧ operacj⇧,¢ a wi❎c chc⇧c usuwa⇨ takie znaki naleəy¢ wy⇧czy⇨ opcj❎ UNINVERSE!¢¢ ABOUT¢ -----¢ Informacje o programie oraz autorze.¢¢ EXIT TO DOS CONTROL¢ -------------------¢ Powrt do DOS Control.¢¢ UWAGA! Wszytkie ustawione opcje zosta-¢ n⇧ zapisane wraz z ustawieniami DOS¢ Control.¢¢ Plik TXTCNV.CFG¢¢ Jak wspomniaem na pocz⇧tku, przed¢ uruchomieniem gwnej cz❎③ci TC odczy-¢ tywany jest plik konfiguracyjny (za-¢ wsze z tego urz⇧dzenia, z ktrego zos-¢ ta odczytany TC). Plik ten jest¢ w formacie ATASCII, a wi❎c moəna go¢ wczyta⇨ np. do edytora Panther i do-¢ wolnie go poprawia⇨.¢¢ Budowa definicji standardu¢ --------------------------¢ 1. Nazwa standardu (maksymalnie 10¢ znakw). Powinna by⇨ wpisana w in-¢ wersji, ale nie jest to wymagane.¢ Jeəeli nazwa b❎dzie duəsza to spo-¢ woduje to b⇧d (SYNTAX ERROR)¢ i zostan⇧ ustawione warto③ci stan-¢ dardowe.¢ 2. Kody polskich DU⑧YCH liter dla da-¢ nego standardu, wpisyjemy w HEX'ach¢ (bez dolara). Separatorem moəe by⇨¢ dowolny znak (zalecany przecinek).¢ 3. Kody polskich MA{YCH liter dla da-¢ nego standardu, wpisyjemy w HEX'ach¢ (bez dolara). Separatorem moəe by⇨¢ dowolny znak (zalecany przecinek).¢ 4. Kody koca linii (EOL) dla danego¢ standardu, wpisyjemy w HEX'ach (bez¢ dolara). Separatorem moəe by⇨ do-¢ wolny znak (zalecany przecinek).¢ Jeəeli jest to tylko jedna warto③⇨¢ to jako drug⇧ ZAWSZE wpisz 00.¢ 5. Kody znakw specjalnych dla danego¢ standardu, wpisyjemy w HEX'ach (bez¢ dolara). Separatorem moəe by⇨ do-¢ wolny znak (zalecany przecinek).¢ Maksymalnie moəna zdefiniowa⇨ trzy¢ znaki.¢¢ Uwagi¢ -----¢ - warto③ci moəna podawa⇨ maymi lub¢ duəymi literami¢ - kaəda linia MUSI by⇨ zakoczona¢ EOL'em¢ - moəna umie③ci⇨ komentarz. Poprzedzi⇨¢ go naleəy jednym ze znakw ";", "*",¢ "|"¢ - jeəeli jaka③ linia b❎dzie zawieraa¢ niedozwolony znak lub b❎dzie ich za¢ mao, za duəo to ukaəe si❎ odpowied-¢ ni komunikat (w TC) i zostan⇧ usta-¢ wione standardowe formaty (zdefinio-¢ wane w TC)¢ - maksymalnie moəna zdefiniwa⇨ 62¢ standardy¢ - plik konfiguracyjny nie moəe by⇨¢ wi❎kszy niə 8 kilobajtw, a jeəeli¢ b❎dzie to reszta nie zostanie wzi❎ta¢ pod uwag❎.¢¢ Aby nie byo əadnych w⇧tpliwo③ci¢ prosz❎ przegl⇧dn⇧⇨ takəe plik¢ TXTCNV.CFG znajduj⇧cy si❎ na dysku¢ systemowym DC.¢