Maximus, 2005 ________________tcCalendar 1.9 ________________mxmus@yandex.ru
Module listeur de  Maximus pour Total Commander

I. Description:
 - Calendrier perptuel et universel
 - Possibilit d'utiliser des vnements communs, clbrations ou personnels
 - Possibilit de formats spciaux suivant le type d'vnement
 - Nombreux de contrles pour l'affichage des vnements
 - Format des dates d'vnements  diffrents formats :
	Relatifs  Pques (Orthodoxe ou Catholique)
	Par numro de semaine dans le mois
	Mobiles
	Cycliques
	Particulires
	Au format de date Julienne
 - Le calendrier est fait de deux parties (Classique et liste) avec possibilit de prsentation
   suivant le type d'vnement
 - L'affichage de la liste peut tre limit (Nombre de jours avant et aprs aujourd'hui) 
 - Possibilit d'exporter un calendrier vers Excel. (Si Excel est install sur l'ordinateur)
 - Interface multilingue (Tchque, Nerlandais, Anglais, Franais, Allemand, Italien, Polonais, Roumain, Russe, Slovaque, Espagnol, Ukrainien)
 
II. Installation:
 1. dcompresser l'archive dans le rpertoire de votre choix ([Chemin_CLD])
 2. installer le module:
     - Configuration -> Options... -> Editer/Voir ->Configurer visionneuse interne... ->Modules-LS
     - ajouter tcCld  la liste des modules
 3. ajouter un nouveau bouton  la barre des boutons:
     - Configuration -> Barre de boutons... -> Ajouter
     - Remplir les champs suivants:
         - Commande = "cm_List [Chemin_CLD]\tcCld.TCCALENDAR"
         - Chemin = "[Chemin_CLD]"
         - Icone = "[Chemin_CLD]\tcCld.ico" ou une icne  votre choix
             Note: le tout sans les guillemets
 4. {Facultatif} tcCalendar peut tre ajout au menu "Utilisateur":
     - {Utilisateur -> Modifier le menu Utilisateur... -> Ajouter...}
     - entrer le nouveau nom pour l'lment du menu (par exemple: "tcCalendar") -> Confirmer 
     - remplir les champs de la manire suivante:
        - Commande = "cm_List [Chemin_CLD]\tcCld.TCCALENDAR"
        - Chemin = "[Chemin_CLD]"
	  - Confirmer
     NOTE: Ne pas introduire les guillemets lors de la saisie.
 5. {Facultatif} Si le point 4 a t excut, on peut dfinir une touche raccourci pour tcCalendar:
     - {Options -> Configuration... -> Divers.}
     - Choisir une combinaison de touche Changer la dfinition des touches d'accs rapide
     - Choisir la commande "cm_UserMenu" en remplaant le "" par le bon numro dans le menu.
     - Appliquer -> Confirmer
     
______________________________________________________             

III. Clavier:
 NUM+  -  anne suivante
 NUM-  -  anne prcdente
    S  -  Montrer/cacher le panneau d'agencement
    D  -  Montrer/cacher le panneau liste des dates proches
    R  -  Recharger la liste des vnements
    C  -  Recharger le calendrier
    G  -  Sauter  un jour au choix dans la liste
    T  -  Sauter  une anne au choix

dition de note ou d'une clbration:
 Ctrl+Supp   -  effacer 
 Ctrl+Ins    -  ajouter note
 Ctrl+<      -  dplacer la note vers le haut
 Ctrl+>      -  dplacer la note vers le bas
 Ctrl+Entre -  Confirmer les modifications
 
IV. Souris:
Dans le calendrier:
 Double clic - Sauter a une anne prcise
Dans le tableau:
 Double clic gauche - pour ajouter ou changer une note
 CTRL + clic gauche - pour diter une clbration
 Maj + clic gauche  - pour diter un vnement personnel
 Clic avec bouton central pour sauter  une date  choisir

