feat(calendarium): new Calendarium desklet — clock, sun, moon, zodiac, Wikipedia, holidays

calendarium@kami911/README.md

@@ -0,0 +1,59 @@
+# Calendarium
+
+A rich, highly customizable calendar and astronomical information desklet for the Cinnamon Desktop.
+
+## Features
+
+- **Date & Time** — Customizable strftime format, 12/24-hour, optional seconds
+- **Traditional Month Names** — Old Hungarian, Old English (Anglo-Saxon), Old German
+- **Moon Phase** — Locally calculated phase, symbol, name, and age in days
+- **Sunrise & Sunset** — Locally calculated from configurable coordinates (default: Budapest)
+- **Western Zodiac** — Sign with Unicode symbol
+- **Chinese Zodiac** — Year animal and element
+- **New Year Countdown** — Days until next January 1st
+- **Name Days** — Today plus up to 5 days lookahead (Hungarian, German, English datasets)
+- **Wikipedia** *(opt-in, internet required)* — On-this-day births & deaths, article of the day
+
+## Installation
+
+Copy or symlink the `files/calendarium@kami911/` directory to:
+```
+~/.local/share/cinnamon/desklets/calendarium@kami911/
+```
+
+Then right-click the Cinnamon desktop → Add Desklets → Calendarium.
+
+## Localization
+
+Translations use standard Gettext `.po` files in `files/calendarium@kami911/po/`.
+To compile translations:
+```
+cd /path/to/cinnamon-spices-desklets
+./cinnamon-spices-makepot calendarium@kami911
+```
+
+To add a new UI language:
+1. Create `po/XX.po` based on `po/calendarium@kami911.pot`
+2. Run `cinnamon-spices-makepot calendarium@kami911`
+
+## Contributing Name Days
+
+To add name day data for a new language, open a pull request with:
+
+1. `files/calendarium@kami911/data/namedays/XX.json` — map of `"MM-DD": ["Name1", …]` entries
+2. A new option added to the `nameday-locale` key in `settings-schema.json`
+
+> **Note:** Do not edit files inside the installed desklet directory directly — those changes will be overwritten the next time the desklet is updated.
+
+## Contributing Traditional Month Names
+
+To add traditional month names for a new language, open a pull request with:
+
+1. A new `xx: […]` array added to `Localization.TRADITIONAL_MONTHS` in `lib/localization.js`
+2. A new option added to the `traditional-lang` key in `settings-schema.json`
+
+> **Note:** Do not edit files inside the installed desklet directory directly — those changes will be overwritten the next time the desklet is updated.
+
+## License
+
+GPL-3.0

calendarium@kami911/files/calendarium@kami911/data/folkdays/de.json

