WikiDer > Yordam: Andoza - Vikipediya

Ushbu yordam sahifasi a qanday qilib ko'rsatma berish. Unda Vikipediya normalari va amaliyotlarining ba'zi jihatlari (lariga) oid jarayonlar yoki protseduralar batafsil bayon etilgan. Bu bittasi emas Vikipediya qoidalari yoki ko'rsatmalari, va o'zgaruvchan darajalarni aks ettirishi mumkin Kelishuv va tekshirish.

Yorliqlar H: T WP: shablon

A shablon boshqa sahifalarga qo'shilishi uchun yaratilgan Vikipediya sahifasi. Shablonlar odatda takrorlanadigan materiallardan iborat bo'lib, ular har qanday miqdordagi maqola yoki sahifada ko'rsatilishi kerak bo'lishi mumkin. Ular odatda ishlatiladi qozon xabarlar, standartlashtirilgan ogohlantirishlar yoki bildirishnomalar, infobokslar, navigatsion qutilarva shunga o'xshash maqsadlar.

Inklyuzivning eng keng tarqalgan usuli deyiladi transklyuziya, qaerda vikitekst maqsad sahifada shablonga havola mavjud {{Shablon nomi}} sintaksis. Boshqa usul almashtirish, bu erda shablon tarkibi saqlanganida, faqat bir marta, maqsad sahifaning vikitekstiga ko'chiriladi.

Yordam: Shablonlar bo'yicha tezkor qo'llanma mavzu haqida qisqacha ma'lumot beradi. MediaWiki va Wikimedia tomonidan qo'shimcha yordam mavjud mw: Yordam: Shablonlar, m: Yordam: Andozava m: Yordam: Kengaytirilgan shablonlar.

Andoza uchun shablon havolasi

Shablonning haqiqiy to'liq ismini Vikipediya maqolasiga matn sifatida (atrofidagi qavslarni ham qo'shib) qo'shish uchun shablon havolasi shablon. Buning asosiy motivatsiyasi ko'rsatma va hujjatlarda. Qisqa misol:

{{tl | foo}}

hosil qiladi

{{foo}}

Umumiy tavsif

Media-ni ijro etish

Shablonlarning qanday ishlashiga oid asosiy sharh (8 daqiqali video)

Shablonlarning aksariyati Shablon nomlari maydoni, bu ularning "Andoza:XXXX"Biroq, istalgan nom maydonini almashtirish va almashtirish mumkin,^[a] va shuning uchun ba'zi shablon sahifalari boshqa nom maydonlarida, masalan Foydalanuvchi nomlari maydoni. Andoza sahifalari birlashtirildi suhbat sahifalari.

