Прагляд зыходнага тэксту старонкі Вікіпедыя:Механізм шаблонаў

Вам не дазволена правіць гэту старонку, з-за наступнай прычыны:

Ваш IP-адрас у дыяпазоне, які быў заблакаваны на ўсіх вікі-праектах Фонда Вікімедыя.

Блакіроўка была зроблена ‪EPIC‬. Названая прычына: Open proxy/Webhost: See the help page if you are affected.

Пачатак блакіроўкі: 11:48, 2 ліпеня 2024
Канец блакіроўкі: 11:48, 2 ліпеня 2025

Ваш бягучы IP-адрас - 206.189.44.186, а заблакаваны дыяпазон - 206.189.32.0/20. Калі ласка, уключайце ўсе гэтыя падрабязнасці ў свае звароты.

Калі вы лічыце, што былі заблакаваны па памылцы, вы можаце знайсці дадатковую інфармацыю і інструкцыі на старонцы Недапушчальнасць выкарыстання адкрытых проксі-сервераў глабальных правіл.

У адваротным выпадку, каб абмеркаваць блакіроўку, калі ласка, звярніцеся з запытам пра перагляд на МетаВікі або адпраўце электроннае паведамленне ў чаргу VRT stewards па адрасе stewards@wikimedia.org, уключаючы ўсе вышэйпералічаныя дэталі.

Можна бачыць і капіраваць зыходны тэкст гэтай старонкі:

