// ui-ncurses
// (c) copyright 2002 wojtek kaniewski <wojtekka@irc.pl>

interfejs ten różni się nieco od readline z okienkami. główną różnicą jest
fakt, że pierwsze okienko istnieje _zawsze_ i jest oknem stanu. do niego
lecą informacje o pojawianiu się i znikaniu ludzi. szczegóły dotyczące
obsługi klawiatury znajdują się w pliku README.

zalecane ustawienia:

	set display_ack 3
	set display_sent 1
	set make_window 2

pasek stanu zawiera zegar, informacje o własnym numerku (kolor określa
stan: czarny -- niedostępny, biały -- dostępny, szary -- zajęty, ciemnoszary
-- niewidoczny), numer aktualnego okna, informacje o aktywności w innych
oknach, nowej poczcie itd.

dodano nowy format ,,statusbar''. podobnie jak i reszta obsługuje kolory,
ale nie ma dopełniania, mrugania itp. są za to konstrukcje warunkowe oraz
rozszerzone informacje:

	%{time}		aktualny czas formatu %H:%M
	%{uin}		własny numer
	%{window}	numer aktualnego okna
	%{query}	rozmówca w aktualnym oknie
	%{activity}	lista okien, w których się coś pojawiło
	%{nick}		własny pseudonim
	%{descr}	opis stanu
	%{mail}		ilość nowej poczty lub pusty jeśli nie ma
	%{query_descr}	opis stanu rozmówcy
	%{version}	wersja ekg
	%{url}		adres do strony ekg

konstrukcje warunkowe pozwalają dodawać do pasku stanu teksty tylko,
gdy spełniony zostanie określony warunek. konstrukcje te wyglądają
następująco:

	%{?warunek tekst}	tekst wyświetlony przy spełnionym warunku
	%{?!warunek tekst}	tekst wyświetlony przy niespełnionym warunku

warunkiem może być dostępność któregoś z wyżej wymienionych tekstów.
jeśli na przykład w aktualnym oknie jest prowadzona rozmowa, warunek
%{?query ...} będzie spełniony. jeśli nie skonfigurowaliśmy własnego
numeru, spełniony będzie warunek %{?!uin ...}. ponadto występują również:

	%{?away ...}		stan zajęty
	%{?avail ...}		stan dostępny
	%{?notavail ...}	stan niedostępny (niepołączony)
	%{?invisible ...}	stan niewidoczny
	%{?more ...}		dopisano coś do okna, gdy jest przewinięte
	%{?query_away ...}	rozmówca zajęty
	%{?query_avail ...}	rozmówca dostępny
	%{?query_notavail ...}	rozmówca niedostępny
	%{?query_invisible ...}	rozmówca niewidoczny

warunki można zagnieżdżać, tzn. %{?query %{!?query_descr ...}} zostanie
wyświetlone, jeśli prowadzona jest rozmowa, ale rozmówca nie ma stanu
opisowego.

domyślny format czasu (%{time}) można zmienić za pomocą wpisu
,,ncurses_timestamp''. szczegóły w stronie manuala strftime(3).

dzięki temu można konstruować kosmiczne paski stanu. ale i tak domyślny
powinien wystarczyć każdemu. jest możliwość rozszerzenia pasku stanu do
maksymalnie 5-ciu linii. kolejne linie są opisane formatami ,,statusbar2'',
,,statusbar3'' itd. jeśli występuje format ,,statusbar1'', ma on
pierwszeństwo przed ,,statusbar''.

możliwe jest też włączenie nagłówka okna, tj. paska wyświetlanego u góry
ekranu, nad oknami. jest on opisany formatami ,,header'', ,,header1'',
,,header2'' itd., analogicznie do paska stanu. dostępne formaty są identyczne.

%|  w pasku stanu lub nagłówku okna dopełnia do końca linii. przydatne, gdy
    zmieniamy kolor tła, ponieważ domyślnym kolorem jest niebieski.

%}  w pasku stanu lub nagłówku okna wyświetla znak '}'


$Id: ui-ncurses.txt 2249 2004-02-03 21:18:58Z wojtekka $
