Шаблон:Надрадковае папярэджанне/Дакументацыя

Дакументацыя да шаблона Надрадковае папярэджанне.

Гэты мета-шаблон прызначаны для фарміравання надрадковых шаблонаў-папрэджанняў (напрыклад, паразроны тэкст^{[нейкая прэтэнзія]}), такіх як {{няма АК}}, {{удакладніць}} або {{нявызначанасць}}. Адзіны абавязковы параметр — text.

Шаблон таксама можа абготрваць папярэдні тэкст у тэгі <span> (напрыклад, незразумелы тэкст^{[нейкая прэтэнзія]}), а таксама ўлічваць дату пастаноўкі. У шаблонах з запаўненнем даты рэкамендуецца ўжываць модуль Unsubst (гл. ніжэй), каб пры падстаноўцы шаблона ў яго аўтаматычна дадавалася бягучая дата, напрыклад:

{{subst:няма АК}} → {{няма АК|26|04|2024}}.

Ужыванне

Параметр	Апісанне
day month year errorcat	Параметры для пазначэння даты пастаноўкі шаблона. Дата пазначаецца толькі лічбамі. У параметры errorcat можна задаць катэгорыю, у якую будуць дадавацца артыкулы з няправільна зададзенай датай. Калі вы бачыце папярэджанне «», то, хутчэй за ўсё, вы не пазначылі дату прастаноўкі шаблона, для гэтага замяніце {{назва шаблона|параметры}} на {{subst:назва шаблона|параметры}}.
span-text span-style	Параметр span-text задае тэкст, які выдзяляецца. Па змоўчанні вядзяляецца такім чынам, аднак фон і колер тэксту можна змяніць на любы пажаданы з дапамогай параметра span-style. Прызначаны для шаблонаў кшталту {{няма АК 2}}.
comment comment-default	Каментарый да шаблона для пазначэння сутнасці прэтэнзій да тэксту. У параметры comment-default пажадана задаць тэкст каментарыя па змоўчанні з магчымасцю пазначэння прычыны пры кожнай пастаноўцы шаблона, інакш у якасці яго будзе выводзіцца спасылка, зададзеная ў параметры link. Таксама разам з каментарыем выводзіцца дата пастаноўкі шаблона (калі яна зададзена). Рэкамендуецца ўжываць у лакальных шаблонах таксама карацейшыя назвы параметра c і кам (вось так: {{{comment|{{{c|{{{кам|}}}}}}}}}) для зручнасці хуткага набору з клавіятуры.
text	Тэкст надрадковага папярэджання (напрыклад: крыніца? → [крыніца?]). Адзіны абавязковы параметр, пры адсутнасці якога выводзіцца памылка «».
link	Назва старонкі з адпаведнай рэкамендацыяй для дзеянняў у выпадку выяўлення шаблона (например, Вікіпедыя:Спасылкі на крыніцы → ). Спасылка задаецца без квадратных дужак.
talk	Спасылка на раздзел старонкі, дзе вядзецца абмеркаванне тэксту, да якога пастаўлена папярэджанне. У лакальных шаблонах варта задаваць дзве назвы для параметра: абм і talk (вось так: {{{talk|{{{абм|}}}}}}).
anchor	Якар на папярэджанне для магчымасці стварыць спасылку з абмеркавання. У лакальных шаблонах параметру рэкамендуецца задаць дзве назвы: anchor і якар (вось так: {{{anchor|{{{якар|}}}}}}.
cat cat''N'' cat-date''N'' nocat	Параметры для задання катэгорый. Параметр cat — для катэгорыі, якая не залежыць ад моманту пастаноўкі шаблона. Для параметраў cat''N'' артыкул трапляе ў катэгорыю толькі ў выпадку выканання ўмовы, зададзенай у параметры cat-date''N'' з адпаведным індэксам (ад 1 да 3), змесціва якога павінна складацца з аператара (знака параўнання) і ліку (напрыклад: cat-date2 = >= 100 будзе значыць што пачынаючы з 100 дня пасля моманту прастаноўкі артыкул будзе трапляць у катэгорыю «cat2»). Спасылка на катэгорыю задаецца з квадратнымі дужкамі, або адпаведным шаблонам. Катэгарызацыя працуе толькі ў асноўнай прасторы назваў. Параметр nocat падаўляе катэгарызацыю.

Лакальныя параметры

• абм (talk) — спасылка на раздзел старонкі, дзе вядзецца абмеркаванне тэксту, да якога пастаўлена папярэджанне (на старонцы абмеркавання або форуме). Калі неабходна спаслацца на раздзел на старонцы абмеркавання, дастаткова пазначыць толькі назву раздзела, то бок калі ў спасылцы адсутнічае або знаходзіцца ў пачатку сімвал рашоткі (#), то спасылка вядзе у адпаведны раздзел на старонцы абмеркавання. У адваротным выпадку — на раздзел іншай старонкі. Спасылка задаецца без квадратных дужак. Напрыклад:
  • {{няма АК|26|04|2024|абм=Прапановы}} →
  • {{няма АК|26|04|2024|абм=Вікіпедыя:Форум/2015#Анджэй, па футболе і Дубашчыт}} →
• кам (c, comment) — каментарый да шаблона для пазначэння сутнасці прэтэнзіі да тэксту; задаецца з мэтай яе канкрэтызацыі. Калі каментарый зададзены ў артыкуле, то тэкст папярэджання падкрэсліваецца пункцірам. Напрыклад:
  • {{няма АК|26|04|2024|кам=бла-бла-бла}} →
• якар (anchor) — якар на папярэджанне для магчымасць стварыць спасылку з абмеркавання. Прынцып працы аналагічны шаблону {{якар2}}. Напрыклад:
  • на шаблон з кодам {{няма АК|26|04|2024|якар=Прыклад}} у графе «link» раздзела «Ужыванне» вядзе спасылка [[Шаблон:Надрадковае папярэджанне#Прыклад|спасылка]] → спасылка.

Нарыхтоўка для капіявання

Для шаблонаў з пазначэннем даты пастаноўкі

з выдзяленнем папярэдняга тэксту і абавязковым напаўненнем даты

{{ {{{|safesubst:}}}#invoke:unsubst||2={{{{{|safesubst:}}}CURRENTDAY}}|3={{{{{|safesubst:}}}CURRENTMONTH}}|4={{{{{|safesubst:}}}CURRENTYEAR}}
 |$B = {{Надрадковае папярэджанне
  | day = {{{2}}}
  | month = {{{3}}}
  | year = {{{4}}}
  | span-text = {{{1|}}}
  | span-style =
  | text = 
  | link = 
  | talk = {{{talk|{{{абм|}}}}}}
  | comment = {{{comment|{{{c|{{{кам|}}}}}}}}}
  | comment-default = 
  | anchor = {{{anchor|{{{якар|}}}}}}
  | cat1 = 
  | cat-date1 = 
  | cat2 =
  | cat-date2 = 
  | cat3 = 
  | cat-date3 = 
  | errorcat =
  | nocat = {{{nocat|}}}
}} }}

без выдзялення папярэдняга тэксту і абавязковага напаўнення даты

{{ {{{|safesubst:}}}#invoke:unsubst||1={{{{{|safesubst:}}}CURRENTDAY}}|2={{{{{|safesubst:}}}CURRENTMONTH}}|3={{{{{|safesubst:}}}CURRENTYEAR}}
 |$B = {{Надрадковае папярэджанне
  | day = {{{1|}}}
  | month = {{{2|}}}
  | year = {{{3|}}}
  | text = 
  | link = 
  | talk = {{{talk|{{{абм|}}}}}}
  | comment = {{{comment|{{{c|{{{кам|}}}}}}}}}
  | comment-default = 
  | anchor = {{{anchor|{{{якар|}}}}}}
  | cat1 = 
  | cat-date1 = 
  | cat2 =
  | cat-date2 = 
  | cat3 = 
  | cat-date3 = 
  | nocat = {{{nocat|}}}
  | errorcat =
}} }}

Для шаблонов без пазначэння даты пастаноўкі

{{Надрадковае папярэджанне
  | span-text = {{{1|}}}
  | span-style =
  | text = 
  | link = 
  | comment = {{{comment|{{{c|{{{кам|}}}}}}}}}
  | comment-default = 
  | anchor = {{{anchor|{{{якар|}}}}}}
  | cat = 
  | nocat = {{{nocat|}}}
}}

Прыклад ужывання

Гл. {{Не АК}}, {{Няма АК 2}}