Şablon:Mikutu/belge

[bullvar_katip]

İşbu ([m]adde leti [kutu]su) üst şablonu, gibi maddelere yönelik ileti kutuları oluşturmak için kullanılmaktadır. Kutuları isteğe bağlı olarak biçimlendirmek ve farklı görünümler kazandırmak için gerekli işlevler şablona tanımlı olarak bulunmaktadır. Sık kullanılan parametreler Aşağıda bu şablonun en sık kullanılan parametreleri verilmiş olup her birinin işlevi ilgili alt başlıklarda açıklanmıştır. ad Bu parametre sayfanın ad alanını belirtmeden yalnızca şablon adını vermek için kullanılmaktadır. örneğinde şablon şeklinde kullanılmalıdır. Eğer şablon taşındıysa parametreye girilen ad da taşınan ada göre güncellenmelidir. Bu parametre iki amaç için kullanılmaktadır: Eğer hatalı yerleştirilmişse, üst şablonun değiştirilen şablonun adını bildirmesini sağlar ve bu bilgi yazarların sorunu çözmesine yardımcı olur. Belirtilmediyse bile eklenme tarihini göstermek ya da şablon kategorisini otomatik olarak eklemek gibi şablonun sayfa adından daha yararlı bilgilerin görüntülenmesini sağlar. yk Açılımı [y]erine [k]oyma olan bu parametre şablon içeriğinin kullanılan sayfaya doğru şekilde kopyalanarak aktarılıp aktarılmadığının tespitini yapar ve eğer hatalı işlem yapılmışsa uyarı iletisi görüntülenmesini sağlar. Hatalı işlem yapıldığında ilgili sayfa otomatik olarak hatalı yerine koyma işlemi yapılan şablon içeren sayfalar kategorisine eklenir. Parametreyi yukarıda örnek verildiği şekilde kullanmak yeterlidir. küçük Bu parametre ileti kutusunun çok daha küçük boyutta ve sayfanın sol tarafına hizalanmış şekilde görüntülenmesini sağlamaktadır. Bunun için parametreye değeri girilmelidir. Parametre yalnızca İngilizce kelimelere duyarlıdır, Türkçe değer girilmemelidir. Aksi takdirde normal boyutta görüntülenecektir: Diğer kullanımlar: Eğer ileti kutusunun hiçbir zaman küçük boyutta görüntülenmemesi gerekiyorsa şeklinde komut verilebilir ya da bu parametre hiç kullanılmayabilir. Eğer ileti kutusunun her zaman küçük boyutta görüntülenmesi gerekiyorsa şeklinde komut verilebilir. Eğer ileti kutusunun varsayılan olarak küçük boyutta görüntülenmesi gerekiyorsa şeklinde komut verilebilir. Bu durumda şablon hiçbir parametre belirtilmediği takdirde küçük boyutta görüntülense de isteğe bağlı olarak komutu verildiğinde normal boyutlarda görüntülenmesi sağlanabilir. Maddelerin yalnızca bir alt başlığına yönelik oluşturulan şablonlarda parametresinin nasıl kullanılması gerektiğine yönelik bilgi için kısmını okuyun. tür Bu parametre kutunun solundaki çubuğun rengini ve varsayılan resmi değiştirmek için kullanılmaktadır. Kutuya içeriğin ilgili konuya göre kategorize edilmesi amacıyla yedi farklı görünüm tanımlanmıştır: Eğer bu parametreye hiçbir bilgi girilmezse varsayılan olarak değeri sağlanacaktır. resim Bu parametre kullanılarak belirli bir resim kutunun solunda görüntülenmesi için ayarlanabilir: Örneğin şablonuna şeklinde resim tanımlı olup şu şekilde görüntülenmektedir: Bir başka örnek olarak şablonuna şeklinde resim tanımlı olup şu şekilde görüntülenmektedir: resim parametresi kullanılırken şunlar da göz önünde bulundurulmalıdır: Eğer bir resim girilmezse belirtilen türün varsayılan resmi kullanılır. Eğer şeklinde kullanılırsa türün varsayılan resmi de dâhil olmak üzere hiçbir resim görüntülenmez ve metin kutunun tamamını kaplar. Yalnızca kamu malı resimler şablonlarda kullanılmalıdır. Eklenen resme parametreleri ile değer girerek imleç ile üzerinde beklendiğinde açıklama görüntülenmesi, tıklandığındaysa belirli bir maddeye gitmesi sağlanabilir ve böylece erişilebilirlik artırılabilir. altbaşlık Çoğu madde iletisi şablonu Bu madde... girizgâhını kullansa da alt başlıklar için oluşturulan ileti şablonlarının Bu alt başlık... şeklinde başlaması arzu edilir. Bunun istendiği durumlarda bu parametreye girilen değer "madde" kelimesinin yerine kullanılacaktır. , , gibi farklı madde türlerine yönelik kullanılabilir. Parametrenin en bilindik ve işlevsel kullanımı şeklindedir. Böylece yazarlara "madde" kelimesini değiştirmek için ilk adsız parametre olarak bir belirtme seçeneği sunulacaktır. Örneğin şu şekilde görünür: Bir diğer yöntem de </nowiki>}} şeklinde farklı bir değer tanımlamaktır. Böylece şablona özel olarak şeklinde kullanılabilecek farklı bir parametre oluşturulabilir. gerektiğinde kullanılması şiddetle önerilir. Kullanıma hazır şu örnek: } }}</nowiki></code>}} aşağıdakilere olanak sağlar: şablonunun tespit edeceği , vb. herhangi bir olumlu değer "madde" yerine "altbaşlık" metnini görüntüleyecek. İsteğe bağlı olsa da ve parametrelerinin her ikisini de tanımlamak yazarların hangi parametrenin işe yaradığını düşünmesini gerektirmeyeceğinden kolaylık sağlaması açısından kullanılması önerilir. Yukarıdaki örnek kod olduğu gibi kullanılarak başka hiçbir işlem yapılmadan bu sağlanabilir. Girilecek olan herhangi bir değer "madde" kelimesi yerine geçecektir: , , , gibi. parametresi ile oluşturulan küçük boyutlu ileti şablonunun diğer benzer şablonlarla karışmaması için maddenin en üstünde değil de ilgili alt başlıkta görüntülenecek şekilde ayarlanması gerekli olup aşağıdaki şekilde bu sağlanabilir: }}</nowiki></code>}} Bu kullanım şeklinde ya da parametresinin yanı sıra parametresine de bilgi girildiği takdirde şablonun küçük sürüme geçmesi için ayarlama yapılmıştır. sorun ve çözüm sorun parametresi maddedeki sorunu tanımlamak için kullanılır. Sorun kısaca, en basit şekilde açıklanmalı (yaklaşık 10-20 kelime) ve ilgili bir politikaya ya da yönergeye bağlantı verilmelidir. çözüm parametresi, maddeyi geliştirmek için ne yapılması gerektiğini açıklayan metni içerir. Buraya girilecek olan bilgi sorun parametresine yazılan metinden daha uzun olabilir ancak yine de en fazla iki cümle olması önerilmektedir. Şablon toplu hâldeyken ( içerisine yerleştirildiğinde) ya da küçük hâlde ( şeklinde kullanıldığında) yalnızca sorun parametresine girilen metin görüntülenir. Örneğin şablonuna ilgili parametreler şu şekilde tanımlanmıştır: ve tek başına kullanıldığında her iki metin de görüntülenir: Ancak içerisinde ya da ile kullanıldığında yalnızca sorun görüntülenir: tartışma Bazı madde ileti şablonları, tartışma sayfasına bağlantı içerir ve doğrudan ilgili alt başlığa erişmek için de alt başlık adı vermeye olanarak sağlar. şeklinde bu kolaylık sağlanabilir. Bu tanımlama yapıldığında parametre daha sonra aşağıdaki gibi farklı usullerle kullanılabilir: – Eğer tartışma sayfası şablonun eklendiği maddenin tartışma sayfasıyla yalnızca şeklinde kullanılabilir. – Eğer tartışma sayfası şablonun eklendiği maddenin değil de farklı bir maddenin tartışma sayfasıysa şeklinde sayfanın ve alt başlığın tamamı kullanılmalıdır. Alt başlıkların bağlantı mantığına dair ayrıntılı bilgi için bölüm bağlantısı kılavuzu okunabilir. Notlar: Bu parametre bir şablon tarafından kullanıldığında tartışma sayfası bağlantısı şablonda görünecektir. Tartışma sayfasına bağlantı gittiğinden emin olmak için kullanımı önerilir. Bağlantı verilen tartışma sayfası henüz oluşturulmamışsa görüntülenmez. tarih Bu parametre kullanılarak şablonun maddeye ne zaman eklendiğine dair bilgi verilebilir. Girilen bilgi asıl metinden daha küçük boyutta görüntülenecektir. bilgi Bu parametre ek bilgi girmek içindir. Buraya ne eklenirse eklensin tarihten sonra gelecek ve şablon içine alınmışsa görüntülenmeyecektir. kaldırmailetisi Eğer şeklinde komut verilirse ve içine alınmamışsa tarih ile bilgi parametrelerine girilen bilgileri takiben şablonda aşağıdaki metin görüntülenecektir: kat Şablona bu parametre vasıtasıyla izleme ya da temizlik kategorileri tanımlanabilir. şeklinde kullanıldığında: Eğer belirtilmişse şablonun eklendiği madde Kategori:TARİHİNDEN beri KATEGORİ kategorilerinde dizinlenir. Eğer tarih belirtilmemişse yalnızca Kategori:KATEGORİ şeklinde belirtilen kategoride dizinlenir. Örneğin şablonuna kategorisi tanımlanmış olup şeklindeki kullanımda ilgili madde Haziran 2010 tarihinden beri kaynakları olmayan maddeler kategorisine otomatik olarak eklenir. Parametre kullanılırken bağlantı verilmemeli ve "Kategori:" ön eki kullanılmamalıdır. tümü Bu parametre şablonun eklendiği tüm maddelerin istisnasız olarak ekleneceği üst kategorileri belirtmek için kullanılır. Parametre kullanılırken bağlantı verilmemeli ve "Kategori:" ön eki kullanılmamalıdır. Diğer parametreler Aşağıdaki "Tüm parametreler" kutusunda bu şablona tanımlı parametrelerin tamamı listelenmiştir. Bununla birlikte içeriğin olduğu gibi kopyalanması önerilmemektedir zira hiçbir zaman bütün parametrelerin aynı anda kullanılması gerekmeyecektir. sağresim Bu parametre kullanılarak kutunun sağ tarafında da resim gösterilmesi sağlanabilir. Kullanım şekli resim parametresi ile tamamen aynıdır. küçükresim ve küçüksağresim Bu parametreler kullanılarak küçük boyutlu kutuların her iki yanında görüntülenmesi için ayrı resimler tanımlanabilir. Yalnızca komutu verildiğinde görüntülenirler. sınıf Kutuya uygulanacak olan özel CSS sınıfının adı. Birden fazla sınıf eklenecekse boşluk karakteri ile birbirlerinden ayrılmış olmaları gerekmektedir. biçim ve metinbiçimi İsteğe bağlı biçim değerleri. Tırnak işareti olmadan yalnızca noktalı virgül ile birbirlerinden ayrılarak belirtilmelidir. biçim, kutunun tamamını biçimlendirmek için kullanılır. metinbiçimi, yalnızca metin parametresine girilen yazı için kullanılır. metin ve küçükmetin Bilgi kutusuna sorun ve çözüm parametreleri ile ayrı ayrı bilgi girmek yerine yalnızca metin parametresini kullanmak da mümkündür. Eğer küçük boyutlu bir şablon hazırlanıyorsa aynı işlev için küçükmetin parametresi kullanılmalıdır. yalınbağ Vikipedi'de bir dış bağlantı verildiğinde varsayılan olarak örnek.com şeklinde görüntülenir. Buna karşın gibi bağlantının yanındaki ok simgesini gizlemek mümkündür. Eğer ileti kutusu dış bağlantı içeriyorsa ve ok simgesinin görünmesi istenmiyorsa komutu ile bu sağlanabilir. kat2, kat3, tümü2 ve tümü3 kat2 ve kat3 parametrelerinin kullanım amacı ve şekli kat parametresi ile tamamen aynıdır. tümü2 ve tümü3 parametrelerinin kullanım amacı ve şekli tümü parametresi ile tamamen aynıdır. Teknik detaylar Bu üst şablon MediaWiki:Common.css adresinde tanımlı olan ambox ("ambox" kelimesinin açılımı "article message box" olup "mikutu"nun İngilizcesidir) CSS sınıflarını kullanmaktadır. Özel işlevlerin kullanılması gerektiği takdirde sınıflar doğrudan vikitabloda kullanılabilir. metin parametresinde şablonun işleyişini bozan özel işaretlerin kullanılması gerektiği durumlarda aşağıdaki gibi HTML işaretlemesi kullanılmalıdır: </nowiki> ancak HTML koduyla kullanılabiliyor. Bir de ikisini art arda kullanalım tam olsun . }} Bu şablon parametrelerini modülünden çağırmaktadır. Yukarıdaki örnekteki metni çevreleyen etiketleri çoğunlukla gerekli değildir. Ancak, metin satır atlama içeriyorsa bazı durumlarda, özellikle de dikey noktalı listeler kullanılırken olmadık yerlerde satır atlanabilir. Bu sorunu düzeltmek için div etiketlerini kullanmak elzemdir. Şablon MediaWiki:Common.css'de tanımlı CSS sınıflarının çoğunu kullanır, bu nedenle tamamen biçimlendirilebilirdir. Şablon tablo oluştururken bazı dezavantajları olduğundan viki biçemini değil HTML biçimlendirmesini kullanmaktadır. Viki biçemini kullanmak, örneğin, ayrıştırıcı işlevler için gerekli bazı özel karakterlerin kullanılmasını zorlaştırmaktadır. Şablonun varsayılan resimleri SVG formatı yerine PNG formatındadır. Bunun temel nedeni, bazı eski tarayıcıların MediaWiki'nin SVG görüntüler için oluşturduğu saydam arka planları göstermede sorun yaşamasıdır. Daha fazla teknik detay için şablonun oluşturulduğu İngilizce Vikipedi'deki ve aşağıdaki "Ayrıca bakınız" kısmına göz atılabilir. Bu şablon , , ve ile tam olarak aynı şekilde çalıştığından o şablonların tartışma sayfalarında da daha fazla detay bulunabilir. Ayrıca bakınız