Taşınabilir Bilgi Kutuları

Şablon:Özellik/Geliştirme
Şablon:Bilgi kutusu/Özellik
Fandom'un daha kapsayıcı bir wiki ekosistemine yönelik çabası artık en iyi uygulama için bir "iyi uygulama" içeriyor (henüz bir en iyi uygulama değil) Taşınabilir Bilgi Kutuları (ayrıca CSS ve Etiketler için yardıma bakın). Bunlar gelişmeye devam ediyor ve InfoboxBuilder tarafından yönlendirilen şablonlardan sonraki yeni nesil. Birçok Taşınabilir Bilgi Kutusu zaten oluşturuldu! Bu belge, mevcut resmi belgelere bir alternatiftir.

**Genellikle şablon oluşturmuyor veya değiştirmiyorsanız, bu kılavuz mutlaka size göre değildir.**

SSS sayfasını okuyarak başlamak isteyebilirsiniz.

## Arkaplan

Çoğu bilgi kutuları gibi, bir `Şablon:` maddesinde bir format geliştirilir (örn. `Şablon:Karakter bilgi kutusu`). Ancak diğer çoğu şablonun aksine, Taşınabilir Bilgi Kutusu şablonu vikimetin veya Lua şablonlama dili yerine özel bir XML biçiminde yazılır. Bu işaretleme türü, vikimetin içindeki HTML veya uzantılar için daha tipiktir ve Taşınabilir Bilgi Kutusu sözdizimi gerçekten de bir uzantının betiktir; bu, işlenen Bilgi Kutusunu birden çok platformda iyi biçimlendirmesini sağlar.

Şablon: oluşturulduktan sonra, maddelerdeki diğer şablonlar gibi kullanılabilir. Birçokları için bu, maddelerde yazılanları değiştirmek zorunda kalmadan çoğu viki için doğrudan değiştirmenin mümkün olduğu anlamına gelir. Taşıma aracı tam da böyle bir amaç için tasarlanmıştır; sonuçta ortaya çıkan taslaklar birçok durumda ince ayar gerektirecektir ve az sayıda wiki için olduğu gibi kullanılamaz. Bu durumlarda, sözdizimi kullanan daha kapsamlı bir iyileştirme gereklidir. Taşıma aracının iyi bir sonuca yaklaşmada iyi çalışmadığı çoğu durumda, taşınan şablonların ya çok eski (ve cihazlar arasında iyi işlenmeme eğiliminde), çok karmaşık (Lua kullanarak veya ayrıntılı ayrıştırıcı işlevi) veya çok tipik olmayan Bilgi Kutuları (genellikle tüm cihazlarda iyi işlenmeyen tasarımlarla).

## Temeller

Şablon:Ana
Bir maddenin içinde, tipik olarak yapıldığı gibi bir bilgi kutusu kullanılır.

```
{{Bilgi kutusu karakteri
}}
```

Çağrılan Şablon (bu durumda Şablon:Bilgi kutusu karakteri) şuna benzeyen Taşınabilir Bilgi Kutusu sözdizimini kullanıyor olabilir:

```
<infobox>
 <title source="başlık" />
 <image source="resim">
 <caption source="resimaltyazı" />
 </image>
 <data source="görev" />
 <data source="yaş" />
 <data source="durum" />
 <data source="yükseklik" />
 <data source="ağırlık" />
</infobox>

```

Yukarıdaki örnek, geçerli bir bilgi kutusu üretir ve gerçekten de Taşıma Aracı tarafından üretilen temel sonuç olabilir. Bu Taslağı daha iyi hâle getirmek için kullanılabilecek bazı özellikler eksik. Burada, "default" ("source" gerektiren herhangi bir ögenin alt ögesi olarak kullanılabilir), "tags" ve "format" ile tanıtacağız. İkincisi, karışık veriler ve birimler yerine saf verileri kullanmaya başlayabilmemiz için kullanılır, ancak aynı işlev bu belgede daha sonra daha ayrıntılı olarak açıklayacağımız birçok önemli şeyi yapabilir.

