Podręcznik slrn-pl 
> Instalacja i konfiguracja > Podręcznik > FAQ > Pozostała dokumentacja

5. Makra

Konfiguracja makr została zgrupowana w dwóch miejscach.

1. Na końcu pliku slrn-macros.rc są przypisywane makrom wywołujące je skróty klawiszowe. Jesli komuś nie odpowiadają domyślne ustawienia klawiszy, może je szybko i wygodnie zmienić w tym miejscu.
2. W pliku konfiguracja.sl można zmodyfikować parametry makr. Ponieważ jest to plik parsowany przez interpreter s-langu, zmiennym tym można (oprócz zwykłego przypisania wartości) przypisać także wynik dowolnego makra, procedury czy też funkcji zapisanej w tym języku. UWAGA: makro konfiguracja.sl musi interpretowane jako ostatnie!

5.1 Opis i konfiguracja poszczególnych makr

konwertuj.sl

Makro automatycznie wykonuje konwersje zestawów znaków artykułu do standardu lokalnego. Wywoływane jest przez tsca-mymime.sl. Nie wymaga dodatkowej konfiguracji. Konwersję można również wykonać na żądanie (domyślnie klawiszem Ctrl+k).

tsca-mymime.sl

Makro to dokonuje automatycznej konwersji artykułów zakodowanych w UTF-7, UTF-8 na iso-8859-2/cp-1250, LaTeX i QP na 8-bit oraz wycina z artykułów wysłanych jako multipart/{alternative, mixed} część w HTMLu, vcard-y, sygnatury PGP/MIME, itp pozostawiając część tekstową w lokalnym charsecie. Wymaga makra konwertuj.sl do poprawnego działania. Makro nie wymaga dodatkowej konfiguracji.

autoupdate.sl

Makro sprawdza co określony (w pliku konfiguracja.sl) czas, czy pojawiła się już nowa wersja pakietu slrn-pl. Makro do dzialania wymaga programu sciagajacego dane z sieci i wyrzucajacego je na stdout (pod Linuksem np. wget, lynx).

get-by-mid.sl

Wyszukuje w widocznym na ekranie artykule wszystkie msg-id i otwiera menu, pozwalające wybrać jeden z nich. Po wybraniu następuje otwarcie oznaczonego przez ten msg-id artykułu - pod warunkiem, że znajduje się on jeszcze / już na serwerze :). Jeśli nie, makro próbuje znaleźć artykuł w bazie Google Groups. W przypadku powodzenia artykuł bieżący zastępowany jest artykułem ściągniętym. Makro jest domyślnie podpięte pod klawisz "M" (można to zmienić w pliku slrn-macros.rc). Wywołanie listy msg-id znalezionych w artykule: ESC-1-M. Szukanie podanego w minibuferze posta na Google: ESC-2-M. Szukanie podanego w minibuferze posta tylko na serwerze lokalnym: M. Konfiguracja w pliku konfiguracja.sl.

easy-keys.sl

Makro to zmienia definicję klawiszy, powalając poruszać się po drzewie grup i artykułów jedynie przy pomocy klawiszy strzałek. Nie wymaga dodatkowej konfiguracji (jedynie uaktywnienia w pliku slrn-macros.rc). Działanie klawiszy zmienia się następująco :

• Strzałka w prawo wybiera artykuł lub grupę
• Strzałka w górę przewija artykuł lub listę grup
• Strzałka w dół przewija artykuł lub listę grup
• Strzałka w lewo - wyjście z artykułu lub listy grup
• Wciśniecie TAB przenosi do następnej grupy z nieprzeczytanymi artykułami

new-search.sl

Przeszukuje artykuły, próbując odnaleźć w nich podany tekst. Naciśnięcie klawisza $ rozpoczyna nowe wyszukiwanie, klawisz & kontynuuje wyszukiwanie.

Konfiguracja: Oprócz domyślnych klawiszy (ustawianych w pliku slrn-macros.rc) można także zmienić sposób wyszukiwania. Dokonujemy tego modyfikując w pliku konfiguracja.sl wiersze :

• NewSearch->set_preference("start_at_bob", 1); (lub 0)
  1 - rozpocznij poszukiwania od początku bufora, 0 - od bieżącego artykułu. Domyślnie - 0
• NewSearch->set_preference("wrap_search", 1); (lub 0)
  1 - po dojściu do końca listy artykułów, rozpocznij przeszukiwanie od początku. 0 - zakończ poszukiwania na końcu listy artykułów. Domyślnie - 0

