 Maximus, 2005________________tcCalendar 2.0________________mxmus@yandex.ru
::::Lister-plugin do Total Commandera
________________________________________________________________________________
I. OPIS:
 Uniwersalny kalendarz.
 Pozwala na korzystanie z powszechnych oraz wasnych dat z podziaem na kategorie.
 Dla wikszoci typw dat dostpne s specjalne formaty, pozwalajce na specjalne definiowanie dat:
 - zalenych od Wielkanocy katolickiej
 - zalenych od Wielkanocy ortodoksyjnej
 - zalenych od liczby dni roboczych w miesicu
 - ruchomych
 - cyklicznych
 - wg kalendarza juliaskiego
 Kalendarz skada si z dwch czci (tabeli i listy dat) z moliwoci definicji kadego z ich elementw.
 Dla listy dat istnieje mozliwo ograniczenia liczby wywietlanych dat zarwno wstecz, jak i "do przodu" w stosunku
 do  daty biecej.
 Istnieje moliwo eksportu kalendarza do Excela oraz zapisu jako plik RTF lub zwyky plik tekstowy.
 Korzystajc z zewntrznego moduu SunMoon.ecl tcCalendar moe pokazywa informacje dotyczce soca i ksizyca.
 Posiada wielojzyczny interfejs (czeski, duski, holenderski, angielski, francuski, niemiecki, grecki, wgierski,
 woski, polski, rumuski, rumuski, rosyjski sowacki, hiszpaski, ukraiski)
________________________________________________________________________________
II. INSTALACJA:
 1. Rozpakuj zawarto archiwum do wybranego katalogu ([CLD_PATH])
 2. Zainstaluj wtyczk:
     - Konfiguracja->Opcje...->Edycja/Widok->Skonfigurj wewn. przegldark...->Lister-Wtyczki
     - dodaj tcCld do listy wtyczek
 3. Dodaj nowy przyczisk do paska paska przyciskw:
     - Konfiguracja->Zmie pasek narzdzi...->Dodaj
     - wypenij pola w nastpujcy sposb:
         - 'Polecenie' = "cm_List [CLD_PATH]\tcCld.TCCALENDAR"
         - 'Pocztkowa cieka' = "[CLD_PATH]"
         - 'Ikona plik' = "[CLD_PATH]\tcCld.ico" lub wybierz wsasn
     UWAGA: wszystkie wpisy bez cudzysoww
 4. |opcjonalnie| Moesz doda tcCalendar do menu 'Start' w TC:
     - {Start->Zmie pocztkowe menu...->Dodaj pozycj...}
     - wprowad nazw pozycji (np.: "tcCalendar")
     - wypenij pola w nastpujcy sposb:
        - 'Polecenie' = "cm_List [CLD_PATH]\tcCld.TCCALENDAR"
        - 'cieka pocztkowa' = "[CLD_PATH]"
     UWAGA: wszystkie wpisy bez cudzysoww
 5. |opcjonalnie| Jeli wykonae polecenia z punktu 4, moesz zdefiniowa klawisz skrtu dla tcCalendara:
     - {Konfiguracja->Opcje...->Rne}
     - wybierz kombinacj klawiszy w grupie 'Przedefiniowanie klawiszy'
     - w polu 'polecenie' , z sekcji "User" wybierz "cm_UserMenu" z numerem, ktry tcCalendar ma w menu pocztkowym
________________________________________________________________________________
III. KLAWISZE:
    S - poka/ukryj panel ustawie
    D - poka/ukryj panel dat
    Y - Poka/ukryj panel roku
    R - Zaaduj ponownie list dat
    C - Zaaduj ponownie tabel kalendarza
    G - Przewi list dat do wybranego dnia
    T - Przejd do wybranego roku
 NUM+ - nastpny rok
 NUM- - poprzedni rok
 NUM* - biecy rok
Edycja formatw notatek/rocznic/wasnych terminw:
 Ctrl+Del   - usu
 Ctrl+Ins   - dodaj
 Ctrl+<     - przenie w gr (za wyjtkiem formatw rocznic)
 Ctrl+>     - przenie w d (eza wyjtkiem formatw rocznic)
 Ctrl+Enter - zastosuj zmiany (klawisz 'OK' )