V. Fichiers: 
VNEMENTS:
 [Chemin_CLD]\Dates\*.cdt - vnements usuels du pays
 [Chemin_CLD]\Dates\*.pdt - vnements et notes personnelles
 [Chemin_CLD]\Dates\*.edt - vnements tendus
 [Chemin_CLD]\Dates\Void\*.cdt,*.pdt,*.edt - exemples de fichiers d'vnements ( copier dans "[Chemin_CLD]\Dates" pour utilisation)
MODULES EXTERNES:
 [Chemin_CLD]\ExLib\*.ecl 
 [Chemin_CLD]\ExLib\SunMoon.ecl - Informations au sujet du soleil et de la lune 
        Vous pouvez tlcharger SunMoon.ecl depuis le site maximus.in.ua
JEUX DE POLICES:
 [Chemin_CLD]\FontScheme\*.fnt
 [Chemin_CLD]\tcCld.fnt - jeu actuel
LANGUES:
 [Chemin_CLD]\Language\*.lng
AIDE:
 [Chemin_CLD]\ReadMe\readme_*.txt
 
VI. Format des fichiers dates:
_______________________________________________________________________________________________
N| Type| Section       | Format             | Commentaires
__|_____|_______________|____________________|_________________________________________________
1 |.pdt |[Notes]        | jj.mm.aaaa=texte   | Notes directement dans tcCalendar
  |     |               |                    | jj = jour (2 caractres)
  |     |               |                    | mm = mois (2 caractres)
  |     |               |                    | aaaa - anne (4 caractres)
__|_____|_______________|____________________|_________________________________________________
2 |.cdt |[Dates de base]| jj.mm=texte        | Date simple
  |     |[Dates]        |                    | jj = jour (2 caractres)
  |     |[Religieuses]  |                    | mm = mois (2 caractres)_________________________________________________
__|.pdt |[Personnelles] |____________________|_________________________________________________
3 |     |[Clbrations] | ROEx=texte         | Date relative  Pques orthodoxe
  |.edt |[tendues]     |                    | x = nombre   Pques + x jours
  |     |               |                    | x = -nombre   Pques - x jours
__|     |               |____________________|_________________________________________________
4 |     |               | RCEx=texte         | Date relative  Pques catholique
  |     |               |                    | x = nombre   Pques + x jours
  |     |               |                    | x = -nombre   Pques - x jours
__|     |               |____________________|_________________________________________________
5 |     |               | WDMjn=texte        | Date par semaine du mois
  |     |               |                    |                  (pour chaque mois)
  |     |               |                    | j = jour de la semaine
  |     |               |                    |                          0=Dimanche, 1=Lundi...
  |     |               |                    | n = nombre de semaines depuis le dbut du mois
  |     |               |                    | n = -nombre de semaines avant fin du mois
__|     |               |____________________|_________________________________________________
6 |     |               | WDMjn.mm=texte     | date par semaine du mois
  |     |               |                    |                  (Avec mois prcis)
  |     |               |                    | j = jour de la semaine
  |     |               |                    |           0=Dimanche, 1=Lundi, 2=Mardi...
  |     |               |                    | n = nombre de semaines depuis le dbut du mois
  |     |               |                    | n = -nombre de semaines avant fin du mois
  |     |               |                    | mm = mois (2 caractres)
__|     |               |____________________|_________________________________________________
7 |     |               |PDs.jj=texte        |date particulire
  |     |               |                    |s = jour de la semaine
  |     |               |                    |jj = jour
__|     |               |____________________|_________________________________________________
8 |     |               |PDYnnn=texte        |date particulire
  |     |               |                    |nnn = n du jour dans l'anne
__|     |               |____________________|_________________________________________________
9 |     |               |Jjj.mm=texte        |Date au format du calendrier Julien
  |     |               |                    |jj = jour
  |     |               |                    |mm = mois
