 Maximus, 2005__________________tcCalendar 2.0__________________mxmus@yandex.ru
Lister-plugin for Total Commander____________________________mxmus@maximus.in.ua

I. POPIS:
Univerzln kalend.
Umouje pouvat obecn a osobn zznamy rznch kategori a monost omezen jejich zobrazen.
Pro vtinu zznam je umonm speciln formt:
  - relativn ortodoxn velikonoce  - relativn katolick velikonoce
  - urit den tdne v msci       - data Julinskho kalende
  - pohybliv svtky                - udlosti s opakovnm
  - zvltn udlosti
 Vtinu soust mete konfigurovat jak je libo. 
 Kalend mete exportovat do excelu nebo jako obrzek (BMP) a uloit zznamy jako RTF nebo jako text.
 Pouitm externho modulu SunMoon.ecl tcCalendar zskte informace o slunci a msci.
 Kalend m vcejazyn rozhran (Czech, Danish, Dutch, English, French, German, Hellenic, Hungarian, Italian, Polish, Romanian, Russian, Slovak, Slovenian, Spanish, Ukrainian)

________________________________________________________________________________


II. INSTALACE:
 1. Rozbalte archiv do zvolenho adrese ([CLD_PATH])
 2. Nainstalujte plugin:
     - {Konfigurace->Nastaven...->Prohlen->Konfigurace internho prohlee...->Zs. moduly}
     - pidejte tcCld do seznamu
 3. Pidejte nov tlatko do lity:
     - {Konfigurace->Tlatkov lita...->Pidat}
     - vyplte pole nsledujcm zpsobem:
        - 'Pkaz' = "cm_List [CLD_PATH]\tcCld.TCCALENDAR"
        - 'Cesta' = "[CLD_PATH]"
        - 'Soubor ikon' = "[CLD_PATH]\tcCld.ico" nebo Vae vlastn ikona
     Poznmka: vechno pite bez uvozovek
 4. |voliteln| Mete pidat tcCalendar do nabdky 'Start':
     - {Start->Zmna Start Menu...->Pidat poloku}
     - vlote nzev poloky (napklad: "tcKalend")
     - vyplte pole nsledujcm zpsobem:
        - 'Pkaz' = "cm_List [CLD_PATH]\tcCld.TCCALENDAR"
        - 'Vchoz adres' = "[CLD_PATH]"
     Poznmka: vechno pite bez uvozovek
 5. |voliteln| Jestlie mte proveden 4. bod, mete nastavit klvesovou zkratku pro tcCalendar:
     - {Konfigurace->Nastaven...->Rzn}
     - zvolte vhodnou kombinaci klves ve skupin 'Pemapovn klvesnice'
     - V okn 'Pkaz', sekce "User" zvolte "cm_UserMenu" s slem tcCalendar ve 'Start' menu


________________________________________________________________________________

III. KLVESNICE:

    S  -  zobrazit/skrt panel nastaven
    D  -  zobrazit/skrt panel dat
    Y  -  zobrazit/skrt rok
    R  -  obnoven vpisu udlost
    C  -  znovunaten kalende
    G  -  posunout vpis zznam k oznaenmu dnu
    T  -  pejt na poadovan rok
 NUM+  -  dal rok
 NUM-  -  pedchoz rok
 NUM*  -  aktuln rok

Editace zznam:
 Ctrl+Del   - smazat zznam
 Ctrl+Ins   - pidat zznam
 Ctrl+<     - posun nahoru (mimo oslav)
 Ctrl+>     - posun dolu (mimo oslav)
 Ctrl+Enter - potvrzen zmn (tlatko 'OK')
________________________________________________________________________________
IV. MY:
Year panel:
 Dvoj-klik           - pejt na poadovan rok

V kalendi:
 Dvoj-klik           - editace zznam
 Ctrl+lev tlatko  - editace oslav
 Shift+lev tlatko - editace osobnch zznam
 Prostedn tlatko - posun vpis zznam na tento den
________________________________________________________________________________
V. DATOV SOUBORY:
 [CLD_PATH]\Dates\*.cdt - obecn svtky
 [CLD_PATH]\Dates\*.pdt - osobn zznamy
 [CLD_PATH]\Dates\*.edt - rozen svtky
 [CLD_PATH]\Dates\Void\*.cdt,*.pdt,*.edt - pklady datovch soubor (pro zkoprovn do "[CLD_PATH]\Dates")
