# To jest przykadowy plik konfiguracyjny.  Powiniene go skopiowa do
# swojego katalogu domowego jako .elmorc.  Oczywicie najpierw
# trzeba pozmienia dane :)
#
# Puste wiersze oraz te zaczynajce si od znaku '#' s ignorowane.
#
# 1. Ustawianie zmiennych
# Zmienne ustawiamy przy pomocy sowa kluczowego set.  Jednej zmiennej
# mona przypisa wiele wartoci.  Jeli elmo bdzie potrzebowa
# jednej, to spyta, ktr wybra.
# UWAGA: Spacje musz by ujte w cudzysowy.  W przeciwnym przypadku
# wygenerowany zostanie bd skadniowy.
#
# 2. Ustawianie klawiszy
# Klawisze definiujemy prawie tak samo jak w mutt'cie.  Literki,
# cyferki i inne znaki, ktre mona wpisa z klawiatury podajemy
# normalnie.  Wyjtkiem s znaki specjalne, ktre trzeba poprzedzi
# backslashem (<, >, spacja, tabulacja, \, {, }, :, ', ").  Znaki,
# ktre wprowadzamy z controlem wpisujemy jako np. \Ca.  Klawisze
# specjalne wpisujemy: <tab>, <esc>, <up>, <down>, <left>, <right>,
# <pageup>, <pagedown>, <backspace>, <delete>, <insert>, <enter>,
# <home>, <end>, <space>, <f1>, <f2>, ...  Ostatni moliwoci
# wprowadzania klawiszy jest podanie wartoci semkowej jako trzech
# cyfr poprzedzonych backslashem.
#
# 3. Hooki
# Hooki pozwalaj na wykonanie pewnej akcji za kadym razem, gdy inna
# zostanie uruchomiona.  Hooki s uruchamiane w tej samej kolejnoci,
# wic:
#   hook fetch_get_mail fetch_del_mail
#   hook fetch_get_mail fetch_next
# sprawi, e po cigniciu listu zostanie on najpierw usunity, a
# potem podwietlenie przesunie si do nastpnej pozycji.


######################################################################
# ZMIENNE
######################################################################

# Plik z ksik adresow jest nadpisywany przy wyjciu z programu,
# jeli cokolwiek byo mieszane z adresami.
#
# set addressbook ~/.addressbook


# Zmienna charset okrela uywany przez nas zestaw znakw i jej
# warto jest uywana do ustawienia Content-Type.  W przypadku braku
# ustawienia domylnie przyjmowana jest warto us-ascii.
#
# set charset iso-8859-2


# Jako sygnaturk mona poda nazw pliku, w ktrym si znajduje, lub
# nazw programu, ktry wypisze sygnaturk na standardowe wyjcie.  W
# drugim przypadku naley poprzedzi nazw programu znakiem |.
#
# set sigfile ~/.signature
# set sigfile "|/usr/games/fortune"


# Dodanie opcji sig_dashes sprawi, e sygnaturka zostanie dodatkowo
# poprzedzona wierszem zawierajcym dwa mylniki oraz spacj: "-- ".
#
# set sig_dashes on


# Edytor, w ktrym zamierzamy pisa listy.  Cig musi zawiera
# sekwencj %f, ktry zostanie podmieniony nazw pliku do otworzenia.
# Moe rwnie zawiera sekwencj %d, ktra zamieniona zostanie na
# numer wiersza, do ktrego naley przej.
#
# set editor 'emacsclient +%d %f'
# set editro 'vim %f'


