Templat:Kotak info cuti
Templat ini menggunakan ciri-ciri sintaks templat yang rumit.
Anda digalakkan untuk membiasakan diri dengan persediaan dan fungsi penghurai sebelum menyunting templat ini. Jika suntingan anda menyebabkan masalah yang tidak diduga, sila undurkannya dengan segera kerana templat ini mungkin digunakan di sebilangan besar halaman. Ingat bahawa anda boleh menjalankan uji kaji dan perlu menguji semua penambahbaikan, sama ada di /kotak pasir atau laman pengguna anda sebelum melakukan sebarang perubahan. (lihat sejarah) |
Templat ini menggunakan Lua: |
Templat ini menggunakan ciri Wikidata berikut: |
The {{Kotak info cuti}}
template adds an infobox with data fields for defining a particular festival or other day of observance.
Usage
sunting{{Infobox holiday | holiday_name = required | type = required | image = | imagesize = | caption = | official_name = | nickname = | observedby = | litcolor = | longtype = | significance = | begins = | ends = | date = | scheduling = <!-- e.g. "same day each year" --> | duration = <!-- e.g. "1 day", "1 week" --> | frequency = <!-- e.g. "Annual", "Every 4 years", "Once" --> <!-- Use next three if holiday is the same day of the same week every year --> | week_ordinal = <!-- "first", "second", "last", etc. --> | weekday = <!-- "Sunday", "Monday", "Friday", etc. --> | month = <!-- "January", "February", "December", etc. --> <!-- Use next four if the date changes in an unusual pattern each year --> | date2023 = <!-- only for days that change each year --> | date2024 = <!-- only for days that change each year --> | date2025 = <!-- only for days that change each year --> | date2026 = <!-- only for days that change each year --> | celebrations = | observances = | relatedto = }}
For an annual holiday occurring on the same day each year:
{{Infobox holiday
| holiday_name = Template Day
| type =
| image =
| imagesize =
| caption =
| official_name =
| nickname =
| observedby =
| litcolor =
| longtype =
| significance =
| begins =
| ends =
| date = 30 February
| scheduling = same day each year
| duration = 1 day
| frequency = Annual
| celebrations =
| observances =
| relatedto =
}}
Parameters
suntingRequired
sunting- holiday_name
- This is the most common holiday name, which appears at the top of the infobox. It should almost always be the name of the article.
- type
- The type of the holiday, for example: national, Judaism, Islamic, etc.
- begins
- required for multi-day holidays - This is the starting date for a multi-day holiday.
- ends
- required for multi-day holidays - This is the ending date for a multi-day holiday.
- date
- required for single-day holidays - This is the date of a single-day holiday. (If you use the week_ordinal/weekday/month parameters below, date will default to a phrase like "First Sunday in January". Otherwise it has no default and is required.). Specific phrases for other rules are decoded in Template:Infobox holiday/date. Sample: "first Thursday after 18 April". If no value is given, the value of d:Property:P837 of the holiday's Wikidata item is displayed instead.
- date2024
- highly recommended for holidays that don't stay on the same Gregorian date - This is the Gregorian date on which the holiday will occur in 2024. At the end of 2024, this will be replaced with date2025, which will later be replaced with date2026. Therefore, it's a good idea to specify the Gregorian date for a few future years. (Not necessary if week_ordinal/weekday/month are specified instead.)
Optional
sunting- image
- This should be an image that represents the holiday. The value is just the simple target-name, not a full wikilink.
- imagesize
- The size of the image (default is 225px).
- caption
- This is a caption that describes the image.
- official_name
- This should contain the official name of the holiday if it is not the holiday_name; this can also be the name of the holiday in its original language
- nickname
- This should hold any nicknames, alternatives, and translations for the holiday_name or official_name
- observedby
- highly recommended - These are the people who celebrate/observe the holiday (e.g. Muslims and Islam, United States, people worldwide)
- litcolor
- This is the liturgical color of the day, if applicable to a religious holiday; or other color which is applicable to the holiday (e.g. green for Saint Patrick's Day)
- longtype
- This is a lengthier description of the type, for example if there are two types that could be defined, for example "Cultural, Historical, Islamic"
- significance
- This is a lengthier description of the holiday's significance
- scheduling
- define the how the date varies (not displayed). Sample value: "same day each year"
- duration
- time the holiday or observance last. Sample values: "1 day", "1 week", "3 days"
- frequency
- the frequency with which the holiday or observance re-occurs. Sample values: "Annual", "Weekly", "Monthly"
- week_ordinal, weekday, month
- For days that are observed on the same day of the same week every year, these specify the week (week_ordinal), day of the week (weekday), and month. If you use these, you no longer have to specify date2023, date2024, date2025 and date2026. If you specify week_ordinal, then weekday and month are required also.
- date2023, date2025, date2026
- recommended for holidays that don't stay on the same Gregorian date - The template will display the previous and next year's dates along with that of the current year, if they are provided. Again, it's a good idea to provide dates for a few years further into the future as well. (Not necessary if week_ordinal/weekday/month are specified instead.)
- mdy
- if set to a non-blank value, auto-formatted dates will be displayed in "month day, year" format instead of the default "day month year" order.
- firsttime
- first time/year the holiday was observed (if available)
- lasttime
- last time/year the holiday was observed (if no longer observed)
- celebrations
- This contains the celebrations that occur on the holiday.
- observances
- This contains essentially the same thing as the celebrations attribute. However, the word observances is used. This may be more appropriate than celebrations when referring to prayer or more solemn observances. Most likely, you will not need both celebrations and observances.
- relatedto
- This contains holidays that relate to the current holiday.
Examples
suntingSame date every year
sunting{{Infobox holiday
| image =
| caption = Fireworks at the [[Eiffel Tower]], [[Paris]], 2017
| holiday_name = Bastille Day
| nickname = French National Day<br />(''Fête nationale'')<br />The Fourteenth of July<br />(''Quatorze juillet'')
| significance = Commemorates the [[Storming of the Bastille]] on 14 July 1789, and the unity of the French people at the [[Fête de la Fédération]] on 14 July 1790
| observedby = [[France]]
| date = 14 July
| frequency = annual
| celebrations = [[Military parade]]s, [[fireworks]], concerts, [[Ball (dance)|ball]]s
| type = national
}}
|
|
Same day of same week every year
sunting{{Infobox holiday
| holiday_name = Astronauts Day
| type = secular
| observedby = United States
| week_ordinal = last
| weekday = Friday
| month = January
}}
|
|
Different days and dates each year
sunting{{Infobox holiday
| holiday_name = Giving Tuesday
| type = cultural
| duration = 1 day
| frequency = annual
| observedby = Worldwide
| date = Tuesday after Black Friday/Cyber Monday
| date2022 = November 29
| date2023 = November 28
| date2024 = December 3
| date2025 = December 2
| relatedto = [[Thanksgiving (United States)|Thanksgiving]], [[Black Friday (shopping)|Black Friday]]
}}
|
|
Formulas for calculating occurrences
suntingSample formulas used in Template:Infobox holiday/date:
- For First Day of Summer: first Thursday after 18 April:
- {{Weekday after date|{{{year}}}|April|18|Thursday}}
- See also: Template:Weekday after date
- For Victoria Day (Scotland): last Monday before or on 24 May
- {{Weekday before date|{{{year}}}|May|25|Monday}}
- See also: Template:Weekday before date
- For Sexagesima: second Sunday before Ash Wednesday (56 calendar days before Easter Sunday)
- {{#invoke:Easter|Calculate|{{{year}}}|day=-56|format=F j}}
- See also: Module:Easter
For some holidays, this is still defined on the holiday page itself. For First Day of Summer, this would be:
| date = first Thursday after 18 April
| date{{LASTYEAR}} = {{Weekday after date|{{LASTYEAR}}|April|18|Thursday}}
| date{{CURRENTYEAR}} = {{Weekday after date|{{CURRENTYEAR}}|April|18|Thursday}}
| date{{NEXTYEAR}} = {{Weekday after date|{{NEXTYEAR}}|April|18|Thursday}}
| date{{#time:Y|+2 years}} = {{Weekday after date|{{#time:Y|+2 years}}|April|18|Thursday}}
TemplateData
suntingTemplateData untuk Kotak info cuti
Tiada keterangan.
Parameter | Keterangan | Jenis | Status | |
---|---|---|---|---|
Jenis | type | Jenis cuti
| Rentetan | diperlukan |
holiday_name | holiday_name | Usually the same as the page name
| Tidak diketahui | diperlukan |
image | image | Do not include File: and do not wikilink
| Tidak diketahui | disarankan |
image_size | image_size | tiada keterangan | Tidak diketahui | pilihan |
imagesize | imagesize | tiada keterangan | Tidak diketahui | pilihan |
alt | alt | Image description for visually impaired readers
| Tidak diketahui | disarankan |
caption | caption | Image caption | Rentetan | pilihan |
official_name | official_name | tiada keterangan | Tidak diketahui | disarankan |
nickname | nickname | Nickname for the date, or translations
| Tidak diketahui | disarankan |
observedby | observedby | Countries or people who celebrate or observe the date
| Rentetan | disarankan |
litcolor | litcolor | Color used for the holiday
| Rentetan | disarankan |
longtype | longtype | Lengthier alternative to type
| Tidak diketahui | pilihan |
significance | significance | Lengthier description of holiday's significance | Rentetan | disarankan |
celebrations | celebrations | What usually happens on that date. Observances can be used instead.
| Rentetan | disarankan |
observances | observances | Can be used instead of celebrations to describe what happens on the date | Rentetan | pilihan |
begins | begins | Required for multi-day holidays
| Tidak diketahui | disarankan |
ends | ends | Required for multi-day holidays
| Tidak diketahui | disarankan |
date | date | Date of event, do not use "1st", "5th" use 1, 5
| Tidak diketahui | diperlukan |
week_ordinal | week_ordinal | For the first, second etc weeks in a month
| Tidak diketahui | pilihan |
weekday | weekday | Day of week if always the same
| Tidak diketahui | disarankan |
month | month | Use for long observances
| Tidak diketahui | disarankan |
date2024 | date2024 | tiada keterangan | Tidak diketahui | pilihan |
date2023 | date2023 | tiada keterangan | Tidak diketahui | pilihan |
date2022 | date2022 | tiada keterangan | Tidak diketahui | pilihan |
date2021 | date2021 | Use when the date changes every year | Tidak diketahui | pilihan |
scheduling | scheduling | Not displayed
| Rentetan | disarankan |
mdy | mdy | if set auto-formatted dates will be displayed in "month day, year"
| Rentetan | pilihan |
duration | duration | tiada keterangan
| Rentetan | disarankan |
frequency | frequency | How often it occurs
| Tidak diketahui | disarankan |
firsttime | firsttime | either first date or calculation of how long ago
| Tidak diketahui | disarankan |
lasttime | lasttime | Useful for events no longer held or not held every year | Tidak diketahui | pilihan |
startedby | startedby | Person or organization | Tidak diketahui | disarankan |
relatedto | relatedto | Any other dates or wiki pages linked to it
| Tidak diketahui | disarankan |
Tracking categories
suntingPages using the template with unsupported parameters are tracked in Kategori:Pages using infobox holiday with unknown parameters (16).
Other maintenance categories include:
Pendokumenan di atas ditransklusikan daripada Templat:Kotak info cuti/doc. (sunting | sejarah) Para penyunting boleh membuat percubaan di laman kotak pasir (sunting | beza) dan kes ujian (cipta) templat ini. Sila letakkan kategori di sublaman /doc. Sublaman templat ini. |