Help:Templates/tr

Birkaç sayfaya eklemek istediğiniz standart metinleriniz varsa, MediaWiki şablon özelliği devreye girer. Uzantılardan ve medya dosyalarından farklı olarak, şablonlar için merkezi bir depo yoktur. Şablonlar yeni yazılabilir veya daha önce yapılmış, başka bir vikiden dışa aktarılan çoğaltma çalışmasını kaydetmek için; Wikipedia ve ardından hedef vikiye aktarılır.

Oluşturma
Şablonlar, içeriği diğer sayfaların içinde çapraz dahil (gömülü) olacak şekilde tasarlanmış standart viki sayfalarıdır. Şablonlar, adı " " ile ön ekli olduğu bir kuralı izleyerek ad alanı; bunun dışında başka bir viki sayfası gibi onları oluşturabilirsin.

Şablonların en basit kullanımı aşağıdaki gibidir. İçeriği olan "Şablon:Hoş geldiniz" adlı bir sayfa oluşturursanız:

Merhaba! Vikiye hoş geldiniz.

ilk şablonunuzu oluşturdunuz! Daha sonra kodu girerseniz:

Başka bir sayfada, o sayfa görüntülendiğinde "Merhaba! Vikiye hoş geldiniz." şablon içeriği diğer sayfaya "çevrilir", yani sayfaya entegre edilir.

Ardından, birisini kabul etmek istediğiniz herhangi bir sayfanın herhangi bir yerine  adresini ekleyebilirsiniz. 100 sayfada kullanıldığını varsayalım. Şablon içeriğini daha sonra değiştirirseniz:

Merhaba! Bu harika vikiye hoş geldiniz.

ve şablonun kullanıldığı 100 sayfadan herhangi birini tekrar ziyaret ederseniz, orijinal metin yerine yeni metni görürsünüz. Bu şekilde, 100 sayfanın içeriğini düzenlemeden değiştirdiniz, çünkü şablon bu sayfalara çevrilmiş.

Bu temel mekanizmadır. Bu mekanizmayı zenginleştiren ve şablonları çok kullanışlı kılan birkaç ek çeviri özelliği vardır.

Kullanım
Şablonlar diğer sayfalarda şu şekillerde kullanılabilir:


 * — yukarıda açıklandığı gibi, bu bağlantı, şablon bağlantısı olan sayfanın yüklü olduğu zaman, Şablon:Adı 'nı geçerli içeriği ile dinamik olarak değiştirilecektir. Bağlantı, sayfanın kaynağında değişmeden kalacaktır.
 * — bu şablon bağlantısı kullanıldığında, bağlantıya sahip sayfanın kaydedildi tarihinden itibaren bir kez ve herkes için Şablon:Ad içeriğiyle değiştirilecektir: Şablon:Ad 'ın içeriğinin bir kopyası, şablon bağlantısı için' 'değiştirilecek' 'olacaktır. İçerik daha sonra dahil edilen sayfanın bir parçasıdır ve orijinalden ayrı olarak normal şekilde düzenlenebilir. Not: kaynak şablon sayfasındaki daha sonra yapılacak değişiklikler, şablon bağlantısının bulunduğu sayfaya yayılmaz.
 * — bu, transkripsiyonu bozmayan sübstitüsyona izin vermek için tanıtıldı, en:Help:Substitution sayfasına bakın.
 * şablonu, onu içeren sayfa getirildiğinde ham viki sözdizimi ( gibi) olarak görüntüleyen bir forma ekler.

Aslında, sıradan bir viki sayfası, yalnızca içinde bulunduğu ad alanını belirterek, şablon olarak da kullanılabilir, bu nedenle:


 * ,  dahil eder
 * ,  dahil eder
 * ,  dahil eder
 * kendisini  içeriğiyle değiştirir

Böyle bir ad alanı yoksa, tam başlığın bir şablon olduğu varsayılır:


 * ,  dahil eder