# Mailbox to katalog, w ktrym znajduj si skrzynki w formacie
# maildir lub mbox.  Przy starcie elmo prbuje otworzy inbox z
# podanego katalogu (chyba, e zostanie podane pole start).
# Domylne wartoci dla skrzynek to odpowiednio: inbox, sent, drafts,
# inbox.  Jeli trash nie jest zdefiniowane, kasowane wiadomoci
# bd usuwane.  W przeciwnym przypadku bd przenoszone do wskazanej
# skrzynki.  Uwaga!  Skrzynka taka musi ju by poprawnym maildirem
# (to znaczy zawiera podkatalogi cur i new), eby mona byo tam
# przenosi listy.
# Skrzynka powinna wyglda mniej wicej tak:
# ~/mail
#    +--> inbox
#       +--> cur
#       +--> new
#       +--> tmp
#    +--> sent
# ...
#
# name    -- nazwa skrzynki
# root    -- cieka
# start   -- ktr skrzynk otworzy przy starcie (domylnie: inbox)
# inbox   -- gdzie maj by cigane listy
# sent    -- gdzie zachowywa wysane listy (domylnie: sent)
# drafts  -- gdzie zachowywa niewysane listy (domylnie: drafts)
# outbox  -- gdzie zachowywa listy do wysania
# trash   -- dokd przenosi kasowane listy (domylnie: usuwa)
# spam    -- dokd przenosi listy kasowane jako spam (domylnie:
#            usuwa)
# protect -- czy chroni skrzynk przed spamem (domylnie: nie)
#
# set mailbox {
#   name:     'moja skrzynka'
#   root:     ~/mail
#   start:    odebrane
#   sent:     wyslane
#   drafts:   szablony
#   outbox:   nadawcza
#   trash:    kosz
#   spam:     spam
#   protect:  yes
# }


# Aby filtr antyspamowy dziaa potrzebna jest jeszcze nazwa pliku, w
# ktrym bdzie mona przechowywa baz danych.
#
# set bayes_file ~/mail/.bayes_file


# Zmienna relative_names okrela, czy elmo ma wywietla nazwy
# skrzynek obcite o warto zmiennej mail/root.  Czyli np. inbox
# zamiast /home/rzyj/mail/inbox.
#
# set relative_names on


# Ta zmienna jest wykorzystywana przez funkcj pop_check_new_mail.
# Jeli w jednej ze skrzynek jest jaka poczta, elmo sprawdzi warto
# tej zmiennej i sprbuje j wykorzysta do uruchomienia programu,
# ktry zawiadomi Ci o nowej poczcie.  Program ten nie musi odgrywa
# adnego dwiku, ale ma pozamykane standardowe wejcie / wyjcie.
#
# set sound_app "/usr/bin/play /usr/share/sounds/gotmail.wav"


# Ta zmienna suy do definiowania konta smtp.  Kont mona definiowa
# wiele.  Przed wysaniem uytkownik ma moliwo zmienienia
# domylnego konta na jedno z pozostaych.  Domylnie uywane jest to,
# ktre zostao zdefiniowane jako ostatnie.
#
# name     -- nazwa konta
# server   -- adres serwera
# port     -- opcjonalny numer portu (domylnie 25)
# my_name  -- imi pojawiajce si we From przed adresem email
# email    -- adres
# username -- nazwa uytkownika, jeli serwer wymaga uwierzytelnienia
# password -- haso do uwierzytelnienia
# ssl      -- ustaw na "yes", jeli poczenie ma by szyfrowane
#
# set smtp_acc {
#   name:    poczta.fm
#   server:  poczta.fm
#   my_name: 'Jasio Morderca'
#   email:   jasio@poczta.fm
# }


# Ta zmienna suy do definiowania konta pop3.
#
# name      -- nazwa konta
# server    -- adres serwera
# port      -- opcjonalny numer portu (domylnie 110)
# username  -- identyfikator uytkownika (login)
# password  -- haso
# use_apop  -- wymusza korzystanie z metody autoryzacji APOP.
#              Niestety niektre serwery (np. poczta.fm) pomimo
#              oferowania tej moliwoci autoryzacji (duo
#              bezpieczniejszej od standardowej) wcale jej nie
#              obsuguj odpowiadajc komunikatem "authorization
#              failed".  Dlatego te domyln wartoci jest no.
# ssl       -- ustaw na "yes", jeli poczenie ma by szyfrowane
#
# set pop_acc {
#   name:     onet
#   server:   pop3.poczta.onet.pl
#   username: jasio@op.pl
#   password: malgosia
# }



