Модуль:Цёзкі/Дакумэнтацыя
Гэта падстаронка-дакумэнтацыя для Модуль:Цёзкі
 | Гэта падстаронка дакумэнтацыі для Модуль:Цёзкі (націсьніце, каб праглядзець модуль). Яна зьмяшчае зьвесткі пра выкарыстаньне, катэгорыі й іншы зьмест, не датычны непасрэдна старонкі модульу. |
 | Гэты модуль гатовы для шырокага агульнага выкарыстаньня, бо ён знаходзіцца ў стабільным стане, а вядомыя памылкі выпраўленыя. |
 | Гэты шаблён выкарыстоўвае Lua: |
Гэты модуль апрацоўвае шаблён {{Цёзкі}} і выводзіць тэкст пра іншых людзей, якія маюць такое ж імя ці прозьвішча, ці поўнае імя (цёзкі). Модуль падтрымлівае як ручны ўвод парамэтраў, так і аўтаматычнае вызначэньне існых артыкулаў.
Выкарыстаньне
[рэдагаваць код]Каб выклікаць модуль у шаблён, трэба напісаць такі код:
{{#invoke:Цёзкі|main|{{{1|}}}}}
У такім шаблёне карыстальнік можа перадаць парамэтар:
{{Цёзкі|Імя}}: «Імя» — тэкст, на які будзе спасылка.- Можа ўключаць разьметку:
{{Цёзкі|[[Імя Прозьвішча|І. Прозьвішча]]}}.
Лёгіка працы модулю
[рэдагаваць код]Калі парамэтар уведзены ({{{1|}}} не пусты)
[рэдагаваць код]- Модуль заўсёды выкарыстоўвае менавіта ўведзены карыстальнікам тэкст для спасылкі.
- Вызначае форму паведамленьня па супадзеньні словаў з загалоўкам артыкула:
- Калі ёсьць супадзеньне са словам імя: «У Вікіпэдыі ёсьць артыкулы пра іншых людзей зь імем [[Імя]]».
- Калі ёсьць супадзеньне са словам прозьвішча: «У Вікіпэдыі ёсьць артыкулы пра іншых людзей з прозьвішчам [[Прозьвішча]]».
- Калі ёсьць супадзеньне з усім імем і прозьвішчам: «У Вікіпэдыі ёсьць артыкулы пра іншых людзей з такімі ж імем і прозьвішчам: [[Імя Прозьвішча]]».
- Калі няма супадзеньня, выкарыстоўваецца агульны тэкст: «У Вікіпэдыі ёсьць артыкулы пра іншых людзей, якія ёсьць поўнымі ці няпоўнымі цёзкамі гэтай асобы, глядзіце [[Тэкст]]».
Калі парамэтар ня ўведзены выкарыстоўваецца аўтаматычны рэжым
[рэдагаваць код]- Модуль шукае існыя артыкулы:
- Імя (з магчымым «(неадназначнасьць)»).
- Прозьвішча (з магчымым «(неадназначнасьць)»).
- Поўнае імя (з магчымым «(неадназначнасьць)»).
- І выводзіць адпаведны выгляд шаблёну.
- Ніколі не выводзіць спасылку на сам артыкул, у якой выкарыстоўваецца шаблён.
- Калі ніводнай спасылкі ня знойдзена й артыкул у асноўнай прасторы назваў, модуль аўтаматычна дадае спасылку тыпу Прозьвішча зь неадназначнасьцю й катэгорыю
[[Катэгорыя:Вікіпэдыя:Артыкулы зь няіснымі старонкамі ў шаблёне «Цёзкі»]]. - Калі модуль не знаходзіць нават прозьвішча ў загалоўку, ён дадае
[[Катэгорыя:Вікіпэдыя:Артыкулы з пустым шаблёнам «Цёзкі»]].
Функцыі модулю
[рэдагаваць код]p.main(frame)
-- Галоўная функцыя модулю.
-- frame: абʼект, перададзены шаблёнам {{#invoke}}.
-- Вяртае тэкст зь верхняй зноскай альбо катэгорыю, калі спасылкі ня знойдзеныя.