________________________________________________________________________________
IV. MYSZKA:
Panel roku:
 Podwjny klik     - przejd do wybranego roku
Tabela kalendarza
 Podwjny klik     - edytuj istniejc notatk
 Ctrl+lewy klik    - edytuj istniejc rocznic
 Shift+lewy klik   - edytuj wasny termin
 Srodkowy klik     - przewi list dat do wybranego dnia
________________________________________________________________________________
V. PLIKI:
 [CLD_PATH]\Dates\*.cdt - zestaw wsplnych dat
 [CLD_PATH]\Dates\*.pdt - zestaw wasnych dat i notatek
 [CLD_PATH]\Dates\*.edt - rozszerzony zestaw dat
 [CLD_PATH]\Dates\Void\*.cdt,*.pdt,*.edt - przykadowe zestawy dat (aby skorzysta z nich, skopiuj je do "[CLD_PATH]\Dates")
Zewntrzne moduy:
 [CLD_PATH]\ExLib\*.ecl
 [CLD_PATH]\ExLib\SunMoon.ecl - modu pozwalajcy uzyska informacje o socu i ksiycu
     Moesz pobra SunMoon.ecl ze strony http://maximus.in.ua
Schematy czcionek:
 [CLD_PATH]\FontScheme\*.fnt
 [CLD_PATH]\tcCld.fnt - biecy schemat czcionek
Pliki jzykowe:
 [CLD_PATH]\Language\*.lng
Pliki pomocy:
 [CLD_PATH]\ReadMe\readme_*.txt

________________________________________________________________________________
VI. FORMAT PLIKW Z ZESTAWAMI DAT:
________________________________________________________________________________
-|Typ |Sekcja         |Format            |Komentarz
_|____|_______________|__________________|______________________________________
1|.pdt|[Notes]        |dd.mm.yyyy=notes  |Notatka
 |    |               |                  |dd = <dzie>
 |    |               |                  |mm = <miesic>
 |    |               |                  |yyyy = <rok>
_|____|_______________|__________________|______________________________________
2|.cdt|[MainDates]    |dd.mm=dates       |Prosta data
 |    |[Dates]        |                  |dd = <dzie>
 |    |[Religious]    |                  |mm = <miesic>
_|.pdt|[PersonalDates]|__________________|______________________________________
3|    |[Celebrations] |ROEx=dates        |Daty zalene od ortodoksyjnej Wielkanocy
 |.edt|[Extended]     |                  |x = <dni_po_ortodoksyjnej_wielkanocy>
 |    |               |                  |x = -<dni_przed_ortodoksyjnej_wielkanocy>
_|    |               |__________________|______________________________________
4|    |               |RCEx=dates        |Daty zalene od katolickiej Wielkanocy
 |    |               |                  |x = <dni_po_katolickiej_wielkanocy>
 |    |               |                  |x = -<dni_przed_katolickiej_Easter>
_|    |               |__________________|______________________________________
5|    |               |WDMwn=dates       |Data wg liczby dni roboczych w miesicu
 |    |               |                  |              (dla wszystkich miesicy)
 |    |               |                  |w = <dzie_roboczy>
 |    |               |                  |                    [0..6] 0-Niedziela
 |    |               |                  |n = <number_relatively_month_begin>
 |    |               |                  |n = -<number_relatively_month_end>
_|    |               |__________________|______________________________________
6|    |               |WDMwn.mm=dates    |Data wg liczby dni roboczych w miesicu
 |    |               |                  |            (dla konkretnego miesica)
 |    |               |                  |w = <dzie roboczy>
 |    |               |                  |                    [0..6] 0-Niedziela
 |    |               |                  |n = <number_relatively_month_begin>
 |    |               |                  |n = -<number_relatively_month_end>
 |    |               |                  |mm = <miesic>
_|    |               |__________________|______________________________________
7|    |               |PDw.dd=dates      |Szczeglna data
 |    |               |                  |w = <dzie_roboczy>
 |    |               |                  |dd = <dzie>
_|    |               |__________________|______________________________________
8|    |               |PDYnnn=dates      |Szczeglna data
 |    |               |                  |nnn = <dzie_w_roku>