Parametreler
Kopyalama mekanizmasını zenginleştirmek için MediaWiki, parametrelerin kalıp geçirildiğinde bir şablona geçirilmesine izin verir. Parametreler, şablonun farklı içerikler üretmesine veya farklı davranışlara sahip olmasına izin verir.

Diyelim ki diğer kullanıcıların tartışma sayfasına küçük bir teşekkür notu eklemek istediğinizi varsayalım:

Teşekkür notu bir neden (bu durumda, "bütün çabalarınız") ve bir imza ("Ben") olacaktır. Amacınız, herhangi bir kullanıcının herhangi bir nedenle başka bir kullanıcıya teşekkür edebilmesidir.

Notun kullanıldığı her yerde benzer görünmesi için, örneğin Template:Thankyou adlı bir şablon tanımlayabilirsiniz. Not, bir kullanıcı başka bir kullanıcıya teşekkür ettiğinde benzer görünmekle birlikte, içeriği (yani nedeni ve imzası) farklı olacaktır. Bu nedenle, bunları parametre olarak iletmelisiniz. Kutuyu biçimlendirmek ve görüntüyü yerleştirmek için kalan öğeleri yoksayarsak, şablonun temel içeriği şu olur:

ve  kullanıldığına dikkat edin. Şablonlar içinde, şablon kullanıldığında geçirilecek parametreleri tanımlamanın yolu budur. Şablon içinde, her parametrenin üç parantez içine alındığına dikkat edin:. Bu normal şablon adı kullanımından farklıdır.

Bir sayfada şablonu kullanırken, bir "dikey çizgi" karakteri ile ayrılmış parametre değerlerini doldurursunuz. MediaWiki, parametrelerin şablona üç şekilde iletilmesine izin verir: Anonim, Numaralı ve Adlandırılmış.

İsimsiz parametreler
Anonim parametreleri iletmek için, bu parametrelerin değerlerini sırayla listeleyin:

Bu durumda,  şablonu parametreleri   ve   alır, şunu üreten:

Anonim parametrelerin aktarılma sırası davranışı için çok önemlidir. Parametrelerin sırasını tersine çevirmek, şöyle:

bu sonucu üretir:

Numaralı parametreler
Parametreleri sayıya göre geçirmek için, her parametreyi geçerken tanımlayın:

Bu sefer,  şablonu   ve   parametreleri alır, ancak ters sırada sağlandıklarından ve ürettiklerinden:

Adlandırılan parametreler
Parametreleri iletmenin üçüncü yolu sayılar yerine ada göre yapılır. Bu durumda, şablon içeriği şu şekilde değiştirilir:

Biraz teşekkür ederim... için. sarılır,

Şablon içinde, her parametreyi bir sayı yerine tanımlamak için  ve   kullanırız. Bu parametreleri ada göre geçirmek için, geçerken her parametreyi tanımlayın:

Bu durumda,  şablonu   parametreleri alır ve   şunu üretir:

Adlandırılmış parametreler büyük / küçük harfe duyarlıdır, bu nedenle:

şunu üretir:

Şablonunuzda adlandırılmış parametreleri kullanmanın avantajı, sıra parametrelerinde geçirilebilen esnekliğin yanı sıra, çok sayıda parametre olup olmadığını anlamak için şablon kodunu daha kolay hale getirmesidir.

Varsayılan değerler
Parametreleri bekleyen ancak bağımsız değişkenlerini bu şekilde sağlamayan bir şablonu aşarsanız:

yukarıdaki numaralandırılmış parametreler örneğinde aşağıdakileri elde edersiniz:

Hiçbir argüman iletilmediğinden, şablon parametreleri kendi değerleri yerine kendileri sunar. Bu durumlarda, parametreler için varsayılan değerlerin, yani herhangi bir değer geçirilmezse kullanılacak değerlerin tanımlanması yararlı olabilir. Örneğin, şablon içeriği şu şekilde değiştirilirse:

sonra,   parametresi için bağımsız değişken sağlanmadıysa,   değeri kullanılır. Benzer şekilde,   değerini varsayılan   parametresiyle değiştirir. Şimdi, herhangi bir argüman iletmeden şablonu tekrar transkript etmek aşağıdakileri sağlar:

Değerlendirme sırası
Birkaç istisna ile şablon parametreleri şablona aktarılmadan önce tam olarak değerlendirilir. Parametrelerinizden biri başka bir şablona çağrı ise, aslında geçirilen genişletilmiş parametredir.

şunu olur: olmadan önce:

Birkaç durumda, bu değerlendirme sırası bir fark yaratır alternatif. (Alternatif sonuçları kontrol etmek ek şablon olup olmadığını görmek için şablon çağrısının genişletmiştir.)

İlk olarak, şablonun adı aynı anda genişletilebilir ve parametrelerle aynı şekilde.

Bu sayede might expand to Böylece  adlı bir şablon teşekkür ettiğinizi tercih ettiğiniz dilde görüntüleyebilir (ancak bu belirlenmiştir.)

İkinci olarak, çağrılan şablon daha sonra çağrılacak parçalardan bir şablon oluşturamaz. Çağrı başlangıcı ve ise biçimini alan bir şablon çalışmaz.
 * =Ben}}

Üçüncüsü, iletilen parametre, yalnızca bir kez değil, bir kez genişletilir. parametrenin şablonda kullanıldığı her yer. Bu daha fazla mediawiki sunucusunda verimli.

Son olarak, çağrılan şablon parametrenin tamamen genişletilmesini durduramaz. Bir şablon yalnızca bazılarında parametre kullanıyor olsa bile bu durumda, arama yapılmadan önce her zaman genişletilecektir.

Değerlendirme sırasına ilişkin istisnalar
Birkaç durumda, şablon parametreleri şablona aktarılmadan önce değerlendirilmez.

Bir  genişlemesine ilişkin parametreler değerlendirilmez, ancak kelimenin tam anlamıyla iletilir.

Bazı sihirli kelimeler parametre olarak değerlendirilmez. Değerlendirmeleri ertelendi çünkü yan etkileri var. Örneğin:, şunu olmaz:


 * 1)   değerlendirin
 * 2) sayfanın görünen başlığını değiştirin ve
 * 3) parametre 1 boşken   çağırın

bunu yerine


 * 1)   henüz değerlendirilmeyecek (henüz)
 * , parametre 1 olacak şekilde çağrılır
 * 1) yalnızca     olarak değerlendirilirse sayfanın görünen başlığı değiştirilir.

Hangi sihirli kelimelerin bu şekilde geç değerlendirildiği tam olarak belgelenmemiştir. Bilinenlere aşağıdakiler dahildir:

Şablonlarda özyineleme
Kendi başına bir şablon eklemek MediaWiki'yi sonsuz özyinelemeye atmaz. MediaWiki şablonun adı kalın yazıyla özyinelemeyi durduracaktır. Örneğin, "Şablon:Aaaa" içeriği " " ise, "Template:Aaaa" olarak gösterilir ve Şablon döngüsü algılandı: Şablon:Aaaa görüntülenir.

Kontrol şablonu dahil etme
Varsayılan olarak, hem doğrudan görüntülendiğinde hem de başka bir sayfaya dahil edildiğinde bir şablonun içeriği bütünüyle görüntülenir. Ancak,,   ve   etiketlerini kullanarak bir şablonun hangi bölümlerinin görüneceğini ve içerileceğini kontrol edebilirsiniz.

ile  arasındaki herhangi bir şey yalnızca şablonun sayfası doğrudan görüntülendiğinde görülür, ancak başka bir sayfaya eklendiğinde görülmez. Bu, şablonu içeren herhangi bir sayfaya yaymak istemediğiniz bir şablona metin veya kod eklemek istediğinizde yararlıdır:


 * Kategori, şablonun kendisini kategorilere ayırırken bağlanır
 * Diller arası bağlantılar diğer dillerde benzer şablonlara
 * Şablonun nasıl kullanılacağı hakkında açıklayıcı metin

