calendarium-romanum 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b9480b0f651cac34e75c9b46bcf5d1be6cd6cd82
-  data.tar.gz: 6bc42d50fd376ab9ad14a75e9396f9b84a87c6a5
+  metadata.gz: 3f03289cd9ccaa431cf73253540580d536eeee2a
+  data.tar.gz: 42b4c38cf3f8269573bf609d147299027223c59a
 SHA512:
-  metadata.gz: 273cfd23765b4c7c36b41350cf0fa6330b97cd7e40ca5b8d07698afa6ae10577e1a87724e481473d5bd50a13235217183c5d53df7afb01d357046d6cb6182775
-  data.tar.gz: f3d83d90c16d03a210d006385cf30472cb981b8c3bdf5b466f2492085357d82efb47ef560625a34f2e5ab63f72eb775ba6ee71fda182d5d3ec57c66df2dc8782
+  metadata.gz: 10a1d987dbcab6e3cf9685acc491e216212872b66a4f5438621503f1883b49060cb1812582dbe258dc570aedb1890c5d7e9c5b9f36f0db7208de2518431bde4d
+  data.tar.gz: 67441557436e16191e974bc2c666231b7676d8f159f7b5ba761d2e83a1f54ae538f6d1e152a30255fa7c37bc907af670996c60395e139c151d691cf82921f0f9

data/config/locales/cs.yml

@@ -16,7 +16,35 @@ cs:
       holy_trinity: Nejsvětější Trojice
       body_blood: Těla a krve Páně
       sacred_heart: Nejsvětějšího srdce Ježíšova
+      immaculate_heart: Neposkvrněného Srdce Panny Marie
       christ_king: Ježíše Krista krále
+    extension:
+      christ_eternal_priest: Ježíše Krista, nejvyššího a věčného kněze
+    ordinary:
+      sunday: '%{week} neděle v mezidobí'
+      ferial: '%{weekday} %{week} týdne v mezidobí'
+    advent:
+      sunday: '%{week} neděle adventní'
+      ferial: '%{weekday} po %{week} neděli adventní'
+    christmas:
+      nativity_octave:
+        ferial: '%{day} den v oktávu Narození Páně'
+      sunday: '%{week} neděle po Narození Páně'
+      ferial: '%{weekday} po oktávu Narození Páně'
+      after_epiphany:
+        ferial: '%{weekday} po Zjevení Páně'
+    lent:
+      after_ashes:
+        ferial: '%{weekday} po Popeleční středě'
+      sunday: '%{week} neděle postní'
+      ferial: '%{weekday} po %{week} neděli postní'
+      holy_week:
+        ferial: '%{weekday} Svatého týdne'
+    easter:
+      octave:
+        ferial: '%{weekday} v oktávu velikonočním'
+      sunday: '%{week} neděle velikonoční'
+      ferial: '%{weekday} po %{week} neděli velikonoční'
   rank:
     '1_1': Velikonoční triduum
     '1_2': Primární liturgické dny
@@ -37,4 +65,12 @@ cs:
       sunday: neděle
       memorial: památka
       memorial_opt: nezávazná památka
-      ferial: ferie
+      ferial: ferie
+  weekday:
+    '0': Neděle
+    '1': Pondělí
+    '2': Úterý
+    '3': Středa
+    '4': Čtvrtek
+    '5': Pátek
+    '6': Sobota

data/config/locales/en.yml

@@ -16,7 +16,33 @@ en:
       holy_trinity: The Most Holy Trinity
       body_blood: The Most Holy Body and Blood of Christ
       sacred_heart: The Most Sacred Heart of Jesus
+      immaculate_heart: Immaculate Heart of Mary
       christ_king: Our Lord Jesus Christ, King of the Universe
+    ordinary:
+      sunday: '%{week} Sunday in Ordinary Time'
+      ferial: '%{weekday}, %{week} week in Ordinary Time'
+    advent:
+      sunday: '%{week} Sunday of Advent'
+      ferial: '%{weekday}, %{week} week of Advent'
+    christmas:
+      nativity_octave:
+        ferial: '%{day} day of Christmas Octave'
+      sunday: '%{week} Sunday after the Nativity of the Lord'
+      ferial: '%{weekday} after Christmas Octave'
+      after_epiphany:
+        ferial: '%{weekday} after Epiphany'
+    lent:
+      after_ashes:
+        ferial: '%{weekday} after Ash Wednesday'
+      sunday: '%{week} Sunday of Lent'
+      ferial: '%{weekday}, %{week} week of Lent'
+      holy_week:
+        ferial: '%{weekday} of Holy Week'
+    easter:
+      octave:
+        ferial: 'Easter %{weekday}'
+      sunday: '%{week} Sunday of Easter'
+      ferial: '%{weekday}, %{week} week of Easter'
   rank:
     '1_1': Easter triduum
     '1_2': Primary liturgical days