_|    |               |__________________|______________________________________
9|    |               |Jdd.mm=dates      |Data kalendarza juliaskiego
 |    |               |                  |dd = <dzie>
 |    |               |                  |mm = <miesic>
_|____|_______________|__________________|______________________________________
1|.pdt|[PersonalDates]|CDccc:dd.mm.yyyy  |Cykliczna data
0|    |               | -dd.mm.yyyy=dates|ccc = <dni_w_cyklu>
 |    |               |                  |dd.mm.yyyy (pierwsza grupa) =
 |    |               |                  |                   <lewe_ograniczenie>
 |    |               |                  |dd.mm.yyyy (druga grupa) =
 |    |               |                  |                  <prawe_ograniczenie>
_|____|_______________|__________________|______________________________________
1|.cdt|[MainDates]    |MDdate:l,r>dti    |Data ruchoma (krtki format)
1|    |[Dates]        |            =dates|l = <lewy_dzie_roboczy>
 |.pdt|[PersonalDates]|                  |r = <prawy_dzie_roboczy>
 |    |[Celebrations] |                  |t = <docelowy_dzie_roboczy>
 |    |               |                  |           l,r,t - [0..6] 0-Niedziela
 |    |               |                  |d = <kierunek_ruchu>
 |    |               |                  |          N - nastony, P - poprzedni
 |    |               |                  |i = <ignoruj>
 |    |               |                  |  I - bdzie wywietlane tylko jeli
 |    |               |                  |                  zostao przeniesione
 |    |               |                  |date = format daty 2,3,4
_|    |               |__________________|______________________________________
1|    |               |MDdate:l1,r1>dt1  |Data ruchoma (dugi format)
2|    |               | :l2,r2>dt2i=dates|       jak w krtkim formacie,
 |    |               |                  |               ale zawiera dwa warunki
_|    |               |__________________|______________________________________
1|    |               |MDdd.mm:WDMwn>    |Data ruchoma (format zaleny)
3|    |               |    WDMwn.mm=dates|dd = <dzie>
 |    |               |                  |mm = <miesic>
 |    |               |                  |w = <dzie_roboczy>
 |    |               |                  |                    [0..6] 0-Niedziela
 |    |               |                  |n = <number_relatively_month_begin>
 |    |               |                  |n = -<number_relatively_month_end>
_|    |               |__________________|______________________________________
1|    |               |MDdate:WDMwn.mm>  |Data ruchoma (zalena od Wielkanocy)
4|    |               |     WDMwn.mm=|w = <dzie_roboczy>
 |    |               |                  |                    [0..6] 0-Niedziela
 |    |               |                  |n = <number_relatively_month_begin>
 |    |               |                  |n = -<number_relatively_month_end>
 |    |               |                  |date = formaty daty 3,4
_|____|_______________|__________________|______________________________________
_|____|_______________|__________________|______________________________________
UWAGA:
  1. daty = date_1%ndate_2%n ... %ndate_X
       dla rocznic - .pdt [Celebrations]:
       date_i = celebration_name#celebration_begin_year#format_number
       format_number = muner formatu nma licie formatw (>=-1, -1 - domylny format)
                                       {Panel ustawie->Daty->Zestawy->Klawisz '>'}
  2. notatki = Note_1%nNote_2%n ... %nNote_X
  3. Format wsplny dat ruchomych:
       MDsource_date:move_condition>target_date
       MDsource_date:move_condition_1>target_date_1:move_condition_2>target_date_2 (long format)
  4. Istnieje moliwo edycji notatek oraz prostych dat (dd.mm), cznie z rocznicami,
  z poziomu wtyczki tcCalendar (zobacz cz MYSZ)
