Readme dla Slrn-pl dla Windows

Jarek Baczyński, jarek@fanthom.irc.pl

Spis treści

1. Uruchamianie
2. Konfiguracja
3. Dokumentacja
4. Nowosci, uwagi dla uzytkownikow starszych wersji
5. Znane bledy
6. Kontakt z opiekunami

1. Uruchamianie

1.1 slrn

Przed przystąpieniem do pracy z slrn, jako niezbędne minimum, powinieneś:

• skonfigurowac adres serwera news w skrypcie startowym slrn.bat,
• skonfigurowac swoje dane personalne w pliku slrn.rc.

Do uruchamiania czytnika uzywaj skryptu slrn.bat.

1.2 slrnpull

Jesli pracujesz off-line (nie masz stalego polaczenia z serwerem news), do wymiany postow mozesz uzywac programu slrnpull.

Przed pierwszym uruchomieniem powinienes:

• skonfigurowac adres serwera news w skrypcie startowym slrnpull.bat, (zauwaz, ze jesli uzywasz slrnpull-a, nie musisz ustawiac adresu serwera w slrn.bat)
• skonfigurowac slrn-a, aby korzystal z slrnpull-a; w pliku etcslrn.rc/ odkomentuj linie zawierajaca: %include slrn-slrnpull.rc,
• w pliku spool/slrnpull.conf okresl interesujace Cie grupy.

Kazdorazowo, aby wyslac/pobrac newsy, uruchom skrypt slrnpull.bat.

1.3 sendsmtp

Aby forwardowac posty mailem lub wysylac kopie grzecznosciowe swoich odpowiedzi do autora, mozesz skorzystac z programu sendsmtp.

W pliku etc/slrn.rc lub w prywatnym slrn.rc (wyjasnienie roznicy dalej) powinienes ustawic adres swojego serwera pocztowego uzywajac zmiennej sendmail_command. Zobacz komentarz tej zmiennej w etc/slrn.rc.

2. Konfiguracja

Istnieja dwa pliki slrn.rc. W podkatalogu etc/ znajduje sie tzw. systemowy plik konfiguracyjny slrn.rc, ktory wczytywany jest w pierwszej kolejnosci przy starcie slrn. W standardowej konfiguracji plik ten wlacza pozostale pliki z podkatalogu etc/, tak wiec caly ten katalog stanowi konfiguracje systemowa.

Drugi plik slrn.rc znajduje sie w katalogu glownym drzewka (po rozpakowaniu) i jest to tzw. prywatny plik konfiguracyjny uzytkownika. Slrn wczyta go jako ostatni plik przy starcie, co oznacza, ze wszystkie zawarte w nim ustawienia _nadpisza_ ustawienia systemowe z katalogu etc/.

Zaleca sie dokonywac zmian konfiguracji w prywatnym pliku uzytkownika. W przypadku kolejnych aktualizacji pakietu, umozliwi to latwe odtworzenie swoich ulubionych ustawien poprzez skopiowanie jednego pliku rc.

3. Dokumentacja

W podkatalogu doc/manual/ znajduje sie "Podrecznik uzytkownika slrn". Kazdy nowy uzytkownik slrn-a powinien sie z nim zapoznac.

Aby poznac mozliwosci konfiguracyjne czytnika, mozesz rowniez przegladnac pliki konfiguracji systemowej (katalog etc/), zapoznajac sie z opisami poszczegolnych zmiennych.

W podkatalogu doc/slrn/slrnfuns/ znajduje sie dokument opisujacy wewnetrzne funkcje czytnika przydatne dla zaawanswanych uzytkownikow przy pisaniu makr.

4. Nowosci, uwagi dla uzytkownikow starszych wersji

Po szczegolowy wykaz zmian wzgledem poprzedniej wersji, zajrzyj do pliku changes-pl.txt.

4.1 Aktualizacja

Jesli uzywasz wersji slrn-pl 1.4.x, aktualizacja do wersji 1.4.2w moze polegac na nadpisaniu starego katalogu bin/ plikami binarnymi z nowego pakietu.

Jesli uzywasz wersji starszej niz 1.4.0, zaleca sie skorzystanie z nowego pakietu w calosci ze wzgledu na liczne zmiany w kodzie czytnika, w makrach, w konfiguracji oraz dokumentacji. Do skonfigurowania nowej wersji pakietu mozesz uzyc swojego starego prywatnego pliku konfiguracyjnego, kopiujac go w nowe miejsce. Przygotuj sie jednak na poprawki, gdyz niektore opcje konfiguracyjne moga okazac sie przestarzale w nowej wersji czytnika.

4.2 slrnXFace