loop.sl

Pozwala na poruszanie się po liście grup lub artykułów jak po pierścieniu. Oznacza to, że po dojściu do ostatniego artykułu (grupy) na liście powracamy na pozycję pierwszą, a poruszając się w przeciwnym kierunku, po dojściu do pierwszej pozycji - kursor przeskakuje na ostatnią.
Makro nie wymaga dodatkowej konfiguracji, a jedynie uaktywnienia w pliku slrn-macros.rc. W pliku tym można także przedefiniować sobie klawisze, jeśli komuś nie odpowiadają domyślne klawisze strzałek.

licznik.sl

Zlicza wysyłane posty. Dodatkowo, każdy z nich może otrzymać nagłówek o postaci

  X-Post-Counter: zliczony_numer
  

choice = 1; (lub 0)

Zmienna choice pozwala włączać/wyłączać wstawienie do postu dodatkowego X-nagłówka z numerem postu. Zmieniając ją w pliku konfiguracja.sl na 0 wyłączamy nagłówek. Wartością domyślną jest counter = 1;.

logging = 1; (lub 0)

Zmienna logging pozwala włączać/wyłączać tworzenie pliku z dziennkiem postów (tzn. z logiem).

header = "X-Post-Counter";

Postać nagłówka można dowolnie zmieniać, przypisując nową wartość zmiennej header (przykładowo header = "X-Licznik").

"slrnstat": Istnieje napisany przez Brzeziego programik generujący na podstawie tworzonego przez to makro pliku .slrn_post_log statystyki aktywności na grupach. Programik dostępny jest pod adresem http://www.geocities.com/tsca.geo/slang.html#counter.

prhn.sl

Makro to przygotowuje czytany aktualnie artykuł do wysłania na grupę pl.rec.humor.najlepsze. Artykuł zostaje odpowiednio przeformatowany, a po ewentualnej ręcznej edycji i zaakceptowaniu, wysyłany na grupę poprzez bramkę mail2news. Niech inni też się pośmieją.

Konfiguracja: Oprócz uaktywnienia w pliku slrn-macros.rc można również zdefiniować klawisz, pod który jest podpięte makro. Klawiszem domyślnym jest %. Można go zmienić w pliku slrn-macros.rc:

    setkey article forward_to_prhn "%"
   

prhn-v2.sl

Makro to (tak jak poprzednie) przygotowuje czytany aktualnie artykuł do wysłania na grupę pl.rec.humor.najlepsze, odmienny jest jednak sposób wysyłania artykułu. O ile poprzednia wersja makra korzysta z bramki mail2news, o tyle ta wersja stara się wykorzystać przy wysyłaniu bezpośrednio serwer news. Innymi słowy, artykuł zostanie wysłany tak jak każdy inny, prosto na grupę.

Konfiguracja: Oprócz uaktywnienia w pliku slrn-macros.rc można również zdefiniować klawisz, pod który jest podpięte makro. Klawiszem domyślnym jest @. Można go zmienić w pliku slrn-macros.rc:

    setkey article forward_to_prhn "@"
   

temp-score.sl

Pozwala przydzielić wszystkim artykułom tymczasową wartość score, bazując na tytule, autorze lub zawartości artykułu. Zmiana to nie modyfikuje samego pliku scorefile.

Konfiguracja: Oprócz domyślnego klawisza (do ustawienia w pliku slrn-macros.rc) można także zmienić sposób punktowania artykułów. Dokonujemy tego modyfikując w pliku konfiguracja.sl wiersze:

• TempScore->set_preference("score_additive", 1); (lub 0);
  1 - zwiększ punktację wyszukanych artykułów, 0 - ustaw punktację. Domyślnie - 0)
• TempScore->set_preference("score_value", wartość_liczbowa);
  wartość_liczbowa - wartość, o którą zmieni się score / która zostanie ustawiona.

oe_quot.sl

poprawianie cytowanych linii zepsutych przez OE. Makro zamienia takie cytaty:

>> Once upon a time there were three little
foxes
>> Who didn't wear stockings and who didn't wear
sockses

>> Once upon a time there were three little
>> foxes
>> Who didn't wear stockings and who didn't wear
>> sockses

>> Once upon a time there were three little foxes
>> Who didn't wear stockings and who didn't wear sockses

picker.sl