{{shortcut|ВП:МШ}}
{{main|Вікіпедыя:Шаблоны}}
'''Шаблоны''' — клас асаблівых старонак у [[MediaWiki]] (праграмным забеспячэнні [[Вікіпедыя|Вікіпедыі]]), змесціва якіх можна ўставіць у іншыя старонкі. Прычым гэта змесціва счытваецца пры кожнай загрузцы старонкі: змены ў шаблоне выявяцца на старонках, іх прымяняюць (за выключэннем выпадку, калі шаблон выкарыстоўваецца з падстаноўкай, — гл. [[#Падстаноўка|ніжэй]]). Ніжэй апісваецца, як яны працуюць.

== Агульныя звесткі ==
Старонкі шаблонаў — паўнацэнныя [[вікі]]-дакументы, для якіх адведзена свая [[Вікіпедыя:Прастора назваў|прастора назваў]] «Шаблон». У Вікіпедыі іх дазволена правіць любому ўдзельніку.

Выклікаецца шаблон устаўкай у рэдагуемы тэкст старонкі запісу {{tc|імя шаблона|_nobr=x}} і, калі трэба, пасля імені шаблона запісваюцца значэнні параметраў. Першая літара імені можа быць малой ці вялікай — без розніцы. Пры адлюстраванні старонкі на месцы выкліку будзе разгорнута змесціва старонкі ''<nowiki>Шаблон:Імя шаблона</nowiki>''. Калі старонка не існуе, то выклік будзе адлюстраваны як спасылка на неіснуючы артыкул шаблона. Таму, каб не з’яўлялася чырвоная спасылка «[[Шаблон:Неіснуючы шаблон]]», пераканайцеся ў існаванні выкліканых шаблонаў праз папярэдні прагляд старонкі да захавання праўкі.

Калі ўявіць, што ў асноўнай прасторы назваў існуе артыкул ''Імя шаблона'', то можна выклікаць яго, паставіўшы перад імем шаблона двукроп’е: {{tc|:Імя шаблона|_nobr=x}}. Такім чынам, любую старонку можна выкарыстоўваць як шаблон. Калі выклікаць малюнак, загружаны ў Вікіпедыю, а не на [[Вікісховішча]] ({{tc|Файл:Імя шаблона|_nobr=x}}) ці катэгорыю ({{tc|Катэгорыя:Імя шаблона|_nobr=x}}), то будзе падстаўлена апісальная частка карцінкі або катэгорыі адпаведна. Такім спосабам зручна:
* эксперыментаваць з шаблонамі (не залазячы ў прастору шаблонаў),
* «выцягваць» подпісы і апісанні малюнкаў,
* вырабляць адмысловыя састаўныя артыкулы (напрыклад, для друку).
Калі ў редагуемую старонку ўставіць выклік шаблона {{tc|/Імя падстаронкі|_nobr=x}}, то ў гэтым месцы ў працэсе перадпрагляду адлюструецца змесціва яе падстаронкі. У прасторы імён «Вікіпедыя» часта выкарыстоўваецца шаблон {{tc|/Шапка|_nobr=x}}. Калі перайсці ў рэжым рэдагавання старонкі [[Вікіпедыя:Запыты на статус даглядчыка]], то ў яе пачатку можна ўбачыць выклік шаблона {{tc|/Шапка|_nobr=x}}. У рэжыме перадпрагляду адлюстроўваецца тэкст падстаронкі [[Вікіпедыя:Запыты на статус даглядчыка/Шапка]].

== Выкарыстанне шаблонаў ==
Каб выкарыстаць шаблон, неабходна ўставіць тэкст выкліку шаблона, у выніку чаго ў месцы выкліку ў рэдагуемым тэксце з’яўлецца змест іншай старонкі.

Напрыклад, калі вы ўвядзеце ў рэдактар наступны код выкліку шаблона <code><nowiki>{{*}}</nowiki></code>, чытач убачыць {{*}}. У дадзеным прыкладзе выкарыстоўваўся [[Шаблон:*]].

Знайсці неабходны шаблон можна ў [[:Катэгорыя:Шаблоны|спецыяльнай службовай катэгорыі]].

На старонцы шаблона звычайна ёсць загатоўка для яго выкліку, напрыклад:

<pre>
{{Штучны спадарожнік
| назва                 = 
| арыгінальная назва    = 
| выява                 = 
| памер                 = 
| подпіс                = 
| арганізацыя           = 
| краіна                = 
| распрацоўшчык         = 
| мэта                  = 
| спадарожнік           = 
| касмічная праграма    = 
| папярэдні             = 
| наступны              = 
| абарачэнняў           = 
| час запуску           = 
| касмадром             = 
| ракета-носьбіт        = 
| тэрмін працы          = 
| канец працы           = 
| NSSDC_ID              = 
| сайт                  = 
| маса                  = 
| арбіта                = 
| вялікая паўвось       = 
| эксцэнтрысітэт        = 
| нахіленне             = 
| перыяд абарачэння     = 
| апагей                = 
| перыгей               = 
}}
</pre>

Гэтую загатоўку можна скапіраваць і ўставіць у патрэбны артыкул. Як можна ўбачыць у прыкладзе ніжэй, у шаблоне ёсць шмат параметраў, аднак не абавязкова капіраваць ці запаўняць кожную графу:

{|
|-
|<pre>
{{Штучны спадарожнік
| назва                 = БелКА
| арганізацыя           = 
| краіна                = {{Сцяг Беларусі}} [[Беларусь]]
| распрацоўшчык = 
| мэта =
| спадарожнік = [[Планета Зямля|Зямлі]]
| час запуску = 20:43 [[26 ліпеня]] [[2006]]
| касмадром = {{Сцяг Расіі}} [[Касмадром Байканур|Байканур]]
| ракета-носьбіт = {{Сцяг Расіі}} {{Сцяг Украіны}} [[Днепр-1]]
}}</pre>
|{{Штучны спадарожнік
| назва                 = БелКА
| арганізацыя           = 
| краіна                = {{Сцяг Беларусі}} [[Беларусь]]
| распрацоўшчык = 
| мэта =
| спадарожнік = [[Планета Зямля|Зямлі]]
| час запуску = 20:43 [[26 ліпеня]] [[2006]]
| касмадром = {{Сцяг Расіі}} [[Касмадром Байканур|Байканур]]
| ракета-носьбіт = {{Сцяг Расіі}} {{Сцяг Украіны}} [[Днепр-1]]
}}
|}

== Параметры ==
Параметры шаблона могуць быць найменнымі або нумараванымі. Сінтаксіс выкліку шаблона і спосаб выкарыстання параметраў у целе шаблона ў гэтых двух выпадках будуць адрознівацца:
* <code><nowiki>{{назва шаблона|назва параметра 1=значэнне параметра 1|назва параметра 2=значэнне параметра 2}}</nowiki></code> — выкарыстоўваюцца найменныя параметры. Тады ў целе шаблона трэба спасылацца на імя параметра: <code><nowiki>{{{імя параметра 1}}}</nowiki></code>, <code><nowiki>{{{імя параметра 2}}}</nowiki></code>.
* <code><nowiki>{{імя шаблона|значэнне параметра 1|значэнне параметра 2}}</nowiki></code> або <code><nowiki>{{імя шаблона|1=значэнне параметра 1/2=значэнне параметра 2}}</nowiki></code> — выкарыс��оўваюцца нумараваныя параметры. Тады ў целе шаблона трэба выкарыстоўваць парадкавы нумар параметра <code><nowiki>{{{1}}}</nowiki></code>, <code><nowiki>{{{2}}}</nowiki></code>.

Звярніце ўвагу, што фігурныя дужкі вакол імён параметраў '''патройныя''', а не падвойныя.

Параметры, прысутныя ў выкліку шаблона, але адсутныя ў целе шаблона, ігнаруюцца. Найменныя параметры адчувальныя да рэгістра сімвалаў.

Пры выкліку шаблона выконваюцца два тыпы падстановак:
* імя шаблона ў двайных фігурных дужках замяняецца змесцівам шаблона;
* імя або нумар параметра шаблона ў патройных фігурных дужках замяняецца значэннем параметра.

Параметрам шаблона можа быць спасылка на іншы артыкул. Хай, напрыклад, у нас ёсць такі шаблон:
<syntaxhighlight lang="text">
Пачатак {{{1}}} канец.
</syntaxhighlight>
і ён завецца «Шаблон». Тады пры выкліку шаблона ў тэксце старонкі запісам
<syntaxhighlight lang="text">
{{Шаблон|[[Галоўная старонка]]}}
</syntaxhighlight>
шаблон будзе разгорнуты ў
<syntaxhighlight lang="text">
Пачатак [[Галоўная старонка]] канец.
</syntaxhighlight>

=== Нявызначаныя і пустыя значэнні параметраў ===
Калі ў радку выкліку шаблона з найменнымі  ці нумараванымі параметрамі параметр не атрымаў значэнне, то ён застаецца нераскрытым тэкстам: з найменнымі параметрамі <code><nowiki>{{{параметр 1}}}</nowiki></code>, з нумараванымі параметрамі <code><nowiki>{{{1}}}</nowiki></code>. Параметр будзе раскрыты ў далейшым, калі артыкул, які выклікаў шаблон, уключаецца ў іншы артыкул, дзе гэты параметр зададзены.

Заўважым, што выклік шаблона з найменнымі параметрамі <code><nowiki>{{шаблон 1|параметр 1=|параметр 2=а}}</nowiki></code> робіць параметр «параметр 1» вызначаным, роўным пустому радку. Выклік <code><nowiki>{{шаблон 1|параметр 2=а}}</nowiki></code> задае параметр «параметр 2», «параметр 1» не вызначаны.

Аналагічна для шаблона з нумараванымі параметрамі: выклік <code><nowiki>{{шаблон 2||а}}</nowiki></code> робіць першы параметр вызначаным, роўным пустому радку, выклік <code><nowiki>{{шаблон 2|2=а}}</nowiki></code>) задае другі параметр, першы параметр не вызначаны.

Калі код паміж вертыкальнымі рысамі змяшчае знак роўнасці (напрыклад, а=б), выклік шаблона <code><nowiki>{{шаблон|а=б|в}}</nowiki></code> не прысвоіць значэнне «а=б» нумараванаму параметру «1», а створыць параметр «а» са значэннем «б»; а вось <code><nowiki>{{шаблон|1=а=б|2=в}}</nowiki></code> усё зробіць правільна. Адзіны мінус у тым, што пры выкліку шаблона даводзіцца нумараваць усе параметры шаблона, калі нумаруецца хоць адзін. Для ўстаўкі сімвала роўнасці ў значэнне параметра можна выкарыстоўваць лічбавую спасылку на гэты сімвал ({{lang-en|numeric character reference}}), запісаўшы <code>&amp;#61;</code>, ці выкарыстоўваць спецыяльны шаблон {{ш|=}}, які ўстаўляе сімвал «=».

=== Умоўнае значэнне параметра ===
Каб не з’яўляўся нераскрыты тэкст параметра з незададзеным значэннем, выкарыстоўваюць ''умоўнае значэнне параметра'' ў тэксце шаблона. Найменны або нумараваны параметр ''параметр'' унутры шаблона запісваецца ў форме <code><nowiki>{{{параметр|альтэрнатыўны тэкст}}}</nowiki></code>. Калі значэнне параметра не зададзена ў выкліку шаблона, то будзе выкарыстаны альтэрнатыўны тэкст; калі зададзена значэнне параметра (у тым ліку пустое), то выкарыстоўваецца зададзенае значэнне. Напрыклад, альтэрнатыўны тэкст пусты: <code><nowiki>{{{параметр|}}}</nowiki></code>. Тады калі значэнне параметра зададзена пры выкліку шаблона — выкарыстоўваецца зададзенае значэнне; калі значэнне параметра не зададзена — выкарыстоўваецца пустое значэнне, гэта значыць у месцы параметра ніякі тэкст выводзіцца не будзе.

У залежнасці ад значэння параметра шаблона ў тэкст артыкула можна ўстаўляць фрагменты. Для гэтай мэты ў тэксце шаблона выкарыстоўваюцца [[Вікіпедыя:Функцыі парсера|функцыі парсера]], многія з якіх з’яўляюцца асобнымі выпадкамі ўмоўнага аператара: <code><nowiki>{{#if}}</nowiki></code> і іншыя. Сінтаксіс функцыі <code><nowiki>{{#if}}</nowiki></code> выглядае так:

 &#123;{#if: ''правяраемы параметр''
 | ''тэкст, калі значэнне параметра запоўнена''
 | ''тэкст, калі значэнне параметра пустое''
 }}

''Тэкст, калі значэнне параметра пустое'', не з’яўляецца абавязковым, таму можна выкарыстоўваць скарочаную форму:

 &#123;{#if: ''правяраемы параметр''
 | ''тэкст, калі значэнне параметра запоўнена''
 }}