________________________________________________________________________________
VI. PRZYKADY:
  ROE0=Wielkanoc                       23.04=Urodzny Jana%nUrodziny Piotra
  ROE49=Uroczystoci Trjcy witej    WDM02=druga niedziela kadego miesica
  ROE-7=Niedziela Palmowa              WDM3-1=ostatnia roda kadego miesica
  RCE0=Katolicka Wielkanoc             WDM51.11=pierwszy pitek listopada
  PD5.13=Pitek "trzynastego"
  PDY256=Dzie programistw

  J25.12=Boe Narodzenie
    Koci ortodoksyjny wituje Boe Narodzenia (a moe i inne wita) w starym stylu
    (kalendarzu juliaskim).
    Obecnie rnica midzy kalendarzem gregoriaskim,a juliaskim wynosi 13 dni
    ale od 1 marca 2010 roku bdzie to 14 dni, a przed 1 marca 1900 byo 12.
  CD015:14.09.2005-03.05.2006=Data cykliczna
    Bdzie powtrzana co 15 dni poczwszy od 14.09.2005, ale nie pniej ni do 03.05.2006.
  MD02.04:2,3>P1:4,5>N1=2 kwietnia wito w Argentynie
    Jeli 2 kwietnia wypada we wtorek lub rod, to wito przenoszene jest na poprzedazajcy
    je poniedziaek, jeli w czwartek lub pitek to - na nastpny poniedziaek, w innym razie nie
    jest przenoszone.
  MD01.01:6,6>N1:0,0>N1=Dodatkowe wito za Nowy Rok na Ukrainie
         MD01.01:6,0>N1=Dodatkowe wito za Nowy Rok na Ukrainie
    Na Ukrainie, jeli wito pastwowe (cznie z Nowym Rokiem) wypada w sobot lub niedziel
    to wystpuje dodatkowy wolny dzie w kolejny poniedziaek.
  MD01.01:6,0>N1I=Dodatkowe wito za Nowy Rok na Ukrainie
    Jeli dodane jest 'I' na kocu "przenoszonej" daty w krtkim lub dugim formacie
    wwczas data ta bdzie wywietlana tylko jeli bdzie przeniesiona.
  MD01.05:WDM01>WDM02.05=1 maja wito Gdzie tam
    Jeli 1 maja jest w pierwsz niedziel miesica wwczas wito przenoszone jest
    na drug niedziel maja.
_______________________________________________________________________________
VII. FORMAT ROCZNIC:
 {Panel ustawie->Daty->Zestawy->Klawisz '>'}
Specjalne symbole:
[N] - Nazwa rocznicy
[Y] - Rok rozpoczcia
[A] - Rocznica
Jeli np. chcesz zobaczy na licie dat informacj:
"Tego dnia , 10 lat temu, Urodzi si nasz drogi Jasiu. To wspaniae wydarzenia miao miejsce w 1995 roku."
musisz doda nastpujcy format:
"Tego dnia , [A] lat temu, Urodzi si nasz drogi [N]. To wspaniae wydarzenia miao miejsce w [Y] roku."
i wybra ten format dodajc/edytujcrocznice (menu podrczne kalendarza) w trzeciej kolumnie tabeli, w pierwszej naley wpisa jako nazw: "Jasiu"
________________________________________________________________________________
VIII. FORMAT DAT:
 {Panel ustawie->Wywietlanie->Inne->Format dat}
Specjalne symbole:
[D] - Dzie
[M] - Numer miesica
[L] - Litera miesica
[A] - Alternatywna litera miesica
[Y] - Rok
[S] - Skrcony rok
[J] - Data juliaska
[W] - Dzie tygodnia
[B] - Krtki dzie tygodnia
 \t - tab (ma znaczenie dla listy dat)
Przykad:
Format daty juliaskiej: j[D].[M] = j03.08
 Format na licie dat: [L] [D], [Y] ([J]) = 16 sierpnia, 2005 (j03.08)
________________________________________________________________________________
IX. FORMAT CZASU:
 {Panel ustawie->Czas->Format czasu}
Specjalne symbole:
[H] - Godziny
[T] - Godziny (12-godzinny format)
[M] - Minuty
[S] - Sekundy
Przykad:
 [H]:[M] = 16:09
 [T]:[M] = PM04:09
________________________________________________________________________________
X. FORMAT PODPOWIEDZI:
 {Panel ustawie->Podpowied->Zawarto->Format podpowiedzi}
Wsplne symbole specjalne:
\n  - nowa linia
\t  - tabulator

Dzi:
  Specialne symbole:
    [T] - Dzi
  Sample:
    :::: [T] :::: = :::: Dzi ::::

Format nagwkw typw dat:
  Specialne symbole:
    [N] - Nazwa typu daty
  Przykad:
    ::++ [N] ++:: = ::++ wita pastwowe ++::

