"Modül:Kategori/belge" sayfasını değiştirmektesiniz

{{#ifeq:{{PAGENAME}}|Kategori|{{Yüksek riskli|70,500+}}

{{şb|otomatik kategori}} şablonunu çalıştıran modüldür.

==Çalışma mantığı==
# Önce sayfa adını işleme sokuyoruz. Mesela '''2000 doğumlular'''.
# Bu sayfa adını parçalarına ayırıyoruz. Baştaki tüm sayıları '''yıl''' yerine sayıyoruz; çünkü en başta daima yıl olacağı biliniyor (şimdilik, eğer yılın başta olmadığı durumlar da bu modüle dahil edilirse buraya yeni argümanlar ekleyebiliriz). Yılın devamındaki tüm sözcükleri de sayfanın türü yani '''kategori adı''' olarak sayıyoruz. Bu durumda yılımız '''2000''', kategori adımız da '''doğumlular''' oluyor.
# Şimdi de bulduğumuz kategori adına göre işleme devam etmeliyiz. [[Modül:Kategori/veri]] sayfasında listelenen nesneler arasından '''doğumlular''' başlığını saptıyoruz. 2000 doğumlular veya 2000'lerde doğanlar gibi sayfaların ortak kategori nesnesi bu.
# En başta, nesnenin kategori değerine göre yukarıya bulunduğu yıldan 5 değer öncesi ve 5 değer sonrasına kadar mevcut bir '''gezinti çubuğu''' eklenir. Bu çubuğun alt satırında bir de '''ebeveyn çubuk''' bulunur. Bu da, mesela bir yıl kategorisindeysek şu anda olduğu gibi; '''2000 doğumlular''' bir yıl kategorisi. Bunun bir üstü onyıl kategorisidir. Yani '''2000'lerde doğanlar'''. Eğer mevcut kategorinin bir üstü yani onyıl kategorisi mevcutsa ebeveyn çubuk da, gezinti çubuğu ile birlikte görünür. Yoksa yalnızca gezinti çubuğu görünür. Ama biz zaten bir onyıl kategorisindeysek bu defa onyıllar ebeveyn çubuk değil, gezinti çubuğu olurlar. Çünkü her zaman bulunduğumuz kategorinin yıl tipi bizim asıl gezinti çubuğumuzdur. Bu durumda '''2000'lerde doğanlar''' kategorisinin ebeveyn çubuğu da yüzyıllar olur. Yani '''21. yüzyılda doğanlar'''. Gidebildiğimiz kadar üst rütbeye çıkabiliriz yani. Fakat görüntüleyebileceğimiz çubuk sayısı her sayfada iki adettir. Bir '''gezinti çubuğu''' ve bir de '''ebeveyn çubuk'''.
# Çubukların hemen altında açıklama yazıları mevcuttur. Nesnemizin bir açıklama yazısı var ise, onu gösteririz. Yoksa da boş görüntülenir.
# Açıklama yazısının yanında, sağ tarafa sabit bir '''Commons bağlantı''' şablonu da bulunabilir. Bu da şu şekilde çalışmakta, sayfa eğer bir vikiveri ögesine bağlıysa bu ögeyi çağırıyoruz. Daha sonra bu ögenin bir Commons değeri olup olmadığını kontrol ediyoruz. Varsa da şablonu ekliyoruz.
# Son olarak da yukarıda '''ebeveynler''' değerlerinde anlatıldığı şekilde, tüm ebeveynler, '''sıra anahtarları''' kullanılarak sayfaya eklenir. Yani kategori, eklenmesi gereken tüm üst kategorilere eklenir.

==Veri modülleri==
{{Özel:PrefixIndex/Modül:Kategori/veri}}

Eğer bir ana kategori genişlemiş ise bunun alt kategorisinin modülü ayrıca açılabilir.

===Liste===
Tüm veriler detaylıca buradan incelenebilir: {{şb|otomatik kategori/liste}}

}}{{#ifeq:{{#invoke:String|sub|{{kırp|{{PAGENAME}}}}|10|13}}|veri|
Bu modül, [[Modül:Kategori]] tarafından kullanılan bir veri modülüdür. Yeni bir kategori verisi eklemek için lütfen önce ana modülün belgelemesini okuyun. Daha sonra da aşağıda belirtilen nesnelerin yapısını anlayın.

<table class="wikitable">
<tr>
<th>Diğer veri modülleri</th><td>{{Özel:PrefixIndex/Modül:Kategori/veri|stripprefix=1}}</td>
</tr>
</table>

==Nesnelerin yapısı==
Bir nesnenin yapısı şu şekildedir (her nesnede aynı etiketler mevcut):
<pre>
k["doğanlar"] = {
	"doğumlular",
	ek = {"y", "d"},
	ebeveynler = {"başlangıçlar", "kişiler"},
	sira_anahtari = {"D", "D"},
	kademe = 4,
	aciklama = "{{{yılda}}} doğmuş olan insanlar",
	bak = {"ölenler"},
	gore = "doğum",
}
</pre>

===numaralı değerler===
'''1''', '''2''', '''3''' veya '''4''' numaralı değerler şu anlamda kullanılır; mesela genel olarak eserler kategorileri şu şekildedir:
* {{k|2012'de eserler}}
* {{k|2010'larda eserler}}
* {{k|21. yüzyılda eserler}}
* {{k|3. binyılda eserler}}

Görüleceği üzere tüm kademelerde (yıl, onyıl, yüzyıl ve binyıl) sonuna eklenen kısım aynı ve bu '''eserler'''. Ama bazu durumlarda bu adlar aynı olmayabilir. Yukarıdaki '''doğanlar''' nesnesinde '''1''' numaralı değer ''doğumlular'' olarak girilmiş, bunun sebebi şudur:
* {{k|2012 doğumlular}}
* {{k|2010'larda doğanlar}}
* {{k|21. yüzyılda doğanlar}}
* {{k|3. binyılda doğanlar}}

Birinci kademede (yıl değerinde) ''doğumlular'' yazılırken üst kademelerde ''doğanlar'' yazılır. Eğer bu durum şöyle olsaydı:
* 2012'de doğanlar
* 2010'lar doğumlular
* 21. yüzyılda doğanlar
* 3. binyılda doğanlar

Bu defa da nesnede şöyle bir giriş yapılması gerekirdi:
<pre>
k["doğanlar"] = {
	nil, "doğumlular"
}
</pre>
'''1''' numaralı değeri geçersiz kılacak "nil" değerini girmeliyiz ve ardından '''2''' numaralı değere de ikinci kademe kategorinin (onyıl) adında ''doğumlular'' eklendiği için bu değeri yazmalıyız. '''3''' ve '''4''' numaralı değerleri kullanmıyoruz, çünkü bir farklılık olmadığı sürece gerek yok.

===ek====
Bu değer bir nesne tipindeki yıl, onyıl, yüzyıl veya binyıl değerinden sonra "de, da" eklerinin eklenip eklenmeyeceğini saptamamıza yardım eder. Bu değerin tipi bir '''string''' de olabilir, '''table''' da. Yukarıda gördüğümüz örnekte bir tablo olarak eklenmiş. Bunun sebebi şu:
* {{k|2012 doğumlular}}
* {{k|2010'larda doğanlar}}
* {{k|21. yüzyılda doğanlar}}
* {{k|3. binyılda doğanlar}}

Bu listede yıl kademesinde ek yok, fakat üst kademelerde var. Bu sebeple şu şekilde tablo eklenmiş: <code>{"y", "d"}</code> Birinci "y" değeri, "yanlış" demek, yani ek eklenmemeli. İkinci "d" değeri ise "doğru" demek yani ek eklenmeli. Bunun sıralaması da şu şekildedir, bu tablo içerisine '''4''' numaraya kadar değer eklenebilir, her bir değer bir kademe (yıl, onyıl, yüzyıl veya binyıl) içindir. Birinci değer yıl kademesi içindir, ikinci değer onyıl kademesi içindir ve eğer devamında bir değer yoksa ikinci değerde olduğu gibi kullanılır.

Tabi hepsi birbiri ile tutarlı ise, yukarıdaki '''eserler''' örneğindeki gibi. Buraya tablo yerine <code>ek = "d",</code> şeklinde bir değer eklenir yalnızca. Bu da her kademede ek eklenmesi gerektiğini söyler.

'''NOT:''' Eğer 2012'deki afetler gibi bir kategoriye aitse nesne, herhangi bir ek değerini "d" veya "y" değil de "ki" yapmanız gerekmektedir.

===ebeveynler====
Kategorinin eklenmesi gereken üst kategorilerin tipine göre '''kategori adlarının''' listesini bize verir. Yukarıdaki durumda ilk ebeveynimiz '''başlangıçlar''' mesela. Bu demek oluyor ki, en başta sayfa adından ayırdığımız yıl değerini en başa ekleyip uygun ebeveyne eklememiz gerek. Yılımız 2000 idi. Yani ilk ebeveynimiz '''2000'de başlangıçlar''' olacak. Burada yılın ekinin eklenip eklenmeyeceğini de '''başlangıçlar''' nesnesine bakarak anlıyoruz:
<pre>
k["başlangıçlar"] = {
	ek = "d",
	ebeveynler = {"kategoriler"},
	sira_anahtari = {"B"},
	kademe = 4,
}
</pre>

İkinci ebeveynimiz de '''kişiler''', aynı işlem bu ebeveyne de yapılır.

Şimdi ise, bir üst kademe kategorisine geçmemiz gerek, bir üst kademe onyıl kategorisi olduğu için mevcut yılın bulunduğu onyılı saptıyoruz öncelikle, ki bu da 2000'ler, yani sonuç olarak da '''2000'lerde doğanlar''' ebeveynini elde ediyoruz. Her bir nesnenin bir üst seviyedeki kategorisi otomatik olarak saptanmaktadır. Yani, bu durumda '''2000'lerde doğanlar''' nesnesinin üst kategorisini elde ettik, fakat eğer bu tipi onyıla göre ayırıyorsak bu kategori eklenir. Aksi takdirde eklenmez. Bir üst kademe kategorisinin hangi durumlarda eklenip eklenmeyeceği aşağıdaki <code>kademe=</code> başlığında açıklanmıştır.

===sira_anahtari====
Bir tablodur. Bu tablonun içerisinde sırasıyla her ebeveyne eklenecek olan '''kategori anahtarı''' bulunur. Kategori anahtarı ise, bir kategori eklerken sıralanacağı harfi belirler. Yani <code><nowiki>[[Kategori:2020'de sanat|E]]</nowiki></code> ifadesindeki '''E''' bir kategori anahtarıdır. Her kategori, her ebeveynine farklı bir anahtar ile eklenebilir. Önemli olan ebeveynlerin ve anahtarların aynı sıralamada olmasıdır.

===kademe====
Bir kategori tipinin hangi kademeye kadar devam edeceğini belirtir. Mesela yukarıdaki örnekte bu değer 4 olarak belirlenmiş. Bu demek oluyor ki, doğanlar kategorilerini yıldan, binyıla kadar ayırt edebiliyoruz. Fakat '''derleme albümleri''' nesnesini incelediğimizde:
<pre>
k["derleme albümleri"] = {
	ek = "y",
	ebeveynler = {"albümler"},
	sira_anahtari = {"D"},
	kademe = 2,
}
</pre>
Görüyoruz ki, buradaki kademe 2, yani bu derleme albümlerini yalnızca yıla ve onyıla göre ayırt edebiliyoruz. Bu kademe değerleri zamanla yoğunluğa göre değiştirilebilir.

===kademeYok====

Bu parametre, bir istisna parametresidir. Normalde eğer bir kategori tipinin kademeleri yüzyıla veya binyıla kadar çıkıyorsa, fakat, yıl ve onyılda kademelendirmesi mevcut değilse bu parametre kullanılabilir.

Örneğin, [[:Kategori:21. yüzyıl kişileri]] kategorisi mevcutken [[:Kategori:2021 kişileri]] adlı bir kategori mevcut değildir. Bu durumda bu nesnenin yapısı bu şekildedir:
<pre>
k["kişileri"] = {
	ek = "y",
	ebeveynler = {"kategoriler"},
	sira_anahtari = {"K"},
	kademe = 4,
	kademeYok = 2,
}
</pre>

Yukarıda girilmiş olan <code>kademeYok = 2</code> ifadesi demektir ki, bu kategori tipinin yıl ve onyıl kategorileri mevcut değil. Eğer bu değer <code>1</code> olmuş olsaydı o zaman yalnızca yıl kategorileri mevcut olmayıp, kademeler onyıldan başlayacaktı.

===aciklama====
Sayfada eğer bir açıklama yazısı eklenecek ise bu yazıdır.

===bak====
Eğer {{şb|kategori ayrıca bakınız}} şablonu ile en başa eklenmesi gereken başka bir kategori varsa, bunu buraya ekleyebiliriz. Örnekte <code>{"ölenler"}</code> şeklinde eklenmiş. Bir tablonun içerisinde "ölenler" değeri var. Yani '''ölenler''' nesnesini çağırıp onun aynı kademediki karşılık kategorisini en üste ekliyoruz.

===sonHarfSil====
Bu varsa <code>true</code> değeri ile eklenebilir. Bu şu amaç için kullanılır, mesela '''derleme albümleri''' kategorileri şu şekildedir:
* {{k|2010 derleme albümleri}}
* {{k|2010'lar derleme albümleri}}

Ama bunların her biri şöyle ana kategorilere sahiptir:
* {{k|Yıla göre derleme albümler}}
* {{k|Onyıla göre derleme albümler}}

Görüldüğü üzere "yıla göre ..." ifadesinde kullanılırken derleme albümleri ifadesindeki son harf olan "i" silinmiştir, yani eğer bu değer girilirse '''göre''' kategorilerinde hep son harf silinir. Benzer durumlar; "2010 şarkıları", "2010 albümleri" vs...

===gore====
Bu değer {{k|Yıla göre derleme albümler}} veya {{k|Döneme göre müzik}} tarzı kategoriler için kullanılan bir değerdir. Mesela en üstteki örneğimizde bu değer <code>gore = "doğum",</code> şeklinde girilmiş. Bu demek oluyor ki, {{k|Döneme göre doğanlar}} kategorisindeysek, bu kategorinin üst kategorisi "doğanlar" veya "doğumlular" değil "doğum" şeklinde olmalıdır.

Bu değer eğer '''hayır''' olursa, {{k|Başladığı döneme göre televizyon dizileri}}nde olduğu gibi, bunun üst kademesi eklenmez, yalnızca ebeveynler değerleri eklenir.

Bu değer eğer '''üst''' olursa, {{k|Yıla göre remiks albümleri}}nde olduğu gibi, bunun üst kategorisi yani bir "Döneme göre ..." kategorisi yoktur, bu sebeple de direkt {{k|Remiks albümleri}} kategorisine eklenir.

Eğer hem üst kategorisi yani bir "Döneme göre ..." kategorisi yoksa ve de göre kategorileri farklı adla adlandırılmış bir kategoriye eklenecekse bu değeri bir tablo şeklinde eklemelisiniz. Yani  <code>{"üst", "dönemlere göre Almanya tarihi"}</code> gibi. Mesela Almanya nesnesi incelendiğinde:
<pre>
k["Almanya"] = {
	ek = "d",
	ebeveynler = {"Avrupa", "ülkelere göre"},
	sira_anahtari = {"A", "A"},
	kademe = 4,
	gore = {"üst", "dönemlere göre Almanya tarihi"}
}
</pre>
Normalde ''Yıla göre Almanya'' kategorisinin '''üst''' değeri eklendiği için ''Döneme göre Almanya'' kategorisine değil de ''Almanya'' kategorisine eklenmesi gerekir. Fakat tablo şeklinde ekleme yapıldığında ve hem '''üst''' hem de ikinci bir '''dönemlere göre Almanya tarihi''' adı girildiğinde ''Yıla göre Almanya'' kategorisi, ''Dönemlere göre Almanya tarihi'' kategorisine eklenir.

===goreTipi====

Eğer [[:Kategori:Yıla göre eserler]] gibi çok yoğun bir alt kategori kitlesine sahip bir kategorinin bir de alt dalları mevcutsa bunun için '''goreTipi''' parametresi kullanılabilir. Mesela, [[:Kategori:Yıla göre albümler‎]] normalde bu kategoride bulunması gerekiyor, fakat bu kategori yıllar ile dolduğu için (400'den fazla yıl kategorisi) bunun gibi alt kategoriler burada karmaşaya sebep olacaktır. Bu sebeple [[:Kategori:Yıla ve tipe göre eserler]] isimli bir alt kategori oluşturulmuş, buraya da eserlerin alt tipleri yerleştirilmiştir. Bu durumda "albümler" kategori nesnesinin '''goreTipi''', '''tipe''' olmuş oluyor.

Örnek:

<pre>
k["albümleri"] = {
	ek = "y",
	ebeveynler = {"müzik", "eserler"},
	sira_anahtari = {"A", "A"},
	kademe = 3,
	sonHarfSil = true,
	goreTipi = "tipe"
}
</pre>

Yani özetle herhangi bir kategoriyi "Yıla ve ... göre KATEGORİ", "Onyıla ve ... göre KATEGORİ" vs. şeklinde sınıflandırmak için bu parametreyi kullanabilirsiniz.

===basta====
Bu değer bir string değeridir. Bir kategori adında yıl başta değilse, yani yılın başında gelen başka bir ifade mevcutsa, bunu bu parametreyi kullanarak belirtmelisiniz.

Mesela ''[[:Kategori:Kıtalara göre 2012]]'' kategorisi. Burada 2012 yılı kategorinin en sonunda. Bu nesnede '''basta''' parametresine bizim "kıtalara göre" ifadesini girmemiz gerekiyor ki, modül yılın kıtalara göre'den sonra geldiğini anlayabilsin.

Ya da "ülkelere göre spor" nesnesini incelersek, [[:Kategori:Ülkelere göre 2010'da spor]] kategorisi için baktığımızda, burada nesnemizin adı, yılı çıkarttığımız zamanki haliyle oluşmuş. Fakat yıl ortada duruyor. Yılın hangi ifadeden sonra geldiğini anlayabilmesi için modülün, aşağıdaki gibi "basta" parametresine "ülkelere göre" yazmalısınız.

<pre>
k["ülkelere göre spor"] = {
	ek = "d",
	ebeveynler = {"futbol", "ülkelere göre"},
	sira_anahtari = {"Ü", "Ü"},
	kademe = 3,
	basta = "ülkelere göre"
}
</pre>

===donustur====

Eğer bir kategori tipinin yıl kategorilerindeki ismi ile göre kategorilerindeki ismi farklı ise <code>donustur=</code> parametresi ile bu ismin dönüştürülmesi sağlanır. Örneğin,
<pre>
k["kurguda"] = {
	ek = "y",
	ebeveynler = {"kategoriler"},
	sira_anahtari = {"K"},
	kademe = 4,
	donustur = "kurgu",
}
</pre>
Yukarıdaki nesne normalde [[:Kategori:Kurguda 2010]] gibi yıl kategorilerine sahiptir. Yani aslında bu nesnenin ismi "kurguda" olarak kodlanır. Fakat [[:Kategori:Onyıla göre kurguda]] gibi bir kullanım değil de [[:Kategori:Onyıla göre kurgu]] diye bir kullanım mevcuttur. Bu sebeple de bu nesneye <code>donustur=</code> parametresi ile "kurgu" değeri verilmiştir.

===oncesi=, sonrasi=, arasi====

Bu parametre, bir kategori nesnesini belli bir yıldan önce, başka bir kategori nesnesine dönüştürür. Mesela, Amerika Birleşik Devletleri 1776'dan beri vardır. Bu tarihten önce On Üç Koloni olarak bilinmektedir. Fakat bunun altındaki bazı alt kategoriler her iki dönemde de mevcuttur. 1776 yılından önce Amerika Birleşik Devletleri diye bir ülke olmadığı için, bu kategori nesnesini 1776 yılından öncesindeki kategoriler için On Üç Koloni'ye dönüştürür. Örnek olarak [[:Kategori:1607'de Virginia]] sayfasına bakabilirsiniz. Burada ebeveyn On Üç Koloni olarak görünmekte. Fakat [[:Kategori:1776'da Virginia]] sayfasında ebeveynlerde artık Amerika Birleşik Devletleri'ni görebilmekteyiz.

<pre>
k["Amerika Birleşik Devletleri"] = {
	 ek = "d",
	 ebeveynler = {"Kuzey Amerika", "ülkeler"},
	 sira_anahtari = {"A", "A"},
	 kademe = 4,
	 oncesi = {"1776", "On Üç Koloni"}
}
</pre>

}}
<includeonly>[[Kategori:Beta modüller]]</includeonly>