# Istnieje kilka zmiennych definiujcych format wywietlania danych
# (tzw format string).  Jest to acuch znakw zawierajcy pewne
# sekwencje kontrolne.  Sekwencja skada si ze znaku %, modyfikatorw
# i litery okrelajcych dan, ktr ma zosta zastpiona.
# Modyfikator to liczba okrelajca maksymaln dugo podstawianego
# tekstu.  Jeli poprzedzona jest zerem, to acuch zostanie
# uzupeniony spacjami do danej dugoci.  Poprzedzajcy zero dywiz
# sprawi, e tekst bdzie wyrwnany do prawej strony.
#
# Oto sekwencje kontrolne w formatach zwizanych z listami:
#
#   %% -- znak %
#   %f -- imi i nazwisko / pseudo autora listu (np. "Jasio Kowalski")
#   %F -- to samo co powyej, ale z adresem email
#         (np. "Jasio Kowalski <jasio.killer@poczta.onet.pl>")
#   %i -- inicjay autora listu (np. JK)
#   %t -- imi i nazwisko / pseudo adresata (np. "Magosia Leszcz")
#   %T -- to samo co powyej, ale z adresem email
#         (np. "Magosia Leszcz <super.laska@interia.pl>")
#   %d -- data listu
#   %D -- data w skrconej formie (np. maj 7)
#   %s -- temat listu
#   %S -- rozmiar (np. 3.5K)
#   %$ -- flagi listu
#   %? -- wskanik, czy list ma zaczniki
#   %# -- wskanik spamu
#
# A oto zwizane z listami zmienne okrelajce format wraz z
# domylnymi wartociami.

# line_format i sent_format okrelaj sposb prezentacji wiadomoci w
# gwnym oknie programu.  sent_format jest wykorzystywany w
# skrzynkach zawierajcych wiadomoci napisane przez uytkownika
# (t.j. sent i drafts).  fetch_format okrela sposb prezentacji listy
# wiadomoci znajdujcych si na serwerze pop3
#
# set line_format "%?%$%# %D %016f (%-06S)  "
# set sent_format "%?%$  %D %016t (%-06S)  "
# set win_fetch {
#   fetch_fmt "%?%$  %D %016f (%-06S)  %s"
# }

# Zmienne postaci *_wrote su do okrelenia tekstu pojawiajcego si
# przed cytowan wiadomoci.
#
# set male_wrote "On %d, %f wrote:"
# set female_wrote "On %d, %f wrote:"
# set o_male_wrote "On %d, %f wrote:"
# set o_female_wrote "On %d, %f wrote:"

# Zmienna indent_string definiuje cig znakw, ktrym zostanie
# poprzedzony kady wiersz cytowanego listu.
#
# set indent_string "> "


# A oto sekwencje kontrolne w formacie ksiki adresowej:
#
#   %% -- znak %
#   %n -- imi i nazwisko / pseudo (np. "Ja (Kiler) Kowalski")
#   %e -- adres email (np. "jasio.killer@poczta.onet.pl")
#   %o -- 'o' jeli adres jest oficjalny, ' ' w p.p.
#   %f -- 'f' jeli adres jest obcy, ' ' w p.p.
#   %s -- 'M' dla pci mskiej, 'F' dla eskiej i '?' dla innych
#
# set abook_format "%s %020n %e"


# A oto sekwencje kontrolne w formacie okna pomocy:
#
#   %% -- znak %
#   %k -- klawisz
#   %f -- nazwa funkcji
#   %d -- opis funkcji
#
# set win_help {
#   help_fmt "%012k %030f %d"
# }


# Sekwencje kontrolne w formacie okna wyboru skrzynki:
#
#   %% -- znak %
#   %n -- nazwa skrzynki
#   %t -- oglna liczba wiadomoci w skrzynce
#   %u -- liczba wiadomoci jeszcze nie przeczytanych
#
# set win_boxes {
#   box_fmt: " %010n (%u/%t)"
# }


# Sekwencje uywane w oknach, w ktrych wywietlane sa zaczniki:
#
#   %% -- znak %
#   %f -- nazwa pliku
#   %t -- typ zacznika
#   %s -- rozmiar zacznika
#   %c -- zestaw znakw (lub puste)
#   %C -- to samo co ", %c" jeli %c jest niepuste
#   %e -- kodowanie zacznika
#   %E -- to samo co ", %e" jeli %e jest niepuste
#
# set win_attach {
#   attach_fmt: "%020f (%-06s) [%t%C%E]"
# }
# set win_sender {
#   sender_fmt: "%020f (%-06s) [%t%C%E]"
# }