Extern moduly:
 [CLD_PATH]\ExLib\*.ecl
 [CLD_PATH]\ExLib\SunMoon.ecl - modul pro zskn informac o Slunci a Msci
 SunMoon.ecl mete sthnout z http://maximus.in.ua/
Schema font:
 [CLD_PATH]\FontScheme\*.fnt
 [CLD_PATH]\tcCld.fnt - aktuln schema font
Jazykov soubory:
 [CLD_PATH]\Language\*.lng
Soubory s npovdou:
 [CLD_PATH]\ReadMe\readme_*.txt
________________________________________________________________________________
VI. FORMT DATOVCH SOUBOR
________________________________________________________________________________
|Typ |Sekce          |Formt            |Koment
_|____|_______________|__________________|______________________________________
1|pdt |[Notes]        |dd.mm.yyyy=zznamy|zznam
 |    |               |                  |dd = <den>
 |    |               |                  |mm = <msc>
 |    |               |                  |yyyy = <rok>
_|____|_______________|__________________|______________________________________
2|cdt |[MainDates]    |dd.mm=udlosti    |prost zznam
 |    |[Dates]        |                  |dd = <den>
 |    |[Religious]    |                  |mm = <msc>
_|    |[PersonalDates]|__________________|______________________________________
3|pdt |[Celebrations] |ROEx=udlosti     |relativn datum od pravoslavnch velikonoc
 |edt |[Extended]     |                  |x = <dny_ped>
 |    |               |                  |x = -<dny_po>
_|    |               |__________________|______________________________________
4|    |               |RCEx=udlosti     |relativn datum od katolickch velikonoc
 |    |               |                  |x = <dny_ped>
 |    |               |                  |x = -<dny_po>
_|    |               |__________________|______________________________________
5|    |               |WDMwn=udlosti    |udlost konkrtn den tdne v msci
 |    |               |                  |                  (pro vechny msce)
 |    |               |                  |w = <den_v_tdnu>
 |    |               |                  |                     [0..6]  0-nedle
 |    |               |                  |n = <poad_od_zatku_msce>
 |    |               |                  |n = -<poad_od_konce_msce>
_|    |               |__________________|______________________________________
6|    |               |WDMwn.mm=udlosti |udlost konkrtn den tdne v msci
 |    |               |                  |                 (pro konkrtn msc)
 |    |               |                  |w = <den_v_tdnu>  
 |    |               |                  |                      [0..6]  0-nedle
 |    |               |                  |n = <poad_od_zatku_msce>
 |    |               |                  |n = -<poad_od_konce_msce>
 |    |               |                  |mm = <msc>
_|    |               |__________________|______________________________________
7|    |               |PDw.dd=udlost    |Zvltn udlost
 |    |               |                  |w = <den_v_tdnu>
 |    |               |                  |dd = <den>
_|    |               |__________________|______________________________________
8|    |               |PDYnnn=udlost    |Zvltn udlost
 |    |               |                  |nnn = <den_v_roce>
_|    |               |__________________|______________________________________
9|    |               |Jdd.mm=udlost    |Udlost podle julinskho kalende
 |    |               |                  |dd = <den>
 |    |               |                  |mm = <msc>
_|____|_______________|__________________|______________________________________
1|pdt |[PersonalDates]|CDccc:dd.mm.yyyy  |opakujc se udlost
0|    |               |  -dd.mm.yyyy     |ccc = <dny_v_cyklu>  
 |    |               |  =udlosti       |
 |    |               |                  |dd.mm.yyyy (prvn skupina) = <zatek>
 |    |               |                  |                     <poten_datum>
 |    |               |                  |dd.mm.yyyy (druh skupina) =
 |    |               |                  |                    <konen_datum>
