Şablon:Dikutu/belge

Bu sayfa, Dikutu şablonunun işleyişini açıklamak için hazırlanan belgeleme sayfasıdır. Doğrudan tek başına görüntülendiğinde bağlantıların kullandığı bazı değişkenler bozuk görüntülenebilir. Bu durum normal olup lütfen söz konusu değişkenler yerine sabit kodlanan sayfa adları veya URL'ler girmeyiniz.

İleti kutusu şablonları
şablon	bağlam
{{mikutu}}	madde
{{kikutu}}	kategori
{{dikutu}}	dosya
{{tikutu}}	tartışma
{{bikutu}}	başlık/altlık
{{sikutu}}	sair sayfalar
{{çikutu}}	otomatik tespit
{{mtkutu}}	taslak madde
{{aikutu}}	anlam ayrımı

İşbu {{dikutu}} ([d]osya [i]leti [kutu]su) üst şablonu, {{Commons'a taşımayın}} gibi dosyalara 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. Çalışma prensibi {{mikutu}} ile aynı olup parametreleri de ortaktır.

Kullanımı

En basit kullanım:

{{dikutu|metin=İleti metni.}}

İleti metni.

Detaylı kullanım:

{{dikutu
| tür = biçim
| biçim = width:400px;
| resim = [[Dosya:Emblem-question-yellow.svg|40pik]]
| metinbiçimi = font-style:italic; font-weight:bold; color:red; 
| metin = İleti metni.
}}

İleti metni.

Kutu türleri

Bu parametre kutunun çerçeve 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 dokuz farklı görünüm tanımlanmıştır:

tür=hızlı – Hızlı silme politikasında açıklanan durumlarda {{sil}} gibi şablonlar oluşturmak için.

tür=sil – Silme politikasında açıklanan diğer durumlarda {{silinmeye aday sayfa}} benzeri şablonlar oluşturmak için.

tür=içerik – {{adil kullanım kalitesini düşür}} gibi büyük hata ve sorunlara yönelik şablonlar oluşturmak için.

tür=biçim – {{açıklama yok}} gibi küçük hata ve sorunlara yönelik şablonlar oluşturmak için.

tür=bildirim – Her türlü geçici bildirimler ve iletiler için.

tür=taşıma – {{Commons'ta mevcut}} gibi taşımaya, bölmeye ya da birleştirmeye yönelik şablonlar oluşturmak için.

tür=koruma – {{koruma}} gibi değişiklik kısıtlamasına sahip dosyalara yönelik şablonlar oluşturmak için.

tür=seçkin – {{SR}} gibi dosyaların kalite durumlarına yönelik şablonlar oluşturmak için.

İsteğe bağlı resim

Yukarıdaki varsayılan resimler kolaylık sağlaması adına türlere tanımlanmıştır. Çoğu durumda konuyla daha ilgili resimlerin kullanılması daha uygundur. Bu durumda resim parametresi kullanılarak aşağıdaki gibi daha uygun resimler şablonda gösterilebilir:

tür = biçim
resim = [[Dosya:Gnome-dev-camera.svg|42pik]]
Bu resim {{resim temizle}} şablonunda kullanılır.

tür = taşıma
resim = [[Dosya:To Commons.svg|52pik]]
Bu resim {{Wikimedia Commons'a taşı}} şablonunda kullanılır.

Diğer kullanımlar

Tür ve resim belirtilmedi. (varsayılan)

Tür belirtilmedi ve resim=none komutu verildi – Hiçbir resim kullanılmaz ve metin tüm ileti kutusuna yayılır.

Parametreler

Tüm parametreler:

{{dikutu
| ad = şablonun adı
| tür = hızlı / sil / içerik / biçim / bildirim / taşıma / koruma / telif / seçkin
| resim = none / [[Dosya:DOSYAADI.svg|40pik]]
| sağresim = [[Dosya:DOSYAADI.svg|40pik]]
| biçim = CSS değerleri
| metinbiçimi = CSS değerleri
| metin = Ana ileti metni
| alt = Alt kısım için ek ileti metni
| yalınbağ = evet
}}

ad

(isteğe bağlı) Şablonun adı. Bu değer botlara ya da betiklere göre kullanılmak üzere HTML elemanına kutu-ad şeklinde bir CSS sınıfı ekler.

tür

Eğer tür parametresi boş bırakılırsa varsayılan olarak mavi arka plana sahip bildirim değeri girilecektir.

resim

Parametresiz = Eğer boş bırakılırsa tür parametresine girilen değere bağlı olarak o türün varsayılan resmi görüntülenecektir.

Herhangi bir resim = Viki biçemine uygun şekilde bir resim belirtildiğinde kutunun solunda görüntülenecektir.

Örneğin: resim = [[Dosya:Gnome-dev-camera.svg|40pik]]

none = Bu değer girildiğinde kutuda hiçbir resim görüntülenmez.

sağresim

Parametresiz = Eğer boş bırakılırsa kutunun sağ tarafında hiçbir resim görüntülenmez.

Herhangi bir resim = Viki biçemine uygun şekilde bir resim belirtildiğinde kutunun sağında görüntülenecektir.

Örneğin: sağresim = [[Dosya:Nuvola apps bookcase.png|40pik]]

biçim

İsteğe bağlı olarak kutunun tamamını biçimlendirmek için CSS değeri girilebilir. Tırnak işareti " " olmadan bilgi girilmelidir.

Örneğin: biçim= margin-bottom: 0.5em;

metinbiçimi

İsteğe bağlı olarak kutuya eklenen metni biçimlendirmek için CSS değeri girilebilir. Tırnak işareti " " olmadan bilgi girilmelidir.

Örneğin: biçim = text-align: center;

metin

İleti kutusunda görüntülenecek olan metin.

alt

Resimlerin ve metin alanının altındaki tam genişlikte ek metin alanı. Yalnızca metin ekleneceği gibi başka bir dikutu gibi yahut başka herhangi bir nesne de eklenebilir.

Örneğin: alt = {{dikutu|tür=içerik|metin='''Bu telif etiketi kullanımdan kaldırıldı!'''}}

yalınbağ

Vikipedi'de bir dış bağlantı verildiğinde varsayılan olarak örnek.com şeklinde görüntülenir. Buna karşın örnek.com 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 |yalınbağ=evet komutu ile bu sağlanabilir.

Teknik detaylar

• 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:

{{dikutu
| metin = <div>
Eşittir işareti = ve küme parantezleri { } görüldüğü üzere normal şekilde kullanılabiliyor.
Ancak dikey çubuk &#124; ve çift küme parantezi kapama işareti ancak HTML koduyla kullanılabiliyor <nowiki>}}</nowiki>.
Bir de ikisini art arda kullanalım tam olsun <nowiki>|}}</nowiki>.
</div>
}}

Eşittir işareti = ve küme parantezleri { } görüldüğü üzere normal şekilde kullanılabiliyor. Ancak dikey çubuk | ve çift küme parantezi kapama işareti }} ancak HTML koduyla kullanılabiliyor. Bir de ikisini art arda kullanalım tam olsun |}}.

