Module:Calendar/doc

Fantasy Calendar

The FantasyCalendar module generates a customizable fantasy calendar using a six-day week, five-week month, and three-month season.

Calendar Structure

Unit	Length
Week	6 days
Month	5 weeks (30 days)
Season	3 months (90 days)
Year	4 seasons (360 days)

Each month begins on the first day of the week. Because all months are exactly 30 days long, the same dates always fall on the same weekdays.

Basic Usage

To display the calendar with default settings:

{{#invoke:FantasyCalendar|main
|year=1042
}}

This displays all twelve months, organized into four seasons.

Complete Example

The following example demonstrates all the principal customization options.

{{#invoke:FantasyCalendar|main
|year=1042
|view=year
|seasons=Spring,Summer,Autumn,Winter
|months=Aren,Belar,Cerin,Doran,Elmar,Ferin,Galan,Haran,Irin,Joran,Kelar,Loran
|days=First,Second,Third,Fourth,Fifth,Sixth
|mark=5-14
}}

Parameter Reference

Parameter	Description	Default
year	The year displayed above the calendar. This is a label only and does not change the calendar's date calculations.	None
view	Determines how much of the calendar is displayed. Accepted values are year, season, and month.	year
seasons	A comma-separated list of four season names, in chronological order.	Spring, Summer, Autumn, Winter
months	A comma-separated list of twelve month names, in chronological order. The first three belong to the first season, the next three to the second, and so forth.	Month 1 through Month 12
days	A comma-separated list of six weekday names, in order.	Day 1 through Day 6
mark	Highlights a particular calendar date. The format is MONTH-DAY, such as 5-14 for the 14th day of the fifth month.	None
season	Selects a particular season (1–4) when view=season.	1
month	Selects a particular month (1–12) when view=month.	1

Display Options

Full Year

Displays all four seasons and twelve months.

{{#invoke:FantasyCalendar|main
|year=1042
|view=year
}}

Single Season

Displays one season consisting of three months.

{{#invoke:FantasyCalendar|main
|year=1042
|view=season
|season=2
}}

The season parameter determines which season appears:

• 1 = First season (months 1–3)
• 2 = Second season (months 4–6)
• 3 = Third season (months 7–9)
• 4 = Fourth season (months 10–12)

Single Month

Displays one month containing five weeks of six days each.

{{#invoke:FantasyCalendar|main
|year=1042
|view=month
|month=5
}}

The month parameter accepts values from 1 to 12.

Custom Names

Seasons

Season names can be replaced with any four names.

|seasons=Spring,Summer,Autumn,Winter

Months

Supply twelve comma-separated month names.

|months=Aren,Belar,Cerin,Doran,Elmar,Ferin,Galan,Haran,Irin,Joran,Kelar,Loran

These names are assigned sequentially across the year:

Season	Months
Spring	Aren, Belar, Cerin
Summer	Doran, Elmar, Ferin
Autumn	Galan, Haran, Irin
Winter	Joran, Kelar, Loran

Weekdays

Supply six comma-separated weekday names.

|days=First,Second,Third,Fourth,Fifth,Sixth

Every month uses the same six-day sequence, repeated five times.

Highlighting Dates

The mark parameter highlights one date.

|mark=5-14

In this example:

• 5 represents the fifth month.
• 14 represents the fourteenth day.

Only the specified date is highlighted.

The highlighted date must be included in the current calendar view to appear.

Calendar Mathematics

The calendar follows a fixed structure:

• 6 days × 5 weeks = 30 days per month.
• 30 days × 3 months = 90 days per season.
• 90 days × 4 seasons = 360 days per year.

Because every month contains exactly five complete weeks, there are no partial weeks or weekday offsets between months.

The calendar does not currently implement leap days, date conversion, or automatic tracking of the current fictional date.

Installation

The calendar requires:

• Module:FantasyCalendar — Contains the Lua code that generates the calendar.
• MediaWiki:Common.css — Contains the calendar's visual styling.

To use the module, insert the relevant #invoke code into any wiki page.