_|____|_______________|__________________|______________________________________
1|.cdt|[MainDates]    |MDdate:l,r>dti    |Pohybliv zznam (krtk formt)
1|    |[Dates]        |           =zznam|l = <lev_den_v_tdnu>
 |    |[Religious]    |                  |r = <prav_den_v_tdnu>
 |.pdt|[PersonalDates]|                  |t = <clov_den_v_tdnu>
 |    |[Celebrations] |                  |               l,r,t - [0..6] 0-nedle
 |.edt|[Extended]     |                  |d = <smr_pesunu>
 |    |               |                  |                N - dal, P - pedchz
 |    |               |                  |i = <ignorovat>
 |    |               |                  |                 I - bude zobrazeno pouze
 |    |               |                  |             v ppadech kdy se pesouv
 |    |               |                  |date = datumov formt 2,3,4
_|    |               |__________________|______________________________________
1|    |               |MDdate:l1,r1>dt1  |Pohybliv zznam (dlouh formt)
2|    |               |:l2,r2>dt2i=zznam|                    jako krtk formt,
 |    |               |                  |             ale obsahuje dv podmnky
_|    |               |__________________|______________________________________
1|    |               |MDdd.mm:WDMwn>    |Pohybliv zznam (relativn formt)
3|    |               |   WDMwn.mm=zznam|dd = <den>
 |    |               |                  |mm = <msc>
 |    |               |                  |w = <den_v_tdnu>
 |    |               |                  |                       [0..6] 0-nedle
 |    |               |                  |n = <relativn_poet_msc_zatek>
 |    |               |                  |n = -<relativn_poet_msc_konec>
_|    |               |__________________|______________________________________
1|    |               |MDdate:WDMwn.mm>  |Movable date (Easter relative format)
4|    |               |   WDMwn.mm=zznam|w = <den_v_tdnu>
 |    |               |                  |                       [0..6] 0-nedle
 |    |               |                  |n = <relativn_poet_msc_zatek>
 |    |               |                  |n = -<relativn_poet_msc_konec>
 |    |               |                  |date = datumov formt 3,4
_|____|_______________|__________________|______________________________________

POZNMKY:
  1. zznamy = zznam_1%nzznam_2%n ... %nzznam_X
       pro oslavy - .pdt [Celebrations]:
       zznam_i = jmno oslavy#poten_rok_oslavy#slo_formtu
       slo_formtu = slo_formtu v seznamu formt (>=-1, -1 - defaultn formt)
                                           {Volby->Svtky->Nastaven->Tlatko '>'}
  2. udlosti = udlost_1%nudlost_2%n ... %nudlost_X
  3. Obecn formt pohyblivch udlost:
       MDvchoz_datum:podmnka_pesunu>clov_datum
       MDvchoz_datum:podmnka_pesunu_1>clov_datum_1:podmnka_pesunu_2>clov_datum_2 (dlouh formt)
  4. Zznamy je mon editovat pmo z kalende (viz MY)
________________________________________________________________________________
PKLADY:
  ROE0=Velikonoce              23.04=John - narozeniny%nPetr - narozeniny
  ROE49=Trinity                WDM02=druh nedle v msci (kad msc)
  ROE-7=Palm Sunday            WDM3-1=posledn steda v msci (kad msc)
  RCE0=Katolick velikonoce    WDM51.11=prvn ptek v listopadu
  PD5.13=ptek 13.
  PDY256=Den programtor


  J25.12=vnoce
    Pravoslavn crkev slav vnoce (a mon i jin svtky) starm zpsobem
    (Julinsk kalend)
    Nyn je rozdl mezi Gregorinskm a Julinskm kalendem 13 dn, ale od
    1. bezna 2100 to bude 14 dn, a ped 1. beznem 1900 to bylo 12 dn.
  CD015:14.09.2005-03.05.2006=Cyklick udlost
    bude se opakovat kadch 15 dn ponaje 14.09.2005, ale ne po 03.05.2006
  MD02.04:2,3>P1:4,5>N1=2.dubna svtek v Argentin
    Jestlie 2.dubna je ter nebo steda, potom se svtek pesouv na pedchoz Pondl,
    kdy je to tvrtek nebo ptek - na nsledujc pondl, v ostatnch ppadech se nepesouv.
  MD01.01:6,6>N1:0,0>N1=Dodaten svtek Novho roku na Ukrajin
         MD01.01:6,0>N1=Dodaten svtek Novho roku na Ukrajin
    Na Ukrajin, jestlie je sttn svtek (vetn Novho roku) v sobotu nebo v nedli,
    potom se pidv jeden svtek na nsledujc pondl.
  MD01.01:6,0>N1I=Dodaten svtek Novho roku na Ukrajin
    Jestlie je pidno 'I' na konci pohybliv udlosti v krtkm nebo dlouhm formtu,
    potom se zznam zobraz pouze kdy dojde k pesunu.

  MD01.05:WDM01>WDM02.05=1.kvtna svtek kdekoliv
    Jestlie 1.kvtna je prvn nedle v msci, potom se svtek pesouv na druhou nedli v kvtnu.