Benzer şekilde,  ile   arasındaki herhangi bir şey işlenir ve yalnızca sayfa eklenirken görüntülenir, ancak şablon sayfası doğrudan görüntülendiğinde gösterilmez ve aşağıdaki gibi durumlarda yararlıdır:


 * Kategori şablonu içeren sayfalar. Not: bir şablon tarafından bu şekilde uygulanan kategoriler değiştirilirken, bu şablonu içeren sayfaların kategorisi bir süre sonraya kadar güncellenmeyebilir: bu, tarafından işlenir. Belirli bir sayfanın yeniden kategorize edilmesini zorlamak için, o sayfayı düzenlemek üzere açın ve değişiklik yapmadan kaydedin.
 * Şablon sayfasını görüntülerken şablon kodunun yürütülmemesini sağlamaktır. Genellikle bunun nedeni parametreleri beklemesidir ve parametresiz yürütülmesinin istenmeyen bir sonucu vardır.

ve  dışındaki her şey normal şekilde işlenir ve görüntülenir; yani hem şablon sayfası doğrudan görüntülendiğinde hem de şablon başka bir sayfaya dahil edildiğinde. Odak bu iki etiketin içinde var.

etiketlerinin dışındaki her şey ekleme işleminde atılır. Dahil olarak etiketlenmiş bölümler bile yalnızca içerme olarak etiketlenmedikleri sürece ekleme işleminde atılır. Odak bu etiketin dışında olan şeydir.

Bu etiketlerin iç içe yerleştirilmesi de mümkündür.

Üç kısmi ekleme etiketi, işlenen ve oluşturulan öğelerin tüm olası kombinasyonlarını etkinleştirir. Yorumlar da bir rolü doldurur.

Şablonları düzenleme
Şablonların etkili olabilmesi için kullanıcıların bunları bulmaları ve nasıl kullanacaklarını öğrenmeleri gerekir.

Bunları bulmak için kullanıcılar şunları yapabilir:
 * 1) ' tıklayın > '
 * 2) ' listesinde, Şablon seçin ve ' tıklayın.

Kullanım bilgileri vermek için şablon sayfasına bunun gibi bir örnek ekleyin:

Kullanım
Hoşgeldiniz kullanıcıları:

Ardından, bir düzenleyici şablonu kullanmak için örneği kopyalayıp yapıştırabilir.

Bir şablona bağlantı verme
Bir şablon sayfası diğer wiki sayfalarına benzer şekilde bağlanabilir. Örneğin, bağlantısı vikikod   kullanılarak oluşturulur.

Birçok vikide, Şablon:Tl, şablonu gerçekten transkripsiyon yapmadan transkript etmek için gerekli olan "çift kıvırcık kaşlı ayraçlar" vikikodunu gösterecek şekilde biçimlendirilmiş bir şablona bağlantı sağlamak için kullanılabilir. Örneğin, Navbar bağlantısını oluşturmak için  kodu kullanılabilir.

Bu yapı, şablon belgelerinde, yardım sayfalarında ve şablonlara atıfta bulunurken konuşma sayfalarında yaygın olarak kullanılır. Aynı etki,, ancak tl yaklaşım çok daha az yazmayı içerir. Herhangi bir vikide, varsa Tl şablonu metni burada gösterildiği gibi bir "kod" öğesinde oluşturabilir veya oluşturmayabilir. Değilse, benzer şekilde adlandırılmış başka bir şablon bunu yapabilir. Örneğin, Türkçe Vikipedi'deki tr:Şablon:Şb belgelerinin "Ayrıca bakınız" bölümüne bakın.

Bir vikiden diğerine kopyalama
Şablonlar genellikle CSS veya başka şablonlar gerektirir; Aşağıdaki adımlar çoğu şablon için geçerli olmalıdır.