@@ -31,10 +57,20 @@ en:
     '3_11': Proper obligatory memorials
     '3_12': Optional memorials
     '3_13': Ferials
+    '4_0': Commemorations
     short:
       solemnity: solemnity
       feast: feast
       sunday: Sunday
       memorial: memorial
       memorial_opt: optional memorial
-      ferial: ferial
+      ferial: ferial
+      commemoration: commemoration
+  weekday:
+    '0': Sunday
+    '1': Monday
+    '2': Tuesday
+    '3': Wednesday
+    '4': Thursday
+    '5': Friday
+    '6': Saturday

data/config/locales/it.yml

@@ -6,7 +6,7 @@ it:
       mother_of_god: Ottava di Natale. Maria Santissima Madre di Dio
       epiphany: Epifania del Signore
       baptism_of_lord: Battesimo del Signore
-      ash_wednesday:
+      ash_wednesday: Mercoledì delle ceneri
       palm_sunday: Domenica delle palme
       good_friday: Venerdì santo
       holy_saturday: Sabato santo
@@ -16,7 +16,33 @@ it:
       holy_trinity: Santissima Trinità
       body_blood: Santissimo Corpo e Sangue di Cristo
       sacred_heart: Sacro Cuore di Gesù
+      immaculate_heart: Cuore Immacolato di Maria
       christ_king: "Nostro Signore Gesù Cristo Re dell'universo"
+    ordinary:
+      sunday: '%{week} Domenica del Tempo Ordinario'
+      ferial: '%{weekday} della %{week} settimana del Tempo Ordinario'
+    advent:
+      sunday: '%{week} Domenica Avvento'
+      ferial: '%{weekday}, %{week} Avvento'
+    christmas:
+      nativity_octave:
+        ferial: '%{day}, Ottava di Natale'
+      sunday: 'Domenica %{week}, Tempo di Natale'
+      ferial: '%{weekday}, Tempo di Natale'
+      after_epiphany:
+        ferial: '%{weekday} dopo la Epifania del Signore'
+    lent:
+      after_ashes:
+        ferial: '%{weekday} dopo le Ceneri'
+      sunday: 'Domenica %{week} di Quaresima'
+      ferial: '%{weekday}, %{week} di Quaresima'
+      holy_week:
+        ferial: '%{weekday}, Settimana Santa'
+    easter:
+      octave:
+        ferial: '%{weekday}, Ottava di Pasqua'
+      sunday: 'Domenica %{week} di Pasqua'
+      ferial: '%{weekday}, %{week} di Pasqua'
   rank:
     '1_1': Easter triduum
     '1_2': Primary liturgical days
@@ -37,4 +63,12 @@ it:
       sunday: domenica
       memorial: memoria
       memorial_opt: memoria facoltative
-      ferial: feria
+      ferial: feria
+  weekday:
+    '0': Domenica
+    '1': Lunedì
+    '2': Martedì
+    '3': Mercoledì
+    '4': Giovedì
+    '5': Venerdì
+    '6': Sabato

data/config/locales/la.yml

@@ -16,7 +16,33 @@ la:
       holy_trinity: Sanctissimae Trinitatis
       body_blood: Sanctissimi Corporis et Sanguinis Christi
       sacred_heart: Sacratissimi Cordis Iesu
+      immaculate_heart: Immaculati Cordis B. Mariae Virginis
       christ_king: Domini nostri Iesu Christi universorum regis
+    ordinary:
+      sunday: 'Dominica %{week} per annum'
+      ferial: '%{weekday}, hebdomada %{week} per annum'
+    advent:
+      sunday: 'Dominica %{week} Adventus'
+      ferial: '%{weekday}, hebdomada %{week} Adventus'
+    christmas:
+      nativity_octave:
+        ferial: 'De die %{day} infra octavam Nativitatis'
+      sunday: 'Dominica %{week} post Nativitatem'
+      ferial: '%{weekday} post octavam Nativitatis'
+      after_epiphany:
+        ferial: '%{weekday} post Epiphaniam'
+    lent:
+      after_ashes:
+        ferial: '%{weekday} post Cineres'
+      sunday: 'Dominica %{week} Quadragesimae'
+      ferial: '%{weekday}, hebdomada %{week} Quadragesimae'
+      holy_week:
+        ferial: '%{weekday} Hebdomadae Sanctae'
+    easter:
+      octave:
+        ferial: '%{weekday} infra octavam Paschae'
+      sunday: 'Dominica %{week} Paschae'
+      ferial: '%{weekday}, hebdomada %{week} temporis paschalis'
   rank:
     '1_1': Triduum paschale
     '1_2': Dies liturgici primarii
