Oros at 19:57, 16 October 2026

2026-10-16T19:57:47Z

← Older revision		Revision as of 19:57, 16 October 2026
Line 2:		Line 2:
	= Fantasy Calendar =		= Fantasy Calendar =

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

	== Calendar Structure ==		== Calendar Structure ==
Line 30:		Line 30:

	<pre><nowiki>		<pre><nowiki>
	{{#invoke:~~FantasyCalendar~~\|main		{{#invoke:Calendar\|main
	\|year=1042		\|year=1042
	}}		}}
Line 42:		Line 42:

	<pre><nowiki>		<pre><nowiki>
	{{#invoke:~~FantasyCalendar~~\|main		{{#invoke:Calendar\|main
	\|year=1042		\|year=1042
	\|view=year		\|view=year
Line 99:		Line 99:

	<pre><nowiki>		<pre><nowiki>
	{{#invoke:~~FantasyCalendar~~\|main		{{#invoke:Calendar\|main
	\|year=1042		\|year=1042
	\|view=year		\|view=year
Line 110:		Line 110:

	<pre><nowiki>		<pre><nowiki>
	{{#invoke:~~FantasyCalendar~~\|main		{{#invoke:Calendar\|main
	\|year=1042		\|year=1042
	\|view=season		\|view=season
Line 129:		Line 129:

	<pre><nowiki>		<pre><nowiki>
	{{#invoke:~~FantasyCalendar~~\|main		{{#invoke:Calendar\|main
	\|year=1042		\|year=1042
	\|view=month		\|view=month
Line 218:		Line 218:
	The calendar requires:		The calendar requires:

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

Oros: Created page with " = Fantasy Calendar = The '''FantasyCalendar''' module generates a customizable fantasy calendar using a six-day week, five-week month, and three-month season. == Calendar Structure == {| class="wikitable" ! 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 sam..."

2026-10-16T19:56:56Z

Created page with " = Fantasy Calendar = The '''FantasyCalendar''' module generates a customizable fantasy calendar using a six-day week, five-week month, and three-month season. == Calendar Structure == {| class="wikitable" ! 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 sam..."

New page

= Fantasy Calendar =

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

== Calendar Structure ==

{| class="wikitable"
! 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:

<pre><nowiki>
{{#invoke:FantasyCalendar|main
|year=1042
}}
</nowiki></pre>

This displays all twelve months, organized into four seasons.

== Complete Example ==

The following example demonstrates all the principal customization options.

<pre><nowiki>
{{#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
}}
</nowiki></pre>

== Parameter Reference ==

{| class="wikitable"
! 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.

<pre><nowiki>
{{#invoke:FantasyCalendar|main
|year=1042
|view=year
}}
</nowiki></pre>

=== Single Season ===

Displays one season consisting of three months.

<pre><nowiki>
{{#invoke:FantasyCalendar|main
|year=1042
|view=season
|season=2
}}
</nowiki></pre>

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.

<pre><nowiki>
{{#invoke:FantasyCalendar|main
|year=1042
|view=month
|month=5
}}
</nowiki></pre>

The month parameter accepts values from 1 to 12.

== Custom Names ==

=== Seasons ===

Season names can be replaced with any four names.

<pre><nowiki>
|seasons=Spring,Summer,Autumn,Winter
</nowiki></pre>

=== Months ===

Supply twelve comma-separated month names.

<pre><nowiki>
|months=Aren,Belar,Cerin,Doran,Elmar,Ferin,Galan,Haran,Irin,Joran,Kelar,Loran
</nowiki></pre>

These names are assigned sequentially across the year:

{| class="wikitable"
! 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.

<pre><nowiki>
|days=First,Second,Third,Fourth,Fifth,Sixth
</nowiki></pre>

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

== Highlighting Dates ==

The '''mark''' parameter highlights one date.

<pre><nowiki>
|mark=5-14
</nowiki></pre>

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.

[[Category:Module documentation]]

Module:Calendar/doc - Revision history

Oros at 19:57, 16 October 2026