Aktualna wersja slrn-pl wyposazona jest w slrnXFace, program do wyswietlania X-Face-ow napisany przez Andrzeja Kaczmarka ak@wroc.vulcan.pl.

Jesli po uruchomieniu czytnika, pojawi sie bitmapa, mozesz "chwycic" ja myszka i przesunac w wybrane przez siebie miejsce -- w tym miejscu beda wyswietlane X-Face-y. Program slrnXFace posiada menu kontekstowe z dostepnymi funkacjami wywolywane prawym przyciskiem myszy na bitmapie. Oryginalna dokumentacja znajduje sie w podkatalogu doc/slrnxface/.

Program jest domyslnie wlaczony. Jesli nie chcesz z niego korzystac, powinienes:

• w skrypcie startowym slrn.bat zakomentowac linijke start slrnxface.exe,
• w pliku etc/slrn-macros.rc zakomentowac linijke interpret macros\xface.sl.

4.3 licznik.sl

Jesli uzywasz makra licznik.sl tworzacego statystyki wysylanych postow, przy aktualizacji od wersji wczesniejszej niz 1.4.0, powinienes zmienic nazwy istniejacych plikow roboczych:

• .counter --> .slrn_counter
• .statistik --> .slrn_post_log

W przeciwnym wypadku, nowe makro bedzie zliczalo od poczatku.

5. Znane bledy

5.1 Bledy wersji biezacej

• jesli po edycji postu, a przed wyslaniem, zdecydujemy sie na ponowna edycje, po wejsciu do edytora niektore polskie znaki moga byc niepoprawne (duze polskie 'A' zamienia sie w male polskie 'a', duze polskie 'Z' zamienia sie w duze polskie 'C' ;) uwaga: dotyczy tylko sytuacji, gdy uzywamy edytora windowsowego i zestawu znakow win1250,
• slrnXFace moze przestac dzialac, jesli w pliku rc korzystamy z opcji server przypisujac plikowi jnews.rc inna nazwe niz standardowa,
• przy edycji nowego postu, niektore polskie litery w temacie moga zniknac po wejsciu do edytora (np. wpisujac jako temat polskie "asz", w edytorze otrzymujemy tylko pierwsza litere); jesli ma to miejsce, mozliwe sa dalsze klopoty przy wysylaniu przesylki (program proponuje reedycje artykulu).

5.2 Stare bledy

• polskie znaki w plikach konfiguracyjnych powinny byc kodowane w dosowym zestawie znakow ibm852 (w szczegolnosci realname, regexpy, itp..),
• brak mozliwosci wpisywania polskich liter przy podawaniu tematu postu, frazy do odszukania itp... (nie dotyczy W2K oprocz jednej literki :) (nie dotyczy oczywiscie tresci postu, ktora wprowadzamy w edytorze zewnetrznym; temat rowniez mozna wtedy poprawic),
• wszystkie edytory, ktorych uzywamy (do postow, maili, score'a...) musza pracowac ALBO w windows-1250 (edytory windows'owe) ALBO w cp852 (edytory w okienku dos'a), w zaleznosci od tego odpowiednio ustawiamy zmienna charset,
• makro prhn.sl niestety jeszcze nie dziala (mozna wyprobowac prhn-v2.sl),
• w standardowej konfiguracji nie jest rozwiazana kwestia drukowania.

6. Kontakt z opiekunami

W chwili obecnej projekt Slrn-pl rozwijany jest przez nastepujace osoby:

• Arkadiusz 'Jo Joro' Sochala jojoro@poczta.onet.pl, pomyslodawca projektu, aktualnie wtyczka w PLD :)
• Jarek 'bacza' Baczynski jarek@fanthom.irc.pl, wspoltworca, skrzydlo RH i win32,
• Tomasz 'tsca' Sienicki tsca@edb.dk, zasila projekt w bardzo wartosciowe makra, pomoc w tlumaczeniach,
• Jerzy 'HARY' Klejnowski ksionrze@poczta.wp.pl, pomoc w tlumaczeniach, zywa dzialalnosc na pl.news.czytniki.

Jesli chcesz, aby twoje nazwisko znalazło sie na tej liscie ;), skontaktuj się z jednym z nas. Bedziemy wdzieczni za kazda pomoc.

Jesli masz jednak pytania dotyczace uzytkowania czytnika, skorzystaj z zalaczonej dokumentacji a w nastepnej kolejnosci, z grupy dyskusyjnej pl.news.czytniki. Na korespondencje prywatna decyduj sie tylko w uzasadnionych przypadkach. ;)

Konkretne uwagi, sugestie, zaobserwowane bledy dotyczace wersji dla windows, wysylaj do mnie.

W imieniu zespolu, zycze przyjemnego uzytkowania slrn-pl!