________________________________________________________________________________

VII. FORMT OSLAV:
 {Volby->Svtky->Nastaven->Tlatko '>'}
Speciln symboly:
[N] - Jmno oslavy
[Y] - Poten rok
[A] - Vro oslavy
Napklad, pokud chcete vidt tento text:
"Je to pesn 10 let, co se nm narodil Filip. Toto tst ns postihlo v roce 1995."
muste vytvoit nsledujc formt:
"Je to pesn [A] let, co se nm narodil [N]. Toto tst ns postihlo v roce [Y]."
a zvolit tento formt pi editaci oslavy (kalend - kontextov menu) ve tetm sloupci tabulky.
________________________________________________________________________________

VIII. FORMT DATA:
 {Volby->Zobrazen->Ostatn->Formt data}
Speciln symboly:
[D] - Den
[M] - Msc slem
[L] - Msc slovn
[A] - Msc slovn (2. pd)
[Y] - Rok
[S] - Rok zkrcen
[J] - Julinsk datum
[W] - Den v tdnu
[B] - Zkratka dne v tdnu
 \t - tabultor (pro vpis udlost)

Pklad:
 Julinsk datum: j[D].[M] = j03.08
 Formt data ve vpisu: [L] [D], [Y] ([J]) = Srpen 16, 2005 (j03.08)
                        [D].[A] [Y] = 16.srpna 2005
________________________________________________________________________________
IX. FORMT ASU:
 {Volby->as->Formt asu}
Speciln symboly:
[H] - Hodiny
[T] - Hodiny (12-hodinov formt)
[M] - Minuty
[S] - Sekundy
Pklady:
 [H]:[M] = 16:09
 [T]:[M] = PM04:09
________________________________________________________________________________
X. FORMT HLAVIKY TYPU DATA:
 {Volby->Npovdn text->Obsah npovdnch text->Upravit formt}
Obecn speciln symboly:
\n  - nov dek
\t  - tabultor

Dnes:
  Speciln symboly:
    [T] - Dnes
  Pklad:
    :::: [T] :::: = :::: Dnes ::::

Hlavika typu svtku:
  Speciln symboly:
    [N] - Jmno typu svtku
  Pklad:
    ::++ [N] ++:: = ::++ Sttn svtek ++::
________________________________________________________________________________
Formt informac o Slunci a Msci:
  Speciln symboly:
    [SR] - Vchod Slunce
    [SS] - Zpad Slunce
    [MR] - Vchod Msce
    [MS] - Zpad Msce
    [PP] - Fze Msce (v procentech)
    [PN] - Jmno msn fze

  Pklad:
     Slunce & Msc:\nSlunce vychz v [SR] a zapad v [SS]\nMsc vychz v [MR] a zapad v [MS]\nFze Msce: "[PN]" [PP]%
     =
     Slunce & Msc:
     Slunce vychz v 03:52 a zapad v 20:13
     Msc vychz v 12:17 a zapad v 00:36
     Fze Msce: "Prvn tvr" 50%
________________________________________________________________________________

XI. POUIT PARAMETR PRO FORMT FONT:
 {Volby->Zobrazen->Psma}
________________________________________________________________________________
                | N/U      | U/O   | U/A
________________|__________|_______|____________________________________________
Rok             | VA       |       |
Pozad          |          | FC BC | FC={barva pozad seznamu udlost}
                |          |       | BC={barva pozad kalende}
Mka kalende|          | BC    | BC={barva mky}
... [Datum]     | VA HA    |       | BC={... znaka barvy}
... [Text]      | VA HA BC |       |
________________|__________|_______|____________________________________________
Zkratky:
 N/U - nelze pout  U/O - lze pout  U/A - zpsob pouit
 VA - svisl zarovnn    FC - barva znak
 HA - vodorovn zarovnn  BC - barva pozad