Калі правяраемы параметр шаблона запісаны ў форме <code><nowiki>{{{параметр}}}</nowiki></code>, то непустое значэнне параметра азначае: альбо яго значэнне зададзена непустым пры выкліку шаблона, альбо яно не зададзена і застаецца нявызначаным (і калі вывесці яго на старонку, то мы так і атрымаем: <code><nowiki>{{{параметр}}}</nowiki></code>). Гэта значыць, мы не можам зразумець, зададзена значэнне параметра ці не. Каб мець магчымасць выклікаць шаблон з меншай колькасцю параметраў, чым у тэксце шаблона, і каб незададзеныя параметры ігнараваліся, параметры ў целе шаблона запісваюцца ў форме <code><nowiki>{{{параметр|}}}</nowiki></code>. Калі пры выкліку шаблона зададзена непустое значэнне параметра, то яно будзе выкарыстоўвацца. У адваротным выпадку выкарыстоўваецца ўмоўнае значэнне параметра ''пуста''.

== Тэгі noinclude, includeonly, onlyinclude ==
Усё, што знаходзіцца паміж тэгамі <code><nowiki><noinclude></nowiki></code> і <code><nowiki></noinclude></nowiki></code>, будзе апрацоўвацца і паказвацца толькі ў выпадку, калі шаблон паказваецца непасрэдна, не ўключаным у іншую старонку. Магчымыя ўжыванні:
* Катэгарызацыя шаблонаў саміх па сабе, а не тых старонак, у якія шаблон уключаны. Для шаблонаў, якія маюць старонкі [[Шаблон:Дакументацыя|дакументацыі]], рэкамендуецца прастаўляць катэгорыі ў іх, пры гэтым там, наадварот, выкарыстоўваецца <code><nowiki><includeonly></nowiki></code>.
* Старонкі ў прасторы назваў MediaWiki.
* Тэкст з тлумачэннем таго, як выкарыстоўваць шаблон. Як правіла, для гэтага ствараецца дакументацыя шаблона.
Тэг <code><nowiki><includeonly></nowiki></code> мае процілеглае дзеянне. Тэкст паміж <code><nowiki><includeonly></nowiki></code> і <code><nowiki></includeonly></nowiki></code> будзе апрацоўвацца і паказвацца толькі тады, калі шаблон уключаны ў артыкул. Відавочнае ўжыванне:
* уключэнне ўсіх артыкулаў, якія змяшчаюць шаблон, у катэгорыю (пры гэтым сам шаблон у катэгорыю не патрапіць).
Калі тэкст абгорнуты ў тэгі <code><nowiki><onlyinclude></onlyinclude>, пры ўключэнні гэтай старонкі на іншую будзе выводзіцца толькі фрагмент унутры гэтых тэгаў (фрагменты, калі некалькі тэгаў). Абгортванне ў гэты тэг пэўнага фрагмента тэксту аналагічна абгортванню ўсяго астатняга тэксту старонкі, акрамя абгорнутай у <code><nowiki>onlyinclude</nowiki></code>, у тэг <code><nowiki>noinclude</nowiki></code>.
'''Не дапускайце пустых радкоў''' вакол канструкцый <code><nowiki><noinclude></nowiki></code> і <code><nowiki><includeonly></nowiki></code>, бо пусты радок будзе інтэрпрэтавацца як перанос радка, які будзе ўнесены шаблонам у артыкул.

