|
ВП:МШ
|
Шаблоны
? клас асабл?вых старонак у
MediaWiki
(праграмным забеспячэнн?
В?к?педы?
), змесц?ва як?х можна ?став?ць у ?ншыя старонк?. Прычым гэта змесц?ва счытваецца пры кожнай загрузцы старонк?: змены ? шаблоне выявяцца на старонках, ?х прымяняюць (за выключэннем выпадку, кал? шаблон выкарысто?ваецца з падстано?кай, ? гл.
н?жэй
). Н?жэй ап?сваецца, як яны працуюць.
Старонк? шаблона? ? па?нацэнныя
в?к?
-дакументы, для як?х адведзена свая
прастора назва?
≪Шаблон≫. У В?к?педы? ?х дазволена прав?ць любому ?дзельн?ку.
Выкл?каецца шаблон уста?кай у рэдагуемы тэкст старонк? зап?су
{{
?мя шаблона
}}
?, кал? трэба, пасля ?мен? шаблона зап?сваюцца значэнн? параметра?. Першая л?тара ?мен? можа быць малой ц? вял?кай ? без розн?цы. Пры адлюстраванн? старонк? на месцы выкл?ку будзе разгорнута змесц?ва старонк?
Шаблон:?мя шаблона
. Кал? старонка не ?снуе, то выкл?к будзе адлюстраваны як спасылка на не?снуючы артыкул шаблона. Таму, каб не з’я?лялася чырвоная спасылка ≪
Шаблон:Не?снуючы шаблон
≫, пераканайцеся ? ?снаванн? выкл?каных шаблона? праз папярэдн? прагляд старонк? да захавання пра?к?.
Кал? ?яв?ць, што ? асно?най прасторы назва? ?снуе артыкул
?мя шаблона
, то можна выкл?каць яго, пастав??шы перад ?мем шаблона двукроп’е:
{{
:?мя шаблона
}}
. Так?м чынам, любую старонку можна выкарысто?ваць як шаблон. Кал? выкл?каць малюнак, загружаны ? В?к?педыю, а не на
В?к?схов?шча
(
{{
Файл:?мя шаблона
}}
) ц? катэгорыю (
{{
Катэгорыя:?мя шаблона
}}
), то будзе падста?лена ап?сальная частка карц?нк? або катэгоры? адпаведна. Так?м спосабам зручна:
- эксперыментаваць з шаблонам? (не залазячы ? прастору шаблона?),
- ≪выцягваць≫ подп?сы ? ап?санн? малюнка?,
- вырабляць адмысловыя саста?ныя артыкулы (напрыклад, для друку).
Кал? ? редагуемую старонку ?став?ць выкл?к шаблона
{{
/?мя падстаронк?
}}
, то ? гэтым месцы ? працэсе перадпрагляду адлюструецца змесц?ва яе падстаронк?. У прасторы ?мён ≪В?к?педыя≫ часта выкарысто?ваецца шаблон
{{
/Шапка
}}
. Кал? перайсц? ? рэжым рэдагавання старонк?
В?к?педыя:Запыты на статус даглядчыка
, то ? яе пачатку можна ?бачыць выкл?к шаблона
{{
/Шапка
}}
. У рэжыме перадпрагляду адлюстро?ваецца тэкст падстаронк?
В?к?педыя:Запыты на статус даглядчыка/Шапка
.
Каб выкарыстаць шаблон, неабходна ?став?ць тэкст выкл?ку шаблона, у вын?ку чаго ? месцы выкл?ку ? рэдагуемым тэксце з’я?лецца змест ?ншай старонк?.
Напрыклад, кал? вы ?вядзеце ? рэдактар наступны код выкл?ку шаблона
{{*}}
, чытач убачыць
?·
. У дадзеным прыкладзе выкарысто?ва?ся
Шаблон:*
.
Знайсц? неабходны шаблон можна ?
спецыяльнай службовай катэгоры?
.
На старонцы шаблона звычайна ёсць загато?ка для яго выкл?ку, напрыклад:
{{Штучны спадарожн?к
| назва =
| арыг?нальная назва =
| выява =
| памер =
| подп?с =
| арган?зацыя =
| кра?на =
| распрацо?шчык =
| мэта =
| спадарожн?к =
| касм?чная праграма =
| папярэдн? =
| наступны =
| абарачэння? =
| час запуску =
| касмадром =
| ракета-носьб?т =
| тэрм?н працы =
| канец працы =
| NSSDC_ID =
| сайт =
| маса =
| арб?та =
| вял?кая па?вось =
| эксцэнтрыс?тэт =
| нах?ленне =
| перыяд абарачэння =
| апагей =
| перыгей =
}}
Гэтую загато?ку можна скап?раваць ? ?став?ць у патрэбны артыкул. Як можна ?бачыць у прыкладзе н?жэй, у шаблоне ёсць шмат параметра?, аднак не абавязкова кап?раваць ц? запа?няць кожную графу:
{{Штучны спадарожн?к
| назва = БелКА
| арган?зацыя =
| кра?на = {{Сцяг Беларус?}} [[Беларусь]]
| распрацо?шчык =
| мэта =
| спадарожн?к = [[Планета Зямля|Зямл?]]
| час запуску = 20:43 [[26 л?пеня]] [[2006]]
| касмадром = {{Сцяг Рас??}} [[Касмадром Байканур|Байканур]]
| ракета-носьб?т = {{Сцяг Рас??}} {{Сцяг Укра?ны}} [[Днепр-1]]
}}
|
|
Параметры шаблона могуць быць найменным? або нумараваным?. С?нтакс?с выкл?ку шаблона ? спосаб выкарыстання параметра? у целе шаблона ? гэтых двух выпадках будуць адрозн?вацца:
{{назва шаблона|назва параметра 1=значэнне параметра 1|назва параметра 2=значэнне параметра 2}}
? выкарысто?ваюцца найменныя параметры. Тады ? целе шаблона трэба спасылацца на ?мя параметра:
{{{?мя параметра 1}}}
,
{{{?мя параметра 2}}}
.
{{?мя шаблона|значэнне параметра 1|значэнне параметра 2}}
або
{{?мя шаблона|1=значэнне параметра 1/2=значэнне параметра 2}}
? выкарысто?ваюцца нумараваныя параметры. Тады ? целе шаблона трэба выкарысто?ваць парадкавы нумар параметра
{{{1}}}
,
{{{2}}}
.
Звярн?це ?вагу, што ф?гурныя дужк? вакол ?мён параметра?
патройныя
, а не падвойныя.
Параметры, прысутныя ? выкл?ку шаблона, але адсутныя ? целе шаблона, ?гнаруюцца. Найменныя параметры адчувальныя да рэг?стра с?мвала?.
Пры выкл?ку шаблона выконваюцца два тыпы падстановак:
- ?мя шаблона ? двайных ф?гурных дужках замяняецца змесц?вам шаблона;
- ?мя або нумар параметра шаблона ? патройных ф?гурных дужках замяняецца значэннем параметра.
Параметрам шаблона можа быць спасылка на ?ншы артыкул. Хай, напрыклад, у нас ёсць так? шаблон:
? ён завецца ≪Шаблон≫. Тады пры выкл?ку шаблона ? тэксце старонк? зап?сам
{{Шаблон|[[Гало?ная старонка]]}}
шаблон будзе разгорнуты ?
Пачатак [[Гало?ная старонка]] канец.
Нявызначаныя ? пустыя значэнн? параметра?
[
прав?ць зыходн?к
]
Кал? ? радку выкл?ку шаблона з найменным? ц? нумараваным? параметрам? параметр не атрыма? значэнне, то ён застаецца нераскрытым тэкстам: з найменным? параметрам?
{{{параметр 1}}}
, з нумараваным? параметрам?
{{{1}}}
. Параметр будзе раскрыты ? далейшым, кал? артыкул, як? выкл?ка? шаблон, уключаецца ? ?ншы артыкул, дзе гэты параметр зададзены.
За?важым, што выкл?к шаблона з найменным? параметрам?
{{шаблон 1|параметр 1=|параметр 2=а}}
роб?ць параметр ≪параметр 1≫ вызначаным, ро?ным пустому радку. Выкл?к
{{шаблон 1|параметр 2=а}}
задае параметр ≪параметр 2≫, ≪параметр 1≫ не вызначаны.
Аналаг?чна для шаблона з нумараваным? параметрам?: выкл?к
{{шаблон 2||а}}
роб?ць першы параметр вызначаным, ро?ным пустому радку, выкл?к
{{шаблон 2|2=а}}
) задае друг? параметр, першы параметр не вызначаны.
Кал? код пам?ж вертыкальным? рысам? змяшчае знак ро?насц? (напрыклад, а=б), выкл?к шаблона
{{шаблон|а=б|в}}
не прысво?ць значэнне ≪а=б≫ нумараванаму параметру ≪1≫, а створыць параметр ≪а≫ са значэннем ≪б≫; а вось
{{шаблон|1=а=б|2=в}}
усё зроб?ць прав?льна. Адз?ны м?нус у тым, што пры выкл?ку шаблона даводз?цца нумараваць усе параметры шаблона, кал? нумаруецца хоць адз?н. Для ?ста?к? с?мвала ро?насц? ? значэнне параметра можна выкарысто?ваць л?чбавую спасылку на гэты с?мвал (
англ.
:
numeric character reference
), зап?са?шы
=
, ц? выкарысто?ваць спецыяльны шаблон
{{
=
}}
, як? ?ста?ляе с?мвал ≪=≫.
Каб не з’я?ля?ся нераскрыты тэкст параметра з незададзеным значэннем, выкарысто?ваюць
умо?нае значэнне параметра
? тэксце шаблона. Найменны або нумараваны параметр
параметр
унутры шаблона зап?сваецца ? форме
{{{параметр|альтэрнаты?ны тэкст}}}
. Кал? значэнне параметра не зададзена ? выкл?ку шаблона, то будзе выкарыстаны альтэрнаты?ны тэкст; кал? зададзена значэнне параметра (у тым л?ку пустое), то выкарысто?ваецца зададзенае значэнне. Напрыклад, альтэрнаты?ны тэкст пусты:
{{{параметр|}}}
. Тады кал? значэнне параметра зададзена пры выкл?ку шаблона ? выкарысто?ваецца зададзенае значэнне; кал? значэнне параметра не зададзена ? выкарысто?ваецца пустое значэнне, гэта значыць у месцы параметра н?як? тэкст выводз?цца не будзе.
У залежнасц? ад значэння параметра шаблона ? тэкст артыкула можна ?ста?ляць фрагменты. Для гэтай мэты ? тэксце шаблона выкарысто?ваюцца
функцы? парсера
, мног?я з як?х з’я?ляюцца асобным? выпадкам? ?мо?нага аператара:
{{#if}}
? ?ншыя. С?нтакс?с функцы?
{{#if}}
выглядае так:
{{#if:
правяраемы параметр
|
тэкст, кал? значэнне параметра запо?нена
|
тэкст, кал? значэнне параметра пустое
}}
Тэкст, кал? значэнне параметра пустое
, не з’я?ляецца абавязковым, таму можна выкарысто?ваць скарочаную форму:
{{#if:
правяраемы параметр
|
тэкст, кал? значэнне параметра запо?нена
}}
Кал? правяраемы параметр шаблона зап?саны ? форме
{{{параметр}}}
, то непустое значэнне параметра азначае: альбо яго значэнне зададзена непустым пры выкл?ку шаблона, альбо яно не зададзена ? застаецца нявызначаным (? кал? вывесц? яго на старонку, то мы так ? атрымаем:
{{{параметр}}}
). Гэта значыць, мы не можам зразумець, зададзена значэнне параметра ц? не. Каб мець магчымасць выкл?каць шаблон з меншай колькасцю параметра?, чым у тэксце шаблона, ? каб незададзеныя параметры ?гнаравал?ся, параметры ? целе шаблона зап?сваюцца ? форме
{{{параметр|}}}
. Кал? пры выкл?ку шаблона зададзена непустое значэнне параметра, то яно будзе выкарысто?вацца. У адваротным выпадку выкарысто?ваецца ?мо?нае значэнне параметра
пуста
.
Усё, што знаходз?цца пам?ж тэгам?
<noinclude>
?
</noinclude>
, будзе апрацо?вацца ? паказвацца тольк? ? выпадку, кал? шаблон паказваецца непасрэдна, не ?ключаным у ?ншую старонку. Магчымыя ?жыванн?:
- Катэгарызацыя шаблона? сам?х па сабе, а не тых старонак, у як?я шаблон уключаны. Для шаблона?, як?я маюць старонк?
дакументацы?
, рэкамендуецца праста?ляць катэгоры? ? ?х, пры гэтым там, наадварот, выкарысто?ваецца
<includeonly>
.
- Старонк? ? прасторы назва? MediaWiki.
- Тэкст з тлумачэннем таго, як выкарысто?ваць шаблон. Як прав?ла, для гэтага ствараецца дакументацыя шаблона.
Тэг
<includeonly>
мае проц?леглае дзеянне. Тэкст пам?ж
<includeonly>
?
</includeonly>
будзе апрацо?вацца ? паказвацца тольк? тады, кал? шаблон уключаны ? артыкул. В?давочнае ?жыванне:
- уключэнне ?с?х артыкула?, як?я змяшчаюць шаблон, у катэгорыю (пры гэтым сам шаблон у катэгорыю не патрап?ць).
Кал? тэкст абгорнуты ? тэг?
<onlyinclude></onlyinclude>, пры ?ключэнн? гэтай старонк? на ?ншую будзе выводз?цца тольк? фрагмент унутры гэтых тэга? (фрагменты, кал? некальк? тэга?). Абгортванне ? гэты тэг пэ?нага фрагмента тэксту аналаг?чна абгортванню ?сяго астатняга тэксту старонк?, акрамя абгорнутай у <code><nowiki>onlyinclude
, у тэг
noinclude
.
Не дапускайце пустых радко?
вакол канструкцый
<noinclude>
?
<includeonly>
, бо пусты радок будзе ?нтэрпрэтавацца як перанос радка, як? будзе ?несены шаблонам у артыкул.
Канструкцыя
(subst:)
пасля падвойных ф?гурных дужак прымушае выконваць падстано?ку тэксту шаблона або нават зменнай у момант захавання старонк?, якая спасылаецца на шаблон.
Напрыклад, кал? мы нап?шам
{{subst:CURRENTDAY}} {{subst:CURRENTMONTHNAMEGEN}} {{subst:CURRENTYEAR}}, {{subst:CURRENTTIME}} (UTC)
або
~~~~~
пры захаванн? старонк? падставяцца бягучыя дата ? час:
18 кастрычн?ка 2017, 08:57 (UTC)
у той час як
{{CURRENTDAY}} {{CURRENTMONTHNAMEGEN}} {{CURRENTYEAR}}, {{CURRENTTIME}} (UTC)
кожны раз будзе паказваць бягучы час:
27 мая 2024, 10:13 (UTC)
А наступны код выкарысто?ваецца для прыв?тання новых удзельн?ка?:
{{subst:
в?таем
}} ~~~~