________________________________________________________________________________

XII. EEN PROBLM:
 V nkterch verzch Windows (vtinou Windows 2000) se vpis udlost nezobrazuje korektn.
 Pro odstrann problmu zkoprujte soubor disk:\WINDOWS\SYSTEM32\riched20.dll (z Windows 98 nebo XP) do odpovdajcho adrese (ve Windows 2000 - disk:\WINNT\SYSTEM32\)
     disk - disk, kde je instalovn OS
________________________________________________________________________________
XIII. MATERILY:
 Pro zskn informac o Slunci a Msci byla pouita st aplikace TMoon.
     Andreas Horstemeier
     andy@hoerstemeier.de
     http://www.hoerstemeier.com
 Jako hlavn informace pro urovn souadnic mst (tcCld.lct) byl pouit soubor cities.dat z Calendar wfx-plugin.
     Fabio Chelly,
     fabio@chelly.net
     http://totalcommander.free.fr/fabio/calendar.zip
________________________________________________________________________________
XIV. HISTORIE:
[+] - pidno  [/] - opraveno  [*] - zmnno

[2.0]
+ uloen tabulky kalende jako bitmapa (BMP) {Volby->Export}
+ schemata font {Volby->Zobrazen->Psma}
+ nastaven obsahu npovdnch text {Volby->Npovdn text->Obsah npovdnch text} (viz X. TOOLTIP FORMAT)
+ manuln zadn souadnic {Volby->as a poloha}
+ nastaven pozice okna pi sputn {Volby->Program}
+ tlatka pro skryt vpisu udlost a zobrazen roku
+ odsazen text {Volby->Zobrazen->Psma}
+ klvesa pro pechod na aktuln rok - NUM*

[1.9]
+ zskn informac o Slunci a Msci pouitm externho modulu {Volby->Npovdn text->Slunce a Msc}
      (viz EXTERN MODULY, FORMT INFORMAC O SLUNCI A MSCI)
      Vbr msta a formtu asu {Volby->as} (viz FORMT ASU)
+ hlaviky pro typy data v npovdnch textech {Volby->Npovdn text->Hlavika typu data}
      (viz FORMT HLAVIKY TYPU DATA)
+ den v tdnu v dlouhm formtu data a formt data ve vpisu udlost (viz FORMT DATA)
+ podpora pohyblivch udlost pro .cdt [Religious] a .edt [Extended]
+ nov formt pohyblivch udlost (relativn formt velikonoc)
+ monost nastaven velikosti a skrvn panelu rok

+ soubor svtk (Austria, German)

[1.8]
/ podpora soubor svtk delch ne 64 Kb s etzci delmi ne 2 Kb
/ opravena chyba v pohyblivch udlostech (nezobrazovalo se pi pesunu z pedchozho/nsledujcho roku)
/ uvaovn rozdl mezi Julinskm a Gregorinskm kalendem pro vpoet Ortodoxnch velikonoc
+ Julinsk data v datovch souborech (viz formt datovch soubor/9, PKLADY)
+ Julinsk data ve vpisu {Panel nastaven->Zobrazen->Ostatn->Date format} (viz FORMT DATA)
+ Julinsk data v npovdnch textech kalende {Panel nastaven->Svtky->Omezen +}
+ doplnk k pohyblivm udlostem ('I' kl, viz formt datovch soubor/11, PKLADY)
+ doplnk k pohyblivm udlostem (limity od 6 do 2, viz PKLADY)
+ doplnk ke zvltnm udlostem (den v roce, viz formt datovch soubor/8, PKLADY)
+ priority zznam a formt {Panel nastaven->Zobrazen->Priority}
+ odstavce v npovdnch textech {Panel nastaven->Svtky->Ostatn}
+ monost nastaven aktulnho data {kontextov menu}
+ uloen vpisu udlost i jako prost text {Panel nastaven->Export}
+ skryt export do excelu (rychlej) {Panel nastaven->Export}
+ posun vpisu udlost na vybran den (viz KLVESNICE, MY)
+ monost nahrt seznam udlost pro vybran rok {Panel nastaven->Svtky->Omezen +}
+ rozen kontextov menu v kalendi a ve vpisu udlost
+ rychlej pstup k editaci zznam (viz MY)
+ jazykov soubor (Hellenic)
+ soubor svtk (Hellas, Hellenic)
+ pklad souboru svtk (Hellenic)