== Падстаноўка ==
Канструкцыя <code>(subst:)</code> пасля падвойных фігурных дужак прымушае выконваць падстаноўку тэксту шаблона або нават зменнай у момант захавання старонкі, якая спасылаецца на шаблон.

Напрыклад, калі мы напішам
<pre>{{subst:CURRENTDAY}} {{subst:CURRENTMONTHNAMEGEN}} {{subst:CURRENTYEAR}}, {{subst:CURRENTTIME}} (UTC)</pre> або <code><nowiki>~~~~~</nowiki></code>

пры захаванні старонкі падставяцца бягучыя дата і час:
 18 кастрычніка 2017, 08:57 (UTC)

у той час як

<pre>{{CURRENTDAY}} {{CURRENTMONTHNAMEGEN}} {{CURRENTYEAR}}, {{CURRENTTIME}} (UTC)</pre>

кожны раз будзе паказваць бягучы час:

 {{CURRENTDAY}} {{CURRENTMONTHNAMEGEN}} {{CURRENTYEAR}}, {{CURRENTTIME}} (UTC)

А наступны код выкарыстоўваецца для прывітання новых удзельнікаў:
 &#123;{subst:[[Шаблон:вітаем|вітаем]]}} <nowiki>~~~~</nowiki>

[[Катэгорыя:Вікіпедыя:Даведка]]
[[Катэгорыя:Вікіпедыя:Спосабы афармлення артыкулаў]]

