 Maximus, 2005-2006____________tcCalendar 2.5___________mailto:mxmus@rambler.ru
Lister-plugin for Total Commander___________________________http://maximus.in.ua

Dansk ved: Peter H. S. Madsen (petermad) peter@madsenworld.dk
________________________________________________________________________________
I. BESKRIVELSE:
 Universel kalender.
 Tillader brug af generelle og personlige aftaler i forskellige kategorier.
 For de fleste datatyper findes specielle formater:
  - relativ Katolsk Pske                 - relativ Ortodoks Pske
  - efter ugedagens nummer i mneden      - Julianske datoer
  - forskydelige datoer                   - cykliske datoer
  - srlige datoer

 Du kan konfigurere nsten ethvert element i kalenderen som du vil.
 Du kan eksportere kalendertabellen til Excel eller gemme den som bitmap (BMP), og datolisten kan gemmes som RTF eller ren Tekstfil.


 Kalenderen bestr af to dele (tabel og datoliste), for hvilke man kan definere formatet for hvert af deres elementer.
 I datolisten kan man begrnse det viste antal af datoer henholdsvis fr og efter dags dato.
 Man kan eksportere kalendertabellen til Excel og datolisten kan gemmes som RTF eller ren Tekstfil.
 Ved hjlp af det eksterne modul SunMoon.ecl kan tcCalendar vise information om Sol og Mne.
 Kalenderen har et interface p flere sprog (Kinesisk, Tjekkisk, Dansk, Hollandsk, Engelsk, Fransk, Tysk, Ungarnsk, Gsk, Italiensk, Polsk, Rumnsk, Russisk, Slovakisk, Spansk, Ukrainsk)
________________________________________________________________________________
II. SETUP:
 1. Udpak zip-filen i sin egen mappe ([CLD_PATH])
 2. Installer plugin:
     - {Opstning -> Indstillinger... -> Rediger/Vis -> Indstilling af intern fremviser... -> LS-plugins}
     - tilfj tcCld.wlx til plugin listen
 3. Tilfj ny knap til knappanel:
     - {Opstning -> ndre knappanel... -> Tilfj}
     - udfyld felterne sledes:
        - 'Kommando' = "cm_List [CLD_PATH]\tcCld.TCCALENDAR"
        - 'Start-mappe' = "[CLD_PATH]"
        - 'Ikonfil' = "[CLD_PATH]\tcCld.ico" eller vlg selv en ikon
     OBS: medtag ikke anfrselstegnene nr felterne udfyldes
 4. |valgfrit| Man kan fje tcCalendar til 'Startmenu'en:
     - {Start -> ndre Startmenu... -> Tilfj punkt...}
     - angiv et navn for menupunktet (for eksempel: "tckalender")
     - udfyld felterne sledes:
        - 'Kommando' = "cm_List [CLD_PATH]\tcCld.TCCALENDAR"
        - 'Start-mappe' = "[CLD_PATH]"
     OBS: medtag ikke anfrselstegnene nr felterne udfyldes
 5. |valgfrit| Hvis punkt 4 er udfrt, kan man definere en genvejstast for tcCalendar:
     - {Opstning -> Indstillinger... -> Diverse}
     - vlg en bekvem kombination under 'Omdefiner genvejstaster'
     - i 'Kommando' listen under "|___User___|" vlges "cm_UserMenu#" med det # som tcCalendar har i 'Startmenu'en
________________________________________________________________________________
III. TASTATUR:
 NUM+ - nste r
 NUM- - forrige r
    S - vis/gem indstillingspanel
    D - vis/gem datoliste
    Y - vis/gem rstalspanel
    R - genindls datoliste
    C - genindls kalendertabel
    G - rul datoliste til valgte dag
    T - g til det nskede r
 NUM+ - nste r
 NUM- - forrige r
 NUM* - indevrende r