wybór programu do obsługi URL-i (przeglądarki WWW, ściągarki plików, itd). Kolejne programy dodawać można w pliku konfiguracja.sl. Pamiętać przy tym należy o odzielaniu nazw programów przecinkami i o dodawaniu programów w odpowiedniej części (``zawsze''/''X''/''MS Windows''). Programy uruchamiane pod systemem X-Window warto zapisywać jako "&program" (poprzedzać nazwę znakiem "&") -- spowoduje to uruchomienie programu w tle.

slrnface.sl

Makro umożliwia wyświetlenie X-Face w X-Window przy wykorzystaniu programu slrnface. X-Face jest wyświetlany jako dwubarwny obrazek, umieszczony domyślnie w prawym górnym rogu terminala, na którym uruchomiony jest slrn.

W pliku konfiguracja.sl można ustawić następujące parametry zmieniające sposób wyświetlania X-Face:

• slrnface->yOffsetChar = "1" - odległość od górnej krawędzi terminala wyrażona w znakach. Odległość jest więc uzależniona od wielkości czcionki na danym terminalu.
• slrnface->xOffsetChar = "0" - odległość od prawej krawędzi terminala wyrażona w znakach. Odległość jest więc uzależniona od wielkości czcionki na danym terminalu.
• slrnface->yOffsetPix = "2" - odległość od górnej krawędzi terminala wyrażona w pikselach. Wartość ta sumuje sie z odległością podaną dla zmiennej yOffsetChar. Zmienna ta używana jest głównie do drobnej korekty położenia obrazka z X-Face'm.
• slrnface->xOffsetPix = "0" - odległość od prawej krawędzi terminala wyrażona w pikselach.
• slrnface->XFacePad
• slrnface-> = "0" - odległość w pikselach pomiędzy xfacem a tekstem wyświetlanym w slrn. Należy odpowiednio zwiększyć tę wartość, jeżeli chcemy zachować odstęp między obrazkiem X-Face, a tekstem wyświetlanym w okienku terminala, który przylega do obrazka.
• slrnface->usefarben = 1 - Określa czy kolorystyka x-Face ma być określana w sposób automatyczny, zgodnie z aktualną paletą kolorów czytnika. Kolor tła obrazka będzie taki sam jak kolor tła artykułu, a kolor rysunku będzie taki sam jak kolor tekstu. Jednakże odcienie koloru mogą się nieco różnić od tego który jest na terminalu. Odpowiednich korekt można dokonać w definicjach kolorów danego terminala.
  Jeśli opcja ta jest włączona, to wszelkie zdefiniowane przez użytkownika kolory X-Face zostaną zignorowane.
• slrnface->ink = "black" - Określa kolor X-Face
• slrnface->paper = "white" - Określa kolor tła X-Face
• slrnface->padColor = "black" - Określa kolor odstępu zdefiniowanego przez slrnface->XFacePad

   white   = 0  (biały)
   black   = 1  (czarny)
   red     = 2  (czerwony)
   green   = 3  (zielony)
   yellow  = 4  (żółty)
   blue    = 5  (niebieski)
   magenta = 6
   cyan    = 7
   

Można również odwrócić paletę kolorów (zamienić kolor tła z kolorem rysunku) X-Face wciskając klawisz "`".

txtface.sl

Makro umożliwia wyświetlenie X-Face jako ASCII-art przy pracy na terminalu tekstowym i zapisanie zawartości nagłówka X-Face w wybranym katalogu.

Po otwarciu artykułu zawierającego nagłówek X-Face, w ostatniej linii ekranu zostanie wyświetlony odpowiedni komunikat. Po uruchomieniu makra (domyślnie klawiszem 'X') obrazek zawarty w X-Face zostanie wyświetlony w oknie na środku ekranu.

Podczas wyświetlania dostępne są następujące klawisze:

   Klawisz     Działanie
   ---------------------
   's'         odwróć domyślny sposób wyświetlania,
   'n'         odwróć ,,kolory'' (negatyw),
   'w'         zapisz do pliku,
   inny        zamknij okno.

Możliwa jest modyfikacja działania makra przez podanie argumentu prefiksowego przy wywołaniu:

   Argument    Działanie
   ---------------------
   0 lub brak  domyślne,
   1           odwróć domyślny sposób wyświetlania,
   2           odwróć ,,kolory'',
   3           odwróć oba.

Konfiguracja: Wartości domyślne zmiennych sterujących działaniem makra można ustawić w pliku konfiguracja.sl:

• hr_xface->use_neg = 0; (lub 1) pozwala wyświetlać X-Face w pozytywie ('0'), lub negatywie ('1'), czyli odwróconej palecie kolorów. Niektóre X-Face, wyglądają znacznie lepiej w negatywie.
• hr_xface->use_simple = 0; (lub 1) powoduje wyświetlenie obrazka w postaci uproszczonej, bez wygładzania krawędzi ('1')
• hr_xface->xfdir = "XFace" Określa katalog, do którego będą zapisywane xface (klawiszem 'w')

onekey_score.sl

punktowanie artykułów za pomocą jednego klawisza. Konfiguracja w pliku konfiguracja.sl.

farbenwahl.sl

schematy kolorów dla slrn z możliwością ich wyboru/zmiany podczas pracy. Istnieje możliwość ustawienia ostatnio używanego schematu jako domyślnego (tzn. automatycznego wczytania go przy następnym uruchomieniu slrn). W połączeniu z makrem slrnface.sl makro uaktualnia również kolory wyświetlanego X-Face. Konfiguracja w pliku konfiguracja.sl.

binpost.sl

dołączanie plików binarnych do wiadomości. Użycie: podczas edycji artykulu wpisz JAKO PIERWSZĄ LINIĘ W EDYTORZE (JAKO PIERWSZĄ LINIĘ NAGŁÓWKÓW):

   X-File: /scieżka/do/pliku
   

add2mutt_ab.sl

wpisywanie autora czytanego posta do książki adresowej mutt-a/abook-a, konfiguracja w pliku konfiguracja.sl.

identity.sl

Makro umożliwia definiowanie "osobowości" (tj: imienia i nazwiska, adresu email, adresu reply-to oraz sygnaturki) i przypisanie tych osobowości do danej grupy lub zbioru grup. Dane aktualnie obowiązującej "osobowości" można podejrzeć (domyślny klawisz: "ESC-I", można zmienić w pliku etc/slrn-macros.rc).

Konfiguracja: Konfiguracja makra w całości ma miejsce w pliku konfiguracja.sl. Polega na zadeklarowaniu jednej lub wielu osobowości, przypisaniu jej do danej grupy/zbioru grup a następnie zdefiniowaniu jej (tzn. podaniu danych takich jak imię, adres, etc). Zajrzyj do pliku konfiguracja.sl -- znajduje się tam definicja przykładowej osobowości o nazwie "test". Regułki te powodują, że (po uaktywnieniu makra w pliku etc/slrn-macros.rc) posty wysyłane przez ciebie na grupę pl.test będą miały w nagłówkach

From: fan pakietu slrn-pl <uzytkownik@myhost.pl>
Reply-To: uzytkownik@myhost.pl
   

% Osobowość nr 1:  "nazwa" "grupa lub wyrażenie regularne opisujące zbiór grup"
   

% Koniec definicji osobowości nr 1 o nazwie "test"
   

tagscore.sl

Makro oznacza znakiem * i chroni przed skasowaniem cenne artykuły. "Cenne artykuły" to artykuły o punktacji X lub wyższej. Wartość X ustawia się za pomocą zmiennej tags->tag_score_value w pliku konfiguracja.sl. Aby skasować "zabezpieczony" artykuł, wciśnij klawisz '*'.
Można także automatycznie odznaczać "cenne artykuły" po odpowiedzi na grupę (tags->untag_followup = 1) lub po odpisaniu na dany artykuł emailem (tags->untag_reply = 1).

win_resize.sl

Pozwala na zdefiniowanie domyślnego rozmiaru okienka artykułu. Parametr określa rozmiar okienka jako procent liczby wierszy terminala. Konfiguracja w pliku konfiguracja.sl.

slrn-pl: podręcznik użytkownika

1. Wstęp

2. Zmiany ogólne

• 2.1 Systemowe pliki konfiguracyjne
• 2.2 Zmiana nazw plików i katalogów
• 2.3 Dokumentacja

3. Instalacja slrn-pl

• 3.1 Linux
• 3.2 Windows
• 3.3 Aktualizacja: jak zachować swoją konfigurację

4. Łatki

• 4.1 Opis i konfiguracja
• 4.2 Łatki oficjalne z slrn.sourceforge.net

5. Makra

• 5.1 Opis i konfiguracja poszczególnych makr

6. Programy dodatkowe

• 6.1 slrnface
• 6.2 iksfejs
• 6.3 xbm2icon
• 6.4 cleanscore.pl
• 6.5 slrnrc-conv.pl
• 6.6 fch.pl