Шаблоны на гэтай старонцы:

Шаблон:* (паказ крыніцы) (ахоўваецца)
Шаблон:Lang (правіць)
Шаблон:Lang-en (паказ крыніцы) (часткова ахоўваецца)
Шаблон:Lang/ядро (паказ крыніцы) (часткова ахоўваецца)
Шаблон:Main (правіць)
Шаблон:No redirect (правіць)
Шаблон:Plainlist/styles.css (правіць)
Шаблон:Shortcut (правіць)
Шаблон:Tc (правіць)
Шаблон:Tl (правіць)
Шаблон:Wikidata (правіць)
Шаблон:Асноўны артыкул (правіць)
Шаблон:Картка (паказ крыніцы) (часткова ахоўваецца)
Шаблон:Картка/арыгінал назвы (правіць)
Шаблон:Картка/назва (правіць)
Шаблон:Картка/унізе (правіць)
Шаблон:Сцяг Беларусі (правіць)
Шаблон:Сцяг Расіі (правіць)
Шаблон:Сцяг Украіны (правіць)
Шаблон:Ш (правіць)
Шаблон:Штучны спадарожнік (правіць)
Шаблон:• (правіць)
Модуль:Arguments (правіць)
Модуль:Hash (правіць)
Модуль:Hatnote (правіць)
Модуль:Infobox (правіць)
Модуль:List (правіць)
Модуль:Redirect (правіць)
Модуль:Shortcut (правіць)
Модуль:Shortcut/config (правіць)
Модуль:Shortcut/styles.css (правіць)
Модуль:Sources (правіць)
Модуль:Sources-utils (правіць)
Модуль:TableTools (правіць)
Модуль:Template call code (правіць)
Модуль:Template call code/styles.css (правіць)
Модуль:Transclude (правіць)
Модуль:Wikidata (правіць)
Модуль:Wikidata/config (правіць)
Модуль:WikidataSelectors (правіць)
Модуль:Yesno (правіць)
Модуль:Асноўны артыкул (правіць)

Вярнуцца да Вікіпедыя:Механізм шаблонаў.

Узята з "https://be.wikipedia.org/wiki/Вікіпедыя:Механізм_шаблонаў"