__|_____|_______________|____________________|_________________________________________________
10|.pdt |[Personnelles] |CDccc:jj.mm.aaaa    |vnments cycliques
  |     |               | -jj.mm.aaaa=texte  |ccc = <cycle> (nombre de jour dans l'intervalle)
  |     |               |                    |jj.mm.yyyy (Premier groupe) = <date de dbut>
  |     |               |                    |jj.mm.yyyy (Second groupe) = <date de fin>
__|_____|_______________|____________________|_________________________________________________
11|.cdt |[Dates de base]|MDdate:g,d>sci      |Dates mobiles (format court)
  |     |[Dates]        |            =texte  |g = <Jour de la semaine  gauche>
  |     |[Religieuses]  |                    |d = <Jour de la semaine  droite>
  |.pdt |[Personnelles] |                    |c = <Jour de la semaine cible>
  |     |[Clbrations] |                    |           g,d,c - [0..6] 0=Dimanche
  |.edt |[Extendue]     |                    |s = <Sens de la mobilit>
  |     |[Clbrations] |                    |                N = Suivant, P = Prcdent
  |     |               |                    |i = <ignore>
  |     |               |                    |                I = affich seulement si dplace
  |     |               |                    |texte = formats date 2,3,4
__|     |               |____________________|__________________________________________________
12|     |               |MDdate:g1,d1>sc1    |Dates mobiles (format long)
  |     |               |  :g2,d2>sc2i=texte |        comme le format court,
  |     |               |                    |          mais avec deux conditions
__|     |               |____________________|__________________________________________________
13|     |               |MDjj.mm:WDMsn>      |Date mobile (relative)
  |     |               |    WDMsn.mm=texte  |jj = <jour>
  |     |               |                    |mm = <mois>
  |     |               |                    |s = <Jour de la semaine>
  |     |               |                    |                       [0..6] 0=Dimanche
  |     |               |                    |n = <nombre du mois du dbut>
  |     |               |                    |n = -<nombre du mois de la fin>
__|     |               |____________________|__________________________________________________
14|     |               |MDdate:WDMsn.mm>    |Date mobile (relative  Pques)
  |     |               |    WDMsn.mm=texte  |date = format date 3,4
  |     |               |                    |mm = <mois>
  |     |               |                    |s = <Jour de la semaine>
  |     |               |                    |                       [0..6] 0=Dimanche
  |     |               |                    |n = <nombre du mois du dbut>
  |     |               |                    |n = -<nombre du mois de la fin>
__|_____|_______________|____________________|__________________________________________________

Remarques pour l'introduction de plusieurs donnes pour une mme date il suffit de les sparer par %n :
  Texte = Texte_1%nTexte_2 ... %nTexte_X
  notes = Note_1%nNote_2 ... %nNote_X

Remarques pour les clbrations uniquement [Celebrations] (Fichiers xxxxx.pdt):
  jj.mm=Nom_Clbration#Anne_Dbut_Clbration_year#format_numro
     format_numro =numro du format dans la liste sauvegards dans tcCld.ini sous la rubrique [CelFormat]
 					(>=0, 0 = format par dfaut)
  
  Pour crer ou modifier les formats : {Options->Calendrier->Choix->Bouton >}
 
  	[N] = nom de l'vnement  clbrer
  	[Y] = Anne o l'vnement a eu lieu
  	[A] = Nombre d'anne coules depuis que l'vnement a eu lieu
 
  Exemples : 1=[N] ne en [Y] il y a [A] ans
		 2=[N] n en [Y] il y a [A] ans
		 3=Entre  [N] en [Y] il y a [A] annes
		 4=En [Y] il y a donc [A] ans naissait [N]




Autres exemples:
_______________________________________________________________________________________________
    ROE0=Pques orthodoxe                       WDM02=second dimanche de chaque mois
    ROE49=Trinit orthodoxe                     WDM3-1=dernier mercredi de chaque mois
    ROE-7=Dimanche des Rameaux orthodoxe        WDM51.11=premier vendredi de novembre
    RCE0=Pques catholique                      CD015:14.09.2005-03.05.2006=vnement cyclique
    PD5.13=Vendredi 13                          (Rptera tous les 15 jours entre le 14.09.2005
    PDY256=Jour des programmeurs                                            et le 03.05.2006)
    23.04=Anniversaire de Jean%nMariage de Jeanne 
    J25.12=Nol Orthodoxe, L'glise orthodoxe clbre Nol(et d'autres ftes) en suivant le
    calendrier Julien).
    Actuellement la diffrence entre les calendriers Grgorien et Julien est de 13 jours, mais
     partir du 1er mars 2100 il sera de 14 jours, et avant le 1er mars 1900 il tait de 12 jours.
