Yardım:Şablon

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öntemi yansıtmadır; bu şekilde hedef sayfanın vikimetnine {{Ş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'dan mw:Help:Şablonlar, m:Help:Şablon ve m: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:

Ş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 sayfalar tartışma sayfaları ile ilişkilendirilmiştir.

Şablonlar, diğer şablonlara yapılan çağrılar da dahil olmak üzere istenen vikimetin 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çin Kullanı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 bir kı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ılan parametreleri ekleyerek genişletilebilir. Bunun sözdizimi
Şablon:Tdüz,
Şablon adı şablonun adıdır ve her parametre yalnızca bir değer içerebilir (bunlara adsız parametreler denir) veya {{var etiketi|isim} =değer biçiminde olabilir. Birinci, ikinci, üçüncü vb. adsız parametrelere 1, 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ğu isimsiz 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çin Modül:Tanımlanmayan parametre denetimi çağırır; bu çoğunlukla bilgi 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 dilinde değ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'de değ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 olarak ayrıştırılır; ve şu karakterlerden hiçbirini içeremezler: # < > [ ] | { }. Bunun nedeni, viki işaretlemesi ve HTML 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.