@@ -0,0 +1,63 @@
+{
+    "01-01": "Wie das Wetter am Neujahrstag, so es das ganze Jahr bleiben mag.",
+    "01-06": "Dreikönig hell und klar bringt ein gutes Jahr.",
+    "01-13": "Hilarius gilt als der kälteste Tag des Jahres.",
+    "01-17": "Antonius kalt und klar – ein gutes Weinjahr.",
+    "01-20": "Fabian-Sebastian kalt – langer Winter vorausgesagt.",
+    "01-22": "Vinzenz hell und klar – ein gutes Weinjahr wird's sein.",
+    "01-25": "Pauli Bekehrung Sonnenschein – viel Korn, viel Wein.",
+    "02-02": "Wenn's an Mariä Lichtmess stürmt und schneit, ist der Frühling nicht mehr weit. Scheint die Sonne, meint Petrus sechs Wochen mehr Winter.",
+    "02-03": "Blasius Wind sagt das Wetter der nächsten vierzig Tage voraus.",
+    "02-14": "Valentin sonnig – Frühling kommt früh.",
+    "02-22": "Petri Stuhlfeier sonnig – Frühling naht.",
+    "02-24": "Matthias bricht das Eis; hat er keines, macht er eines.",
+    "03-01": "David Regen – nasser Frühling.",
+    "03-12": "Gregor bringt den Frühling, wenn auch Schnee noch liegt.",
+    "03-17": "Patrick Regen – nasser Sommer.",
+    "03-19": "Ist Josefstag hell und klar, kommt ein fruchtbares Weinjahr.",
+    "03-25": "Mariä Verkündigung Regen bringt vierzig Regentage.",
+    "04-04": "Ambrosius Regen – kühler Sommer.",
+    "04-14": "Tiburtius sonnig – angenehmer Sommer.",
+    "04-23": "Georgi Regen – des Bauern Segen.",
+    "04-25": "Markus Regen – vierzig Tage Regen.",
+    "05-01": "Nasser Mai, kühler Mai – füllt dem Bauern Scheuer und Fass.",
+    "05-12": "Pankrazi, Servazi, Bonifazi sind drei frostige Bazi.",
+    "05-13": "Servaz bringt noch manchen Schaden, drum trau dem Mai nicht mit dem Baden.",
+    "05-15": "Sophia, die kalte – letzte Frostnacht des Jahres.",
+    "05-25": "Urban sonnig – gute Weinernte; Regen – saurer Wein.",
+    "06-08": "Medardus nass – vierzig Tage Nass.",
+    "06-11": "Barnabas, der Sonnenlange – längster Tag um Johanni.",
+    "06-24": "Wenn's an Johanni regnet, wird der Wein verdorben.",
+    "06-29": "Petri Regen – schlechte Ernte.",
+    "07-02": "Mariä Heimsuchung Regen – Weinlese fällt aus.",
+    "07-15": "Wenn's an Margareta regnet, regnet es noch vierzig Tage.",
+    "07-20": "Elias Donner – früher Herbst.",
+    "07-22": "Magdalena weint – wenn Regen, nasser Herbst.",
+    "07-25": "Jakobi Regen – Herbst ohne Segen.",
+    "07-26": "Anna Regen – gutes Weinjahr.",
+    "08-01": "Petri Kettenfeier Regen – nasser Herbst.",
+    "08-10": "Laurenzi Sonnenschein – wird ein guter Wein.",
+    "08-15": "Mariä Himmelfahrt Regen – schlechter Herbst.",
+    "08-24": "Bartholomäus Regen – nasser Herbst bis Weihnachten.",
+    "09-08": "Mariä Geburt heller Schein – guten Wein bringt er ein.",
+    "09-14": "Kreuzerhöhung schön – langer warmer Herbst.",
+    "09-21": "Matthäus bringt kalten Tau und nassen Regen.",
+    "09-29": "Michaeli klar und rein – gibt's guten Wein.",
+    "10-04": "Franziskus Regen – nasser Oktober.",
+    "10-18": "Lukäs – sä Weizen, der Heilige segnet ihn.",
+    "10-28": "Simon und Judas nass – nasser Winter folgt danach.",
+    "11-01": "Allerheiligen schön – milder Winter.",
+    "11-02": "Allerseelen Nebel – schneereicher Winter.",
+    "11-11": "Ist Martini Regen und Wind, so wird der Winter gelind.",
+    "11-19": "Elisabeth Schnee – harter Winter voraus.",
+    "11-25": "Kathrinentag Schnee – Weihnachten Klee.",
+    "11-30": "Andreas Regen – weiße Weihnachten.",
+    "12-04": "Barbara Schnee schmilzt bis Weihnachten.",
+    "12-06": "Nikolaus Frost – grüne Weihnachten.",
+    "12-13": "Wie das Wetter an Luzia, so ist's noch vierzig Tage da.",
+    "12-21": "Thomas kalt – harter Winter steht bevor.",
+    "12-24": "Heiligabend klar – gesegnetes neues Jahr.",
+    "12-25": "Grüne Weihnachten – weiße Ostern.",
+    "12-26": "Stephanstag Regen – gute Ernte im nächsten Jahr.",
+    "12-31": "Silvester Wind – das ganze Jahr geschwinde Winde sind."
+}

calendarium@kami911/files/calendarium@kami911/data/folkdays/en.json

