Bản mẫu:Calendar/doc

This template displays either a yearly or monthly calendar (from 1970–2037).

**Parameters**
month
To display a single month the parameter month must be defined. This parameter can be a month name or number, the current month use month=current (next and last are also accepted).
year
The parameter year sets the year of the calendar the default being the current year.
format
To start the week on Monday use either format=Mon1st or, to include ISO week numbers, format=iso. The keywords are case-sensitive.
show_year
To display the year use show_year=on. To show the year after the month use show_year=with month.
txt_pref_m
This adds a prefix to the month name.
txt_suff_m
This adds a suffix to the month name.
float
To float the calendar left or right use float=left or float=right.
lk
To link days, months and years use lk=on.
To link days and months use lk=dm.
To link months and years use lk=my.
To link days and years use lk=dy.
To link days only use lk=d.
To link months only use lk=m.
To link years only use lk=y.
lk_pref
This adds a prefix to all links.
lk_pref_d
This adds a prefix to day links.
lk_pref_m
This adds a prefix to month links.
lk_pref_mnext
This adds a prefix to the next month's link.
lk_pref_mprev
This adds a prefix to the previous month's link.
lk_suff
This adds a suffix to all links.
lk_suff_d
This adds a suffix to day links.
lk_suff_m
This adds a suffix to month links.
lk_suff_mnext
This adds a suffix to the next month's link.
lk_suff_mprev
This adds a suffix to the previous month's link.
prevnext
To add links to the previous and next months use prevnext=on.
title_colour
Use this to change the background colour of the title bar with name of the month, and the bottom bar (e.g. title_colour=#2e8b57).
week_colour
Use this to change the colour of the bar listing the days of the week (e.g. week_colour=#2e8b57).
colour
This is shorthand for both of the above.
wknum_colour
Use this to change the background colour of the ISO week numbers, when using format=iso (e.g. wknum_colour=#2e8b57).
wk5253
Use wk5253=on to start the year with week 52/53, when using format=iso with a year calendar. The only use case for this, is when the year is unknown and it starts with a Saturday. See Common year starting on Saturday as an example.
EndNote
This adds text to the bottom bar.
{
"description": "Display a year or month calendar",
"params": {
"year": {
"label": "Year",
"description": "the ordinal year number of the calendar",
"suggested": true,
"default": "current",
"type": "number"
},
"month": {
"label": "Month",
"description": "whether to display a single month instead of a whole year, and which one",
"example": "current, next, last, 1, January",
"default": "empty",
"suggested": true,
"type": "string"
},
"show_year": {
"label": "Show year",
"description": "whether to display the year number, and where",
"example": "with month, off",
"default": "on",
"type": "boolean"
},
"title": {
"label": "Title text",
"description": "text in the top bar",
"type": "content"
},
"EndNote": {
"label": "End note",
"description": "text in the bottom bar",
"type": "content"
},
"format": {
"label": "Week format",
"description": "The string to be trimmed and counted",
"example": "iso, Mon1st",
"default": "Sun1st",
"type": "string"
},
"col": {
"label": "Months per row",
"description": "Display this many months per row (1, 3, 4 or 6 rows)",
"example": "2, 3, 12",
"default": "4",
"type": "number"
},
"row": {
"label": "Months per column",
"description": "Display this many months per column (3 or 4 cols). If set, overrides ‘col’ parameter.",
"example": "3, 4",
"default": "empty",
"type": "number"
},
"float": {
"label": "Float side",
"description": "Horizontally align the calendar",
"example": "right, left",
"default": "none",
"required": false,
"type": "string"
},
"prevnext": {
"label": "Serial navigation",
"description": "Add links to the previous and next months",
"example": "on",
"type": "boolean"
},
"colour": {
"label": "Background color",
"description": "Default for Title and Week background",
"example": "#2E8B57",
"type": "string"
},
"title_colour": {
"label": "Title background",
"description": "change the background colour of the title bar with name of the month, and the bottom bar",
"inherits": "colour"
},
"week_colour": {
"label": "Week background",
"description": "change the colour of the bar listing the days of the week",
"inherits": "colour"
},
"wknum_colour": {
"label": "ISO week numbers background",
"description": "change the colour of the bar listing the ISO week numbers",
"inherits": "colour"
},
"wk5253": {
"label": "Fixed starting week workaround",
"description": "start the year with week 52/53, when the first day is a Saturday.",
"required": false,
"type": "boolean"
},
"txt_pref_m": {
"label": "Month name prefix",
"description": "Text to add before month names",
"required": false,
"type": "line"
},
"txt_suff_m": {
"label": "Month name suffix",
"description": "Text to add after month names",
"inherits": "txt_pref_m"
},
"lk": {
"label": "Link",
"description": "whether to automatically link days (d), months (m) and years (y)",
"example": "on = dmy, dm, my, dy, d, m, y",
"default": "off",
"required": false,
"type": "string"
},
"lk_pref": {
"label": "Link prefix",
"description": "Text to add before all links",
"inherits": "txt_pref_m"
},
"lk_suff": {
"label": "Link suffix",
"description": "Text to add after all links",
"inherits": "txt_pref_m"
},
"lk_pref_d": {
"label": "Day link prefix",
"description": "Text to add before links to days",
"inherits": "txt_pref_m"
},
"lk_suff_d": {
"label": "Day link suffix",
"description": "Text to add after links to days",
"inherits": "txt_pref_m"
},
"lk_pref_m": {
"label": "Month link prefix",
"description": "Text to add before links to months",
"inherits": "txt_pref_m"
},
"lk_suff_m": {
"label": "Month link suffix",
"description": "Text to add after links to months",
"inherits": "txt_pref_m"
},
"lk_pref_mnext": {
"label": "Next link prefix",
"description": "Text to add before the link to the next month (or year)",
"inherits": "txt_pref_m"
},
"lk_suff_mnext": {
"label": "Next link suffix",
"description": "Text to add after the link to the next month (or year)",
"inherits": "txt_pref_m"
},
"lk_pref_mprev": {
"label": "Previous link prefix",
"description": "Text to add before the link to the previous month (or year)",
"inherits": "txt_pref_m"
},
"lk_suff_mprev": {
"label": "Previous link suffix",
"description": "Text to add after the link to the next month (or year)",
"inherits": "txt_pref_m"
}
}}

**Examples**
produces the calendar above. The calendars below are produced by  and , respectively.

**See also==