Redigering af Noter/Mrkedage/Personlige aftaler/Formater for mrkedage:
 Ctrl+Del          - slet
 Ctrl+Ins, Ctrl+I  - tilfj
 Ctrl+<            - flyt op (undtagen i Formater for mrkedage)
 Ctrl+>            - flyt ned (undtagen i Formater for mrkedage)
 Ctrl+Enter        - udfr ndringer ('OK' knap)
________________________________________________________________________________
IV. MUS:
rstalspanel:
 Dobbeltklik       - g til det nskede r
kalendertabel:
 Dobbeltklik       - rediger noter
 Ctrl+venstreklik  - rediger mrkedage
 Skift+venstreklik - rediger personlige aftaler
 Midterklik        - rul datoliste til denne dag
________________________________________________________________________________
V. FILER:
Datost:
 [CLD_PATH]\Dates\*.cdt - Basale datost
 [CLD_PATH]\Dates\*.pdt - Personlige datost
 [CLD_PATH]\Dates\*.edt - Udvidet datost
 [CLD_PATH]\Dates\Void\*.cdt,*.pdt,*.edt - eksempler p datost (for brug - kopier til "[CLD_PATH]\Dates")
Eksterne moduler:
 [CLD_PATH]\ExLib\*.ecl
 [CLD_PATH]\ExLib\SunMoon.ecl - modul til at f information om Sol og Mne
     Du kan downloade SunMoon.ecl fra http://maximus.in.ua
Tegnst-temaers:
 [CLD_PATH]\FontScheme\*.fnt
 [CLD_PATH]\tcCld.fnt - nuvrende tegnst-tema
Sprogfiler:
 [CLD_PATH]\Language\*.lng
Hjelpefiler:
 [CLD_PATH]\ReadMe\readme_*.txt
________________________________________________________________________________
VI. FORMAT AF DATOSTFILER:
________________________________________________________________________________
N|Type|Afdeling       |Format            |Kommentarer
_|____|_______________|__________________|______________________________________
1|.pdt|[Notes]        |dd.mm.yyyy=noter  |Note
 |    |               |                  |dd = <dag>
 |    |               |                  |mm = <mned>
 |    |               |                  |yyyy = <r>
_|____|_______________|__________________|______________________________________
2|.cdt|[MainDates]    |dd.mm=beskrivelse |Simpel dato
 |    |[Dates]        |                  |dd = <dag>
 |    |[Religious]    |                  |mm = <mned>
_|.pdt|[personalDates]|__________________|______________________________________
3|    |[Celebrations] |ROEx=beskrivelse  |Dato relativt til ortodoks Pske
 |.edt|[Extended]     |                  |x = <dage_efter_ortodoks_Pske>
 |    |               |                  |x = -<dage_fr_ortodoks_Pske>
_|    |               |__________________|______________________________________
4|    |               |RCEx=beskrivelse  |Dato relativt til katolsk Pske
 |    |               |                  |x = <dage_efter_katolsk_Pske>
 |    |               |                  |x = -<dage_fr_katolsk_Pske>
_|    |               |__________________|______________________________________
5|    |               |WDMwn=beskrivelse |Dato efter ugedagens nummer i mneden
 |    |               |                  |                    (for alle mneder)
 |    |               |                  |w = <ugedag>
 |    |               |                  |                       [0..6] 0=sndag
 |    |               |                  |n = <nummer_relativt_til_mned_start>
 |    |               |                  |n = -<nummer_relativt_til_mned_slut>
_|    |               |__________________|______________________________________
6|    |               |WDMwn.mm=         |Dato efter ugedagens nummer i mneden
 |    |               |      beskrivelse |                (for konkrete mneder)
 |    |               |                  |w = <ugedag>
 |    |               |                  |                       [0..6] 0=sndag
 |    |               |                  |n = <nummer_relativt_til_mned_start>
 |    |               |                  |n = -<nummer_relativt_til_mned_slut>
 |    |               |                  |mm = <mned>