@@ -0,0 +1,57 @@
+{
+    "01-01": "If New Year's Eve wind blows south, it betokeneth warmth and growth.",
+    "01-06": "If Twelfth Night be windy, a good year for corn.",
+    "01-13": "St. Hilary's Day is said to be the coldest day of the year.",
+    "01-20": "St. Agnes' Day fair means a good year for lambs.",
+    "01-25": "If it rains on St. Paul's Day, it will be a bad year.",
+    "02-02": "If Candlemas Day be fair and bright, winter will have another flight. If on Candlemas Day it showers and rains, winter is gone and will not come again.",
+    "02-03": "St. Blaise's wind predicts the weather for the next forty days.",
+    "02-14": "If St. Valentine's Day is fair, spring will come early.",
+    "02-22": "St. Peter's Chair: if sunny, spring is near.",
+    "02-24": "St. Matthias breaks the ice; if there is none, he makes it.",
+    "03-01": "If it rains on St. David's Day, the whole spring will be wet.",
+    "03-12": "If it rains on St. Gregory's Day, the summer will be wet.",
+    "03-17": "St. Patrick's Day cold and wet, summer's rains will be early set.",
+    "03-19": "St. Joseph's Day fine means a warm spring to follow.",
+    "03-25": "If it rains on Lady Day, the summer will be dry.",
+    "04-04": "If it rains on St. Ambrose's Day, the summer will be cool.",
+    "04-14": "St. Tiburtius Day: if fine, summer will be pleasant.",
+    "04-23": "St. George's Day fair weather foretells a plentiful year.",
+    "04-25": "If it rains on St. Mark's Day, it will rain for forty days.",
+    "05-01": "A cold May is kindly, and fills the barn finely.",
+    "05-11": "Mamertus, Pancras, Gervase – beware the ice saints' days.",
+    "05-12": "St. Pancras: if cold, summer will be short.",
+    "05-25": "Urban's Day sunshine promises a rich grape harvest.",
+    "06-08": "If it rains on St. Medard's Day, it will rain for forty days.",
+    "06-24": "If it rains on St. John's Day, the harvest will be poor.",
+    "06-29": "If it rains on SS. Peter and Paul's Day, there will be a poor harvest.",
+    "07-02": "If it rains on the Visitation of Our Lady, the wine harvest will fail.",
+    "07-15": "St. Swithin's Day, if thou dost rain, for forty days it will remain. St. Swithin's Day, if thou be fair, for forty days 'twill rain no more.",
+    "07-20": "If it thunders on St. Elijah's Day, an early autumn is expected.",
+    "07-22": "Tears of St. Mary Magdalene – if it rains, the autumn will be wet.",
+    "07-25": "If it rains on St. James' Day, the autumn will be wet.",
+    "07-26": "St. Anne's rain means a good wine year.",
+    "08-01": "Lammas Day: if it rains, the autumn will be wet.",
+    "08-10": "If it rains on St. Lawrence's Day, the autumn will be wet.",
+    "08-15": "If it rains on the Assumption of Our Lady, the autumn will be poor.",
+    "08-24": "If it rains on St. Bartholomew's Day, it rains the whole autumn through.",
+    "09-08": "If it is fine at Our Lady's Birthday, expect a mild winter.",
+    "09-14": "Holy Cross Day: fair weather means a long warm autumn.",
+    "09-21": "St. Matthew brings cold rain and dew.",
+    "09-29": "Michaelmas Day fine and clear brings a long and pleasant autumn here.",
+    "10-04": "St. Francis' Day rain means a rainy October.",
+    "10-18": "St. Luke's Day: sow wheat, for the saint blesses it.",
+    "10-28": "If St. Simon and Jude's Day be fine, winter arrives soon.",
+    "11-01": "All Saints' Day fine means a mild winter.",
+    "11-11": "If Martinmas be fine and clear, look for frosty winters here.",
+    "11-19": "St. Elizabeth's snow foretells a heavy winter.",
+    "11-25": "If St. Catherine frowns with white, Christmas will be light.",
+    "11-30": "If it rains on St. Andrew's Day, Christmas will be white.",
+    "12-04": "St. Barbara's snow melts by Christmas.",
+    "12-06": "St. Nicholas' frost means a green Christmas.",
+    "12-13": "As the weather on St. Lucy's Day, so the winter will stay.",
+    "12-21": "St. Thomas' Day cold means a hard winter ahead.",
+    "12-25": "A green Christmas makes a fat graveyard.",
+    "12-26": "If it rains on St. Stephen's Day, the next year's harvest will be good.",
+    "12-31": "If New Year's Eve night wind blows south, it betokeneth warmth and growth."
+}

calendarium@kami911/files/calendarium@kami911/data/folkdays/es.json