Format informacji o socu i ksiycu:
  Specjalne symbole:
    [SR] - Godzina wschodu Soca
    [SS] - Godzina zachodu Soca
    [MR] - Godzina wschodu Ksizyca
    [MS] - Godzina zachodu Ksizyca
    [PP] - Faza Ksiyca (procent)
    [PN] - Nazwa fazy Ksiyca
Przykad:
 Soce i Ksiyc:\nWschd Soca [SR]\nZachd Soca [SS]\nWschd Ksiyca [MR]\nZachd Ksiyca [MS]
 =
 Soca i Ksiyc:
 Wschd Soca 03:49
 Zachd Soca 20:12
 Wschd Ksiyca 00:26
 Zachd Ksizyca 14:12
________________________________________________________________________________
XI. PARAMETRTY CZCIONEK
 {Panel ustawie->Wywietlanie->Czcionki}
________________________________________________________________________________
                 | N/U      | U/O   | U/A
_________________|__________|_______|____________________________________________
Rok              | VA       |       |
To              |          | FC BC | FC={kolor ta dla listy dat}
                 |          |       | BC={Kolor ta dla kalendarza}
Siatka kalendarza|          | BC    | BC={kolor siatki kalendarza}
... <Data>       | VA HA    |       | BC={... kolor znacznika}
... <Tekst>      | VA HA BC |       |
_________________|__________|_______|____________________________________________
Skrty:
 N/U - nie uywane  U/O - uywane tylko U/A - uywane jako
 VA - wyrwnanie w pionie    FC - kolor czcionki
 HA - wyrwnaie w poziomie   BC - kolor ta
________________________________________________________________________________
XII. USUWANIE PROBLEMW:
 W niektrych wersjach Windowsa (np. Windows 2000) lista dat nie jest wywietlana waciwie.
 Aby usun ten problem naley skopiowa:
     z Windows XP  -  dysk:\WINNT\SYSTEM32\riched20.dll
     z Windows 98  -  dysk:\Windows\SYSTEM32\riched20.dll
      do waciwego katalogu w Windows 2000 - disk:\WINNT\SYSTEM32\)
     dysk - dysk gdzie jest zainstalowany system operacyjny
________________________________________________________________________________
XIII. MATERIAY:
 For getting information about Sun and MoonFor used part of TMoon component.
     Andreas Horstemeier
     andy@hoerstemeier.de
     http://www.hoerstemeier.com
 As initial information for forming of towns location file (tcCld.lct) used file cities.dat from Calendar wfx-plugin.
     Fabio Chelly,
     fabio@chelly.net
     http://totalcommander.free.fr/fabio/calendar.zip
________________________________________________________________________________
XIV. HISTORIA:
[+] - dodano  [/] - poprawiono  [*] - zmieniono

[2.0]
+ saving calendar table as bitmap (BMP) {Settings panel->Export}
+ fonts schemes {Settings panel->Display->Fonts}
+ setting of content of tooltip {Settings panel->Tooltip->Content of tooltip} (see X. TOOLTIP FORMAT)
+ manual location input {Settings panel->Time and Location}
+ setting of window position on start {Settings panel->Program}
+ buttons for hiding year panel and dates list
+ indent for text alignment {Settings panel->Display->Fonts}
+ hotkey for going to current year - NUM*


[1.9]
+ getting information about Moon and Sun using external module {Settings panel->Tooltip->Sun and Moon}
      (see EXTERNAL MODULES, SUN AND MOON INFORMATION FORMAT)
      Choose town and time format {Settings panel->Time} (see TIME FORMAT)
+ headers for date types in tooltips {Settings panel->Tooltip->Date type header}
      (see DATE TYPE HEADER FORMAT)
+ day of week in long date format and dates list date format (see DATE FORMAT)
+ suupport mavable dates for .cdt [Religious] and .edt [Extended]
+ new format of movable dates (Easter relative format)
+ set size and possibility to hide year panel

+ common dates set (Austria, German)