Shablonlar kerakli har qanday narsani o'z ichiga olishi mumkin vikitekst, shu jumladan boshqa shablonlarga qo'ng'iroqlar. Ularning cheklangan dasturlash imkoniyatlari mavjud: moslashtiriladigan qiymatlar (deyiladi parametrlar); hisoblash va dallanishlar (foydalanish ajralish funktsiyalari); va vikiga xos o'zgaruvchilarga kirish (sehrli so'zlar), masalan, sana, vaqt va sahifa nomlari. Ular tarkibida ham bo'lishi mumkin teglar shablonni almashtirish yoki almashtirishda vikitekstning qaysi qismlari kiritilishini belgilaydigan. Bu shuni anglatadiki, shablon sahifasining o'zi translyatsiya qilingan tarkib bilan bir xil bo'lmasligi kerak (masalan, shablon uchun hujjatlar, toifalar va boshqalarni o'z ichiga olishi mumkin).

Buni qanday qilish kerak: Shablonni maqola yoki sahifaga almashtirish uchun yozing {{Shablon nomi}} shablon paydo bo'ladigan joyda vikitekstda. Birinchi harf befarq kichik yoki katta harf bo'lishi mumkin.

Prefiks Andoza: shablon nomi sukut bo'yicha va uni kiritish shart emas. Biroq, boshqa nom maydonlarida saqlangan shablonlar uchun prefiks, masalan Foydalanuvchi:, ko'rsatilishi kerak. Sahifani ko'chirish uchun asosiy bo'shliq, sarlavhasidan oldin ikki nuqta bilan, kabi {{:Sahifa nomi}}.

Eslatma: Mavjud bo'lmagan shablonni ko'chirishga urinish a hosil qiladi qizil havola, xuddi boshqa mavjud bo'lmagan sahifalarga ulanish kabi. Havolani kuzatib borish shablonni yaratishga imkon beradi. Loyihalar o'rtasida sahifalarni ko'chirib o'tkazish mumkin emas (masalan, turli xil tillardagi Vikipedialar yoki MediaWiki) - shablonni boshqa til loyihasida ishlatish uchun shablon nusxasi o'sha loyihada yaratilishi kerak.

Sintaksisdan foydalanish

Parametrlar

Yuqorida keltirilgan asosiy transklyuziya sintaksisining qo'shilishi bilan kengaytirilishi mumkin parametrlar, ular shablonni chiqishini boshqarish uchun ishlatiladi. Buning sintaksisi{{Shablon nomi|parametr|parametr|...}}qayerda Shablon nomi shablonning nomi va har biri parametr yoki faqat bitta qiymatni o'z ichiga olishi mumkin (ular deyiladi noma'lum parametrlar) yoki shaklda bo'lishi mumkin ism=qiymat ( nomlangan parametrlar). Birinchi, ikkinchi, uchinchi va boshqalar noma'lum parametrlarga nomlar beriladi 1, 2, 3, va boshqalar.

Bo'shliq belgilar (bo'shliqlar, yorliqlar, qaytish) boshlari va oxirlaridan tozalanadi nomlangan parametr nomlari va qiymatlari, lekin o'rtadan emas: shunday qilib {{... | myparam = bu sinov}} bilan bir xil ta'sirga ega {{... | myparam = bu sinov}}. Bu tegishli emas noma'lum barcha bo'shliq belgilar saqlanadigan parametrlar.

Qaysi parametrlar (agar mavjud bo'lsa) shablonga o'tishi mumkin yoki o'tkazilishi kerak va qanday nomlanishi ushbu shablonning kodlanishiga bog'liq. Nomlangan parametrlarni istalgan tartibda aniqlash mumkin. Ortiqcha yoki noma'lum parametrlarga e'tibor berilmaydi; aniqlanmagan parametrlarga standart qiymatlar beriladi. Agar parametr bir necha marta aniqlangan bo'lsa, oxirgi qiymat kuchga kiradi.

Parametr qiymati bo'sh satr bo'lishi mumkin, masalan, trubka yoki unga teng keladigan belgidan keyin keyingi trubka yoki yopilish qavslari bilan birga keladi. Bu parametrni butunlay chiqarib yuborishdan farq qiladi, bu esa uni aniqlanmagan holda qoldiradi, garchi shablonlar ikkala holatda ham o'zini bir xil tutishi uchun ko'pincha kodlanadi.

Parametrlarni shablon kodida ko'rsatilmagan bo'lsa ham ko'rsatish mumkin (va hech narsa qilmaydi). Masalan, | sabab = shablon nima uchun joylashtirilganligini vikisursda qisqacha tushuntirish uchun tez-tez yolg'on parametr sifatida ishlatiladi.^[b] Ba'zi shablonlar qo'ng'iroq qiladi Modul: noma'lum parametrlarni tekshiring shablon kodida hisobga olinmagan parametr ishlatilayotgan bo'lsa, muharrirni ogohlantirish; bu asosan uchun ishlatiladi infobokslar va ko'p miqdordagi murakkab parametrlarga ega bo'lgan boshqa shablonlar, bu erda noma'lum kishining borligi odatda bexato xatodir. Agar siz bunday shablonni yangi parametr kiritish uchun yangilasangiz, uning modulga chaqiruvi ham yangi parametrni qo'shish uchun yangilanishi kerak.

Qo'ng'iroq qilish

Shablonga qo'ng'iroq qilish a ga o'xshamaydi o'zgaruvchan yoki a funktsiya dasturlash tilida: uni mos yozuvlar bilan chaqiring va u qiymatni qaytaradi chiqish). Funktsiyalar singari, ba'zi bir shablonlar natijani o'zgartiradigan parametrlarni qabul qiladi.

Yilda MediaWiki, wiki dasturi Vikipediya foydalanadigan, o'zgaruvchilar ularni shablonlardan ajratib turadigan aniqroq ma'noga ega, ammo ularning ikkalasi dubl bilan aniqlanadi qavslar {{ }} va ikkalasi ham qiymat qaytaradi.

MediaWiki o'zgaruvchisi nomlari katta harflar bilan berilgan bo'lsa, shablon nomlari bir xil asosiy xususiyatlarga ega va cheklovlar hamma kabi sahifa nomlari: ular harflarga sezgir (birinchi belgidan tashqari); pastki chiziqlar tahlil qilingan bo'shliq sifatida; va ular ushbu belgilarning hech birini o'z ichiga olmaydi: # < > [ ] | { }. Buning sababi, ular uchun ajratilgan wiki belgisi va HTML.

The raqam belgisi # deyiladi a fragment identifikatori chunki u a ni bildiradi parcha yoki hujjatning qismi (masalan, a Bo'lim Vikipediya maqolasida). Garchi u foydalanish mumkin shablon sahifasining bo'limiga havola qilish uchun (masalan Andoza: Portal # Misol), shablon ma'lumotnomasida fragment identifikatori yoki fragment nomini qo'yish uchun hech qanday sabab yo'q. Yilda {{Portal#Manzil| Kitoblar}}masalan, ip #Manzil maqsadi yo'q va shu tariqa e'tiborsiz qoldiriladi.

O'zgartirish

Shablon o'rnini bosganda uning mazmuni shunday bo'ladi qattiq kodlangan o'rniga sahifada transcluded. Qanday qilib va ​​qanday o'rganish uchun qachon shablonni almashtirish uchun qarang Yordam: almashtirish.

Shablonni ishlatishga oid asosiy misollar

Eslatma: Agar ulardan biri bilan tajriba o'tkazishni istasangiz, iltimos shablon sandbox, Maxsus: ExpandTemplates yoki sizning foydalanuvchi sahifangiz yoki sandbox.

Juda oddiy shablonga misolni topish mumkin Andoza: Lambda, bu matnning shu nuqtasida lambda belgisini (λ) joylashtirish uchun kengayadi. Dasturchi shablon deb aytishi mumkin qaytadi lambda belgisi (λ).

Ustiga bosing Andoza: Lambda, so'ngra shablon kodini (uning vikitekstini) ko'rish uchun "Manbani tahrirlash" yorlig'ini bosing. Deb nomlangan ushbu kodning "faol" qismi kengayish shablonning bitta so'zi & lambda;.^[c] Vikitekstning qolgan qismi orasida joylashgan <noxtlude> teglar, shuning uchun u shablon sahifasida ko'rsatiladi, ammo shablon boshqa sahifada ishlatilganda (yoki chaqirilganda) ko'rsatilmaydi.

Andoza: Lambda-ni boshqa sahifaga almashtirish uchun (ya'ni uni boshqa sahifada ishlatish uchun) yozing {{lambda}} (yoki {{Lambda}} - birinchi harfning ishi ahamiyatli emas) maqsad sahifaning vikitekstiga kirib, bosing Oldindan ko'rishni ko'rsatish. Sahifa. Bilan ko'rsatiladi shablon qo'ng'iroq vikitekst aslida mavjud bo'lganidek, shablonni kengaytirish bilan almashtirildi & lambda; o'sha paytda. Ko'rsatilgan sahifada "λ" matni bo'ladi.

Masalan, yozing Yunon alifbosining 11-harfi lambda ({{lambda}}) sahifani oldindan ko'rib chiqishda yoki o'zgarishni saqlagandan so'ng "yunon alifbosining 11-harfi lambda (λ)" ni ko'rasiz. Shablonlardan ularning kodlari tafsilotlarini bilmasdan foydalanishingiz mumkin; ular faqat shablon sahifasida tavsiflangan qanday natija berishlarini eslashingiz kerak.

Ushbu shablonni ishlatishning yana bir usuli - bu o'rnini bosuvchi u. Agar siz yozsangiz Yunon alifbosining 11-harfi lambda ({{subst: lambda}}) va sahifani oldindan ko'rib chiqing yoki saqlang, yana "Yunon alifbosining 11-harfi lambda (λ)" ni ko'rasiz. Agar siz yana saqlangan vikitekstga qarasangiz,^[d] ammo, siz sahifani saqlaganingizda shablon qo'ng'iroqlari haqiqatan ham shablonni kengaytirish bilan almashtirilganligini ko'rasiz. Chiqish matni va shablon o'rtasidagi bog'lanish endi uzilib qoldi va shablonga kelajakdagi o'zgarishlar ta'sir qilmaydi (transklyuziyada bo'lgani kabi).

Parametrlar bilan misollar

Parametrlarni qabul qiladigan shablonga shablonni misol qilish mumkin {{haqida}}. Yozishni harakat qilib ko'ring {{haqida | andozalardan foydalanish | modullardan qanday foydalanish | Yordam: Modul}} qum qutisida quyidagi matn paydo bo'ladi:

Shablon {{haqida}} uchta foydalanadi noma'lum parametrlar Yuqoridagi misolda (shuningdek, pozitsion parametrlar deb ham ataladi), lekin bir xil shablonni turli xil sonli parametrlar bilan ishlatilishi mumkin. shablon hujjatlari. Masalan, {{about || modullardan qanday foydalanish | Yordam: Modul}}. Bo'sh parametrdan foydalanishga e'tibor bering - bu holda ketma-ket quvurlar shablonga "o'tgan" birinchi parametr bo'sh satr ekanligini anglatadi, bu shablonda uning dastlabki "haqida" jumlasini tashlab yuboradi. Bu quyidagilarni ishlab chiqaradi:

Boshqa shablonlar, ayniqsa murakkabroq, nomlangan parametrlarni yoki nomlangan va nomlanmaganlarning aralashmasini oladi. Oddiy misol Andoza: To'lov matritsasi, 2 dan 2 gacha panjara yaratish uchun ishlatiladi. Masalan:

{{to'lov matritsasi | UL = 5 | UR = 7 | DL = 2 | DR = 9 | Ism = Masalan foydalanish}}

Ga qarang shablon sahifasi ko'proq imkoniyatlar uchun. Shablonning bu erda barcha mumkin bo'lgan parametrlarini aniqlamasdan foydalanganligiga e'tibor bering - aniqlanmagan parametrlarga standart qiymatlar beriladi.

Parametrlar oldidagi va undan keyin teng belgilar atrofidagi bo'shliqlar faqat ravshanlik uchun ishlatiladi - ular kerak emas va shablonni baholashda e'tiborga olinmaydi (garchi bu nomlanmagan parametrlarda bunday bo'lmasa). Parametr nomlari bor to'liq harflarga sezgir bo'lsa-da; masalan, almashtirish mumkin emas DR bilan dr yoki dR yuqoridagi misolda. Shablon tomonidan ishlatilmaydigan nomlari bo'lgan parametrlar shunchaki e'tiborsiz qoldiriladi.

Shablonning manba kodini o'rganishda parametrlarni ifodalovchi qo'shimcha uch qavsli ob'ektlar bilan standart jadval belgilanishi ko'rsatilgan:

{| id = "To'lov matritsasi" style = "background: white; float: {{{Float | o'ng}}}; aniq: to'g'ri; text-align: center; "align ={{{Float | o'ng}}} hujayra oralig'i = 0 katakcha = 8 kenglik ={{{Kenglik | 225}}}| - | style = "width: 33%;" | | style = "width: 33%; border-bottom: solid black 1px;" | {{{2L | Chap}}}| style = "width: 33%; border-bottom: solid black 1px;" | {{{2R | To'g'ri}}}| - | style = "border-right: solid black 1px; text-align: right;" | {{{1U | Yuqoriga}}}| style = "border-right: qattiq qora 1px; border-bottom: solid black 1px; background:{{{ULc | oq}}}; shrift hajmi: 120%; "| {{{UL | 0, 0}}}| style = "border-right: qattiq qora 1px; border-bottom: solid black 1px; background:{{{URc | oq}}}; shrift hajmi: 120%; "| {{{UR | 0, 0}}}| - | style = "border-right: solid black 1px; text-align: right;" | {{{1D | pastga}}}| style = "border-right: qattiq qora 1px; border-bottom: solid black 1px; background:{{{DLc | oq}}}; shrift hajmi: 120%; "| {{{DL | 0, 0}}}| style = "border-right: qattiq qora 1px; border-bottom: solid black 1px; background:{{{DRc | oq}}}; shrift hajmi: 120%; "| {{{DR | 0, 0}}}| - | style = "font-size: 90%;" colspan = 3 |''{{{Ism | {{PAGENAME}}}}}''|}

Tashkilot {{{2L | Chap}}} nomlangan parametrdan foydalanishga shablonni buyuradi 2L yoki matn Chapda agar parametr qo'ng'iroqda mavjud bo'lmasa.

Foydalanish bo'yicha ko'rsatmalar va vaqtinchalik echimlar

Shablonlardan foydalanganda quyidagi fikrlarni ta'kidlash lozim:

• Noma'lum parametr oddiy tenglik belgisini o'z ichiga olmaydi, chunki bu nomlangan parametrni o'chirish deb talqin etiladi.^[e] Noma'lum parametrdagi teng belgisini o'tkazish uchun (masalan, a URL manzili bilan atribut-qiymat juftliklari), tenglik belgisini maxsus shablon bilan almashtiring {{=}}, bu izohlanmaydigan teng belgisini qaytaradi. Boshqa usul - noma'lum parametrni (va keyingi nomlanmagan parametrlarni) nomlangan parametrlarga almashtirish - birinchi noma'lum parametr nomlangan parametrga teng |1= va hokazo. Shablonga qo'ng'iroq qilish uchun {{amalga oshirildi}} bilan a = b birinchi parametr uchun to'g'ridan-to'g'ri qiymat sifatida yozing {{tugadi | a {{=}} b}} yoki {{tugadi | 1 = a = b}}.
• Xuddi shunday, oddiy quvur belgisidan foydalanish mumkin emas | shablon parametrlarida, chunki u ajratuvchi sifatida talqin qilinadi.^[f] Bu safar muammoni sehrli so'z {{!}} trubaning o'rniga, yoki - agar quvurni yuqori darajada ajratish mo'ljallanmagan bo'lsa - yordamida HTML mavjudoti |. Shu bilan bir qatorda, joylashtirish uchun Vikipediyalar shablonlarda siz foydalanishingiz mumkin {{Vikipediya}} haddan oshmaslik uchun {{!}}.
• Bo'shliqdagi belgilar (bo'shliqlar, yorliqlar, aravachalarning qaytishi va chiziqli tasmalar) nomlangan parametrlardan farqli o'laroq noma'lum parametrlarning boshidan va oxiridan avtomatik ravishda o'chirilmasligini unutmang. Bunday belgilarni (yoki boshqa har qanday parametrlarda ko'rinmaydigan boshqa belgilarni) kiritish ba'zi hollarda shablonning xatti-harakatlariga kutilmagan tarzda ta'sir qilishi mumkin. (Andoza dizaynerlari foydalanishi mumkin {{Bo'sh joyni kesib oling}} noma'lum parametrlarda keraksiz bo'shliqni olib tashlash uchun.)
• Hujjatlar va munozaralarda, odatda shablonga qo'ng'iroq qilmasdan, shablon chaqiruvi sintaksisini ko'rib chiqilayotgan shablonga havola bilan ishlab chiqarish imkoniyati juda qulaydir. Buni yordamida osonlikcha bajarish mumkin {{tl}} shablon (""tbirlashtirmoq lsiyoh "shablon). Masalan, {{tl | Misol}} ishlab chiqaradi {{Misol}}. Yana bir nechta bor shablonni bog'laydigan shablonlar turli xil funktsional imkoniyatlarga ega.
• Shablon o'zgartirilganda (shablon yoki uning pastki shablonlaridan biri tahrirlanganda), shablon translyatsiya qilingan barcha sahifalarda aks etadi. Biroq, o'zgarish darhol barcha sahifalarda ko'rinmasligi mumkin; shablonning oldingi versiyasiga asoslangan sahifaning oldindan keshlangan versiyasi bir muncha vaqt namoyish etishda davom etishi mumkin. Dan foydalaning tozalash shablonlarning so'nggi versiyalari yordamida sahifani ko'rsatishga majbur qiladigan funktsiya, shu jumladan, agar u foydalanishga oid misollarni o'z ichiga olgan bo'lsa, shablon sahifasida.
• Sahifalarning eski versiyalarini ko'rishda esda tutingki, andozalar avvalgi sahifa versiyasi faol bo'lgan paytdagidek emas, balki hozirgi kabi translyatsiya qilinadi.
• Shablon ko'chirilgan barcha sahifalarni ro'yxatlash uchun foydalaning Bu erda qanday havolalar mavjud shablon sahifasida. Bu bo'ladi emas shablon o'rnini bosgan sahifalarni o'z ichiga oladi.
• Sahifada translyatsiya qilingan andozalar ro'yxatini olish uchun "Tahrirlash" tugmachasini bosing va tahrirlash oynasi ostidagi ro'yxatni toping. Ushbu ro'yxat shuningdek to'g'ridan-to'g'ri transklyatsiya qilingan shablonlar tomonidan ishlatiladigan subtemplatlarni o'z ichiga oladi. Sahifa bo'limi, sahifaning eski versiyasi uchun bunday ro'yxatni olish uchun,^[g] yoki saqlashdan oldin yangi tahrir qilingan versiyangizni bosing Oldindan ko'rishni ko'rsatish tegishli tahrirlash sahifasida.
• Maqolada bo'lishi mumkin bo'lgan shablonlarning soni va murakkabligi chegaralari mavjud. "Ga qarang§ chegaralarni kengaytirish"buni hal qilishda yordam uchun bo'lim.
• Agar siz shablonni a qoldirishini xohlasangiz vaqt muhri yoki imzo, yozishingiz mumkin <noinclude><nowiki></noinclude>~~~~~<noinclude></nowiki></noinclude>, lekin bu faqat shablonni almashtirganda ishlaydi. Agar siz uni translyatsiya qilsangiz, shunchaki ~~~~~ olasiz.
• O'qish qobiliyatini yaxshilash uchun odatda dasturchilar kodni yangi satrlar bilan ajratib, indentatsiya qilishni yaxshi ko'radilar. Afsuski, MediaWiki dasturiy ta'minot ushbu funktsiyaga ruxsat bermaydi; ko'p hollarda, ushbu maqsadga yo'naltirilgan yangi liniyalar dastur tomonidan tarkib sifatida ko'rib chiqiladi. Mumkin bo'lgan vaqtinchalik echimlardan biri qo'shishdir <!-- har bir yangi satr belgisi oldida va --> undan keyin ishlab chiqaradigan HTML sharhi.

Shablonlarni yaratish va tahrirlash

Shablonlar boshqa sahifalar singari yaratilgan va tahrirlangan: tegishli nomni tanlang, ushbu sahifaga o'ting, so'ngra "Tahrirlash" yorlig'ini bosing yoki kerak bo'lganda yangi sahifa yarating. Yuqorida aytib o'tilganidek, andozalar odatda Shablon nomlari maydoniShunga qaramay, o'zingizning shaxsiy foydalanishingiz yoki tajribangiz uchun mo'ljallangan shablonlarni o'zingiz yaratishingiz mumkin foydalanuvchi maydoni. Oddiy sahifaga yoki maqolaga kiritilishi mumkin bo'lgan har qanday narsani shablonga, shu jumladan boshqa andozalarga (chaqiriladi) qo'shish mumkin subtemplatlar). Shablonlar ko'pincha dasturlash funktsiyalaridan foydalanadi - parametrlar, tahlil qiluvchi funktsiyalar va boshqalar sehrli so'zlar- transklyatsiya qilingan tarkib tarkibiga qarab o'zgarishiga imkon beradigan. Shuningdek, qaysi ma'lumot translyatsiya qilinganligini va boshqasi yo'qligini boshqarish uchun maxsus teglar mavjud.

Shablonni yaratishdan oldin, mavjud shablonlarni (masalan, o'rganish orqali) tezda qidirib toping Turkum: Vikipediya shablonlari) siz xohlagan narsani bajaradigan shablon yoki nusxa ko'chirish va o'zgartirish (yoki joyida qoldirib kengaytirish) mumkin bo'lgan shunga o'xshash shablon mavjudligini ko'rish uchun. Yangi shablonga asos bo'lishi mumkin bo'lgan umumiy shablonlarni qidiring; masalan, navbox generic-ga qo'ng'iroq qilish orqali shablonlarni osongina yaratish mumkin Andoza: Navbox.

Shablon uchun qanday nom tanlash kerakligi haqida qat'iy qoidalar yo'q - uni qisqa, ammo oqilona tavsiflovchi qilib qo'ying. Agar shunga o'xshash shablonlar mavjud bo'lsa, izchil nomlash uslubini bajarishga harakat qiling. Shablonlar mavjudligini buzmasdan qayta nomlanishi mumkin transklyuziyalar (nima deyiladi sinish) taqdim etilgan yo'naltirish yangi shablon nomi ortda qoldi.

Mavjud shablonlarni tahrirlashda juda ehtiyot bo'ling - kiritilgan o'zgartirishlar ko'p sonli sahifalarga ta'sir qilishi mumkin, bu ko'pincha siz kutmagan bo'lishi mumkin. Shu sababli ko'plab yuqori darajadagi shablonlar mavjud himoyalangan dan tashqari tahrirlashga qarshi ma'murlar va shablon muharrirlari; boshqa tahrirlovchilar munozara sahifasida o'zgarishlarni taklif qilishlari mumkin. Ba'zi shablonlar qum qutisini va sinov holatlari tajriba uchun.

Osonlik bilan birlashtirilishi mumkin bo'lgan foydalanilmayotgan yoki noo'rin shablonlarni yoki shablonlarni o'chirishni yoki birlashtirishni taklif qilish uchun Muhokama uchun shablonlar (TfD).

Parametrlarni boshqarish

Shablonga berilishi mumkin bo'lgan parametrlarning qiymatlari shablon kodida ularning orasidagi elementlar bilan ifodalanadi uch baravar qavslar:

• Kod {{{xxx}}} nomlangan parametr qiymati bilan almashtiriladi xxx. ular sifatida tanilgan nomlangan parametrs.
• Kodlar {{{1}}}, {{{2}}}, va hokazolarning o'rniga birinchi, ikkinchi va boshqalar almashtiriladi noma'lum parametr (yoki nomlangan parametr qiymati 1, 2, va boshqalar.); ular sifatida tanilgan pozitsion parametrs.

Agar parametrga qiymat berilmagan bo'lsa, uni almashtirish amalga oshirilmaydi; bu shuni anglatadiki, agar parametr uchun qiymat berilmasa | xxx =, ifodaning qiymati {{{xxx}}} shablon ichida tom ma'noda bo'ladi {{{xxx}}}, siz kutgan "bo'sh" emas. Oddiy parametr qiymatlarini belgilash orqali intuitiv harakatga erishish mumkin. Bu bilan amalga oshiriladi quvur sintaksisi: {{{xxx | dflt}}} standart qiymatni belgilaydi dflt nomlangan parametr uchun | xxx =va {{{1 | dflt}}} standart qiymatni belgilaydi dflt birinchi noma'lum parametr uchun. Ko'pincha, bu nol standart qiymatlarni belgilash uchun ishlatiladi, masalan {{{1|}}} yoki {{{xxx |}}}.

Parametr taxalluslari odatiy qiymatlarning alohida holatidir. Masalan, agar parametrlar |1=, | matn =va | xabar = bir xil parametr uchun nomlar, keyin wikitext {{{xabar | {{{text | {{{1 |}}}}}}}}} ishlatilishi mumkin. Agar ushbu parametrlardan bittasi berilgan bo'lsa, unda xabar ustuvorlikka ega bo'ladi, undan keyin matnva nihoyat birinchi noma'lum parametr bo'yicha. Ya'ni, agar ushbu vikitekstni o'z ichiga olgan shablon parametrlardan o'tkazilsa | xabar = A | matn = B, vikitext kengaytiriladi A.

Ikki qavatli va uch qavatli sintaksisdan ko'p foydalanilganligi sababli, iboralar ba'zan noaniq bo'lishi mumkin. Bunday noaniqlikni hal qilish uchun bo'sh joylarni kiritish foydali yoki zarur bo'lishi mumkin. Masalan, {{{{{{xxx}}}}} yoki {{{{{{xxx}}}}}, ketma-ket beshta qavsni terishdan ko'ra, odam uchun ko'proq tushunarli bo'lishi mumkin. Biroq, shablon kengayishida keraksiz bo'sh joy paydo bo'lishiga e'tibor bering.

Maxsus holat: XML uslubidagi ochilish yorlig'i ichidagi parametrlar

Parametrlar o'ralgan holda kengaytirilmaydi <nowiki> teglar. Ular haqiqiy ichida joylashtirilgan bo'lsa ham kengaytirilmaydi XML- uslubni ochish yorlig'i. Shunday qilib, shablon ichida quyidagilar ishlamaydi:

• <ref name={{{param}}}> Smith, Adam (1776)...</ref>

chunki parametr kengaytirilmagan. Buning o'rniga, dan foydalanishingiz mumkin {{#tag:}} ajralish funktsiyasi, masalan, ishlatilgan {{sfn}} yaratish <ref>...</ref> element; Shuningdek qarang Yordam: Sehrli so'zlar § Formatlash. Shuning uchun quyidagi misol ishlaydi:

• {{#tag: ref | Smit, Adam (1776) ... | ism = {{{{param}}}}}

E'tibor bergan: haddan tashqari kengaytirilgan URL manzillari

Agar parametr qiymati a ga teng bo'lsa (yoki tugasa) URL manzili, URL-dan keyin bir yoki bir nechta belgi bilan kattalashtirilgan havola bilan Vikipediyada ko'rsatilishini tekshiring, shunda havolani bosish xato yoki ishlamay qolishiga olib keladi. Dasturiy ta'minot bilan ishlov berilgandan so'ng, yumshoq joyni ta'minlang (emas a qattiq yoki buzilmaydigan bo'shliq) URL manzilini siz yoki foydalanuvchi URL-manzilni taqdim etganligidan yoki u avtomatik ishlov berish natijasida hosil qilinganligidan qat'i nazar, kuzatib boradi. Ehtimol, manba kodida ishlov berishda tashlangan bo'sh joy bo'lishi yoki hosil bo'lishi mumkin yoki u erda bo'sh joy bo'lmasligi mumkin. Manba kodini to'g'rilang, ehtimol URL manzilidan keyin bo'sh joy paydo bo'lishiga majbur qiling. The {{bo'shliqlar}} shablon foydali bo'lishi mumkin.

Tizim o'zgaruvchilari va shartli mantiq

Shablon kodi ko'pincha tavsiflangan o'zgaruvchilar va tahlil funktsiyalaridan foydalanadi Yordam: Sehrli so'zlar shablonni xatti-harakatlarini atrof-muhitga (masalan, joriy vaqtga yoki ism maydoniga) yoki unga berilgan parametr qiymatlariga bog'liq qilish uchun. Ular arifmetik hisob-kitoblar uchun ham ishlatilishi mumkin, ammo looplar va o'zgaruvchilarni tayinlash kabi ba'zi bir standart dasturlash funktsiyalari mavjud emas. To'liq simli manipulyatsiya ham mavjud emas; bunday funktsiyani ta'minlaydigan ba'zi shablonlar yaratilgan, ammo ular samarasiz va nomukammal.

Quyida eng ko'p ishlatiladigan o'zgaruvchilar va funktsiyalarning ba'zilari keltirilgan. Qo'shimcha ma'lumot uchun qarang Yordam: Sehrli so'zlar va MediaWiki sahifalaridagi to'liq hujjatlar mw: Yordam: Sehrli so'zlar va mw: Yordam: Kengaytma: ParserFunctions.

The {{PAGENAME}} va {{NAMESPACE}} o'zgaruvchilar kontekst asosida shablonni xatti-harakatlarini o'zgartirish uchun juda foydali va tez-tez ishlatiladi. Misol uchun, agar shablon toifadagi havolani o'zgartirsa (masalan, sahifani tozalash kerak bo'lgan sahifaga ajratadigan havolani o'chirib tashlaydigan tozalash shablonlari), u ko'pincha {{NAMESPACE}} munozarali sahifalar, foydalanuvchi sahifalari yoki boshqa biron bir joyda yorliq tasodifan joylashtirilishi mumkinligiga ishonch hosil qilish uchun o'zgarmaydiganlar o'zlarini tozalashga muhtoj sahifalar toifasiga kiritmaydi.

Shablonlarni joylashtirish

Shablonlarda boshqa andozalar bo'lishi mumkin - bu odatda shunday nomlanadi uyalash. Shablonni qayta ishlash jarayonida har qanday ichki o'rnatilgan shablonlar tomonidan ishlab chiqarilgan vikitekst shablonga o'tkaziladi, shunda yakuniy mahsulot asosan eng chuqur joylashtirilgan shablondan qayta ishlanadi. Amaliyotda juda sodda bo'lsa-da, u ba'zi diqqatga sazovor narsalar va fokuslarni o'z ichiga oladi.

Parametr qiymatini ichki o'rnatilgan shablonga o'tkazish uchun parametr yorlig'ini ichki o'rnatilgan shablon parametrlaridan biri qiymati sifatida joylashtiring.

Misollar:

Andoza: A tarkibida "tez jigarrang {{B | {{{3}}}}} sakrab tushadi ..." Bu Andoza: A uchinchi pozitsion parametriga o'tgan qiymatni oladi va uni Andoza: B ning birinchi pozitsion parametri sifatida uzatadi, so'ngra B tomonidan ishlab chiqarilgan vikitekstni so'z birikmasi qismiga qaytaradi.

Andoza: A tarkibida "tez jigarrang {{B | waldo = {{{3}}}}} sakrab o'tmoqda ..." Ilgari bo'lgani kabi, Andoza: A ning uchinchi pozitsion parametri bundan mustasno, Andoza: B ning "waldo" parametriga o'tkaziladi.

Shablon parametrlarining o'zi shartli ravishda tanlanishi mumkin.

Misollar:

Andoza: A tarkibida tez jigarrang {{B | {{{3}}} = tulki}} sakrab o'tmoqda ... Andoza: A "tulki" so'zini Andoza: B nomi berilgan parametri sifatida uzatadi, uning nomi A ning uchinchi pozitsion parametri.

{{#if: sinov satri | test satri bo'sh bo'lmasa qiymat | {{#if: sinov satri | test satri bo'sh bo'lmasa qiymat | agar test satri bo'sh bo'lsa (yoki faqat bo'sh joy bo'lsa) }} }}

Shablon o'zi qo'ng'iroq qilishi mumkin, lekin cheksiz tsiklni oldini olish uchun bitta takrorlashdan so'ng to'xtaydi.

Ichki shablonga mos kelmaydigan qavslar kiritilganda - xuddi shunday {{funt}}}- taqqoslanmagan qavslar ishlov berish paytida matn sifatida qabul qilinadi va joylashtirish shablonidagi qavslarning ajralishiga ta'sir qilmaydi. O'rnatilgan shablon o'rnini bosadigan bo'lsa, birinchi navbatda almashtirish amalga oshiriladi va bu iroda o'rnatish shablonida qanday qavslar ajratilishini o'zgartiring. Buning amaliy foydasi oz, lekin vaqti-vaqti bilan kutilmagan xatolarni keltirib chiqarishi mumkin.

Qarang meta: Yordam: Kengaytirilgan shablonlar va meta: Yordam: vikitekstning rekursiv konversiyasi qo'shimcha ma'lumot olish uchun. Ushbu sahifalarda, shuningdek, kabi noodatiy qo'ng'iroqlar haqida ma'lumotlar mavjud {{shablon {{{parametr |}}}}}.

Inklyuziv nazorat: noinclude, onlyly only and onlyinclude

Odatiy bo'lib, shablon bo'lsa transcluded (yoki almashtirilgan), shablon sahifasining butun vikitekti (kodi) maqsad sahifaning tarkibiga kiradi. Shu bilan birga, shablon kodining qaysi qismlari kiritilishi kerakligini belgilaydigan teglar yordamida ushbu xatti-harakatni o'zgartirish mumkin. Bu faqat shablon sahifasida ko'rsatilishi uchun mo'ljallangan ma'lumotlarni, masalan, shablonning {{hujjatlar}}, toifalarva interwiki havolalari. Shuningdek, kod qismlarini transklyuziv qilish mumkin, ammo emas shablon sahifasida o'zi ishlov berish (masalan, shablonga taalluqli bo'lmagan maqsad sahifalarga qo'llaniladigan toifalar). Teglar quyidagicha:

• <noxtlude> ... - Teglar orasidagi matn bo'ladi emas shablon translyatsiya qilingan (almashtirilgan) bo'lganda kiritilishi kerak, ammo iroda shablon sahifasida ishlov berish; umumiy foydalanish uchun shablonlardagi hujjatlar.
• <faqat o'z ichiga oladi> ... - Bu shuni ko'rsatadiki, sahifada hech narsa yo'q bundan mustasno teglar orasida paydo bo'ladigan narsa o'zgartiriladi (almashtiriladi).
• <faqat o'z ichiga oladi> ... - teglar orasidagi matn iroda transklyuziya qilinadi (almashtiriladi), lekin bo'ladi emas shablonning o'z sahifasida ishlov berish.

Ehtimol, ushbu bloklardan foydalanish bilan bog'liq eng keng tarqalgan muammo - bu keraksiz bo'shliqlar yoki chiziqlar. Shuni esda tutish kerakki, ushbu teglarning ta'siri avvalgi chiziqda yoki oldingi ko'rinadigan belgida emas, balki birinchi burchakli qavsdan darhol boshlanadi; shunga o'xshash effekt keyingi chiziqda yoki keyingi ko'rinadigan belgi bilan emas, balki so'nggi burchakli qavsdan so'ng darhol tugaydi. Masalan:

<faqat o'z ichiga oladi>

}}

}}
<includeonly>

<noxtlude>

}}

}}
<noinclude>

</includeonly><noxtlude>

{{Andoza}}

{{shablon}}
<noinclude>

Ushbu teglar bir-birining ichiga joylashtirilishi mumkin, ammo (ma'lum bir sahifa uchun) bu faqat <faqat o'z ichiga oladi> yorliq; uyalash <faqat o'z ichiga oladi> va <noxtlude> teglar juda ma'nosiz. Teglarni to'g'ri joylashtirish uchun ehtiyot bo'ling. Shunga o'xshash qurilishlar <faqat o'z ichiga oladi>abc<faqat o'z ichiga oladi>def</onlyinclude>ghi</includeonly> iroda emas kutilganidek ishlash. HTML / XML uchun standart bo'lgan "birinchi ochilgan, oxirgi yopilgan" qoidadan foydalaning.

Muammolar va vaqtinchalik echimlar

• Agar shablon tomonidan ishlab chiqarilgan birinchi belgi yoki ajralish funktsiyasi vikini belgilaydigan to'rtta belgidan biri -:, ;, *, #^[h]- keyin u shablon yorlig'i bo'lmasa ham, xuddi satr boshidagi kabi ishlov beriladi. Bu shablon har doim ham ro'yxat uchun to'g'ri joyda bo'lmasligi mumkin bo'lgan shablonlarda har xil ro'yxatlarni yaratishga imkon beradi. Buning oldini olish uchun yoki foydalaning <nowiki /> belgilashdan oldin yoki HTML sub'ektlar :, &#59;, *va # navbati bilan. Ba'zi hollarda, HTML sub'ektlari qachon ishlashadi <nowiki /> emas. Muammo ko'pincha shablon qo'ng'irog'idagi parametr qiymati to'rtta belgidan biri bilan boshlanganda paydo bo'ladi.
• Shablonlarni almashtirish bilan bog'liq masalalar uchun, masalan, pastki shablonlarning o'rnini bosishini yoki ota-ona shablonini almashtirishda qanday boshqarilishini ko'rish uchun qarang. Yordam: almashtirish.
• Shablon {{Bo'sh joyni kesib oling}} har qanday boshlang'ich yoki so'nggi bo'shliqni noma'lum parametr qiymatlaridan olib tashlash uchun ishlatilishi mumkin, agar bu muammo tug'dirsa; nomlangan parametr qiymatlari shu tarzda avtomatik ravishda o'chiriladi.
• Shablonlarni disk raskadrovka qilish uchun ba'zan quyidagi usullar yordam beradi:
  • Foydalanish pastki: shablonni almashtirishda nima sodir bo'layotganini aniqroq ko'rsatib beradigan shablonni almashtirish (uni almashtirish o'rniga); qarang Yordam: almashtirish.
  • Foydalanish msgnw: (qisqartmasi "message, nowikki ") shablon sahifasidagi vikitekstni qayta ishlangan tarkibdan ko'ra ko'proq yoki ozroq translyatsiya qilish uchun. Bu mukammal emas: ro'yxatlar keltiriladi, izohlar o'chiriladi va bitta yangi satrlar bo'shliqlar bilan almashtiriladi (bu, ayniqsa, vikitekstni o'zgartirganda chalkash bo'ladi) jadvallar).
  • Foydalanish Maxsus: ExpandTemplates bir yoki bir nechta shablonlarning to'liq rekursiv kengayishini ko'rish uchun.
• Server resurslarini himoya qilish va cheksiz ko'chadan qochish uchun ajraluvchi chuqur transklyuziya uyasiga va kengaytirilgan shablonlar bilan sahifa hajmiga ma'lum cheklovlar qo'yadi. Bu juda murakkab andozalardan foydalanishda sahifalarni buzilishiga olib kelishi mumkin, ayniqsa bitta sahifada bunday shablonlar ko'p bo'lsa. Qo'shimcha ma'lumot olish uchun qarang Vikipediya: Andoza chegaralari. Sahifaning serverga umumiy yuklanishini, yaratilgan HTML-ni sahifa uchun tekshirib, -ni qidirish orqali tekshirish mumkin NewPP limit hisoboti Izohlar.
• Foydalanmang = maqola makonida foydalanish uchun mo'ljallangan shablon ichida bo'lim sarlavhalarini yaratish uchun wikimarkup; bu yaratadi [tahrirlash] havola qilinganida, tahrirlash uchun shablonni chalkashtirib ochadigan havola.
  • Siz qochishingiz mumkin [tahrirlash] qo'shib shablonga havolalar <includeonly>__NOEDITSECTION__</includeonly>.

Hujjatlar

Shabloningizni turkumlash va undan to'g'ri foydalanilishini hujjatlashtirish boshqa tahrirlovchilarni topish va ulardan foydalanishni osonlashtiradi.

Foydalanuvchilar uchun hujjatlar, shablon toifalari bilan birga, odatda shablon kodidan keyin, ichkariga joylashtiriladi <noinclude>...</noinclude> teglar. Odatda ochilishni qo'yish kerak <noinclude> Keraksiz bo'sh joyni chetlab o'tmaslik uchun kod tugagandan so'ng darhol bo'sh joy yoki yangi qatorlarsiz yorliq qo'ying.

Murakkab shablonlarda hujjatlar (toifalar bilan birgalikda) ko'pincha alohida saqlanadi pastki sahifa Andoza sahifasi ("Andoza:XXX/ doc "). Bu ko'pchilikka ham tegishli himoyalangan shablonlar, bu ma'lumotni administrator bo'lmaganlar tomonidan tahrirlashga imkon beradi. Bunga joylashtirish orqali erishiladi {{Hujjatlar}} asosiy shablon kodidan keyin va ichida shablon <noinclude>...</noinclude> teglar. Agar "/ doc" pastki sahifasi mavjud bo'lmasa, uni yaratishga imkon beruvchi havola paydo bo'ladi.

Kategorizatsiya

Shablonni qo'shish orqali sahifalarni tasniflang

Ba'zi shablonlar o'zlarining transkript kodlarida toifadagi ta'riflarni o'z ichiga oladi, chunki ular maqsadli sahifalarni ma'lum toifalarga joylashtirish uchun mo'ljallangan. Bu ko'pincha texnik xizmat ko'rsatish toifalari bilan amalga oshiriladi (maqolalarni oddiy tarkib toifalariga joylashtirish tavsiya etilmaydi). Buni amalga oshirayotganda foydalanish kerak bo'lishi mumkin <includeonly>...</includeonly> shablonning o'zi toifaga kirmasligi uchun teglar. Toifani qo'llash uchun mo'ljallangan shablonni ishlab chiqish, sinovdan o'tkazish, namoyish qilish yoki namoyish qilish paytida har bir toifani vaqtincha sinov toifasiga almashtiring (bilan boshlang X1, X2, yoki X3) yoki tasniflashni bostirish (qarang andozalarda toifani bostirish).

Shablonlarni turkumga kiriting

Kategorizatsiya deklaratsiyasi [[Kategoriya: Ba'zi mavzulardagi andozalar]] shablonning hujjatlar sahifasiga (yoki ichkariga joylashtirilishi kerak) <noinclude>...</noinclude> teglar translyatsiya qilingan sahifalarni ifloslanishiga yo'l qo'ymaslik uchun hujjat sahifasi bo'lmasa).

Taxalluslar

Taxalluslar bilan yaratilishi mumkin yo'naltirishlar. Masalan, Andoza: Tsh yo'naltirishlar Andoza: Andoza yorlig'i. Keyin yozishingiz mumkin {{tsh|foo}} o'rniga {{Shablon yorlig'i|foo}}.

Faqat bo'shliqlar va katta harflar bilan farq qiladigan shablon taxalluslarini tayyorlash yaxshi. Masalan, deb nomlangan shablon mavjud {{Vikilug'atni ko'ring}}. "W" bosh harfdir, chunki "Vikilug'at" so'zi shunday, lekin yo'naltirish {{Vikipediyaga qarang}} pastki "w" mavjud, chunki foydalanuvchilar uning o'rniga ikkinchisini yozishlari mumkin.

Shablon chegaralari

"Kengayishdan keyin hajmni o'z ichiga oladi" chegarasi. Shablonlar sizning brauzeringizda ko'rish uchun HTML formatida yoki kengaytirilganda, ular xotiradan foydalanadilar. Bunga "kengayishdan keyingi qo'shilish hajmi" deyiladi va uning chegarasi 2 048 000 baytni tashkil qiladi. This size is included as an invisible comment in the HTML output—use your browser's view source feature to show the raw HTML and search for "newpp". The report will look like:

<!--NewPP limit reportPreprocessor node count: 2382/1000000Post-expand include size: 63476/2048000 bytesTemplate argument size: 9517/2048000 bytesExpensive parser function count: 2/500-->

The example shows that template expansion is using 63,476 bytes out of 2,048,000 bytes of available memory.

Display problem. If too many templates are included on a page, the post-expand include size may exceed the limit. When this happens, templates after the limit will no longer expand and will instead display as a wikilink (for example, Andoza:Template name). Common causes are the inclusion of too many citation templates and/or flag templates. To resolve this problem o'rnini bosuvchi templates, remove templates, or Split sahifa.

Non-rendered tranclusions still count towards limit. For example, a page which contains only {{#if:{{:Main Page}}}} would still have a post-expand include size even though it would have no output at all.

Xuddi shu narsa ham amal qiladi Scribunto modules. Masalan, {{#invoke:Test|main}} would still increase post-expand include size even if Module:Test were simply:

mw.getCurrentFrame():preprocess "{{msgnw::Main Page}}" -- remove this line and post-expand include size becomes zeroqaytish {asosiy = funktsiya() oxiri} -- p.main() has no return value

Lua dasturlash tili

Since February 2013, the Lua dasturlash tili is available for use through the Scribunto MediaWiki extension. Lua code can be embedded into templates by employing the {{#invoke:}} functionality of the Scribunto MediaWiki extension. The Lua manba kodi is stored in pages called modules, and these individual modules are then invoked on template pages. Masalan, Module:Example can be invoked using the code {{#invoke:Example|hello}} to print the text "Hello World!".

Template search

As an alternative to using this index linked above, you can search the Template namespace using the Maxsus: qidirish box below:

Shuningdek qarang

Izohlar