@@ -0,0 +1,59 @@
+{
+  "01-01": "Año nuevo, vida nueva; si hay niebla en Año Nuevo, habrá niebla todo el año.",
+  "01-06": "Por Reyes, si hace sol, buena cosecha para el año.",
+  "01-17": "Por San Antón, el frío se rompe o se afirma.",
+  "01-20": "San Sebastián claro, invierno corto y buen verano.",
+  "01-22": "Por San Vicente, el viento anuncia el tiempo que viene.",
+  "01-25": "Por la conversión de San Pablo, si hace buen tiempo, el año será sereno.",
+  "02-02": "Si la Candelaria plora, el invierno ya está fuera; si no plora, ni dentro ni fuera.",
+  "02-03": "San Blas, con el frío o sin él, ya empieza a despejarse.",
+  "02-05": "Por Santa Águeda, si nieva, la siembra se alegra.",
+  "02-14": "Por San Valentín, los pájaros buscan nido y compañín.",
+  "02-24": "Por San Matías, el sol entra en casa fría.",
+  "03-01": "Marzo ventoso y abril lluvioso hacen a mayo florido y hermoso.",
+  "03-12": "Por San Gregorio, la cigüeña llega al campanario.",
+  "03-17": "Por San Patricio, quien no ha sembrado está en el precipicio.",
+  "03-19": "Por San José, si el sol calienta, el invierno ya no se presenta.",
+  "03-25": "Lluvia en la Anunciación, cuarenta días de precipitación.",
+  "04-01": "Abril, aguas mil.",
+  "04-23": "Por San Jorge, a quien no ha sembrado, la cosecha le hace el sordo.",
+  "04-25": "Por San Marcos, si llueve, llueve cuarenta días seguidos.",
+  "05-01": "Mayo fresco y lluvioso, año fructífero y hermoso.",
+  "05-12": "Santos de hielo: Pancracio, Sergio y Bonifacio, tres días del deshielo.",
+  "05-15": "Por San Isidro Labrador, toma el agua y deja el calor.",
+  "05-22": "Por Santa Rita, quien no ha plantado, poquita cosecha.",
+  "05-25": "Por San Urbano, verano temprano.",
+  "06-08": "Si llueve por San Medardo, llueve cuarenta días más tarde.",
+  "06-13": "Por San Antonio, el calor llega con su alborozo.",
+  "06-24": "Por San Juan, el trigo en el granero y el mosto en el lagar.",
+  "06-29": "Por San Pedro, las mieses ya tienen cuerpo.",
+  "07-02": "Si julio es lluvioso, el año es generoso.",
+  "07-16": "Por el Carmen, el sol aprieta, el campo ya fermenta.",
+  "07-25": "Por Santiago, la hoz en la hierba y la guadaña en el trigo.",
+  "07-26": "Por Santa Ana, si hace sol, buena vendimia en la mañana.",
+  "08-01": "En agosto, siembra nabos en el rostro.",
+  "08-10": "Por San Lorenzo, calor que da esperanza al otoño.",
+  "08-15": "Por la Asunción, el verano en su culminación o ya en declive.",
+  "08-24": "Por San Bartolomé, el verano al trastrás se fue.",
+  "09-01": "Septiembre lluvioso, invierno riguroso.",
+  "09-08": "Por la Virgen de Septiembre, el calor a veces se rinde.",
+  "09-29": "Por San Miguel, el verano deja su miel.",
+  "10-01": "Octubre frío, invierno brío.",
+  "10-04": "Por San Francisco, las nueces caen del palo.",
+  "10-12": "Por el Pilar, quien no ha sembrado, ya puede andar.",
+  "10-18": "Lluvia por San Lucas, lluvia por muchas semanas.",
+  "10-28": "Por San Simón y San Judas, las cigüeñas están mudas.",
+  "11-01": "Si el día de Todos los Santos hace sol, la Navidad será con dolor.",
+  "11-11": "Por San Martín, el buey al establo y el vino al festín.",
+  "11-22": "Por Santa Cecilia, si hiela, duro invierno se estila.",
+  "11-25": "Por Santa Catalina, nieve o escarcha la colina.",
+  "11-30": "Por San Andrés, el frío es lo que ves.",
+  "12-04": "Santa Bárbara tronó, quien no sembró ya no sembró.",
+  "12-06": "Por San Nicolás, el invierno está más acá.",
+  "12-08": "Si por la Inmaculada hiela, la Navidad estará fresca.",
+  "12-13": "Por Santa Lucía, mengua la noche y crece el día.",
+  "12-21": "Solsticio de invierno: el frío mayor está encima.",
+  "12-24": "Navidad en balcón, Pascua en tizón.",
+  "12-25": "Navidad seca, año de seca.",
+  "12-31": "Si en San Silvestre el viento es del norte, el invierno será fuerte."
+}

calendarium@kami911/files/calendarium@kami911/data/folkdays/fr.json