[1.8]
/ support files of dates set more then 64 Kb with string width more then 2 Kb
/ fixed error in movable dates (not display if must to move from previous/next year)
/ correctly take into account difference of Julian and Gregorian calendar for Orthodox Easter calculation
+ Julian dates in dates sets (see Format of dates set files/9, SAMPLES)
+ Julian dates in dates list {Settings panel->Display->Other->Date format} (see DATE FORMAT)
+ Julian dates in calendar tooltips(hints) {Settings panel->Dates->Limitation +}
+ addition to movable dates format ('I' key, see Format of dates set files/11, SAMPLES)
+ addition to movable dates format (limits like from 6 to 2, see SAMPLES)
+ addition to particular dates format (day in year, see Format of dates set files/8, SAMPLES)
+ priority of dates and formats {Settings panel->Display->Priority}
+ paragraphs in tooltips(hints) {Settings panel->Display->Other}
+ possibility to set current date {context menu}
+ save dates list also in plain text {Settings panel->Export}
+ invisible export onto Excel (quickly) {Settings panel->Export}
+ scroll dates list to selected day (see KEYBOARD, MOUSE)
+ possibility to load dates list for choosed year {Settings panel->Dates->Limitation +}
+ extended context menu of calendar and dates list
+ more quick access for edit celebrations and personal dates (see MOUSE)

[1.7]
+ movable dates
+ particular dates
+ font format fol all date types in calendar {Settings panel->Display->Fonts}
+ possibility to enable/disable displaying of "Today" {Settings panel->Dates->Limitation}
+ saving dates list in RTF-format {Settings panel->Export}
+ user defined location of "Dates"-folder {Settings panel->Program}
* hotkey for show/hide settings panel change to 'S'

+ language file (Hungarian)
+ common dates set (Argentina, Spanish)
+ common dates set (USA, English)
+ common dates set (Hungary, Hungarian)

[1.6]
+ export calendar to Excel {Settings panel->Export}
/ fixed error with context menu (not right create)
/ now added dates always right away appear in calendar

[1.5]
 + editing personal dates from calendar {context menu}
 + date format
 + save size of not maximized calendar window
 * not execute disk write operations if program was run from CD
 * change dates list height by drag with the mouse
 * extended date sets will released in separated pack

 + language file (Slovak)
 + common dates set (Russia, Russian)
 + common dates set (Slovakia, Slovak)

[1.4]
 + new category of personal dates - celebrations (possibly editing from calendar {context menu})
 + message formats for celebrations (possibly editing from calendar {Settings panel->Dates->Sets->Button '>'})
 * changed keys for notes/celebrations editing (see KEYBOARD)
 * removed panels settings - now their state always save
 * extended calendar context menu

 + language file (Italian)
 + readme-file (Romanian)
 + readme-file (Italian)
 + common dates set (Luxembourg, French)
 + common dates set (Romania, Romanian)
 + common dates set (Italy, Italian)
 + common dates set samples (Romanian)
 + personal dates set sample (German)

[1.3]
 + possibility to use more that one events of the same type on one day in dates sets (symbol %n)
 * new interface for edit notes
 * {Settings->Display->Other} removed 'Thick frame of date', because new type of date marker was added - 'Thick frame'
 + font formatting of current date in calendar

 + language file (Czech)
 + language file (Romanian)
 + readme-file (Czech)
 + common dates set (Canada, English)
 + common dates set (France, French)
 * common dates set (Belgium, French)
 + common dates set (Czechia, Czech)
 + extended dates set (Czech, "Name-day")

[1.2]
 + possibility to use date with defined cycle
 + setting of dates displaying limitation
 + possibility to choose marker type for dates types
 * decreased time of dates list loading

 + common dates set (Poland, Polish)

[1.1]
 / now dates list display right in Windows98
 + new dates type - extended set
 + possibility to use date by number of week day in month relatively begin or end of month
 + fonts settings in separate file


 + language file (German)
 + language file (Polish)
 + language file (Spanish)
 + common dates set (Germany, German)
 + 2 extended dates sets (French, "Saint's days")
 + readme-file (German)
 + readme-file (Spanish)
 + personal dates set sample (German)

[1.01]
 / bug when you can't add notes
 + possibility add and delete personal sets directly in plugin
 + possibility do not choose one of dates set

 + language file (Dutch)
 + language file (French)
 + common dates set (Belgium, French)
 + readme-file (French)
 + personal dates set sample (French)