@@ -37,4 +63,12 @@ la:
       sunday: dominica
       memorial: memoria
       memorial_opt: memoria ad libitum
-      ferial: feria
+      ferial: feria
+  weekday:
+    '0': Dominica
+    '1': Feria secunda
+    '2': Feria tertia
+    '3': Feria quarta
+    '4': Feria quinta
+    '5': Feria sexta
+    '6': Sabbato

data/data/README.md

@@ -34,10 +34,56 @@ DAY must be a number valid as a possible date in the given month.
 31 is not valid in April, as there is never April 31st.)
 
 RANK is a single letter m=memorial, f=feast, s=solemnity.
-If omitted, optional memorial is default.
-The letter can be followed by a number, e.g. ```f2.5``` - the number
-must be valid celebration rank priority as defined in
+If omitted, optional memorial is assumed.
+
+When it is desirable to specify rank of a celebration
+with greater precision, e.g. in order to distinguish feasts
+inscribed in the General Roman Calendar from proper feasts,
+use rank number instead of a rank letter.
+Rank priority numbers are defined in
 [lib/calendarium-romanum/enums.rb](../lib/calendarium-romanum/enums.rb)
+and correspond to section and subsection numbers in
+the Table of Liturgical Days
+(see end of the [General Norms](https://www.ewtn.com/library/CURIA/CDWLITYR.HTM)).
+This is why the sequence is non-continuous:
+`1.4` is followed by `2.5` and `2.9` by `3.10`.
+
+The example below presents pairs of equivalent lines,
+the first one specifying rank by letter, the second one by number.
+Rank letters are always interpreted as if the celebration
+was inscribed in the General Roman Calendar.
+
+```
+3/19 s : Saint Joseph Husband of the Blessed Virgin Mary
+3/19 1.3 : Saint Joseph Husband of the Blessed Virgin Mary
+
+1/25 f : The Conversion of Saint Paul, apostle
+1/25 2.7 : The Conversion of Saint Paul, apostle
+
+1/26 m : Saints Timothy and Titus, bishops
+1/26 3.10 : Saints Timothy and Titus, bishops
+
+1/27 : Saint Angela Merici, virgin
+1/27 3.12 : Saint Angela Merici, virgin
+```
+
+As an example of a proper celebration (which requires rank number
+when exact ranking is important) let's use solemnity of the
+principal patron of Bohemia, martyr duke St. Wenceslas:
+
+```
+9/28 1.4 R : Sv. Václava, mučedníka, hlavního patrona českého národa
+```
+
+When you have dificulties remembering meanings of the numbers,
+but are comfortable with rank letters, it might be helpful for you
+to use rank numbers *alongside* the letters.
+This is supported too, you will find this format used throughout
+the bundled data files.
+
+```
+9/28 s1.4 R : Sv. Václava, mučedníka, hlavního patrona českého národa
+```
 
 COLOUR is a single letter R=red, W=white (G=green, V=violet normally
 shouldn't be necessary in a sanctorale calendar, but both are available
@@ -54,7 +100,7 @@ Included is a script controlling correctness of data files
 and printing detected errors
 
 ```
-$ ruby bin/calendariumrom.rb errors path/to/my/datafile.txt
+$ calendariumrom errors path/to/my/datafile.txt
 ```
 
 ## How to use the Czech calendars
@@ -85,3 +131,15 @@ The tree of correct combinations looks like this:
     * `czech-olomouc-cs.txt`
     * `czech-brno-cs.txt`
     * `czech-ostrava-cs.txt`
+
+`SanctoraleFactory` is a helper class making it really easy
+to build `Sanctorale` from multiple layers:
+
+```ruby
+CR = CalendariumRomanum
+layers = %w(czech-cs czech-cechy-cs czech-praha-cs).collect do |id|
+  CR::Data[id].load
+end
+
+layered_sanctorale = CR::SanctoraleFactory.create_layered(*layers)
+```

data/data/czech-brno-cs.txt

@@ -1,5 +1,13 @@
-# Czech Republic
-# diocese of Brno
+---
+title: kalendář brněnské diecéze
+description: Calendar for diocese of Brno, Czech Republic
+locale: cs
+country: cz
+diocese: Brno
+extends:
+  - czech-cs.txt
+  - czech-morava-cs.txt
+---
 
 5/21 f2.8 : Výročí posvěcení katedrály sv. Petra a Pavla
 5/30 m3.11 : Sv. Zdislavy

data/data/czech-budejovice-cs.txt

@@ -1,5 +1,13 @@
-# Czech Republic
-# diocese of České Budějovice
+---
+title: kalendář českobudějovické diecéze
+description: Calendar for diocese of České Budějovice, Czech Republic
+locale: cs
+country: cz
+diocese: České Budějovice
+extends:
+  - czech-cs.txt
+  - czech-cechy-cs.txt
+---
 
 6/19 m3.11 : Sv. Jana Nepomuckého Neumanna, biskupa
 

data/data/czech-cechy-cs.txt

@@ -1,5 +1,12 @@
-# Czech Republic
-# province of Bohemia
+---
+title: kalendář české církevní provincie
+description: Calendar for province of Bohemia
+locale: cs
+country: cz
+province: Bohemia
+extends:
+  - czech-cs.txt
+---
 
 5/30 m3.11 : Sv. Zdislavy
 

data/data/czech-cs.txt

@@ -1,5 +1,11 @@
-# Calendar for the dioceses of Czech Republic
+---
+title: Český národní kalendář
+description: Calendar for the dioceses of Czech Republic
+locale: cs
+country: cz
+temporale_extensions: [ChristEternalPriest]
 # source: http://cs.wikipedia.org/wiki/%C4%8Cesk%C3%BD_liturgick%C3%BD_kalend%C3%A1%C5%99
+---
 
 = 1
 2 m : Sv. Basila Velikého a Řehoře Naziánského, biskupů a učitelů církve

data/data/czech-hradec-cs.txt

@@ -1,5 +1,13 @@
-# Czech Republic
-# diocese of Hradec Králové
+---
+title: kalendář královéhradecké diecéze
+description: Calendar for diocese of Hradec Králové, Czech Republic
+locale: cs
+country: cz
+diocese: Hradec Králové
+extends:
+  - czech-cs.txt
+  - czech-cechy-cs.txt
+---
 
 10/30 f2.8 : Výročí posvěcení katedrály Sv. Ducha
 

data/data/czech-litomerice-cs.txt

@@ -1,5 +1,13 @@
-# Czech Republic
-# diocese of Litomerice
+---
+title: kalendář litoměřické diecéze
+description: Calendar for diocese of Litoměřice, Czech Republic
+locale: cs
+country: cz
+diocese: Litoměřice
+extends:
+  - czech-cs.txt
+  - czech-cechy-cs.txt
+---
 
 5/30 f2.8 : Sv. Zdislavy, hlavní patronky diecéze
 

data/data/czech-morava-cs.txt

@@ -1,5 +1,12 @@
-# Czech Republic
-# province of Moravia
+---
+title: kalendář moravské církevní provincie
+description: Calendar for province of Moravia
+locale: cs
+country: cz
+province: Moravia
+extends:
+  - czech-cs.txt
+---
 
 5/6 m3.11 R : Sv. Jana Sarkandra, kněze a mučedníka
 5/20 m3.11 : Sv. Klementa Marie Hofbauera, kněze

data/data/czech-olomouc-cs.txt

@@ -1,4 +1,12 @@
-# Czech Republic
-# archdiocese of Olomouc
+---
+title: kalendář olomoucké arcidiecéze
+description: Calendar for archdiocese of Olomouc, Czech Republic
+locale: cs
+country: cz
+diocese: Olomouc
+extends:
+  - czech-cs.txt
+  - czech-morava-cs.txt
+---
 
 6/30 f2.8 : Výročí posvěcení katedrály sv. Václava

data/data/czech-ostrava-cs.txt

@@ -1,5 +1,13 @@
-# Czech Republic
-# diocese of Ostrava and Opava
+---
+title: kalendář ostravsko-opavské diecéze
+description: Calendar for diocese of Ostrava and Opava, Czech Republic
+locale: cs
+country: cz
+diocese: Ostrava, Opava
+extends:
+  - czech-cs.txt
+  - czech-morava-cs.txt
+---
 
 7/16 f2.8 : Výročí posvěcení katedrály Božského Spasitele