-
- 
-
- 
-
- 
-
- 
-
-
+
+ Available artlinks
+Use the keyword in the settings.yaml to change the cover image.
+
+
+ Announcements
+
+
+
+
+
+
+
+
+ {% if officers is defined and meeting_type != "generalconference" %}
+
+
+
+ {% endif %} + + {% if meeting_type == "generalconference" %} +
+
+
+ {% endif %} + +
+
+
+ {% if quote_of_the_month is defined %}
+
+
+ {% endif %}
+
+
+ {% if (announcements is defined or posters is defined) and (announcements or posters) %}
+
+
+ {% endif %}
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/utils.py b/docs/utils.py
new file mode 100644
index 0000000..cc14d7d
--- /dev/null
+++ b/docs/utils.py
@@ -0,0 +1,177 @@
+import datetime as dt
+from dateutil.rrule import rrule, MONTHLY, WEEKLY, SU, MO, TU, WE, TH, FR, SA
+
+
+def get_nearest_saturday_cleaning(cleaning_list, n=2):
+ """
+ Find the next N Saturdays and their corresponding cleaning assignments.
+
+ Args:
+ cleaning_list (dict): A dictionary where keys are `datetime.date` objects
+ representing cleaning dates, and values are strings of cleaning assignments.
+ n (int, optional): The number of upcoming Saturdays to find. Defaults to 2.
+
+ Returns:
+ list[dict]: A list of dictionaries, each containing:
+ - 'date' (str): The formatted date of the Saturday in "DD Month YYYY" format. Example: '30 November 2024'
+ - 'assignment' (str): The cleaning assignment for that Saturday.
+
+ Example:
+ [
+ {'date': '30 November 2024', 'assignment': 'Name1, Name2'},
+ {'date': '14 December 2024', 'assignment': 'Name3, Name4'}
+ ]
+ """
+ # Get today's date
+ today = dt.date.today()
+
+ # Find the next N Saturdays starting from today
+ upcoming_saturdays = list(rrule(freq=WEEKLY, byweekday=SA, count=n, dtstart=today))
+
+ # Match Saturdays with assignments
+ results = []
+ for saturday in upcoming_saturdays:
+ assignment = cleaning_list.get(saturday.date(), None)
+ if assignment:
+ results.append(
+ {"date": saturday.date().strftime("%d %B %Y"),
+ "assignment": assignment}
+ )
+
+ return results
+
+def get_nearest_sunday():
+ """
+ Find the closest upcoming Sunday date, including today if it's already Sunday.
+
+ Returns:
+ datetime.date: The closest upcoming Sunday as a `datetime.date` object.
+
+ If today is Sunday, returns today's date.
+ Otherwise, calculates and returns the date of the next Sunday.
+
+ Example:
+ If today is Friday, November 24, 2024, returns datetime.date(2024, 11, 26)
+ """
+ today = dt.date.today()
+ daynum = today.weekday() # Sunday is day #6
+
+ if daynum == 6:
+ return today
+ else:
+ next_sunday_date = today + dt.timedelta(6 - daynum)
+ return next_sunday_date
+
+def str_to_date(_var):
+ """
+ Convert a string representation of a date into a `datetime.date` object.
+
+ Args:
+ _var (str): A string representing a date in the format "DD Month YYYY".
+
+ Returns:
+ datetime.date: The corresponding `datetime.date` object.
+
+ Raises:
+ ValueError: If the input string does not match the expected format.
+
+ Example:
+ 27 November 2024" -> datetime.date(2024, 11, 27)
+ ```
+ """
+ # Convert string format "27 November 2024" to a datetime.date object
+ return dt.datetime.strptime(_var, "%d %B, %Y").date()
+
+def format_date_ordinal(_date):
+ """
+ Format a date object as a string with an ordinal suffix (e.g., "March 17th" or "January 21st").
+
+ Args:
+ _date (datetime.date): A `datetime.date` object representing the date to format.
+
+ Returns:
+ str: The formatted date string with an ordinal suffix in the format "Month DDth/st/nd/rd".
+
+ Example:
+ date(2024, 3, 17) -> "March 17th"
+ date(2024, 11, 22) -> "November 22nd"
+ """
+ day = _date.day
+ suffix = "th" if 11 <= day <= 13 else {1: "st", 2: "nd", 3: "rd"}.get(day % 10, "th")
+ formatted_date = _date.strftime(f"%B {day}{suffix}")
+ return formatted_date
+
+def weekday_to_int(target_weekday):
+ """
+ Convert a weekday name to its corresponding `dateutil.rrule` weekday constant.
+
+ Args:
+ target_weekday (str): The name of the weekday (case-insensitive).
+ Valid values: "monday", "tuesday", "wednesday", "thursday",
+ "friday", "saturday", "sunday".
+
+ Returns:
+ dateutil.rrule.weekday: The `dateutil.rrule` constant corresponding to the weekday.
+
+ Raises:
+ KeyError: If the input is not a valid weekday name.
+
+ Example:
+ weekday_to_int("Monday") -> dateutil.rrule.MO
+ """
+ weekday_map = {
+ "monday": MO,
+ "tuesday": TU,
+ "wednesday": WE,
+ "thursday": TH,
+ "friday": FR,
+ "saturday": SA,
+ "sunday": SU
+ }
+ res = weekday_map[str(target_weekday).lower()]
+ return res
+
+def next_temple_day(target_weekday, target_week_of_month, closures_list):
+ """
+ Calculate the next temple day based on the specified weekday, week of the month, and closure intervals.
+
+ Args:
+ target_weekday (dateutil.rrule.weekday): The target weekday (e.g., `dateutil.rrule.SA` for Saturday).
+ target_week_of_month (int): The week of the month (e.g., 1 for the first week, 3 for the third week).
+ closures_list (list of tuple): A list of date ranges representing closure intervals.
+ Each tuple contains two `datetime.date` objects (start, end) representing the closed period.
+ If the temple is closed for one day, start and end have the same value.
+
+ Returns:
+ str: The next open temple day in the format "DD Month YYYY".
+
+ Raises:
+ ValueError: If no valid open date is found.
+ """
+
+ # Get today's date
+ today = dt.date.today()
+
+ # Find the next eligible date (Month on week target_week_of_month on day target_weekday)
+ for date in rrule(
+ freq=MONTHLY,
+ byweekday=target_weekday,
+ bysetpos=target_week_of_month,
+ dtstart=today
+ ):
+ # Convert the date to datetime.date
+ date = date.date()
+
+ # Skip if the date falls within any closure range
+ if any(start <= date <= end for start, end in closures_list):
+ continue
+
+ # Return the first valid open date
+ return date.strftime("%d %B %Y")
+
+ # If no date is found (unlikely with this logic), return None or raise an error
+ raise ValueError("No valid open date found.")
+
+
+#if __name__=="__main__":
+ #print(get_nearest_sunday())
\ No newline at end of file
+ {% for key, value in artlinks.items() %}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/template_index.html b/docs/template_index.html
new file mode 100644
index 0000000..f434d68
--- /dev/null
+++ b/docs/template_index.html
@@ -0,0 +1,298 @@
+
+
+
+
+
+
+
+
+
+ {% endfor %}
+
+ 
+
+
+
+ Keyword: {{ key }}
+
+
+ {{ unit }}
+ {% if meeting_type == "sacrament" %} +{{ meeting_sacrament.title }}
+ {% elif meeting_type == "testimony" %} +{{ meeting_testimony.title }}
+ {% elif meeting_type == "ward" %} +{{ meeting_ward.title }}
+ {% elif meeting_type == "stake" %} +{{ meeting_stake.title }}
+ {% elif meeting_type == "generalconference" %} +{{ meeting_generalconference.title }}
+ {% elif meeting_type == "easter" %} +{{ meeting_easter.title }}
+ {% elif meeting_type == "christmas" %} +{{ meeting_christmas.title }}
+ {% elif meeting_type == "primary" %} +{{ meeting_primary.title }}
+ {% endif %} +{{ date }}
+
+
+
+
+
+ {% for officer in officers %}
+ {% for title, name in officer.items() %}
+
+ {{ title }}: {{ name }}
+ {% endfor %} + {% endfor %} ++ {% endif %} + + {% if meeting_type == "generalconference" %} +
+
+
+
+
+
+ General Conference
+Everyone of all faiths, beliefs, and background is invited to watch, listen, and participate in General Conference
++ {% endif %} + +
+
+
+
+
+ + + {% if meeting_type != "generalconference" and meeting_type != "stake" %} +
Opening Hymn
+#{{ hymns.opening.number }}, {{ hymns.opening.title }}
+Sacrament Hymn
+#{{ hymns.sacrament.number }}, {{ hymns.sacrament.title }}
+ {% endif %} + + {% if meeting_type == "sacrament" %} + {% for item in meeting_sacrament.program %} + {% if item.type == "speaker" %} +Speaker
+{{ item.name }}
+ {% elif item.type == "intermediate_hymn" %} +Intermediate Hymn
+#{{ hymns.intermediate.number }}, {{ hymns.intermediate.title }}
+ {% elif item.type == "music" %} +Music Number
+{{ item.title }}, {{ item.description }}
+ {% elif item.type == "custom" %} +{{ item.title }}
+{{ item.description }}
+ {% endif %} + {% endfor %} + + {% elif meeting_type == "testimony" %} + {% for item in meeting_testimony.program %} + {% if item.type == "speaker" %} +Speaker
+{{ item.name }}
+ {% elif item.type == "intermediate_hymn" %} +Intermediate Hymn
+#{{ hymns.intermediate.number }}, {{ hymns.intermediate.title }}
+ {% elif item.type == "music" %} +Music Number
+{{ item.title }}, {{ item.description }}
+ {% elif item.type == "custom" %} +{{ item.title }}
+{{ item.description }}
+ {% endif %} + {% endfor %} + + {% elif meeting_type == "ward" %} + {% for item in meeting_ward.program %} + {% if item.type == "speaker" %} +Speaker
+{{ item.name }}
+ {% elif item.type == "intermediate_hymn" %} +Intermediate Hymn
+#{{ hymns.intermediate.number }}, {{ hymns.intermediate.title }}
+ {% elif item.type == "music" %} +Music Number
+{{ item.title }}, {{ item.description }}
+ {% elif item.type == "custom" %} +{{ item.title }}
+{{ item.description }}
+ {% endif %} + {% endfor %} + + {% elif meeting_type == "easter" %} + {% for item in meeting_easter.program %} + {% if item.type == "speaker" %} +Speaker
+{{ item.name }}
+ {% elif item.type == "intermediate_hymn" %} +Intermediate Hymn
+#{{ hymns.intermediate.number }}, {{ hymns.intermediate.title }}
+ {% elif item.type == "music" %} +Music Number
+{{ item.title }}, {{ item.description }}
+ {% elif item.type == "custom" %} +{{ item.title }}
+{{ item.description }}
+ {% endif %} + {% endfor %} + + {% elif meeting_type == "christmas" %} + {% for item in meeting_christmas.program %} + {% if item.type == "speaker" %} +Speaker
+{{ item.name }}
+ {% elif item.type == "intermediate_hymn" %} +Intermediate Hymn
+#{{ hymns.intermediate.number }}, {{ hymns.intermediate.title }}
+ {% elif item.type == "music" %} +Music Number
+{{ item.title }}, {{ item.description }}
+ {% elif item.type == "custom" %} +{{ item.title }}
+{{ item.description }}
+ {% endif %} + {% endfor %} + + {% elif meeting_type == "primary" %} + {% for item in meeting_primary.program %} + {% if item.type == "speaker" %} +Speaker
+{{ item.name }}
+ {% elif item.type == "intermediate_hymn" %} +Intermediate Hymn
+#{{ hymns.intermediate.number }}, {{ hymns.intermediate.title }}
+ {% elif item.type == "music" %} +Music Number
+{{ item.title }}, {{ item.description }}
+ {% elif item.type == "custom" %} +{{ item.title }}
+{{ item.description }}
+ {% endif %} + {% endfor %} + + {% elif meeting_type == "stake" %} + {% for item in meeting_stake.program %} + {% if item.type == "custom" %} +{{ item.title }}
+{{ item.description }}
+ {% endif %} + {% endfor %} + + {% elif meeting_type == "generalconference" %} + {% for item in meeting_generalconference.program %} + {% if item.type == "custom" %} +{{ item.title }}
+{{ item.description }}
+ {% elif item.type == "url" %} +{{ item.title }}
+ {% endif %} + {% endfor %} + {% endif %} + + + {% if meeting_type != "generalconference" and meeting_type != "stake" %} +Closing Hymn
+ + {% endif %} + + +
+
+
+
+
+
+ +
{{ quote_of_the_month.quote }}
+- {{ quote_of_the_month.author }}
+ +
+
+
+
+
+ 
+ {% endfor %}
+
+ +
Announcements
+ {% for announcement in announcements %} +{{ announcement }}
+ {% endfor %} + {% for poster in posters %} +
+
+
+
+
+
+
+ + + {% if next_cleaning_assignments is not none and next_cleaning_assignments and calendar.cleaning is defined %} +
Cleaning assignments
+ + {% for item in next_cleaning_assignments %} +{{ item.date }} {{ item.assignment }}
+ {% endfor %} + {% endif %} + + {% if calendar is defined %} +Calendar Items
+ + {% if next_temple_day is not none and calendar.temple_day is defined %} +{{ next_temple_day_title }} {{ next_temple_day }}
+ {% endif %} + + {% for item in calendar.custom %} +{{ item.title }}: {{ item.description }}
+ {% endfor %} + {% endif %} + {% if links is defined %} ++