######################################################################
# INTERFEJS
######################################################################

# W elmo mona zmieni niemale kady aspekt wygldu programu.
# Zachcamy uytkownikw, aby nie umieszczali tego typu zmian w swoim
# pliku konfiguracyjnym.  Lepiej jest wszystkie polecenia zmieniajce
# wygld umieci w osobnym pliku i wczy go przy pomocy
# odpowiedniej dyrektywy:
#
# include ~/mail/.plik-z-tematem
#
# Plik taki mona nam przysa, a my umiecimy go w repozytorium i
# bdziemy go dodawa do kolejnych dystrybucji elmo.

# OGLNE ZASADY
# -------------
#
# Okna dziel si na te, ktrych rozmiaru i pozycji nie mona zmienia
# (wiersz polece, pasek statusu oraz grna belka) oraz na pozostae.
# Rozmiar i pozycj okna definiuje si przypisujc do pl width,
# height, top i left odpowiednie wartoci.
# W przypadku szerokoci i wysokoci - do niedodatnich wartoci
# dodawana jest cakowita szeroko / wysoko ekranu (w ten sposb
# mona uzyska okno o szerokoci ekranu, albo ciut mniejsze, bez
# wzgldu na ilo kolum / wierszy terminala).  W przypadku pozycji
# (top, left) odpowiednia warto jest dodawana do ujemnych wartoci
# tych pl.  Lewy grny rg ekranu ma wsprzdne (left = 0, top = 0).
#
# Okna maj rwnie konfigurowalne kolory.  Aby zmieni kolor jakiego
# elementu okna (np. foo) naley przypisa wartoci kolorw do pl
# foo_fg i foo_bg, czyli odpowiednio: kolor obrazu i ta.  Dostpnych
# jest 15 kolorw, z czego tylko 8 moe by uytych jako kolor ta.
# Oto te kolory (gwiazdk zaznaczyem te 8 szczliwych):
#   grey, black(*), rose, red(*), lime, green(*), yellow, orange(*),
#   blue(*), violet, magenta(*), lightblue, cyan(*), white,
#   lightgrey(*)
# eby wic np. mie czarne komunikaty bdw na czerwonym tle naley
# to doda do swojego pliku .elmorc:
# set win_echo {
#   error_fg: black
#   error_bg: red
# }

# RAMKI
# -----
#
# Ramki s rysowane na oknie, ktre jest na samiutekim spodzie.
# Wszystkie pozostae okna s rysowane na oknie z ramkami.  Jeli
# gdzie popenimy bd w rozmiarze jakiego okna, to ramki mog si
# nie pojawi poniewa zostan przez to okno zakryte.
#
# Mona ustawia kolor ramek i wypenie oraz definiowa obszary
# wypenienia i obszary wypenione okrelonym elementem ramki.
# Obszary te okrelone s czterema wsprzdnymi, ktre obowizuj te
# same zasady co przy definiowaniu rozmiarw okien.
#
# Jeli ekran nie obsuguje znakw ramek i pojawiaj si krzaki,
# naley ustawi pole no_frames na yes - spowoduje to narysowanie
# ramek przy pomocy znakw ascii.
#
# Poniej domylne wartoci:
# set win_frames {
#   frame_fg:  blue
#   frame_bg:  black
#   fill_fg :  blue
#   fill_bg :  black
#   no_frames: no
#   fill:      "(25 0 25 0)"
#   f_horiz:   "(0 21 24 21) (0 -8 24 -8)"
#   f_vert:    "(25 1 25 -1)"
#   f_left:    "(25 21 25 21) (25 -8 25 -8)"
#   f_right:   ""
#   f_up:      ""
#   f_down:    ""
#   f_cross:   ""
# }

# WIERSZ POLECE
# --------------
#
# W wierszu polece mona jedynie zmieni kolory tekstu i komuniaktw
# o bdach.
# set win_echo {
#   text_fg : lightgrey
#   text_bg : black
#   error_fg: red
#   error_bg: black
# }