@@ -0,0 +1,64 @@
+{
+  "01-01": "À la Saint-Sylvestre, si le vent souffle de l'est, l'année sera froide.",
+  "01-06": "Quand les Rois sont beaux, les greniers seront pleins.",
+  "01-13": "Saint-Hilaire est le plus froid de l'année.",
+  "01-20": "À la Saint-Sébastien, s'il fait beau, l'hiver s'en va.",
+  "01-22": "Saint-Vincent ensoleillé, bon vin dans le tonneau.",
+  "01-25": "À la conversion de saint Paul, s'il fait beau, l'été sera chaud.",
+  "02-02": "À la Chandeleur, l'hiver se meurt ou prend vigueur.",
+  "02-03": "Saint-Blaise annonce le printemps ou prolonge l'hiver.",
+  "02-14": "À la Saint-Valentin, les oiseaux choisissent leur destin.",
+  "02-22": "Sainte-Isabelle souvent apporte une douceur printanière.",
+  "02-24": "Après saint Mathias, plus de fortes gelées.",
+  "03-01": "En mars, quand il fait beau, l'été sera mauvais.",
+  "03-09": "Sainte-Françoise, belle journée, bonne saison pour semer.",
+  "03-12": "À la Saint-Grégoire, si le soleil brille, le blé sera beau.",
+  "03-17": "Saint-Patrick : s'il pleut, pluvieux sera l'été.",
+  "03-19": "À la Saint-Joseph, si le temps est doux, bon printemps nous aura.",
+  "03-25": "Pluie à l'Annonciation : quarante jours de pluie en saison.",
+  "04-04": "À la Saint-Isidore, la hirondelle est de retour.",
+  "04-14": "À mi-avril, sème à la volée, beau grain sera récolté.",
+  "04-23": "À la Saint-Georges, plante ton jardin sans remords.",
+  "04-25": "Pluie à la Saint-Marc, pluie quarante jours sur la terre.",
+  "05-01": "Mai frais et pluvieux, rend l'été fructueux.",
+  "05-03": "À la Sainte-Croix, les gelées tardives s'éloignent.",
+  "05-12": "Saints de glace : Pancrace, Servais et Boniface – trois jours dangereux.",
+  "05-14": "Après saint Boniface, finis les jours de glace.",
+  "05-25": "À la Sainte-Sophie, si le soleil luit, bon foin sera cueilli.",
+  "06-08": "S'il pleut à la Saint-Médard, il pleut quarante jours plus tard.",
+  "06-11": "Pluie le jour Saint-Barnabé, été pluvieux annoncé.",
+  "06-13": "À la Saint-Antoine, la chaleur s'installe en maîtresse.",
+  "06-20": "Avant la Saint-Jean, la grêle fait du mal ; après, elle est plus rare.",
+  "06-24": "À la Saint-Jean, les blés sont grands.",
+  "06-29": "À la Saint-Pierre, la faux dans la pierre.",
+  "07-02": "Si juillet est pluvieux, l'année est généreuse.",
+  "07-15": "Pluie à la Saint-Donald annonce pluie pour six semaines.",
+  "07-22": "À la Sainte-Marie-Madeleine, les cerises sont dans la plaine.",
+  "07-25": "À la Saint-Jacques, la faux dans l'herbe, la faucille dans le blé.",
+  "07-26": "À la Sainte-Anne, si le soleil brille, belle vendange.",
+  "08-01": "En août, il faut semer les navets.",
+  "08-10": "Saint-Laurent chaud annonce bel automne.",
+  "08-15": "À l'Assomption, l'été bat son plein ou commence à décliner.",
+  "08-24": "À la Saint-Barthélemy, l'été dit adieu.",
+  "08-25": "À la Saint-Louis, la chaleur finit.",
+  "09-01": "Septembre pluvieux, hiver précoce.",
+  "09-08": "À la Nativité de la Vierge, si le beau temps règne, bel automne.",
+  "09-14": "À la Sainte-Croix, les hirondelles s'en vont.",
+  "09-29": "À la Saint-Michel, l'été dit son dernier mot.",
+  "10-01": "Sainte-Thérèse froide annonce un rude hiver.",
+  "10-04": "À la Saint-François, les noix tombent.",
+  "10-18": "Pluie à la Saint-Luc, pluie pour longtemps.",
+  "10-28": "À la Saint-Simon, les hirondelles sont parties depuis longtemps.",
+  "11-01": "Si la Toussaint est belle, Noël sera froid.",
+  "11-11": "À la Saint-Martin, l'été reprend ou l'hiver commence.",
+  "11-25": "Sainte-Catherine en givre annonce un dur hiver.",
+  "11-30": "À la Saint-André, le gel et la neige sont au rendez-vous.",
+  "12-04": "Sainte-Barbe givrée, Noël enneigé.",
+  "12-06": "À la Saint-Nicolas, l'hiver est là.",
+  "12-08": "Si l'Immaculée Conception est froide, Noël sera doux.",
+  "12-13": "À la Sainte-Lucie, les nuits raccourcissent un tout petit peu.",
+  "12-21": "Solstice d'hiver : les jours rallongent, le froid se renforce.",
+  "12-24": "Noël au balcon, Pâques au tison.",
+  "12-25": "Noël blanc, Pâques au soleil.",
+  "12-31": "Dernier jour de l'an : vent du nord, hiver long."
+}