```
<infobox>
 <title source="başlık">
 <default>{{PAGENAME}}</default>
 </title>
 <image source="resim">
 <caption source="resimaltyazı" />
 </image>
 <data source="görev">
 <label>Görev</label>
 </data>
 <data source="yaş">
 <label>Yaş</label>
 </data>
 <data source="durum">
 <label>Durum</label>
 </data>
 <data source="yükseklik">
 <label>Yükselik</label>
 <format>{{{yükseklik}}} inç</format>
 </data>
 <data source="ağırlık">
 <label>Ağırlık</label>
 <format>{{{ağırlık}}} gram</format>
 </data>
</infobox>

```

## Taşıma Aracıyla Taslaklar

Şablon:Ana
Bilgi kutusu taşıma aracı, diğer bilgi kutusu türlerini karışık sonuçlarla taşınabilir bilgi kutuları dönüştürmek için kullanılır. Daha karmaşık şablonlarda el düzenleme gereklidir.

## Görsel Düzenleyici kullanarak Bilgi Kutularının Eklenmesi

Vikiye yeni katkıda bulunanlar için en yaygın araç olan Görsel Düzenleyici'yi kullanmak, bir bilgi kutusu ekleme işlemi kolaydır. Düzenleme araç çubuğunda, Taşınabilir Bilgi Kutularının bir listesini sağlayan bir açılır menü vardır. Aynı bilgi kutusunu ve onunla bazı işlemleri değiştirmek o kadar basit değil. Şu anda, bir Bilgi Kutusunun parametreleri açıklama yapılmadan gösteriliyor ve resimler ve videolar kolayca eklenmiyor.

Bilgi kutusuna bir resim (veya video) eklemek, maddenin ana gövdesindeki Görsel Düzenleyici ekleme aracını ve Kaynak Düzenleyiciyi kullanarak bu resminin işaretçisini bilgi kutusuna kopyalamayı gerektirir. Resmin hangi parametreye yerleştirilmesi gerektiğini hatırlamak önemlidir. Resmine boyutlandırma, resim yazısı, küçük resim veya diğer değiştiricileri işaretlemek önemli değildir, çünkü bunlar yok sayılır. Resmin genişliği CSS tarafından belirlenir ve bir resim yazısı, resim yazısı etiketi kullanılarak ayrı bir parametre tarafından ele alınmalıdır.

Mevcut uygulamada, bu kopyala/yapıştır işlemi Klasik (RTE) Düzenleyicide de gereklidir.

## Etiketler