# PASEK STATUSU
# -------------
#
# W pasku statusu mona tylko zmieni kolor paska i kolor nawiasw
# okalajcych nazw aktualnego okna.
# set win_status {
#   text_fg : lightgrey
#   text_bg : blue
#   paren_fg: lightblue
#   paren_bg: blue
# }

# GRNA BELKA
# -----------
#
# Mona tylko zmieni kolor okna.
# set win_topbar {
#   text_fg: lime
#   text_bg: blue
# }

# ZEGAREK
# -------
#
# Oprcz rozmiaru i pozycji mona rwnie zmieni kolor okna i format
# zegarka (patrz man strftime).
# set win_clock {
#   height:  7
#   width:  25
#   top:    -9
#   left:    0
#   text_fg:   blue
#   text_bg:   black
#   clock_fmt: "   %H:%M  %a, %e %b "
# }

# FOLDER
# ------
#
# W gwnym oknie programu mona zmieni rozmiar, pozycj, kolory i
# czy chcemy miec nagwek.
# set win_folder {
#   height:  -4
#   width:  -26
#   top:      2
#   left:    26
#   label:  yes
#   text_fg: ligthgrey
#   text_bg: black
#   tree_fg: red
#   tree_bg: black
#   tree_bar_fg: red
#   tree_bar_bg: cyan
# }

# WYBR SKRZYNKI
# --------------
#
# set win_boxes {
#   height: 20
#   width:  25
#   top:     2
#   left:    0
#   label: yes
#   text_fg: lightgrey
#   text_bg: black
#   root_fg: white
#   root_bg: black
#   tree_fg: red
#   tree_bg: black
#   tree_bar_fg: red
#   tree_bar_bg: cyan
#   box_fmt: " %010n (%u/%t)"
# }

# LIST
# ----
#
# set win_mail {
#   height: -3
#   width:   0
#   top:     1
#   left:    0
#   label:  no
#   text_fg:      lightgrey
#   text_bg:      black
#   signature_fg: cyan
#   signature_bg: black
#   quote_fg:     green
#   quote_bg:     black
#   to_fg:        cyan
#   to_bg:        black
#   from_fg:      cyan
#   from_bg:      black
#   subject_fg:   cyan
#   subject_bg:   black
#   cc_fg:        cyan
#   cc_bg:        black
#   mua_fg:       cyan
#   mua_bg:       black
#   date_fg:      cyan
#   date_bg:      black
#   replyto_fg:   cyan
#   replyto_bg:   black
#   sigok_fg:     cyan
#   sigok_bg:     black
#   sigwarn_fg:   cyan
#   sigwarn_bg:   black
#   sigfail_fg:   cyan
#   sigfail_bg:   black
# }

# CIAGANIE POCZTY
# ----------------
#
# set win_fetch {
#   height:  -4
#   width:  -26
#   top:      2
#   left:    26
#   label:  yes
#   text_fg: lightgrey
#   text_bg: black
#   fetch_fmt: "%?%$  %D %016f (%-06S)  %s"
# }

# ZACZNIKI
# ----------
#
# set win_attach {
#   height:  8
#   width:   0
#   top:   -10
#   left:    0
#   label: yes
#   text_fg: lightgrey
#   text_bg: black
#   attach_fmt: "%020f (%-06s) [%t%C%E]"
# }

# POMOC
# -----
#
# set win_help {
#   height: -4
#   width:   0
#   top:     2
#   left:    0
#   label: yes
#   text_fg: lightgrey
#   text_bg: black
#   help_fmt: "%012k %030f %d"
# }

# WYSYANIE
# ---------
#
# set win_sender {
#   height: -12
#   width:    0
#   top:     10
#   left:     0
#   label:  yes
#   text_fg: lightgrey
#   text_bg: black
#   info_fg: lightgrey
#   info_bg: black
#   sender_fmt: "%020f (%-06s) [%t%C%E]"
# }


# NAGWKI
# --------
#
# Jedna zmienna win_label okrela wygld wszystkich nagwkw okien.
# set win_label {
#   focus_fg:   white
#   focus_bg:   blue
#   nofocus_fg: lightgrey
#   nofocus_bg: blue
# }