[1.7]
+ pohybliv udlosti
+ zvltn udlosti
+ volba psma pro vechny typy zznam v kalendi {Panel nastaven->Zobrazen->Psma}
+ monost povolit/zakzat zobrazen "Dnes" {Panel nastaven->Svtky->Omezen}
+ uloen seznamu udlost do formtu RTF {Panel nastaven->Export}
+ monost volby umstn adrese zznam {Panel nastaven->Program}
* klvesa zobrazit/skrt panel nastaven zmnna na 'S'

[1.6]
+ export kalende do Excelu {Panel voleb->Export}
/ opravena chyba s kontextovm menu
/ prv pidan zznamy se objev v kalendi okamit

[1.5]
 + editace osobnch zznam z kalende {kontextov menu}
 + voliteln formt data
 + uloen pozice nemaximalizovanho okna
 * neprovdn zpisu pokud byl program sputn z CD
 * vku panelu udlost lze mnit taenm my
 * rozen datov soubory budou vydvny samostatn

 + jazykov soubor (Slovak)
 + soubor svtk (Russia, Russian)
 + soubor svtk (Slovakia, Slovak)

[1.4]
 + nov kategorie osobnch zznam - oslavy (monost editace z kalende {kontextov menu})
 + formty upozornn oslav (monost editace z kalende {Volby->Svtky->Nastaven->Tlatko '>'})
 * zmna klves pro editaci zznam/svtk (viz KLVESNICE)
 * odstranno nastaven panel - nyn se nastaven vdy ukld
 * rozeno kontextov menu kalende

 + jazykov soubor (Italian)
 + readme-soubor (Romanian)
 + readme-soubor (Italian)
 + soubor svtk (Luxembourg, French)
 + soubor svtk (Romania, Romanian)
 + soubor svtk (Italy, Italian)
 + pklad souboru svtk (Romanian)
 + pklad osobnch zznam (German)

[1.3]
 + monost pouit vce udlost stejnho typu ve stejn den v datovch souborech (symbol %n)
 * nov prosted pro editaci zznam
 * {Volby->Zobrazen->Ostatn} odstranna volba 'Tun rmeek oznaenho data', protoe byl pidn nov typ zvraznn - 'Tun rmeek'
 + nastaven psma pro aktuln datum v kalendi

 + jazykov soubor (Czech)
 + jazykov soubor (Romanian)
 + readme-soubor (Czech)
 + soubor svtk (Canada, English)
 + soubor svtk (France, French)
 * soubor svtk (Belgium, French)
 + soubor svtk (Czechia, Czech)
 + rozen soubor svtk (Czech, "Name-day")

[1.2]
 + monost pouit udlost s opakovnm
 + nastaven omezen pro zobrazen dat
 + monost vbru zpsobu zvraznn dne pro jednotliv typy dat
 * zkrcen as pro naten seznamu dat
 
 + soubor svtk (Poland, Polish)

[1.1]
 / nyn seznam dat pracuje korektn ve Windows98
 + nov typy svtk - rozen nastaven
 + monost pouit data konkrtnho dne v tdnu od zatku nebo konce msce
 + seznam font v oddlenm souboru
 
 + jazykov soubor (German)
 + jazykov soubor (Polish)
 + jazykov soubor (Spanish)
 + soubor svtk (Germany, German)
 + 2 rozen soubory svtk (French, "Saint's days")
 + readme-soubor (German)
 + readme-soubor (Spanish)
 + pklad osobnch zznam (German)

[1.01]
 / opravena chyba nemonosti pidvn zznam
 + monost pidn a odstrann osobnch soubor pmo v aplikaci
 + monost nevybrn dnho datovho souboru

 + jazykov soubor (Dutch)
 + jazykov soubor (French)
 + soubor svtk (Belgium, French)
 + readme-soubor (French)
 + pklad osobnch zznam (French)


