------------------------------------------------------------------------ Blacks Editor V1.0 ------------------------------------------------------------------------ Autor: Marco Negri Instrukcjë na podstawie oryginalnej dokumantacji opracowaî Jakub Zalepa (Simon/Maniacs) 1. Prawa autorskie. Niniejsza instrukcja zostaîa opracowana na podstawie oryginalnej dokumentacji doîâczonej do tego programu orza na podstawie osobistych doôwiadczeï jej autora. Moûesz swobodnie rozpowszechniaê ten plik, ale nie wolno Ci dokonywaê w nim ûadnych zmian. Program Blacks Editor naleûy do tzw. SolidarityWare, tzn. masz prawo uûywaê  go przez 30 dni. Po upîywie tego czasu powinieneô zdecydowaê, czy uznajesz program za dobry i jeûeli tak sië stanie powinieneô uiôciê opîatë stanowiâcâ równowartoôê 10$ na jakiô cel spoîecznie uûyteczny oraz przesîaê autorowi kartkë pocztowâ przedstawiajâcâ twój kraj albo przesîaê mu e-mail. Niezaleûnie od tego, program nie posiada (bo i nie jest to moûliwe) ûadnych zabezpieczeï ani ograniczeï. Jeôli wiëc nie postâpisz w powyûszy sposób, to program naturalnie nie przestanie dziaîaê. BED'a moûna rozpowszechniaê bez ûadnych ograniczeï, pod nastëpujâcymi warunkami: * ReqTools nie stanowi czëôci skîadowej BED'a, prawa do tej biblioteki naleûâ do Nico Francois oraz Magnus Holmgren. * nie wolno zmieniaê zawartoôci archiwum. * archiwum BED moûe byê  umieszczane na CD-ROM'ach i innych wydawnictwach, ale autor powinien byê o tym informowany. * nie wolno uûywaê tego programu w jakimkolwiek, nawet poôrednim zwiâzku z rozwojem techniki wojskowej. 2. Krótki opis. * program moûna wystartowaê z CLI lub Workbencha. * skróty klawiaturowe, które pozwalajâ uruchamiaê opcje programu normalnie wybierane z menu sâ zwane definicjami i wymienione w pliku o zakoïczeniu ".dfn" w katalogu BED/Support. * preferencje programu zawiera plik zakoïczony ".prf" znajdujâcy sië w tym samym katalogu. * w katalogu "Rexx" umieszczone sâ uûyteczne skrypty Arexx'a, które powinny byê uruchamiane przy uûyciu "Arexx Menu". * przy uruchomieniu program îaduje ustawienia, które zawiera plik "BED/Support/Startup.prf" oraz uruchamia skrypt Arexx'a "BED/Rexx/Startup.bed". Jeûeli nowe okno programu jest otwarte (jeôli nic innego nie zostaîo ustawione ) BED uruchamia dodatkowo program Arexx'a "BED/Rexx/Doc_Startup.bed". W oryginalnej konfiguracji skrypt ten jest taki sam jak "BED/Rexx/SetConfig.bed". 3. Wprowadzenie. Blacks Editor to posiadajâcy wiele moûliwoôci, przyjazny uûytkownikowi edytor tekstu. Jego gîówne moûliwoôci to: * moûliwoôê jednoczesnej edycji dowolnej liczby tekstów. * îatwoôê i elastycznoôê konfiguracji. Moûna caîkowicie zmieniê wyglâd menu, skróty klawiaturowe. Kaûde okno moûe mieê inne ustawienia. * rozbudowane preferencje. * îatwa wspóîpraca z SAS C. BED'a moûna jednak przystosowaê do pracy z kaûdym jëzykiem programowania lub kompilatorem. * tworzenie kopii bezpieczeïstwa plików. * automatyczny zapis tworzonych tekstów. Moûna wybieraê  przedziaî czasu, co jaki ma to byê dokonywane. * rozszerzone moûliwoôci zapisu ikon. Moûna zapisywaê róûne rodzaje ikon, zaleûne od rodzajów plików. * konwersja tekstów z PC i na PC. * moûliwoôê natychmiastowego przystosowania programu do klawiatury IBM. * peîna lokalizacja pod OS3.0 * doîâczony help w formacie Amigaguide (tylko na OS3.0) * moûliwoôê wyboru uûywanych requesterów miëdzy "reqtools" i "asl". * moûliwoôê uruchamiania dowolnego skryptu Arexx'a przy starcie programu oraz przy otwieraniu kaûdego nowego okna programu. * port Arexx'a rozpoznajâcy 151 komend. 4. Autor. Adres dla korespondencji: Marco Negri Via delle Alpi 19 20026 Novate Milanese (MILANO) I T A L I A WWW: http://www.ing.unico.it/ Moûesz takûe podziwiaê jego zdjëcie doîâczone do archiwum. 5. Oficjalny punkt rozpowszechniania edytora Blacks Editor. Jest to BBS i jednoczeônie provider internetu. Tel.: (510) 581-0600 telnet: bitnova.com Web: www.bitnova.com FTP: ftp.bitnova.com 6. Bîëdy w programie. Autor nie gwarantuje, ûe program Blacks Editor jest caîkowicie pozbawiony blëdów, stâd teû wynika jego standard (Public Domain). Wedîug niego nie ma w nim jednak wiëkszych bîëdów, na taki stan rzeczy wzkazujâ takûe osobiste doôwiadczenia autora polskiej dokumentacji. Jeôli jednak znajdziesz wiëkszy lub mniejszy bîâd w Blacks Editor'ze - skontaktuj sië z jego autorem. 7. Zanim zaczniesz... * AUTOR PROGRAMU NIE PONOSI ODPOWIEDZIALNOÔCI ZA SZKODY WYNIKÎE Z UÛYTKOWANIA BLACKS EDITORA, PROGRAM JEST DOSTARCZANY W STANIE TAKIM, W JAKIM W DANEJ CHWILI SIË ZNAJDUJE. UÛYWASZ PROGRAMU NA WÎASNE RYZYKO. * Minimalne wymagania sprzëtowe: Amiga z Kickstartem 2.04+, zainstalowana reqtools.library v38+, Installer (potrzebny tylko do instalacji na twardym dysku). * dla wiëkszej wygody zalecane: pracujâcy Arexx, twardy dysk. * Aby zainstalowaê Blacks Editora - kliknij dwa razy na ikonie "Install" a potem wybierz ikonë z wîaôciwâ wersjââ jëzykowâ. 8. Uruchomienie programu. Blacks Editor moûe byê  uruchomiony zarówno z CLI, jak i Workbencha. - spod CLI: Wpisz BED z nastëpujâcymi ewentualnymi argumentami, które jednak nie sâ niezbëdne: * NAZWAPLIKU - jeôli po "BED" wpiszesz nazwë pliku, to plik ten zostanie automatycznie zaîadowany do edytora, po jego uprzednim uruchomieniu. * DEFS/K - nazwa definicji, z których ma korzystaê BED (chodzi o plik z zakoïczeniem ".dfn") * PREFS/K - nazwa preferencji, z których BED ma korzystaê (plik z zakoïczeniem ".prf") * MACRO/K - nazwa skryptu Arexx'a który ma byê  uruchomiony po starcie BED'a * QUIT/S - jeôli jakaô kopia BED'a aktualnie pracuje, zostanie zamkniëta. - spod Workbencha: * Wystarczy dwa razy kliknâê ikonë programu BED. Moûliwe jest podanie programowi niektórych parametrów w postaci tooltypów, to znaczy ciâgów tekstowych podanych razem z ikonkâ (moûna je zmieniaê za pomocâ opcji "Information" lub w polskiej wersji Workbencha - "Informacje", po jednokrotnym klikniëciu ikony BED. Rozpoznawane sâ nastëpujâce tooltypy: * FILENAME= - dalej nastëpuje nazwa pliku do domyôlnego zaîadowania. * DEFS= - dalej nazwa definicji do zaîadowania. * PREFS= - dalej nazwa preferencji. * MACRO= - skrypt Arexx'a do uruchomienia po uruchomieniu BED'a. * QUIT - wyjôcie z BED'a. 9. Standardowa konfiguracja programu. Oto standardowa konfiguracja programu BlacksEditor i moûna jâ znaleúê w pliku BED/Support/Standard.dfn. Teraz nastâpi opis poszczególnych opcji menu programu: - Menu: Plik * Nowy dokument - otwiera nowy dokument. * Wyczyôê - czyôci bufor programu przeznaczony na aktualny dokument, tzn. powoduje, ûe Twój dokument po wykonaniu tej funkcji staje sië pusty. * Wczytaj - otwiera requester (mniejsze okno z gadgetami), sîuûâcy do wybierania plików. Moûesz za jego pomocâ wzkazaê plik, który ma byê zaîadowany do Blacks Editora. * Wczytaj nowy dokument - otwiera nowe okno i pozwala zaîadowaê tam wybrany plik. * Wstaw - otwiera requester, który pozwoli Ci wybraê plik, który ma byê wstawiony do dokumentu poczâwszy od aktualnej pozycji kursora. * Zapisz - nagrywa aktualny dokument na dysk. * Zapisz jako - otwiera requester, który pozwoli Ci wybraê nazwë pliku dla aktualnie otwartego dokumentu, który pod tâ nazwâ zostanie zapisany. * Zapisz i skoïcz - nagrywa aktualny dokument pod aktualnâ nazwâ pliku i zamyka okno, w którym dokument ten byî tworzony. * Wydrukuj - drukuje dokument na drukarce, zanim nastâpi wydruk, pojawi sië requester z proôbâ o potwierdzenie. * Zamknij dokument - zamyka okno z aktualnym dokumentem. * Skoïcz - wychodzi z programu, zamknâwszy uprzednio wszystkie okna. - Menu: Okno * Wybierz - pokazuje listë otwartych aktualnie dokumentów i nazwy zwiâzanych z nimi plików oraz pozwala na wybór aktualnego pliku. * Zmniejsz - zmniejsza aktualne okno do minimalnych rozmiarów. * Powiëksz - powiëksza aktualne okno do maksymalnych rozmiarów. * Przywróê - ustawia standardowe rozmiary okna. * Utrwal - zapisuje aktualne ustawienie okna jako standardowe. * Do ikonki - ikonifikacja aktualnego okna programu (przydatna, gdy chwilowo nie jest uûywane). * Do ikonki wszystkie - ikonifikuje wszystkie okna. * Rozîóû równomiernie - automatycznie ustawia wszystkie okna tak, aby byîy równomiernie rozîoûone na ekranie. * Uîóû w stos - ustawia wszystkie okna, jedno pod drugim. * Uîóû w kaskadë - organizuje okna w kaskadë. * Wczytaj ukîad - wczytuje plik zapisany opcjâ "Zapisz ukîad". * Zapisz ukîad jako - zapamiëtuje rozmiary okna, tekstu, pozycjë kursora, nazwy wszystkich otwartych dokumentów. - Menu: Edycja * Poczâtek bloku - zaznacza poczâtek bloku, jeûeli jakiô blok jest juû zaznaczony, zostanie odznaczony. * Zaznacz sîowo - sîowo pod aktualnâ pozycjâ kursora zostanie zaznaczone. * Zaznacz linië - linia w aktualnej pozycji kursora zostanie zaznaczona. * Zaznacz wszystko - caîy dokument zostanie zaznaczony. * Wytnij - wycina to, co zostaîo zaznaczone oraz kopiuje to na clipboard. Moûliwe wiëc bëdzie odzyskanie skasowanej czëôci dokumentu przez uûycie opcji "Wstaw". * Skopiuj - kopiuje na clipboard to, co zostaîo wczeôniej zaznaczone. * Wstaw - wstawia w aktualnj pozycji kursora, to co zostaîo wczeôniej skopiowane na clipboard. * Usuï - bezpowrotnie usuwa zaznaczony blok. * Wytnij z doîâczeniem - zaznaczony blok jest wycinany i doîâczany do koïca tego, co znajduje sië  aktualnie na clipboardzie. * Skopiuj z doîâczeniem - wykonuje tylko kopië zaznaczonego bloku i takûe îâczy go z zawartoôciâ clipboardu. * Wczytaj ze schowka - îâduje oznaczony plik na clipboard. * Zapisz schowek - zapisuje zawartoôê clipboardu na oznaczony plik. * Wydrukuj schowek - drukuje na drukarce zawartoôê clipboardu. - Menu: Znajdú * Znajdú - otwiera okno szukania fragmentów tekstu. * Znajdú nastëpny - znajduje nastëpny ciâg odpowiadajâcy temu, który wpisaîeô w oknie szukania fragmentów. * Znajdú i zamieï - otwiera requester Znajdú i zamieï, który pozwoli Ci wpisaê ciâg znaków, który ma byê  najpierw odszukany a potem zamieniony na inny, równieû podany przez Ciebie ciâg znaków. * Zamieï nastëpny - znajduje kolejny ciâg znaków i zamienia go na podany przez ciebie w requesterze Znajdú i zamieï. * Skocz do linii - otwiera requester, który pozwoli Ci wpisaê numer linii, do której ma sië przemieôciê kursor. * Znajdú nawias - jeôli kursor znajduje sië na znaku "(", który jak wiadomo, otwiera nawias, to po wybraniu tej opcji program automatycznie znajdzie znak zamkniëcia nawiasu ")". * Wstaw zakîadkë - pozwala oznaczyê danâ pozycjë w tekôcie. * Skocz do zakîadki - skacze do miejsca zaznaczonego za pomocâ opcji "Wstaw zakîadkë". - Menu: Format * Formatuj akapit - formatuje linië, w której znajduje sië kursor wedîug zasad okreôlonych w preferencjach, ponadto usuwa niepotrzebne znaki. * Skocz do akapitu - pozwala skoczyê do poprzedniego lub nastëpnego akapitu. * Usuï znaki koïca linii - usuwa wszystkie znaki koïca linii z danego akapitu. Jest to przydatne, gdy tekst tworzony na BED'zie ma byê wykorzystany potem na jakimô programie DTP. Znaki koïca linii wewnâtrz akapitu rodzâ tam róûne komplikacje. * Dosuï do lewej - dosuwa linië tekstu, w której aktualnie znajduje sië kursor, najbardziej do lewej strony. * Dosuï do prawej - to samo, ale do prawej strony. * Rozstrzel - wykonuje zabieg zwany justyfikacjâ. Rozstrzela mianowicie tekst w ten sposób, aby aktualna linia miaîa oznaczonâ szerokoôê i margines z lewej i prawej strony (të   szerokoôê linii oraz marginesy moûna ustawiê  w preferencjach). * Centruj - umieszcza tekst znajdujâcy sië w aktualnej linii na ôrodku tej linii. * Tabulatory -> Spacje - zamienia wszystkie znaki tabulacji na odpowiedniâ iloôê znaków odstëpu. * Spacje -> Tabulatory - wykonuje zabieg odwrotny do poprzedniego. * Usuï puste znaki - usuwa zamotne znaki koïca linii. * Wysuï blok - przesuwa zaznaczony blok w prawo poprzez dodanie do kaûdej jego linii znaku tabulacji. * Wsuï blok - dokonuje zabiegu odwrotnego. * Wysuï linië - to samo, co "Wysuï blok", ale dotyczy linii, w której aktualnie znajduje sië kursor. * Wsuï linië - to samo, co "Wsuï blok", ale dotyczy linii, w której aktualnie znajduje sië kursor. - Menu: Dodatki * Anuluj linië - przywraca linië do stanu sprzed ostatniej zmiany. * Przywróê linië - ostatnia skasowana linia jest wstawiana w miejscu, w którym aktualnie znajduje sië kursor. * Wstaw aktualnâ datë - wstawia aktualnâ datë w aktualnej pozycji kursora. * Wstaw aktualny czas - wstawia aktualnâ godzinë, minuty i sekundy w aktualnej pozycji kursora. * Wstaw znak ASCII - otwiera requester, który pozwoli Ci wpisaê kod ASCII znaku, który chcesz wstawiê do tekstu, a nie moûesz go osiâgâê z klawiatury. * Wstaw îaïcuch z wersjâ - wstawia w aktualnej pozycji kursora ciâg tego rodzaju "$VER: Nazwa_aktualnie_tworzonego_pliku (data)" * Okomentuj blok - opcja przydatna dla programistów, tworzy z aktualnie zaznaczonego bloku, serië linii komentarza. * Ponumeruj linie - numeruje kolejne linie tekstu. * Sîowo z maîymi literami - zamienia wszystkie litery sîowa, na którym aktualnie znajduje sië kursor, na maîe. * Sîowo z duûymi literami - zamienia wszystkie litery sîowa, na którym aktualnie znajduje sië kursor, na wielkie. * Zmieï wysokoôê litery - zmienia literë, na której znajduje sië kursor z duûej na maîâ, chyba ûe jest to juû litera maîa, to na duûâ. * Zaszyfruj blok - szyfruje zaznaczony blok. Uûycie tej funkcji na bloku juû zakodowanym powoduje jego rozkodowanie. - Menu: Makro * Rozpocznij nagrywanie - Twój kaûdy nastëpny ruch zostanie zapamiëtany jako czëôê makro, dopóki nie uruchomisz opcji "Zatrzymaj nagrywanie". * Zatrzymaj nagrywanie - powoduje zakoïczenie nagrywania makro. Makro to potem moûe byê wywoîane i bëdzie wykonywaîo sië automatycznie na Twoje ûâdanie. * Odtwórz makrodefinicjë - za pomocâ tej funkcji moûesz wywoîaê wczeôniej zapisane makro. * Odtwórz wielokrotnie - otwiera requester, w którym moûesz wpisaê, ile razy makro ma sië wykonaê. * Wczytaj makrodefinicjë - pozwala wczytaê makrodefinicjë zapisanâ wczeôniej na dysk. * Zapisz makrodefinicjë jako - pozwala zapisaê na dysk, wczeôniej zdefiniowanâ makrodefinicjë. - Menu: Narz. * Nowy Shell - otwiera standardowy amigowski Shell. * Nowa konsola - otwiera konsolë BED'a. Jest to okienko nieco podobne do Shell lub CLI, ale pozwala bezpoôrednio wykonywaê wewnëtrzne komendy BED'a. Wymiary tego okienka moûna ustalaê w preferencjach. * Wykonaj polecenie - po wybraniu tej opcji pojawi sië requester, który pozwoli Ci uruchomiê wybrany program. * Wywoîaj polecenie - opcja analogiczna do poprzedniej, ale wybrany przez Ciebie program, tu uruchomi sië niezaleûnie od dziaîania BED'a, tzn. BED nie bëdzie czekaî, aû tamten program zakoïczy dziaîanie. * Wykonaj skrypt DOS'u - po wybraniu tej opcji zobaczysz requester, który sîuûy do wyboru skryptu AmigaDOS'u przeznaczonego do wykonania. * Kalkulator - wywoîuje podrëczny kalkulator z podstawowymi dziaîaniami. * Multiview - uruchamia systemowy program Multiview, który sîuûy do przeglâdania tekstu, obrazków i danych, które sâ rozpoznawalne dla systemu dziëki datatypom (to ostatnie tylko na systemie 3.0 i wyûszych). * ... - tutaj moûesz dodawaê wîasne programy do uruchomienia, jeûeli zadasz sobie trud maîej modyfikacji pliku konfiguracyjnego programu. - Menu: Arexx * Wykonaj makrodefinicjë Arexx'a - pozwala uruchomiê makrodefinicjë zapisanâ w jëzyku Arexx. Bezpoôrednio po wybraniu tej opcji zobaczysz requester sîuûâcy do wyboru pliku ze skryptem ARexx'a. * Wykonaj polecenie Arexx'a - pozwala wykonaê pojedyncze polecenie Arexx'a. W oknie, które sië pojawi po wybraniu tej opcji moûesz ustaliê, jakie to ma byê polecenie oraz czy i jakie ma byê otwarte okno wyprowadzania informacji. Dalsze pozycje w menu, do poziomej kreski, to konkretne polecenia Arexx'a, które mogâ byê wywoîane bezpoôrednio z menu, bez koniecznoôci wpisywania ich w oknie. * ... - liczâc od tej pozycji w menu, moûesz umieôciê w nim inne komendy Arexx'a, których czësto uûywasz. - Menu: Ustaw * Zmieï ustawienia - otwiera kolejne okienko menu, z którego moûesz wybraê, co chcesz zmieniê w preferencjach, dalej program sam juû Cië poprowadzi. * Wczytaj ustawienia - pozwoli Ci zaîadowaê wczeôniej zapisane na dysk ustawienia programu. * Zapisz ustawienia - zapisuje ustawienia programu pod ich aktualnâ nazwâ. * Zapisz ustawienia jako standardowe - zapisuje aktualne ustawienia programu jako standardowe, tzn. te, które bëdâ îadowane za kaûdym razem przy starcie programu. Odtâd program bëdzie juû zawsze sië nimi posîugiwaî, chyba ûe je znów zmienisz. * Wczytaj definicje - pozwala wybraê plik z definicjami do zaîadowania, byîa o nich mowa na poczâtku tego tekstu. - Menu: ? * O programie BED - wyôwietla okienko informacyjne na temat programu i jego autora. * Pomoc podrëczna - pozwala uruchomiê indtrukcjë do programu. * Menu BED'a - pomoc na temat funkcji menu. * Polecenia BED'a - jeûei kursor znajduje sië na jakimô poleceniu BED'a, to funkcja ta uruchamia pomoc dotyczâcâ tego polecenia. * Pomoc - informacje na temat programu