# PASEK WYBORU
# ------------
#
# set win_bar {
#   text_fg: lightgrey
#   text_bg: cyan
# }

######################################################################
# TYPY MIME
######################################################################

# Te ustawienia wykorzystywane s w 2 celach.  Po pierwsze po to, aby
# elmo mogo zdecydowa jaki typ ma wysyany plik, a po drugie po to,
# aby elmo wiedziao jaki program naley uruchomi, aby dany zacznik
# otworzy.  Spjrzmy na przykad:
#
# mime image/gif "\.gif$"
#
# Powysza deklaracja spowoduje, e wszystkie pliki pasujce do
# wyraenia regularnego "\.gif$" (czyli majce rozszerzenie .gif) bd
# wysyane jako image/gif.  
#
# handler image/* "fbi %f"
#
# Powyszym informujemy elmo, e chcemy uy programu fbi do
# otwierania obrazkw.
#
# Inne przykady:
#
# mime     application/pdf  "\.pdf$"
# handler  text/html        "links -no-connect -force-html file://%f"


######################################################################
# REGUKI
######################################################################

# Reguki su do rozdzielania listw do skrzynek na podstawie
# wartoci rnych nagwkw listu.  Przykad:
#
# rule elmo-users {
#   Jesli SUBJECT zawiera '[elmo-users]' to umiesc list w elmo.
# }
#
# To nie art.  Reguki mona pisa w jzyku polskim.  Ale najpierw
# zasady:  reguka musi zawiera nazw dopasowywanego nagwka
# kapitalikami, nastpnie ujty w pojedyncze lub podwjne cudzysowy
# napis, a na kocu nazw skrzynki zakoczon kropk (lub rednikiem).
# Wszystkie te elementy mog by rozdzielone dowoln iloci innych
# sw.  Jeli napis bdzie ujty w pojedyncze cudzysowy - bdzie
# poszukiwany explicite w nagwku.  Jeli zostanie ujty w cudzysowy
# podwjne - bdzie potraktowany jako wyraenie regularne, do ktrego
# powinien si nagwek dopasowa.
#
# Pozostaje ju tylko wyjani jak uzyska operatory logiczne: lub
# oraz i.  Koniunkcj wyraamy piszc kilka kolejnych ogranicze, np
# tak:
#
# rule elmo-users {
#   Jesli SUBJECT zawiera '[elmo-users]'
#   a TO pasuje do "rzyj(ontko)?" to przenies do elmo.
# }
#
# Alternatyw wyraamy piszc kilka regu dla tej samej skrzynki, np
#
# rule elmo-users {
#   Jesli SUBJECT zawiera '[elmo-users]' to przenies do elmo;
#   podobnie jesli FROM zawiera 'sourceforge.net' to dawaj do elmo.
# }
#
# Wiadomoci s dopasowywane kolejno do wszystkich reguek.  Jeli nie
# znajd adnej pasujcej - umieszczane s w inbox.
#
# Nagwki, z ktrych mona korzysta w regukach to:
#    SUBJECT - temat listu
#    FROM    - nadawca
#    TO      - odbiorca
#    CC      - odbiorca kopii
#    TOCC    - odbiorca lub odiorca kopii


######################################################################
# KLAWISZE
######################################################################

# Pomocne.
#
# key mail r sender_open_reply
# key mail R sender_open_reply_all
# key mail f sender_open_fwd


######################################################################
# HOOKI
######################################################################

# Tych uywam.
#
# hook folder_toggle_flag folder_bar_next
#
# hook fetch_del_mail fetch_next
# hook fetch_get_mail fetch_next
#
# hook mybox_create_box box_selection_re_read
# 
# hook sender_go mailreader_close

######################################################################
# HOOKI CZASOWE (?)
######################################################################

# Jedyne zastosowanie, jakie przychodzi mi do gowy to regularne
# sprawdzanie, czy nie przysza nowa poczta.  Po sowie kluczowym
# interval dajemy liczb minut, co ile zadana nastpnie funkcja bdzie
# wykonywana.
#
# interval 5 pop_check_new_mail