• Bu şablon parametrelerini {{#invoke:ileti kutusu}} modülünden çağırmaktadır.
• Ş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 tartışma sayfasına ve aşağıdaki "Ayrıca bakınız" kısmına göz atılabilir.

Ayrıca bakınız

Omurgasını {{#invoke:ileti kutusu}} modülünün oluşturduğu yedi ileti kutusu şablonu:

• {{mikutu}}, maddeler için ileti kutuları.
• {{kikutu}}, kategoriler için ileti kutuları.
• {{dikutu}}, dosyalar (resim, elektronik kitap, video vb.) için ileti kutuları.
• {{çikutu}}, farklı ad alanlarındaki kullanıma göre özelleştirilebilen mesaj kutuları.
• {{tikutu}}, tartışma sayfaları için ileti kutuları.
• {{sikutu}}, diğer sayfalar için ileti kutuları.
• {{bikutu}}, üst ve alt bilgi ileti kutuları.

Benzer ileti kutuları:

• {{mtkutu}}, taslak maddeler için ileti kutuları.
• {{aikutu}}, anlam ayrımı ve dizinleme sayfaları için ileti kutuları.

Benzer ileti kutularıyla kullanılmak için tasarlanan alt şablonlar:

• {{sikutu/kısayol}}, ileti kutuları için oluşturulmuş {{kısayol}} alternatifi.