Birşablon, diğer sayfalara eklenmek üzere oluşturulan bir Vikipedi sayfasıdır. Şablonlar genellikle birden fazla sayıda madde veya sayfada görünmesi gerekli olabilecek, tekrarlayan bilgiler içerir. Örneğin basit iletiler, olağan uyarılar veya bildirimler,bilgi kutuları, yönlendirme kutuları ve benzeri amaçlar için kullanılır.
En çok kullanılan şablon ekleme yöntemiyansıtmadır; bu şekilde hedef sayfanınvikimetnine{{Şablon adı}} sözdizimi eklenir. Başka bir yöntem,değiştirmedir; bu yöntemle kaydedildiğinde şablonun içeriği, hedef sayfanın vikimetnine kopyalanır.
Yardım:Şablonlara hızlı başlangıç kılavuzu, konuya kısa bir giriş yapılabilmesi amacıyla hazırlanmıştır. MediaWiki ve Wikimedia'danmw:Help:Şablonlar,m:Help:Şablon vem:Help:Gelişmiş şablonlar sayfalarından da daha fazla yardım alabilirsiniz.
Bir Vikipedi maddesine şablonun gerçek tam adını metin olarak (çevresindeki kaşlı ayraçlar dahil) eklemek içinşablon bağlantısı şablonu uygulayın. Bunu yapmak için birincil motivasyon talimat ve belgelendirmedir. Kısa bir örnek kod:
{{şb|Örnek}}
- şunu oluşturur
- {{Örnek}}
Şablonların çoğu, Şablon ad alanı içindeki sayfalardır. Bu, "Şablon:XXXX" biçiminde başlıklara sahip oldukları anlamına gelir. Bununla birlikte, herhangi bir ad alanını kopyalamak ve yerine koymak mümkündür,[a] ve böylece bazı şablon sayfalarıKullanıcı ad alanı gibi diğer ad alanlarına yerleştirilir. Şablon sayfalartartışma sayfaları ile ilişkilendirilmiştir.
Şablonlar, diğer şablonlara yapılan çağrılar da dahil olmak üzere istenenvikimetin içerebilir. Bazı sınırlı programlama kapasiteleri vardır: özelleştirilebilir değerler (parametreler denilir); hesaplama ve dallar (ayrıştırıcı işlevler kullanımı); ve vikiye özgü değişkenlere erişim (sihirli kelimeler), tarihler, saatler ve sayfa adları gibi. Bunlar, şablon kopyalandığında veya değiştirildiğinde, vikimetinde hangi bölümlerinin dahil edileceğini tanımlayan etiketler içerebilir. Bu, şablon sayfasının kendisinin, kopyalanan içeriğin görünümüyle aynı olması gerekmediği anlamına gelir (örneğin, şablon için belgeler, kategoriler vb. içerebilir).
Nasıl yapılır: Bir şablonu bir madde veya sayfaya yansıtmak için vikimetin şablonun görüneceği yere{{Şablon adı}} yazın. İlk harf kayıtsızca küçük veya büyük harf olabilir.
Şablon adından önceŞablon: öneki varsayılan addır ve dahil edilmesi gerekmez. Ancak, diğer ad alanlarında saklanan şablonlar içinKullanıcı: gibi bir önek belirtilmelidir. Ana sayfadaki bir sayfayı yansıtmak için, başlığından önce{{:Sayfa adı}} yapın.
Not: Mevcut olmayan bir şablonu yansımaya çalışmak, tıpkı varolmayan başka bir sayfaya bağlantı vermek gibi birkırmızı bağlantı üretir. Bağlantıyı takip etmek, o şablonu özel olarak oluşturmanızı sağlar. Başka bir dil projesinde şablon kullanmak için, projeler arasında (farklı dilde Vikipedi veya MediaWiki gibi) sayfalar arasında geçiş yapmak mümkün değildir, o projede şablonun bir kopyası oluşturulmalıdır.
Yukarıda verilen temel transkripsiyon sözdizimi, şablonun çıkışını kontrol etmek için kullanılanparametreleri ekleyerek genişletilebilir. Bunun sözdizimiŞablon:Tdüz,Şablon adı şablonun adıdır ve herparametre yalnızca bir değer içerebilir (bunlaraadsız parametreler denir) veya{{var etiketi|isim} =değer biçiminde olabilir. Birinci, ikinci, üçüncü vb. adsız parametrelere1,2,3 vb. adlar verilir.
Boşluk karakterleri (boşluklar, sekmeler, döndürmeler) parametre adlarının ve değerlerinin başlangıcından ve sonlarından çıkarılır, ancak ortadan kaldırılmaz: bu sayede{{ ... | parametrem = bu bir testtir }},{{...|parametrem=bu bir testtir}} ile aynı etkiye sahiptir. Bu, tüm boşluk karakterlerinin korunduğuisimsiz parametreler için geçerli değildir.
Hangi parametrelerin (varsa) bir şablona geçirilebileceği veya iletilmesi gerektiği ve bunların nasıl adlandırılacağı, söz konusu şablonun kodlamasına bağlıdır. Adlandırılmış parametreler herhangi bir sırayla tanımlanabilir. Gereksiz veya yanlış adlandırılmış parametreler yok sayılır; belirsiz parametrelerine varsayılan değerler atanır. Bir parametre birden fazla tanımlanırsa, son değer geçerli olur.
Bir parametrenin değeri, boru veya eşittir işaretinin hemen bir sonraki boru veya kapanma parantezleri tarafından takip edilmesi gibi boş bir dize olabilir. Her iki durumda da şablonlar aynı şekilde davranacak şekilde kodlanmış olmasına rağmen, bu, parametreyi tamamen atlamaktan farklıdır, bu da onu tanımsız bırakır.
Şablonun kodunda gösterilmese bile parametreler belirtilebilir (ve hiçbir şey yapmaz). Örneğin,|neden= sık sık Vikikaynak'ta şablonun neden yerleştirildiğini kısaca açıklamak için sözde parametre olarak kullanılır. Bazı şablonlar, şablonun kodunda hesaba katılmayan bir parametre kullanılıyorsa editörü uyarmak içinModül:Tanımlanmayan parametre denetimi çağırır; bu çoğunluklabilgi kutuları ve bilinmeyen bir tanesinin varlığının genellikle istem dışı bir hata olduğu çok sayıda karmaşık parametreye sahip diğer şablonlar için kullanılır. Böyle bir şablonu yeni bir parametre içerecek şekilde güncellerseniz, modülün çağrısı da yeni parametreyi içerecek şekilde güncellenmelidir.
Bir şablonu çağırmak, bir programlama dilindedeğişken veya işlev çağırmaktan farklı değildir: bir kaynakla çağırın ve bir değer döndürür (çıkış). İşlevler gibi, bazı şablonlar da çıktıyı değiştiren parametreleri kabul eder.
Vikipedi'nin kullandığıviki yazılımıMediaWiki'dedeğişkenler onları şablonlardan ayıran daha belirgin bir anlama sahiptir, ancak her ikisi de çift parantez{{}} ve her ikisi de bir değer döndürüyor.
MediaWiki değişken adları büyük harfle yazılırken, şablon adları tüm sayfa adlarıyla aynı temel özelliklere ve sınırlamalara sahiptir: büyük/küçük harfe duyarlıdır (ilk karakter hariç); alt çizgiler boşluk olarakayrıştırılır; ve şu karakterlerden hiçbirini içeremezler:# < > [ ] | { }. Bunun nedeni, viki işaretlemesi veHTML için ayrılmıştır.
# sayı işaretine, bir parçanın bir parçasını veya bir bölümünü (Vikipedi maddesindeki bir bölüm gibi) gösterdiği için bir parça tanımlayıcısı denir. Bir şablon sayfasının bir bölümüne bağlanmak için kullanılabilse de, bir şablon kaynağına bir parça tanımlayıcı veya parça adı koymak için bir neden yoktur.
| Yardım sayfalar | Kılavuz sayfalar | Özel sayfalar | Doğrudan görüntüleme olmayan diğer sayfalar |
|---|
| | | |