_|    |               |__________________|______________________________________
7|    |               |PDw.dd=beskrivelse|Srlig dato
 |    |               |                  |w = <ugedag>
 |    |               |                  |dd = <dag>
_|    |               |__________________|______________________________________
8|    |               |PDYnnn=beskrivelse|Srlig dato
 |    |               |                  |nnn = <dag_i_ret>
_|    |               |__________________|______________________________________
9|    |               |Jdd.mm=beskrivelse|Juliansk kalenderdato
 |    |               |                  |dd = <dag>
 |    |               |                  |mm = <mned>
_|____|_______________|__________________|______________________________________
1|.pdt|[personalDates]|CDccc:dd.mm.yyyy- |Cyklisk dato
0|    |               |      dd.mm.yyyy= |ccc = <dage_i_cyklus>
 |    |               |      beskrivelse |dd.mm.yyyy (frste gruppe) =
 |    |               |                  |            <venstre_afgrnsning_dato>
 |    |               |                  |dd.mm.yyyy (anden gruppe) =
 |    |               |                  |            <hjre_afgrnsning_dato>
_|____|_______________|__________________|______________________________________
1|.cdt|[MainDates]    |MDdate:l,r>dti=   |Forskydelig dato (kort format)
1|    |[Dates]        |      beskrivelse |l = <venstre_ugedag>
 |    |[Religious]    |                  |r = <hjre_ugedag>
 |.pdt|[personalDates]|                  |t = <ml_ugedag>
 |    |[Celebrations] |                  |               l,r,t - [0..6] 0=sndag
 |.edt|[Extended]     |                  |d = <flyt_retning>
 |    |               |                  |             N - flgende, P - forrige
 |    |               |                  |i = <ignorer>
 |    |               |                  |             I - vil kun blive vist,
 |    |               |                  |                 hvis dagen flyttes
 |    |               |                  |date = datoformat 2,3,4
_|    |               |__________________|______________________________________
1|    |               |MDdate:l1,r1>dt1  |Forskydelig dato (langt format)
2|    |               | :l2,r2>dt2i=     |             som kort format, men
 |    |               |      beskrivelse |             indeholder to betingelser
_|    |               |__________________|______________________________________
1|    |               |MDdd.mm:WDMwn>    |Forskydelig dato (relativt format)
3|    |               |        WDMwn.mm= |dd = <dag>
 |    |               |      beskrivelse |mm = <mned>
 |    |               |                  |w = <ugedag>
 |    |               |                  |                       [0..6] 0=sndag
 |    |               |                  |n = <nummer_relativt_til_mned_start>
 |    |               |                  |n = -<nummer_relativt_til_mned_slut>
_|    |               |__________________|______________________________________
1|    |               |MDdate:WDMwn.mm>  |Forskydelig dato (Pske relativt format)
4|    |               |        WDMwn.mm= |w = <ugedag>
 |    |               |      beskrivelse |                       [0..6] 0=sndag
 |    |               |                  |n = <nummer_relativt_til_mned_start>
 |    |               |                  |n = -<nummer_relativt_til_mned_slut>
 |    |               |                  |date = datoformat 3,4
_|____|_______________|__________________|______________________________________
Bemrkninger:
  1. datoer = dato_1%ndato_2%n ... %ndato_X
       for mrkedage - .pdt [Celebrations]:
       date_i = mrkedag_navn#mrkedag_start_r#format_nummer
       format_nummer = formatnummer i formatlisten (>= 0, 0 = standardformat)
                                       {Indstillingspanel -> Datost -> St -> '>' (knap)}
  2. noter = note_1%nnote_2%n ... %nnote_X
  3. basalt format for forskydelig dato:
       MDkilde_dato:flytte_betingelse>ml_dato
       MDkilde_dato:flytte_betingelse_1>ml_dato_1:flytte_betingelse_2>ml_dato_2 (langt format)
  4. Det er muligt at redigere noter og simple datoer (dd.mm), inklusive mrkedage, fra tcCalendar (se MUS)