_______________________________________________________________________________________________

    MD02.04:2,3>P1:4,5>N1= 2 avril > Fte en Argentine
    Si le 2 avril est un mardi ou un mercredi, alors la fte se clbre le lundi prcdent,
    si c'est un jeudi ou un vendredi ce sera le lundi suivant, dans les autres cas, ne rien changer.

    MD01.01:6,6>N1:0,0>N1=Fte de "nouvel an" en Ukraine
    En Ukraine, si la fte nationale ou nouvel an est un samedi ou un dimanche,
    alors on ajoute un jour de cong supplmentaire le lundi suivant.
    MD01.01:6,0>N1=Fte de "nouvel an" en Ukraine
    MD01.01:6,6>N1I:0,0>N1=Fte de "nouvel an" en Ukraine, 
    le I ajout fait qu'il ne sera affich que s'il est dplac
    MD01.05:WDM01>WDM02.05=1er mai,  fte
    Si le 1er mai est le premier dimanche du mois, alors la fte aura lieu le second dimanche du mois !.

VII. FORMATS POUR DATES:
 {Options->Affichage->Autre->Format}
Symboles spciaux:
[D] - Jour
[M] - Mois en chiffres
[L] - Mois en lettres
[A] - Mois en lettres (abrgs)
[Y] - Anne
[S] - Anne (courte)
[J] - Date julienne
[W] - Jour de la semaine
[B] - Jour de la semaine (abrg)
 \t - tabulation (pour la liste)
 \\ - \
Exemple :
 Format date julienne: j[D].[M] = j03.08
 Format pour liste: [L] [D], [Y] ([J]) = Aot 16, 2005 (j03.08)
________________________________________________________________________________

VIII. FORMAT POUR CLBRATIONS:
 {Options->Calendriers->Choix->Bouton '>'}
Symboles: spciaux
[N] - Nom de la clbration
[Y] - Anne de la premire clbration
[A] - Anniversaire de la clbration
Par exemple, vous voulez afficher le message suivant:
"Ce jour, il y a dj 10 ans, est n notre cher Johnny. Cet vnement a eu lieu en 1995."
Vous devez entre le format suivant:
"Ce jour, il y a dj [A] ans, est n notre cher [N]. Cet vnement a eu lieu en [Y."
et choisir ce format lors de l'ajout/dition de la clbration (Menu contextuel du calendrier) dans la 3me colonne.
________________________________________________________________________________