MediaWiki kodu
Yeni vikide içe aktarma haklarınız varsa (Özellikle içe aktarma):


 * 1) Orijinal vikide Special:Export gidin ve aşağıdaki tüm gerekli şablonların geçmişini içeren bir .xml dosyası indirin:
 * 2) * Büyük metin kutusuna şablonun adını girin, ör. "Şablon:Hoşgeldiniz". Büyük/küçük harflere ve özel karakterlere özellikle dikkat edin - şablon adı tam olarak doğru değilse, dışa aktarma yine de gerçekleşebilir, ancak .xml dosyası beklenen verilere sahip olmaz.
 * 3) * Check the box "".
 * 4) * Uncheck the box "".
 * 5) * Click "".
 * 6) Go to Special:Import on the new wiki and upload the .xml file.

If you don't have import rights on the new wiki:


 * 1) Go to the template you want to copy from the original wiki. Go to the edit page, and copy all the wikitext
 * 2) On the new wiki, go to the page with the same name as the template you copied. Hit create/edit and paste the wikitext you copied. In the edit summary of each template, link to the original page for attribution.
 * 3) Back in the original wiki at the edit window, below the edit box, look at the list of "Templates used on this page". For each template listed follow these instructions. Also do that for any template used by any of these templates, and so on.

This will copy the entire code necessary, and will suffice for some templates. If it doesn't work also check for red links listed under "Pages transcluded onto the current version of this page:", below the edit box. If there are any repeat the above steps for these as well.

After successfully importing the template and all its linked templates from the other wiki, edit it to change customisations to suit your wiki. For example to change a logo, remove redundant categories or red links.

Eklentiler
An extension often used in templates is ParserFunctions. Visit page and check if any of the functions listed there are used in the templates you've copied. If so, you have to install the extension. To install it, you'll need system admin access to the server of your MediaWiki installation.

Another dependency that may be used in templates, especially those on Wikipedia, is Lua. Having  in template code is a good sign for it. In case it's used, you need to install the extension and system admin access is required too. See that page for more instructions about installing and using the extension.

CSS ve JavaScript kodu
Besides MediaWiki code, many templates make use of CSS and some rely on JavaScript to work fully. If the copied templates are not behaving as expected, this may be the cause. To copy the required CSS and JavaScript to your wiki you'll normally need to have admin privileges, because you'll be editing system messages in the "MediaWiki:" namespace.


 * 1) Look for the use of CSS classes (text like  ) in the template text. If those classes appear in "MediaWiki:Common.css" or "MediaWiki:Monobook.css" on the original wiki, copy those classes to "MediaWiki:Common.css" on the new wiki and check if the template is now fine.
 * 2) If the copied template is still not working as expected, check if there is code in "MediaWiki:Common.js" or "MediaWiki:Monobook.js" on the original wiki. If so, you can try copying it to "MediaWiki:Common.js" on the new wiki. Normally, it is a good idea to only copy code from trusted sources, and first browsing the code to identify and select the parts that are relevant. You may find comments that can serve as clues to identify the functionality of each part.

Ayrıca bakınız

 * – a template special use case example
 * – fancy stuff you may find in some templates
 * - additional fancy control functions such as #if and #switch
 * - guidance on using parser functions in templates
 * m:Help:Template – contains a much more thorough manual on how exactly templates function
 * m:Help:Advanced templates – describes even more advanced techniques such as dynamic template calls and variable parameter names
 * m:Help:Embed page – embedding pages from namespaces other than.
 * A solution to the lack of template bundling has been proposed at Community Wishlist Survey 2019/Miscellaneous/Shared Multilingual Templates and Modules available to all wikis, please support it.
 * A solution to the lack of template bundling has been proposed at Community Wishlist Survey 2019/Miscellaneous/Shared Multilingual Templates and Modules available to all wikis, please support it.
 * A solution to the lack of template bundling has been proposed at Community Wishlist Survey 2019/Miscellaneous/Shared Multilingual Templates and Modules available to all wikis, please support it.
 * A solution to the lack of template bundling has been proposed at Community Wishlist Survey 2019/Miscellaneous/Shared Multilingual Templates and Modules available to all wikis, please support it.
 * A solution to the lack of template bundling has been proposed at Community Wishlist Survey 2019/Miscellaneous/Shared Multilingual Templates and Modules available to all wikis, please support it.