________________________________________________________________________________
Eksempler:
  ROE0=Pskedag                          23.04=John's birthday%nPeter's birthday
  ROE49=Pinsedag                         WDM02=Anden sndag i hver mned
  ROE-7=Palmesndag                      WDM3-1=Sidste onsdag i hver mned
  RCE0=Katolsk Pske                     WDM51.11=Frste fredag i november
  PD5.13=Fredag d. 13.
  PDY256=Programmers day

  J25.12=Jul
    Ortodokse kirke fejrer Jul (og mske andre dage) i gammel stil (Juliansk kalender).
    Nu er forskellen p den Gregorianske og den Julianske kalender 13 dage, men fra
    1. marts 2100 vil den vre 14 dage, og fr 1. marts 1900 var den 12 dage.
  CD015:14.09.2005-03.05.2006=Cyklisk dato
    Vil blive gentaget hver 15. dag startende fra 14.09.2005, men ikke senere end 03.05.2006.
  MD02.04:2,3>P1:4,5>N1=2. april, helligdag i Argentina
    Hvis 2. april er en tirsdag eller onsdag, flyttes helligdagen til forrige mandag,
    hvis den er en torsdag eller fredag flyttes den til nste mandag, i andre tilfde flyttes den ikke.
  MD01.01:6,6>N1:0,0>N1=Ekstra helligdag for Nytr i Ukraine
         MD01.01:6,0>N1=Ekstra helligdag for Nytr i Ukraine
    I Ukraine, hvis den nationale helligdag (inklusiv Nytr) er en Lrdag eller sndag,
    s tilfjes en ekstra helligdag flgende mandag.
  MD01.01:6,0>N1I=Ekstra helligdag for Nytr i Ukraine
    Nr der tilfjes 'I' i slutningen af den forskydelige dato (kort eller langt format), s vil datoen
    kun blive vist hvis den flyttes.
  MD01.05:WDM01>WDM02.05=1. maj, helligdag nogen steder
    Hvis 1. maj er den frste sndag i mneden, s flyttes helligdagen til anden sndag i maj.
________________________________________________________________________________
VII. MRKEDAGE FORMAT:
 {Indstillingspanel -> Datost -> St -> '>' (knap)}
Specielle symboler:
[N] - Mrkedag navn
[Y] - Mrkedagens start-r
[A] - Mrkedagens antal r
For eksempel, hvis du nsker en meddelse som:
"Denne dag, for 10 r siden, blev vores kre Johnny fdt. Denne mindevrdige begivenhed fandt sted i ret 1995."
s m du tilfje et format som ser sledes ud:
"Denne dag, for [A] r siden, blev vores kre [N] fdt. Denne mindevrdige begivenhed fandt sted i ret [Y]."
og derefter vlge dette format i tredje kolonne, nr du tilfjer/redigerer mrkedagen.
________________________________________________________________________________
VIII. DATOFORMAT:
 {Indstillingspanel -> Vis-> Andet -> Datoformat}
Specielle symboler:
[D] - Dag (tal)
[M] - Mned (tal)
[L] - Mned (fuldt navn)
[A] - Mned (forkortet)
[Y] - r (langt format, fire cifre)
[S] - r (kort format, to cifre)
[W] - Ugedag (fuldt navn)
[B] - Ugedag (forkortet)
[J] - Juliansk dato
Eksempel:
 Juliansk datoformat: j[D].[M] = j03.08
 Datoliste datoformat: [L] [D], [Y] ([J]) = August 16, 2005 (j03.08)
________________________________________________________________________________
IX. TIDSFORMAT:
 {Indstillingspanel -> Visning -> Tidsformat}
Special symbols:
[H] - Timer (24-timers format)
[T] - Timer (12-timers format)
[M] - Minutter
[S] - Sekunder
Eksempel:
 [H]:[M] = 16:09
 [T]:[M] = PM04:09