IX. FORMAT POUR L'HEURE:
 {Options->Heure->Format pour l'heure}
Symboles spciaux:
[H] - Heure
[T] - Heure (format 12 heures)
[M] - Minutes
[S] - Secondes
Exemples:
 [H]:[M] = 16:09
 [T]:[M] = PM04:09


X. FORMAT POUR INFO-BULLES: 
FORMAT des titres du calendrier:
 {Options->Outils->FORMAT des titres du calendrier->Dfinir le format}

Symboles spciaux communs:
    \n  - Nouvelle ligne
    \t  - Tabulation

Aujourd'hui:
    [T] - Aujourd'hui
        Exemple :
                    :::: [T] :::: = :::: Aujourd'hui ::::
Titre:                    
    [N] - Nom du titre
    Exemple:
                 ::++ [N] ++:: = ::++ Fris Nationaux ++::
________________________________________________________________________________
FORMAT pour le soleil et la lune:
 {Options->Outils->Soleil et lune->Dfinir le format}

    [SR] - Heure du lever du soleil
    [SS] - Heure du coucher de soleil
    [MR] - Heure du lever de la lune
    [MS] - Heure du coucher de la lune
    [PP] - Luminosit de la lune (en pourcent)
    [PN] - Nom de la phase de la lune

    Exemple:
 Soleil & Lune:\nLever du soleil [SR]\nCoucher du soleil [SS]\nLever de la lune [MR]\nCoucher de la lune [MS]
 =
 Soleil & Lune:
 Lever du soleil 03:49
 Coucher du soleil 20:12
 Lever de la lune 00:26
 Coucher de la lune 14:12 
 

XI. Particularits pour l'utilisation des paramtres de police:
 {Options->Affichage->Polices}
______________________________________________________________________________________
                     | N/U      | U/O   | U/A
_____________________|__________|_______|_____________________________________________
Anne                | VA       |       |
Fond                 |          | FC BC | FC={Couleur fond de la liste des vnements}
                     |          |       | BC={Couleur fond du calendrier}
Grille du calendrier |          | BC    | BC={Couleur de la grille du calendrier}
... <Date>           | VA HA    |       | BC={... couleur du marqueur}
... <Text>           | VA HA BC |       |
_____________________|__________|_______|_____________________________________________
Abrviation:
 N/U - non utilis  U/O - utilis seulement  U/A - utilis comme
 VA - Alignement vertical     FC - Couleur de la police
 HA - Alignement horizontal   BC - Couleur de fond

____________________________________________________________________________________________________

XII. LIMINATION d'un PROBLME:
 Avec certaines versions de Windows (Windows 2000 par exemple) La liste des vnements n'est pas affiche correctement.
 Pour liminer ce problme copier le fichier:
     de Windows XP  -  disque:\WINNT\SYSTEM32\riched20.dll
     de Windows 98  -  disque:\Windows\SYSTEM32\riched20.dll
 vers le rpertoire appropri (de Windows 2000 - disque:\WINNT\SYSTEM32\)
     disque = disque sur lequel le systme est install (C gnralement)

____________________________________________________________________________________________________
XIII. Sources:
 Pour les informations au sujet du soleil et de la lune une partie des composants de TMoon ont t utiliss.
     Andreas Horstemeier
     andy@hoerstemeier.de
     http://www.hoerstemeier.com
 Pour les informations pour les pays, villes et coordonnes incluses dans le fichier (tcCld.lct) le fichier cities.dat du Calendar wfx-plugin a t utilis.
     Fabio Chelly,
     fabio@chelly.net
     http://totalcommander.free.fr/fabio/calendar.zip
________________________________________________________________________________

Historique:
 [+] - Ajout  [/] - Correction  [*] - Modification
[2.0]
+ Enregistrer le calendrier au format bitmap (BMP) {Options->Exporter}
+ Jeux de polices {Options->Affichage >Polices}
+ Agencement pour info-bulles{Options->Outils->Contenu de l'info-bulle} (voir X.)
+ Entre de la situation manuellement {Options->Heure et situation}
+ Caractristiques de la fentre au lancement {Options->Programme}
+ Option pour cacher le calendrier ou la liste (Clic droit)
+ Indentation pour l'alignement du texte  {Options->Affichage->Polices}
+ Raccourci pour revenir  l'anne actuelle - NUM*

[1.9]
+ Informations sur le soleil et la lune par module externe {Options->Outils->Soleil et lune}
      (Voir Modules Externes, FORMAT Soleil et Lune)
      Choisir Format pour la ville et l'heure {Options->Heure et situation} 
+ Titres des calendriers dans la bulle d'information {Options->Titre->Outils->Titres des calendriers}
+ jour de la semaine en format long format et format liste des vnements
+ dates mobiles supportes aussi dans .cdt [Religieux] et .edt [tendu]
+ nouveau format de date mobile (Relative  Pques)
+ possibilit de faire varier la taille ou de cacher le panneau Anne
+ calendriers nationaux (Autriche, Allemagne)

[1.8]
/ supporte des fichiers de plus de 64 Ko avec des chanes de plus de 2Ko
/ erreur fixe pour les dates mobiles ncessitant un changement d'anne
/ correction de la diffrence entre calendrier Julien et Grgorie pour le calcul de Pques Orthodoxe
+ Dates juliennes pour le calendrier (voir Format des dates /9)
+ Dates juliennes pour la liste {Options->Affichage->Autre->Format date} 
+ Dates juliennes pour les outils {Options->Calendrier->Limitation +}
+ ajout pour dates mobiles ('I')
+ ajout pour format dates mobiles (limites comme de 6  2)
+ ajout aux dates particulires (Jour de l'anne)
+ priorit des vnements et formats {Options->Affichage->Priorit}
+ paragraphes dans les outils {Options->Affichage->Autre}
+ possibilit de dfinir la date actuelle {menu contextuel}
+ sauvegarde de la liste aussi au format texte {Options->Exporter}
+ exportation invisible dans Excel (+ rapide) {Options->Exporter}
+ saut  une date  choisir (voir Clavier et Souris)
+ possibilit de charger des calendriers (liste) pour une anne choisie {Options->Calendrier->Limitation +}
+ menu contextuel tendu pour le calendrier et la liste
+ accs plus rapide pour diter les clbrations et vnements personnels (voir Souris)



[1.7]
+ Dates mobiles
+ Dates particulires
+ format de police pour tous les vnement du calendrier {Options->Affichage->Polices}
+ possibilit d'accepter/refuser l'affichage d'"Aujourd'hui" {Options->Calendriers->Limitations}
+ Enregistrement de la liste au format RTF {Options->Exporter}
+ Rpertoire de stockage des donnes dfini par l'utilisateur {Options->Programme}
* Raccourci clavier Montrer/Cacher le panneau des options chang en 'S'
 
[1.6]
+ exportation du calendrier vers Excel {Panneau des prfrences -> Exporter}
/ corrections de l'erreur du menu contextuel (cration errone)
/ vnements nouveaux apparaissent correctement dans le calendrier

[1.5]
 + Edition des vnements personnels dans le calendrier {Menu contextuel)
 + Format d'affichage des dates
 + Enregistrement de la taille d'affichage si pas en plein cran
 * Ne pas excuter d'oprations d'critures si lanc depuis un CD
 * Changement de la hauteur de la liste via la souris
 * Le jeu de dates tendues sera mise  jour dans un bloc spar
 
[1.4]
 + nouvelle catgorie d'vnements personnels - clbrations (possibilit d'diter  partir du calendrier > menu contextuel)
 + formats pour les clbrations (possibilit d'diter  partir du calendrier {Options->Calendrier->Choix->Bouton >})
 * modifi les raccourcis pour l'dition des notes/clbrations (voir Clavier)
 * Options panneaux supprimes
 * menu contextuel pour calendrier tendu

[1.3]
 + Possibilit d'utiliser plusieurs vnements d'un mme type pour une mme date (symbole %n)
 * Nouvelle interface pour l'dition de notes personnelles
 * Suppression de l'option "Encadr pais" dans les options gnrales
 + Aspect rglable pour la date du jour dans le calendrier

 + Fichier langue (Czech)
 + Calendrier (Canada, English)
 + Calendrier (France, French)
 * Calendrier (Belgium, French)
 + Calendrier (Czechia, Czech)
 + Calendrier tendu (Czech, "Name-day")

[1.2]
 +  possibilit d'utiliser des vnements avec un cycle de n jours
 +  rglage pour la limitation d'affichage de certains types d'vnements
 +  possibilit de choisir le marqueur en fonction du type d'vnement
 *  rduction de temps de chargement des listes d'vnements
 *  changement dans la structure des options
 
[1.1]
 /  liste des dates affiches correctement sous Windows98
 +  nouveau type de calendrier - Date tendue
 +  possibilit de dfinir une date par jour de la semaine relativement au dbut ou la fin d'un mois
 +  polices prfres sauvegardes dans un fichier spar
 *  la structure des options est modifie

 +  Fichier langue (German)
 +  Fichier langue (Polish)
 +  Fichier langue (Spanish)
 +  dates set (Germany, German)
 +  2 calendrier tendus (Franais, "Saint(s) du jour")
 +  readme-file (German)
 +  readme-file (Spanish)
 +  personal dates sample (German)
 
[1.01]

 /  bogue lors de l'impossibilit d'ajouter des notes
 +  possibilit d'ajouter et de supprimer des calendriers personnels directement du module
 +  possibilit de ne pas choisir de calendrier personnel

 +  Fichier langue (Dutch)
 +  Fichier langue (French)
 +  Calendrier (Belgium, French)
 +  Fichier readme-fra (French)
 +  Calendrier personnel d'exemple (French)