Şablon:Ana
Geleneksel şablonlara alışkınsanız, üç parantez içine alınmış bir kelimeye (örn. "*<kod>{{{kelime}}}'*) parametre denir. "Kelime" değerinin bir maddede ayarlanan her şey olduğu bir Şablona girdiyi temsil ederler. Aynı giriş, **`source="kelime"`** kullanılarak Taşınabilir Bilgi Kutusunda tanınır. Bu tür parametreler, maddedeki verileri depolamak için kullanılır, ancak girildikleri şekilde görüntülenmeleri gerekmez. **`<format>`** etiketi kullanılarak farklı çıktılar alınabilir.

Bazı etiketler yalnızca diğer etiket türlerinde yuvalanabileceğinden, etiketlerin iç içe yerleştirilmesinin izlenmesi çok önemlidir. XML'de etiketlerin kapalı olması da önemlidir; kapanış etiketi gerekmiyorsa **`/>`** ile bitmelidir.

Veri ögelerini bir bölümde (yatay veya dikey olarak) gruplamak için bir `<group>` etiketi yararlıdır.

`<navigation>` etiketleri, herhangi bir tür vikimetin ögesinin başka türlü göz ardı edilebileceği veya kısıtlanabileceği bir Taşınabilir Bilgi Kutusu içinde oluşturmanın genel bir yolunu temsil eder. Bu etiketler genellikle bir bölümün tamamını kaplar (<data> etiketine çok benzer) ve bağlantıları veya diğer bilgileri göstermek için kullanılabilir. Genellikle, alt bilgi olarak bir gezinme etiketi kullanılır.

### Resimler

`<gallery>` veya `<tabber>` etiketlerdeki şablona bir dizi resim iletirseniz kısmi sekmeci-benzer işlevi desteklenir. Yardımın Birden çok resim veya video kullanma bölümüne bakın.

Örnek taşınabilir bilgi kutusu

```
<!-- Karakter bilgi kutusu -->
<infobox layout="stacked">
  <title source="ad"><default>{{PAGENAME}}</default></title>
  <image source="resim" />
  <data source="sezon"><label>Sezon(lar)</label></data>
  <data source="ilk"><label>İlk görüş</label></data>
</infobox>

```

Örnek galeri kullanımı

```
{{Karakter bilgi kutusu
    Mary riding.jpg|at üstünde Mery
    Mary wedding.jpg|Mery gelinlik
    Mary dancing.jpg|Mary dansı
  </gallery>
           [[4. seri|4]], [[5. seri|5]], [[6. seri|6]]
}}

```

Örnek sekme kullanımı

```
{{Karakter bilgi kutusu
    DDans  = [[Dosya:Mary dancing.jpg]]
  </tabber>
           [[4. seri|4]], [[5. seri|5]], [[6. seri|6]]
}}

```

## CSS ile şekillendirme

Şablon:Ana
Bu tür kodu kullanan bilgi kutuları, topluluğun özel temasından ipuçları alınarak otomatik olarak biçimlendirilir. Değişkenlerden herhangi biri boşsa, şablonun ilgili satırı görüntülenmeyecektir ('default' etiketi kullanılmadığı sürece).

Satır içi CSS desteklenmez. Ayrıca özel sınıfların desteklenmediği, ancak `theme` ve `theme-source` öznitelikleri aracılığıyla ögelere stil vermek için sınırlı sayıda önceden tanımlanmış sınıfların kullanılabileceği görülüyor.

### Düzen

Genel veya tablo bilgi kutuları için, düzenler şu anda oldukça basit ve yalnızca verilere ve etiketlerine uygulanıyor gibi görünüyor.

### etiket

Veri

Varsayılan, sağdaki kutu gibi düzenlenmiş verilerdeki etiketlere sahip "tablo" benzeri bir düzendir.

### etiket

Veri

Diğer düzen `<infobox layout="stacked">` olup, etiketleri verilerin üstüne ve veri girintili kutunun sağına yerleştirir.

Düzenler ayrıca gruplar için de geçerlidir (aşağıya bakın) ve Gruplar için yardımla açıklanacak olan daha fazla seçenek sunar.

### Gruplar

Düzeni ve bazı işlevleri genel bilgi kutusundan bağımsız olarak kontrol edebileceğiniz alt bilgi kutuları gibi gruplar düşünebilirsiniz.

Gruplar, özellikle daraltabilir olmak istediğiniz bilgi kutusunun bölümleri için iyidir. Aşağıdaki özelliklerden birini ekleyebilirsiniz:

* `collapse="closed"` - varsayılan olarak daraltıldı
* `collapse="open"` - varsayılan olarak daraltılmadı

### Temalar

Şablon:Ana
Temalar, belirli bir taşınabilir bilgi kutusuna uygulanan CSS stilleri kümeleridir (`<infobox>` ögesinin `theme="*temaadı*"` özniteliği aracılığıyla). Bir tema belirledikten sonra, `MediaWiki:Common.css` dosyanızda `.portable-infobox.pi-theme-*temaadı*` sınıfı için stiller uygulayabilirsiniz. Varsayılan stilden farklı olacaklar, ancak temada belirtilmeyen herhangi bir şey için varsayılanları devralacaklar.

Örneker
* Taşınabilir Bilgi Kutusu/Temalar sayfasına bakın

## Gelişmiş çıkış

Veri türlerinin en basit kullanımı, değerleri girdileri gibi çıktılamaktır. Ancak, Taşınabilir Bilgi Kutularının ikincil bir hedefi, yapılandırılmış verilere doğru bir harekettir. Yukarıdaki boy ve ağırlık örneklerinde, tüm değerlerin inç ve gram cinsinden olduğu varsayılır ve **`format`** etiketi, bu etiketleri girdinin alacağı beklentisiyle çıktıya ekler. Görsel Düzenleyici'nin gelecekteki tasarımlarında, basit bir sayı olmayan bir değer girilmesine izin verilmeyecektir.

### Format etiketleri

Biçim etiketleri (`<format>`), `<data>`, `<title>` ve `<caption>` etiketleri için parametre verilerinin nasıl görüntülendiği konusunda daha fazla kontrol sağlar.

### ParserFunctions

ParserFunctions çağrısı şu anda `<default>`, `<format>` veya `<navigation>` etiketi içinde, **`{{#switch:`** (veya benzeri) ifadesi kullanılarak yapılır. Biçim veya gezinme etiketlerinde kullanıldığında, üstün veri kaynağı parametresinde bir değer olmadıkça bu çağrılmaz veya görüntülenmez. Varsayılan kullanım için, varsayılan olduğu aynı öğeye atıfta bulunma tuzağına düşmekten kaçının. Varsayılan olarak ayrıştırıcı işlevlerinin kullanımı, eksik bilgilerin çıktısını oluşturmak için başka bir yere girilen bilgileri ödünç alır. Üstün kaynak parametresini test ediyorsa **`{{#if:`** ifadesinin kullanılmasına gerek yoktur, çünkü bunlar bir bilgi kutusunda görüntülenmeyecektir. `<default>` etiketi mevcut olmadığı sürece yok veya boş.

### Lua işlevlerini kullanma

Lua işlevleri (özellikle birden çok girişe sahip olanlar), genellikle bir **`{{#invoke:}}`** ifadesi kullanılarak `<format>` veya `<default>` etiketi içinde kullanılmasına rağmen, Vikimetne izin verilen her yerde çağrılabilir. Bu, üstün veri kaynağı parametresinde bir değer olmadığı sürece çağrılmayacak veya görüntülenmeyecektir.

### DPL

"DPL", Dinamik Sayfa Listesi anlamına gelir ve kategorilere ve diğer meta verilere (zaman damgaları ve son düzenleyici gibi) dayalı listeler (öncelikle tablolar için) oluşturabilen vikiler için karmaşık, güçlü ancak sınırlı bir uzantıdır. Fandom vikilerinde varsayılan olarak etkin değildir, bu nedenle onu kullanmak için etkinleştirilmesini istemeniz gerekir.

## Gelecekteki yönler

Semantic MediaWiki (SMW) ve muhtemelen bilgi kutularının içindeki DynamicPageList için işlevsel değişikliklerle ve ayrıca entegre HTML5 mikro verileriyle ilgili ayrıntılar Community Connect 2015 sırasında tartışıldı, ancak ayrıntılı olarak hiçbir şey yapılmadı.

## Örnekler

Taşınabilir bilgi kutusu örneklerine bakın.

## Ayrıca bakınız

* Taşınabilir Bilgi Kutuları/İpuçları ve püf noktaları
* Taşınabilir Bilgi Kutuları/SSS
* Taşınabilir Bilgi Kutuları/Faydalar
* Taşınabilir Bilgi Kutuları/En iyi uygulamalar
* Taşınabilir Bilgi Kutuları/Etiketler listesi

## Tartışmalar

* Basitleştirilmiş bir belge oluşturma (ör. temel bilgiler sayfası)
* Taşınabilir bilgi kutuları için artılar (ve eksiler) sayfası
* Standart olmayan (veya egzotik) taşınabilir bilgi kutusu kullanımları