________________________________________________________________________________
X. TOOLTIP FORMAT:
 {Indstillinger -> Ballonhjlp -> Indhold af ballonhjlp -> Formater}
Almindelige specialle tegn:
\n  - lijeskift
\t  - tab

Idag:
  Specielle symboler:
    [T] - Idag
  Eksempel:
    :::: [T] :::: = :::: Idag ::::

Datotype-overskrift:
  Specielle symboler:
    [N] - Datotype navn
  Eksempel:
    ::++ [N] ++:: = ::++ Nationale helligdage ++::

Sol og Mne information:
  Specielle symboler:
    [SR] - Sol op
    [SS] - Sol ned
    [MR] - Mne op
    [MS] - Mne ned
    [PP] - Mnefase (i procent)
    [PN] - Mnefase navn
  Eksempel:
    Sol & Mne:\nSun op [SR]\nSol ned [SS]\nMne op [MR]\nMne ned [MS]
    =
    Sol & Mnen:
    Sol op 03:49
    Sol ned 20:12
    Mne op 00:26
    Mne ned 14:12
________________________________________________________________________________
XI. SPIDSFINDIGHEDER MED SKRIFTTYPEINDSTILLINGER:
 {Indstilingspanel -> Vis -> Skrifttyper}
________________________________________________________________________________
            | I/B      | B/K   | B/S
____________|__________|_______|________________________________________________
r          | LJ       |       |
Baggrund    |          | SF BF | SF={baggrundsfarve i datoliste}
            |          |       | BF={baggrundsfarve i kalender}
Gitter      |          | SF BF | SF={kalender gitterfarve}
            |          |       | BF={datoliste gitterfarve}
... [Dato]  |          |       | BF={... markeringsfarve}
____________|__________|_______|________________________________________________
Forkortelser:
 I/B - ikke brugt  B/K - brug kun  B/S - brug som
 LJ - lodret justering    SF - skriftfarve
 VJ - vandret justering   BF - baggrundsfarve
________________________________________________________________________________
XII. PROBLEM-ELIMINERING:
________________________________________________________________________________
XIII. MATERIALE:
 For information om Sol og Mne er brugt en del af TMoon komponenten.
     Andreas Horstemeier
     andy@hoerstemeier.de
     http://www.hoerstemeier.com
 Som indledende information til at lave by-placeringsfilen (tcCld.lct) er filen cities.dat fra Calendar wfx-plugin brugt.
     Fabio Chelly,
     fabio@chelly.net
     http://totalcommander.free.fr/fabio/calendar.zip
________________________________________________________________________________
XIV. HISTORE:
[+] - tilfjet  [/] - ordnet  [*] - ndret

[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 and Location} (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)
+ support 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 kalender 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 kalender 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 kalender and dates list
+ more quick access for edit celebrations and personlig dates (see MOUSE)

+ language file (Hellenic)
+ common dates set (Hellas, Hellenic)
+ dates set samples (Hellenic)

[1.7]
+ movable dates
+ particular dates
+ font format fol all date types in kalender {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 vis/gem 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 kalender to Excel {Settings panel->Export}
/ fixed error with context menu (not right create)
/ now added dates always right away appear in kalender

[1.5]
 + editing personlig dates from kalender {context menu}
 + date format
 + save size of not maximized kalender 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 personlig dates - celebrations (possibly editing from kalender {context menu})
 + message formats for celebrations (possibly editing from kalender {Settings panel->Dates->Sets->Button '>'})
 * changed keys for notes/celebrations editing (see KEYBOARD)
 * removed panels settings - now their state always save
 * extended kalender 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)
 + dates set samples (Romanian)
 + personlig 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 kalender

 + 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)

[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)
 + readme-file (German)
 + readme-file (Spanish)
 + personlig dates set sample (German)

[1.01]
 / bug when you can't add notes
 + possibility add and delete personlig 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)
 + personlig dates set sample (French)
