Help:Extension:ParserFunctions
ParserFunctions uzantısı, MediaWiki'de zaten mevcut olan "sihirli kelimeleri " tamamlamak için on bir ek ayrıştırıcı işlevi sağlar. (Dize işleme için ek ayrıştırıcı işlevleri sağlamak üzere yapılandırılabilir; bu dize işlevleri başka yere belgelenmiştir.) Bu uzantı tarafından sağlanan tüm ayrıştırıcı işlevleri şu şekildedir:
{{#işlevadı: değişken 1 | değişken 2 | değişken 3 ... }}
Not: Bu sayfayı düzenlerken katkınızı CC0 altında yayınlamayı kabul edersiniz. Daha fazla bilgi için Kamu Malı Yardım Sayfalarına bakın. |
#expr
Tür | Operatörler |
---|---|
Gruplama (parantezler) | ( )
|
Sayılar | 1234.5 e (2.718) pi (3.142)
|
ikili operatör e tekli + ,-
| |
Tekli | not ceil trunc floor abs exp ln sin cos tan acos asin atan sqrt
|
İkili | ^
|
* / div mod fmod
| |
+ -
| |
Yuvarlama | round
|
Mantık | = != <> > < >= <=
|
and
| |
or
|
Bu işlev, matematiksel bir ifadeyi değerlendirir ve hesaplanan değeri döndürür.
Bu işlev, mw.ext.ParserFunctions.expr
işlevi aracılığıyla Scribunto olarak da kullanılabilir.
{{#expr: ifade }}
Basic example
{{#expr: 1 + 1 }}
→ 2
Kullanılabilir operatörler, öncelik sırasına göre sağda listelenir. Her operatörün işleviyle ilgili daha fazla ayrıntı için [[Manual:Expr parser function syntax |Help:Hesaplama]] sayfasına bakın. Döndürülen sonucun doğruluğu ve biçimi, vikiyi çalıştıran sunucunun işletim sistemine ve site dilinin sayı biçimine bağlı olarak değişecektir. The accuracy and format of the result returned will vary depending on the operating system of the server running the wiki and the number format of the site language.
Boole cebri kullanılarak değerlendirme yapılırken, sıfır false
olarak değerlendirilir ve pozitif veya negatif herhangi bir sıfır olmayan değer true
olarak değerlendirilir:
{{#expr: 1 and -1 }}
→ 1{{#expr: 1 and 0 }}
→ 0{{#expr: 1 or -1 }}
→ 1{{#expr: -1 or 0 }}
→ 1{{#expr: 0 or 0 }}
→ 0
Boş bir giriş ifadesi boş bir dize döndürür. Geçersiz ifadeler, #iferror
işlevi kullanılarak yakalanabilecek birkaç hata mesajından birini döndürür:
{{#expr: }}
→{{#expr: 1+ }}
→ Expression error: Missing operand for +.{{#expr: 1 = }}
→ Expression error: Missing operand for =.{{#expr: 1 foo 2 }}
→ Expression error: Unrecognized word "foo".
Bir sayıdan önce veya sonra toplama ve çıkarma işlenenlerinin sırası anlamlıdır ve hatalı girdi içeren bir işlenen yerine pozitif veya negatif bir değer olarak kabul edilebilir:
{{#expr: +1 }}
→ 1{{#expr: -1 }}
→ -1{{#expr: + 1 }}
→ 1{{#expr: - 1 }}
→ -1
Sihirli kelimelerin çıkışını kullanıyorsanız, virgülleri kaldırmak ve sayıları çevirmek için bunları ham formatlamanız gerektiğini unutmayın. Örneğin, $numberofusers, $numberofusers2 kullanılarak elde edilebilecek $nou-result-raw ile istediğimiz yerde $nou-result ile sonuçlanır. Bu, özellikle sayıların çevrildiği bazı dillerde önemlidir. Örneğin, Bengalce'de $numberofusers3, $bengali üretir.
For example, {{NUMBEROFUSERS}} results in 18.021.331, where we want 18021331, which can be obtained using {{formatnum :{{NUMBEROFUSERS}}|R}}
.
This is especially important in some languages, where numerals are translated.
For example, in Bengali, {{NUMBEROFUSERS}} produces ৩০,০৬১.
{{#expr:{{NUMBEROFUSERS}}+100}}
→ 118.021{{#expr:{{formatnum:{{NUMBEROFUSERS}}|R}}+100}}
→ 18021431
Yuvarlama
Yuvarlaklar soldaki sayıyı bir kuvvete yükseltilmiş 1/10'un katına çıkarır, üs sağda verilen sayının kesik değerine eşittir.
Yukarı veya aşağı yuvarlamak için sırasıyla tekli ceil
veya floor
kullanın.
Test durumu | Sonuç | Yuvarlama yöntemi |
---|---|---|
{{#expr: 1/3 round 5 }} |
0.33333 | Son rakam < 5 olduğundan belirgin bir yuvarlama oluşmaz (0.333333… → 0.33333) |
{{#expr: 1/6 round 5 }} |
0.16667 | Son rakam ≥ 5 olduğundan yuvarlanır (0.166666… → 0.16667) |
{{#expr: 8.99999/9 round 5 }} |
1 | Yine, sonuç son basamağa yuvarlanır, bu da ek yuvarlama ile sonuçlanır (0.999998… → 1.00000 → 1) |
{{#expr: 1234.5678 round -2 }} |
1200 | Negatif değerler ondalık noktanın soluna yuvarlandığından en yakın 100'e yuvarlanır |
{{#expr: 1234.5678 round 2 }} |
1234.57 | Pozitif değerler ondalık noktanın sağına yuvarlandığından en yakın 100'e yuvarlanır |
{{#expr: 1234.5678 round 2.3 }} |
1234.57 | Yuvarlama dizinindeki ondalık sayılar, yuvarlanan sonuçta hiçbir fark yaratmaz |
{{#expr: trunc 1234.5678 }} |
1234 | Ondalık kısım kesildi (doğranmış) |
En yakın tam sayıya yuvarlama | ||
{{#expr: 1/3 round 0 }} |
0 | Sıfır olan en yakın tamsayıya kadar |
{{#expr: 1/2 round 0 }} |
1 | Bir olan en yakın tamsayıya kadar |
{{#expr: 3/4 round 0 }} |
1 | Bir olan en yakın tamsayıya kadar |
{{#expr: -1/3 round 0 }} |
-0 | Sıfır olan en yakın tamsayıya kadar |
{{#expr: -1/2 round 0 }} |
-1 | Negatif olan en yakın tam sayıya kadar |
{{#expr: -3/4 round 0 }} |
-1 | Negatif olan en yakın tam sayıya kadar |
tavan ve zemin ile yukarı veya aşağı yuvarlama | ||
{{#expr: ceil(1/3) }} |
1 | Bir sonraki daha büyük tam sayıya kadar |
{{#expr: floor(1/3) }} |
0 | Sıfır olan bir sonraki daha küçük tam sayıya kadar |
{{#expr: ceil(-1/3) }} |
-0 | Sıfır olan bir sonraki daha büyük tam sayıya kadar |
{{#expr: floor(-1/3) }} |
-1 | Negatif olan bir sonraki daha küçük tam sayıya kadar |
{{#expr: ceil 1/3 }} |
0.33333333333333 | 1 zaten bir tam sayı olduğundan yuvarlanmaz |
Rounding large numbers | ||
{{#expr: 1e-92 round 400 }} |
1.0E-92 | Rounding to a very large number leads to infinity. Hence, the original value without the infinity is given as the answer. |
{{#expr: 1e108 round 200 }} |
1.0E+108 | Same as above. |
Dizeler
İfadeler yalnızca sayı benzeri değerlerle çalışır, dizeleri veya karakterleri karşılaştıramazlar. Bunun yerine #ifeq kullanılabilir.
{{#expr: "a" = "a" }}
→ Expression error: Unrecognized punctuation character """.{{#expr: a = a }}
→ Expression error: Unrecognized word "a".{{#ifeq: a | a | 1 | 0 }}
→ 1
#if
Bu işlev, bir test dizesini değerlendirir ve boş olup olmadığını belirler. Yalnızca boşluk içeren bir test dizisi boş olarak kabul edilir.
{{#if: test dizesi | test dizisi boş değilse değer | test dizisi boşsa (veya yalnızca beyaz boşluk) değer}}
{{#if: ilk parametre | ikinci parametre | üçüncü parametre }}
Bu işlev, ilk olarak ilk parametrenin boş olup olmadığını test eder. İlk parametre boş değilse, işlev ikinci bağımsız değişkeni görüntüler. İlk parametre boşsa veya yalnızca boşluk karakterleri (boşluklar, yeni satırlar vb.) içeriyorsa, üçüncü bağımsız değişkeni görüntüler.
{{#if: | yes | no}}
→ no{{#if: string | yes | no}}
→ yes{{#if: | yes | no}}
→ no{{#if: | yes | no}}
→ no
Test dizesi her zaman saf metin olarak yorumlanır, bu nedenle matematiksel ifadeler değerlendirilmez (bunun için #ifexpr sayfasına bakın):
{{#if: 1==2 | yes | no }}
→ yes{{#if: 0 | yes | no }}
→ yes
Son parametre (false) atlanabilir:
{{#if: foo | yes }}
→ yes{{#if: | yes }}
→{{#if: foo | | no}}
→
İşlev iç içe olabilir. Bunu yapmak için, #if işlevinin bir parametresi yerine iç #if işlevini tam biçiminde yuvalayın. Yedi seviyeye kadar iç içe yerleştirme mümkündür, ancak bu vikiye veya bir bellek sınırına bağlı olabilir.
{{#if:test dizesi
|test dizisi boş değilse değer
|{{#if:test string
|value if test string is not empty
|test dizisi boşsa (veya yalnızca beyaz boşluk) değer
}}
}}
#if
ifadenizde test dizesi olarak bir parametre de kullanabilirsiniz. Değişken adından sonra |
(boru sembolü) eklediğinizden emin olmanız gerekir.
(Böylece parametrenin bir değeri yoksa, "{{{1}}}
" dizesi yerine boş bir dize olarak değerlendirilir.)
{{#if:{{{1|}}}|1 değişkeninde metin girdiniz|1 değişkeninde metin yok}}
Bu ayrıştırıcı işlevine ilişkin daha fazla örnek için Help:Şablonlarda ayrıştırıcı işlevler sayfasına bakın.
#ifeq
Bu ayrıştırıcı işlevi, iki giriş dizesini karşılaştırır, özdeş olup olmadıklarını belirler ve sonuca göre iki dizeden birini döndürür.
Daha fazla karşılaştırma ve çıkış dizisi gerekiyorsa, #switch
kullanmayı düşünün.
{{#ifeq: string 1 | string 2 | value if identical | value if different }}
Her iki dizi de geçerli sayısal değerlerse, diziler sayısal olarak karşılaştırılır:
{{#ifeq: 01 | 1 | equal | not equal}}
→ equal{{#ifeq: 0 | -0 | equal | not equal}}
→ equal{{#ifeq: 1e3 | 1000 | equal | not equal}}
→ equal{{#ifeq: {{#expr:10^3}} | 1000 | equal | not equal}}
→ equal
Aksi hâlde karşılaştırma metin olarak yapılır; bu karşılaştırma büyük/küçük harf duyarlıdır:
{{#ifeq: foo | bar | equal | not equal}}
→ not equal{{#ifeq: foo | Foo | equal | not equal}}
→ not equal{{#ifeq: "01" | "1" | equal | not equal}}
→ not equal (yukarıdaki benzer örnekle tırnak işaretleri olmadan karşılaştırın){{#ifeq: 10^3 | 1000 | equal | not equal}}
→ not equal (yukarıdaki benzer örnekle karşılaştırın, önce#expr
geçerli bir sayı döndürür)
Pratik bir örnek olarak, kısa ve uzun olmak üzere iki standart zaman arasında seçim yapmak için ayrıştırıcıyı kullanan mevcut bir Template:Timer
şablonu düşünün.
"short" dizesiyle karşılaştırılacak ilk giriş olarak parametreyi alır. Sıralama için bir konvansiyon yoktur, ancak parametre önce giderse okunması daha kolaydır.
Şablon kodu şu şekilde tanımlanır:
{{#ifeq: {{{1|}}} | short | 20 | 40 }}
aşağıdakiler ortaya çıkar:
{{timer|short}}
→ 20{{timer|20}}
→ 40{{timer}}
→ 40
#iferror
Bu işlev bir giriş dizesi alır ve iki sonuçtan birini döndürür; giriş dizesi, #expr
, #time
ve #rel2abs
gibi diğer ayrıştırıcı işlevler tarafından oluşturulan $hatalı bir HTML nesnesi içeriyorsa, döngüler ve özyinelemeler gibi şablon hataları varsa, işlev true
olarak değerlendirilir, ve diğer "failsoft" ayrıştırıcı hataları.
{{#iferror: test string | value if error | value if correct }}
Dönüş dizelerinden biri veya her ikisi atlanabilir. correct
dizesi atlanırsa, hatalı değilse test string
döndürülür. error
dizesi de atlanırsa, bir hata durumunda boş bir dize döndürülür:
{{#iferror: {{#expr: 1 + 2 }} | error | correct }}
→ correct{{#iferror: {{#expr: 1 + X }} | error | correct }}
→ error{{#iferror: {{#expr: 1 + 2 }} | error }}
→ 3{{#iferror: {{#expr: 1 + X }} | error }}
→ error{{#iferror: {{#expr: 1 + 2 }} }}
→ 3{{#iferror: {{#expr: 1 + X }} }}
→ {{#iferror: {{#expr: . }} | error | correct }}
→ correct{{#iferror: <strong class="error">a</strong> | error | correct }}
→ error
Some errors may cause a tracking category to be added, using {{#iferror:}}
will not suppress the addition of the category.
#ifexpr
Bu işlev, matematiksel bir ifadeyi değerlendirir ve sonucun boole değerine bağlı olarak iki dizeden birini döndürür:
{{#ifexpr: expression | value if true | value if false }}
expression
girişi tam olarak yukarıdaki #expr
için olduğu gibi değerlendirilir ve aynı operatörler kullanılabilir. Çıkış daha sonra bir boole ifadesi olarak değerlendirilir.
Boş bir giriş ifadesi false
olarak değerlendirilir:
{{#ifexpr: | yes | no}}
→ no
Yukarıda bahsedildiği gibi, sıfır false
olarak değerlendirilir ve sıfır olmayan herhangi bir değer true
olarak değerlendirilir, bu nedenle bu işlev yalnızca #ifeq
ve #expr
kullanan bir işleve eşdeğerdir:
{{#ifeq: {{#expr: expression }} | 0 | value if false | value if true }}
boş veya yanlış bir giriş ifadesi dışında (bir hata mesajı boş bir dize olarak değerlendirilir; sıfıra eşit değildir, bu nedenle value if true
alırız).
{{#ifexpr: = | yes | no }}
→ Expression error: Unexpected = operator.
karşılama
{{#ifeq: {{#expr: = }} | 0 | no | yes }}
→ yes
Dönüş değerlerinden biri veya her ikisi atlanabilir; uygun dal boş bırakıldığında çıkış verilmez:
{{#ifexpr: 1 > 0 | yes }}
→ yes{{#ifexpr: 1 < 0 | yes }}
→{{#ifexpr: 0 = 0 | yes }}
→ yes{{#ifexpr: 1 > 0 | | no}}
→{{#ifexpr: 1 < 0 | | no}}
→ no{{#ifexpr: 1 > 0 }}
→
Boolean operators of equality or inequality operators are supported.
{{#ifexpr: 0 = 0 or 1 = 0 | yes}}
→ yes{{#ifexpr: 0 = 0 and 1 = 0 | | no}}
→ no{{#ifexpr: 2 > 0 or 1 < 0 | yes}}
→ yes{{#ifexpr: 2 > 0 and 1 > 0 | yes | no}}
→ yes
#ifexist
Bu işlev bir giriş dizesi alır, onu sayfa başlığı olarak yorumlar ve sayfanın yerel vikide bulunup bulunmadığına bağlı olarak iki değerden birini döndürür.
{{#ifexist: page title | value if exists | value if doesn't exist }}
Sayfa mevcutsa, içerik barındırıyorsa, görünür şekilde boşsa (kategori bağlantıları veya sihirli kelimeler gibi meta veriler içeriyorsa, ancak görünür bir içerik sayfası yoksa işlev true
olarak değerlendirir.), boş veya bir yönlendirme değerlendirilir. Sayfanın önceden var olduğu ancak silindiği de dahil olmak üzere, yalnızca kırmızı bağlantı verilen sayfalar false
olarak değerlendirilir.
{{#ifexist: Help:Extension:ParserFunctions/tr | exists | doesn't exist }}
→ exists{{#ifexist: XXHelp:Extension:ParserFunctions/trXX | exists | doesn't exist }}
→ doesn't exist
İşlev, özelleştirilmiş sistem mesajları ve yazılım tarafından tanımlanan özel sayfalar için true
olarak değerlendirilir.
{{#ifexist: Special:Watchlist | exists | doesn't exist }}
→ exists{{#ifexist: Special:CheckUser | exists | doesn't exist }}
→ exists (çünkü bu vikide Checkuser uzantısı yüklüdür){{#ifexist: MediaWiki:Copyright | exists | doesn't exist }}
→ doesn't exist (çünkü MediaWiki:Copyright özelleştirilmedi)
Bir sayfa #ifexist:
kullanarak bir hedefi kontrol ederse, o sayfa hedef sayfanın Special:WhatLinksHere listesinde görünür. Dolayısıyla, {{#ifexist:Foo }}
kodu bu sayfaya (Help:Extension:ParserFunctions/tr) canlı olarak dahil edildiyse, Special:WhatLinksHere/Foo Help:Extension:ParserFunctions/tr sayfasını listeleyecektir.
Paylaşılan bir medya deposu kullanan wikilerde, bir dosyanın depoya yüklenip yüklenmediğini kontrol etmek için #ifexist:
kullanılabilir, ancak vikinin kendisine yüklenmez:
{{#ifexist: File:Example.png | exists | doesn't exist }}
→ doesn't exist{{#ifexist: Image:Example.png | exists | doesn't exist }}
→ doesn't exist{{#ifexist: Media:Example.png | exists | doesn't exist }}
→ exists
Dosya için yerel bir açıklama sayfası oluşturulmuşsa, yukarıdakilerin tümü için sonuç var olur.
#ifexist:
vikiarası bağlantıları ile çalışmaz.
ifexist sınırları
#ifexist:
, "zengin bir ayrıştırıcı işlevi" olarak kabul edilir; herhangi bir sayfaya yalnızca sınırlı sayıda dahil edilebilir (yansıtılmış şablonların içindeki işlevler dahil).
Bu sınır aşıldığında, hedef sayfanın var olup olmadığına bakılmaksızın diğer #ifexist:
işlevleri otomatik olarak false döndürür ve sayfa Category:Pages with too many expensive parser function calls olarak sınıflandırılır.
İzleme kategorisi adı vikinizin içerik diline göre değişebilir.
Bazı kullanım durumlarında, a.new
(var olmayan sayfalara bağlantılar seçmek için) veya a:not(.new)
(mevcut sayfalara bağlantı seçmek için) seçicilerini kullanarak CSS ile ifexist efektini taklit etmek mümkündür.
Ayrıca, tek bir sayfada kullanılabilecek pahalı ayrıştırıcı işlevlerin sayısı $wgExpensiveParserFunctionLimit
ile kontrol edildiğinden, gerekirse LocalSettings.php içindeki sınırı da arttırılabilir.
ifexist ve istenen sayfalar
Mevcut olmayan ve #ifexist kullanımı için test edilen bir sayfa İstenen Sayfalar'da yer alacaktır. Nedeni için görev T14019 ve bir geçici çözüm için w:Template:Linkless exists sayfasına bakın.
#rel2abs
Bu işlev, göreli bir dosya yolunu mutlak bir dosya yoluna dönüştürür.
{{#rel2abs: path }}
{{#rel2abs: path | base path }}
path
girişi içinde aşağıdaki sözdizimi geçerlidir:
.
→ mevcut düzey..
→ bir düzey yukarı çıkın/foo
→ /foo alt dizinine bir düzey aşağı inin
base path
belirtilmezse, bunun yerine sayfanın tam sayfa adı kullanılacaktır:
{{#rel2abs: /quok | Help:Foo/bar/baz }}
→ Help:Foo/bar/baz/quok{{#rel2abs: ./quok | Help:Foo/bar/baz }}
→ Help:Foo/bar/baz/quok{{#rel2abs: ../quok | Help:Foo/bar/baz }}
→ Help:Foo/bar/quok{{#rel2abs: ../. | Help:Foo/bar/baz }}
→ Help:Foo/bar
/.
veya /./
gibi geçersiz sözdizimi yoksayılır.
İkiden fazla ardışık nokta izin verilmediğinden, ardışık ifadeleri ayırmak için aşağıdaki gibi diziler kullanılabilir:
{{#rel2abs: ../quok/. | Help:Foo/bar/baz }}
→ Help:Foo/bar/quok{{#rel2abs: ../../quok | Help:Foo/bar/baz }}
→ Help:Foo/quok{{#rel2abs: ../../../quok | Help:Foo/bar/baz }}
→ quok{{#rel2abs: ../../../../quok | Help:Foo/bar/baz }}
→ Hata: Yolda geçersiz derinlik: "Help:Foo/bar/baz/../../../../quok" (kök düğümünün üstünde bir düğüme erişmeye çalıştı)
For a similar group of functions see also Help:Magic words#URL data. Built-in parser functions include: 'localurl:', 'fullurl:', 'anchorencode:' etc.
#switch
Ayrıca bakınız: w:Help:Switch parser function
Bu işlev, bir giriş değerini birkaç test durumuyla karşılaştırır ve bir eşleşme bulunursa ilişkili bir dize döndürür.
{{#switch: comparison string | case = result | case = result | ... | case = result | default result }}
Örnekler:
{{#switch: baz | foo = Foo | baz = Baz | Bar }}
→ Baz{{#switch: foo | foo = Foo | baz = Baz | Bar }}
→ Foo{{#switch: zzz | foo = Foo | baz = Baz | Bar }}
→ Bar
Kısmi yansıtma etiketli #switch, şablon kodlamasına aşina olmayan bir düzenleyicinin yapılandırılabilir ögeleri görüntülemesini ve düzenlemesini sağlayan bir yapılandırma dosyasını etkileyebilir.
Varsayılan
case
dizesi karşılaştırma dizesi
ile eşleşmezse, varsayılan sonuç
döndürülür:
{{#switch: test | foo = Foo | baz = Baz | Bar }}
→ Bar
Bu sözdiziminde, varsayılan sonuç son parametre olmalı ve ham eşittir işareti içermemelidir ({{}}
olmadan bir eşittir işareti).
Varsa, büyük/küçük harf karşılaştırması olarak kabul edilecek ve hiçbir vaka eşleşmediyse hiçbir metin görüntülenmeyecektir.
Bunun nedeni, varsayılan değerin tanımlanmamış olmasıdır (boş).
Ancak bir durum eşleşirse, ilişkili dizesi döndürülür.
{{#switch: test | Bar | foo = Foo | baz = Baz }}
→{{#switch: test | foo = Foo | baz = Baz | B=ar }}
→{{#switch: test | test = Foo | baz = Baz | B=ar }}
→ Foo
Alternatif olarak, varsayılan sonuç, bir case
"#default
" dizesiyle açıkça bildirilebilir.
{{#switch: comparison string | case = result | case = result | ... | case = result | #default = default result }}
Bu şekilde bildirilen varsayılan sonuçlar, işlev içinde herhangi bir yere yerleştirilebilir:
{{#switch: test | foo = Foo | #default = Bar | baz = Baz }}
→ Bar
default
parametresi atlanırsa ve eşleşme olmazsa, hiçbir sonuç
döndürülmez:
{{#switch: test | foo = Foo | baz = Baz }}
→
Gruplandırma sonuçları
Birkaç case
dizgisinin aynı sonuç
dizgisini döndürdüğü 'geçiş' değerlerine sahip olmak mümkündür. Bu, çoğaltmayı en aza indirir.
{{#switch: comparison string | case1 = result1 | case2 | case3 | case4 = result234 | case5 = result5 | case6 | case7 = result67 | #default = default result }}
Burada 2, 3 ve 4 numaralı durumların tümü result234
döndürür; durum 6 ve 7'nin her ikisi de result67
döndürür.
Yukarıdaki durumda son parametredeki "#default =
" atlanabilir.
Parametrelerle kullanın
İşlev, test dizesi olarak parametrelerle birlikte kullanılabilir.
Bu durumda, boruyu parametre adından sonra yerleştirmek gerekli değildir, çünkü "{{{parameter name}}}
" dizesi olarak bir büyük/küçük harf ayarlamayı seçmeniz pek olası değildir.
(Bu, boru yoksa ve parametre yoksa veya bir değere sahipse parametrenin varsayılan olarak alacağı değerdir.
Help:Şablonlarda ayrıştırıcı işlevler sayfasına bakın.)
{{#switch: {{{1}}} | foo = Foo | baz = Baz | Bar }}
Yukarıdaki durumda, {{{1}}}
, foo
ile eşitse, işlev Foo
döndürür.
baz
ile eşitse, işlev Baz
döndürür.
Parametre boşsa veya mevcut değilse, işlev Bar
döndürür.
Yukarıdaki bölümde olduğu gibi, durumlar tek bir sonuç verecek şekilde birleştirilebilir.
{{#switch: {{{1}}} | foo | zoo | roo = Foo | baz = Baz | Bar }}
Burada {{{1}}}
, foo
, zoo
veya roo
ile eşitse, işlev Foo
döndürür.
baz
ile eşitse, işlev Baz
döndürür.
Parametre boşsa veya mevcut değilse, işlev Bar
döndürür.
Ek olarak, test parametre değeri herhangi bir durumla eşleşmezse hiçbir şey döndürmek istemiyorsanız varsayılan sonuç atlanabilir.
{{#switch: {{{1}}} | foo = Foo | bar = Bar }}
Bu durumda, işlev, {{{1}}}
mevcut olmadığı ve foo
veya bar
ile eşit olmadığı sürece boş bir dize döndürür; bu durumda sırasıyla Foo
veya Bar
döndürür.
Bu, varsayılan sonucu boş olarak bildirmekle aynı etkiye sahiptir.
{{#switch: {{{1}}} | foo | zoo | roo = Foo | baz = Baz | }}
Herhangi bir nedenle bir durumu "{{{parameter name}}}
" olarak ayarlamaya karar verirseniz, parametre olmadığında veya bir değeri olmadığında işlev bu durumun sonucunu döndürür.
İşlevin varsayılan sonucunu döndürmek için parametrenin var olması ve "{{{parameter name}}}
" dizesinden başka bir değere sahip olması gerekir.
- (
{{{1}}}
olmadığında veya boş olduğunda):{{#switch: {{{1}}} | {{{1}}} = Foo | baz = Baz | Bar }}
→ Foo
- (
{{{1}}}
"test
" değerine sahip olduğunda):{{#switch: {{{1}}} | {{{1}}} = Foo | baz = Baz | Bar }}
→ Bar
- (
{{{1}}}
, "{{{1}}}
" değerine sahip olduğunda):{{#switch: {{{1}}} | {{{1}}} = Foo | baz = Baz | Bar }}
→ Foo
Bu varsayımsal durumda, boruyu ({{{1|}}}
) parametresine eklemeniz gerekir.
Karşılaştırma davranışı
#ifeq
ile olduğu gibi, karşılaştırma dizesi ve test edilen durum dizisinin her ikisi de sayısal ise karşılaştırma sayısal olarak yapılır; veya aksi takdirde büyük/küçük harfe duyarlı bir dize olarak:
{{#switch: 0 + 1 | 1 = one | 2 = two | three}}
→ three{{#switch: {{#expr: 0 + 1}} | 1 = one | 2 = two | three}}
→ one{{#switch: 02 | +1 = one | +2 = two | three}}
→ two{{#switch: 100 | 1e1 = ten | 1e2 = hundred | other}}
→ hundred
{{#switch: a | a = A | b = B | C}}
→ A{{#switch: A | a = A | b = B | C}}
→ C
Bir case
dizesi boş olabilir:
{{#switch: | = Nothing | foo = Foo | Something }}
→ Nothing
Bir eşleşme bulunduğunda, sonraki cases
yoksayılır:
{{#switch: b | f = Foo | b = Bar | b = Baz | }}
→ Bar
Ham eşittir işaretleri
"Case" dizeleri ham eşittir işaretleri içeremez. Bu sorunu çözmek için, tek bir eşittir işareti içeren bir $tpl şablonu oluşturun: $code1 veya eşittir işaretini HTML kodu =
ile değiştirin.
Örnek:
Yazdığın | Yaptığın |
---|---|
{{#switch: 1=2
| 1=2 = raw
| 1<nowiki>=</nowiki>2 = nowiki
| 1{{=}}2 = template
| default
}}
|
template |
{{#switch: 1=2
| 1=2 = html
| default
}}
|
html |
#ifeq değiştirme
#switch
, genişleme derinliğini azaltmak için kullanılabilir.
Örneğin:
{{#switch:{{{1}}} |condition1=branch1 |condition2=branch2 |condition3=branch3 |branch4}}
eşdeğerdir
{{#ifeq:{{{1}}}|condition1 |branch1 |{{#ifeq:{{{1}}}|condition2 |branch2 |{{#ifeq:{{{1}}}|condition3 |branch3 |branch4}}}}}}
yani derin yuvalama, doğrusal:
{{#ifeq:{{{1}}}|condition1
|<!--then-->branch1
|<!--else-->{{#ifeq:{{{1}}}|condition2
|<!--then-->branch2
|<!--else-->{{#ifeq:{{{1}}}|condition3
|<!--then-->branch3
|<!--else-->branch4}}}}}}
Öte yandan, anahtarın değiştirilmesi, her iki dalda iç içe geçmiş IF'ler için karmaşık/pratik olabilir (girinti alternatifleriyle gösterilir, her iki tarafta girintili), tam simetrik ağaç yapar:
{{#ifeq:{{{1}}}|condition1
|<!--then-->branch1t{{
#ifeq:{{{1}}}|condition2
|<!--then-->branch1t2t{{#ifeq:{{{1}}}|condition4|<!--then-->branch1t2t4t|<!--else-->branch1t2t4e}}
|<!--else-->branch1t2e{{#ifeq:{{{1}}}|condition5|<!--then-->branch1t2e5t|<!--else-->branch1t2e5e}}
}}
|<!--else-->branch1e{{#ifeq:{{{1}}}|condition3
|<!--then-->branch1e3t{{#ifeq:{{{1}}}|condition6|branch1e3t6t|branch1e3t6e}}
|<!--else-->branch1e3e{{
#ifeq:{{{1}}}|condition7
|branch1e3e7t
|branch1e3e7t
}}
}}
}}
#time
Kod | Açıklama | Mevcut çıkış (Güncellemek için bu sayfanın önbelleğini temizleyin) |
---|---|---|
Yıl | ||
Y
|
4 haneli yıl. | 2024 |
y
|
2 haneli yıl. | 24 |
L
|
Artık yıl ise 1, değilse 0. | 1 |
o [note 1]
|
Belirtilen haftanın ISO-8601 yılı.[note 2] | 2024[note 3] |
Ay | ||
n
|
Ay indeksi, sıfır dolgulu değil. | 11 |
m
|
Ay indeksi, sıfır dolgulu. | 11 |
M
|
Site dilinde ay adının kısaltması. | Kas |
F
|
Site dilinde tam ay adı. | Kasım |
xg
|
Tam ay adını genitif formunda, tam ve yalın formları arasında ayrım yapan site dilleri için çıkış alın. Bu seçenek, Lehçe, Rusça, Beyaz Rusça, Çekçe, Slovakça, Slovence, Ukraynaca vb. gibi birçok Slav dilleri için kullanışlıdır. | Lehçe için:{{#time:F Y|June 2010|pl}} → czerwiec 2010(yalın) {{#time:d xg Y|20 June 2010|pl}} → 20 czerwca 2010(genitif) |
Ayın veya yılın günü | ||
j
|
Ayın günü, sıfır dolgulu değil. | 20 |
d
|
Ayın günü, sıfır dolgulu. | 20 |
z
|
Yılın günü (Ocak 1 = 0). Not: Yılın ISO gününü almak için 1 ekleyin. |
324 |
Hafta ve haftanın günü | ||
W
|
ISO 8601 hafta numarası, sıfır dolgulu. | 47 |
N
|
ISO 8601 haftanın günü (Pazartesi = 1, Pazar = 7). | 3 |
w
|
Haftanın gün sayısı (Pazar = 0, Cumartesi = 6). | 3 |
D
|
Haftanın gününün kısaltması. Nadiren uluslararasılaştırılmış. | Çrş |
l
|
Tam hafta içi adı. Nadiren uluslararasılaştırılmış. | Çarşamba |
Saat | ||
a
|
sabahları "am" (00:00:00 → 11:59:59), aksi takdirde "pm" (12:00:00 → 23:59:59). | pm |
A
|
Yukarıdaki a ifadesinin büyük harfli versiyonu.
|
PM |
g
|
12 saat biçiminde saat, sıfır dolgulu değil. | 9 |
h
|
12 saat biçiminde saat, sıfır dolgulu. | 09 |
G
|
24 saat biçiminde saat, sıfır dolgulu değil. | 21 |
H
|
24 saat biçiminde saat, sıfır dolgulu. | 21 |
Dakika ve saniye | ||
i
|
Dakikalar geçti, sıfır dolgulu. | 41 |
s
|
Dakikayı saniyeler geçti, sıfır dolgulu. | 10 |
U
|
Unix zaman. 1 Ocak 1970 00:00:00 GMT'den bu yana saniyeler. | 1732138870 |
Saat dilimi (1.22wmf2 itibarıyla) | ||
e
|
Saat dilimi tanımlayıcısı. | UTC |
I
|
Tarihin gün ışığından yararlanma saatinde olup olmadığı. | 0 |
O
|
Greenwich saati (GMT) farkı | +0000 |
P
|
İki nokta üst üste ile Greenwich saatine (GMT) göre fark | +00:00 |
T
|
Saat dilimi kısaltması. | UTC |
Z
|
Saniye cinsinden zaman dilimi farkı. | 0 |
Çeşitli | ||
t
|
Geçerli aydaki gün sayısı. | 30 |
c
|
ISO 8601 formatlı tarih, Y-m-d"T"H:i:s+00:00 ile eşdeğer.
|
2024-11-20T21:41:10+00:00 |
r
|
RFC 5322 biçimlendirilmiş tarih, D, j M Y H:i:s +0000 ile eşdeğer, hafta içi gün adı ve ay adı uluslararasılaştırılmamış.
|
Wed, 20 Nov 2024 21:41:10 +0000 |
Gregoryen olmayan takvimler | ||
İslami | ||
xmj
|
Ayın günü. | 18 |
xmF
|
Tam ay adı. | Cemaziyelevvel |
xmn
|
Ay indeksi. | 5 |
xmY
|
Tam yıl. | 1446 |
İran (Celili) | ||
xit
|
Aydaki gün sayısı. | 30 |
xiz
|
Yılın günü. | 245 |
xij
|
Ayın günü. | 30 |
xiF
|
Tam ay adı. | Aban |
xin
|
Ay indeksi. | 8 |
xiY
|
Tam yıl. | 1403 |
xiy
|
2 haneli yıl. | 03 |
İbrani | ||
xjj
|
Ayın günü. | 19 |
xjF
|
Tam ay adı. | Heşvan |
xjt
|
Aydaki gün sayısı. | 30 |
xjx
|
Ay adının genel biçimi. | Heşvan |
xjn
|
Ay numarası. | 2 |
xjY
|
Tam yıl. | 5785 |
Tay güneşi | ||
xkY
|
Tayland güneş takviminde tam yıl. Not: 1941'den önceki yıllar için, Ocak-Mart aralığındaki tarihler doğru şekilde hesaplanmamış. |
2567 |
Minguo/Juche yılı | ||
xoY
|
Tam yıl. | 113 |
Japon nengosu | ||
xtY
|
Tam yıl. | 令和6 |
İşaretler | ||
xn
|
Sonraki sayısal kodu ham ASCII numarası olarak biçimlendirin. | Hintçe dilinde {{#time:H, xnH}} , ०६, 06 üretir.
|
xN
|
xn gibi, ancak dizenin sonuna veya dizede xN ögesinin bir sonraki görünümüne kadar süren, geçişli bir işaret olarak.
| |
xr
|
Sonraki sayıyı romen rakamı olarak biçimlendirin. Yalnızca 10.000'e kadar olan sayılar için çalışır (MediaWiki 1.20 öncesi sürümde 3.000'e kadar). |
{{#time:xrY}} → MMXXIV
|
xh
|
Sonraki numarayı bir İbrani rakamı olarak biçimlendirin. | {{#time:xhY}} → ב'כ"ד
|
Bu ayrıştırıcı işlevi bir tarih ve/veya saat (Miladi takvimde) alır ve verilen sözdizimine göre biçimlendirir. Bir tarih/saat nesnesi belirtilebilir; varsayılan değer sihirli kelime {{CURRENTTIMESTAMP}}
– diğer bir deyişle, sayfanın en son HTML'ye dönüştürüldüğü zaman.
{{#time: format string }}
{{#time: format string | date/time object }}
{{#time: format string | date/time object | language code }}
{{#time: format string | date/time object | language code | local }}
Kabul edilen biçimlendirme kodlarının listesi sağdaki tabloda verilmiştir. Biçimlendirme dizesindeki tanınmayan herhangi bir karakter değiştirilmeden geçirilir; bu aynı zamanda boşluklar için de geçerlidir (sistemin kodları yorumlamak için bunlara ihtiyacı yoktur). If no character is recognized in the formatting string, and the date/time object is without error, then the formatting string is returned as output. Biçimlendirme dizesindeki karakterlerden kaçmanın da iki yolu vardır:
- Bir biçimlendirme karakterinin ardından gelen bir ters eğik çizgi, tek bir değişmez karakter olarak yorumlanır
- Çift tırnak içine alınmış karakterler, değişmez karakterler olarak kabul edilir ve tırnak işaretleri kaldırılır.
Ek olarak, xx
digrafı tek bir değişmez "x" olarak yorumlanır.
Biçimlendirme kodları listesi gelişmeye devam ettikçe (yeni takvimlerin veya farklı şekilde hesaplanan ve biçimlendirilen yeni tarih alanlarının desteğiyle), iletilmesi gereken tüm değişmez karakterlerden (yalnızca şu anda biçimlendirme kodlarında kullanılan ASCII harflerini değil) kaçınmalısınız.
Ne yazık ki, şimdilik, ASCII tek tırnak işareti, hâlihazırda desteklenen ASCII çift tırnak işaretine değişmez metni işaretlemek için basit bir alternatif olarak ve ters eğik çizgiler (JSON, C, C++, PHP, JavaScript, Lua dahil olmak üzere birçok dil tarafından kullanılan dize sabitlerinde de kaçılması gerekir) tanınmamaktadır (örneğin, JSON, C, C++... içinde dize değerlerinin sınırlandırılması gibi diğer kullanımlar için çift tırnak zorunludur). Dolayısıyla, herhangi bir çifte alıntıyı ters eğik çizgi ile çıkarmadan gömemezsiniz (veya bunun yerine başka kıvırcık, açısal veya kare tırnak işaretleri kullanabilirsiniz).
{{#time: Y-m-d }}
→ 2024-11-20{{#time: [[Y]] m d }}
→ 2024 11 20{{#time: [[Y (year)]] }}
→ 2024 (24UTCpmWed, 20 Nov 2024 21:41:10 +0000){{#time: [[Y "(year)"]] }}
→ 2024 (year){{#time: i's" }}
→ 41'10"
tarih/zaman nesnesi
PHP'nin strtotime() işlevi tarafından kabul edilen herhangi bir biçimde olabilir.
Mutlak (ör. 20 December 2000
), göreli (ör. +20 hours
) ve birleşik zamanlar (ör. 30 July +1 year
) kabul edilir.
{{#time: r|now}}
→ Wed, 20 Nov 2024 21:41:12 +0000{{#time: r|+2 hours}}
→ Wed, 20 Nov 2024 23:41:12 +0000{{#time: r|now + 2 hours}}
→ Wed, 20 Nov 2024 23:41:12 +0000{{#time: r|20 December 2000}}
→ Wed, 20 Dec 2000 00:00:00 +0000{{#time: r|December 20, 2000}}
→ Wed, 20 Dec 2000 00:00:00 +0000{{#time: r|2000-12-20}}
→ Wed, 20 Dec 2000 00:00:00 +0000{{#time: r|2000 December 20}}
→ Hata: Geçersiz saat.
ISO 639-3 (?) içindeki dil kodu
, dizenin seçilen dilde görüntülenmesini sağlar
{{#time:d F Y|1988-02-28|nl}}
→ 28 februari 1988{{#time:l|now|uk}}
→ середа{{#time:d xg Y|20 June 2010|pl}}
→ 20 czerwca 2010
local
parametresi, tarih/saat nesnesinin yerel saat dilimine mi yoksa UTC'ye mi atıfta bulunduğunu belirtir.
Bu bir boole parametresidir: değeri, bağımsız değişkenin değeri kullanılarak belirlenir (dizenin boole değerlerine nasıl dönüştürüldüğüne ilişkin ayrıntılar için resmi PHP belgelerine bakın).
$wgLocaltimezone
değişkeni UTC
olarak ayarlanırsa, local
, true
veya false
olarak ayarlandığında çıktıda hiçbir fark olmadığını unutmayın.Ayrıntılar için aşağıdaki örneklere bakın:
{{#time: Y F d H:i:s|now|it|0}}
→ 2024 novembre 20 21:41:13{{#time: Y F d H:i:s|now|it|1}}
→ 2024 novembre 20 21:41:13{{#time: Y F d H:i:s|+2 hours||0}}
→ 2024 Kasım 20 23:41:13{{#time: Y F d H:i:s|+2 hours||1}}
→ 2024 Kasım 20 23:41:13
{{#time:c|2019-05-16T17:05:43+02:00|it}}
→ 2019-05-16T15:05:43+00:00{{#time:c|2019-05-16T17:05:43+02:00|it|0}}
→ 2019-05-16T15:05:43+00:00{{#time:c|2019-05-16T17:05:43+02:00|it|true}}
→ 2019-05-16T15:05:43+00:00
Bir Unix zaman damgası hesapladıysanız, onu önceden bir @
sembolü ekleyerek tarih hesaplamalarında kullanabilirsiniz.
{{#time: U | now }}
→ 1732138873{{#time: r | @1732138870 }}
→ Wed, 20 Nov 2024 21:41:10 +0000
Tam veya kısmi mutlak tarihler belirtilebilir; işlev, geçerli değerler kullanılarak belirtilmeyen tarihin bölümlerini "doldurur":
{{#time: Y | January 1 }}
→ 2024
Dört basamaklı bir sayı her zaman bir yıl olarak yorumlanır, asla saat ve dakika olarak yorumlanmaz:[1]
{{#time: Y m d H:i:s | 1959 }}
→ 1959 11 20 00:00:00
Altı basamaklı bir sayı, mümkünse saat, dakika ve saniye olarak yorumlanır, ancak aksi takdirde bir hata olarak yorumlanır (örneğin, bir yıl ve ay değil):
{{#time: Y m d H:i:s | 195909 }}
→ 2024 11 20 19:59:09 Giriş, yıl+ay kodu yerine zaman olarak değerlendirilir.{{#time: Y m d H:i:s | 196009 }}
→ Hata: Geçersiz saat. 19:60:09 geçerli bir zaman olmasa da 196009, Eylül 1960 olarak yorumlanmaz.
İşlev, belirli bir miktarda tarih matematiği gerçekleştirir:
{{#time: d F Y | January 0 2008 }}
→ 31 Aralık 2007{{#time: d F | January 32 }}
→ Hata: Geçersiz saat.{{#time: d F | February 29 2008 }}
→ 29 Şubat{{#time: d F | February 29 2007 }}
→ 01 Mart{{#time:Y-F|now -1 months}}
→ 2024-Ekim
#time
çağrılarının biçim dizelerinin toplam uzunluğu 6000 karakterle sınırlıdır.[2]
Saat Dilimi sorunu
Bu #time ayrıştırıcı işlevinde (daha özel olarak PHP DateTime içinde), göreli zaman dilimi ofsetleri olarak tamsayı olmayan ögelerin iletilmesine izin vermeyen bir hata var. Bu sorun, EDT gibi bir saat dilimi kullanıldığında geçerli değildir. Örneğin:
{{#time:g:i A | -4 hours }}
→ 5:41 PM
Ancak Hindistan, UTC'den +5.5 saatlik bir zaman farkı üzerindedir ve bu nedenle kendi saat dilimini kullanmak, normal olarak göreli bir zaman dilimi farkının doğru hesaplanmasına izin vermez. İşte olanlar:
{{#time:g:i A | +5.5 hours }}
→ 9:41 PM
Bu soruna geçici bir çözüm bulmak için, zamanı şu şekilde dakikalara veya saniyelere dönüştürmeniz yeterlidir:
{{#time:g:i A | +330 minutes }}
→ 3:11 AM{{#time:g:i A | +19800 seconds }}
→ 3:11 AM
(Bu işlevin geliştiricisi Tim Starling, bu çözüm için tam sözdizimini sağladı.)
#time format like in signatures
Sometimes it is useful to construct a timestamp, which looks like the automatic timestamp generated by signatures in discussions on talk pages. On an English-language wiki, it can be created with:
{{#timel:H:i, j xg Y (e)|+330 minutes}}
→ 03:11, 21 Kasım 2024 (UTC)
#timel
Bu işlev, local
parametresi true
olarak ayarlandığında {{#time: ... }}
ile aynıdır, bu nedenle her zaman vikinin yerel saatini kullanır ($wgLocaltimezone içinde ayarlandığı gibi).
İşlevin sözdizimi şöyledir:
{{#timel: format string }}
{{#timel: format string | date/time object }}
{{#timel: format string | date/time object | language code }}
$wgLocaltimezone
değişkeni UTC
olarak ayarlanırsa, local
, true
veya false
olarak ayarlandığında çıktıda hiçbir fark olmadığını unutmayınÖrneğin, aşağıdaki örneklere bakın:
{{#time:c|now|it}}
→ 2024-11-20T21:41:13+00:00{{#time:c|now|it|0}}
→ 2024-11-20T21:41:13+00:00{{#time:c|now|it|1}}
→ 2024-11-20T21:41:13+00:00{{#timel:c|now|it}}
→ 2024-11-20T21:41:13+00:00
#timef
This function formats a date using a standard format for the selected language, as defined in $dateFormats
(see görev T223772).
{{#timef: date/time object }}
{{#timef: date/time object | format type }}
{{#timef: date/time object | format type | language code }}
The format of the date/time object is the same as for #time. If it is empty, the time when the page was rendered is used.
The format type may be one of:
time
- Only the time is shown.
date
- Only the date is shown.
both
- Both the time and date are shown.
pretty
- Only the date is shown, using an abbreviated format which does not include the year. Not all languages support this; if it is not supported, the "date" format is used.
If the format type is not specified, both the time and date will be show, as if both
were specified.
If the language code is not specified, the page's content language is used.
Using #timef
instead of #time
allows templates to more easily support multiple languages, since different languages have different ways to format dates.
In English, the order of the day and month is controlled by $wgAmericanDates
.
Examples:
{{#timef:now|both|en}}
→ 21:41, 20 November 2024{{#timef:now|both|ja}}
→ 2024年11月20日 (水) 21:41{{#timef:now|pretty|en}}
→ 20 November{{#timef:now|pretty|pl}}
→ 20 listopada{{#timef:|time}}
→ 21.41
#timefl
This function is the same as #timef except that it uses the local timezone of the wiki as configured in $wgLocaltimezone .
{{#timefl: date/time object }}
{{#timefl: date/time object | format type }}
{{#timefl: date/time object | format type | language code }}
#titleparts
Bu işlev, bir sayfa başlığını eğik çizgilere göre bölümlere ayırır ve ardından bu bölümlerden bazılarını çıkış olarak döndürür.
{{#titleparts: sayfa adı | döndürülecek segment sayısı | geri dönen ilk segment }}
Döndürülecek segment sayısı parametresi belirtilmemişse, varsayılan olarak "0" olur ve döndürülecek ilk segment üzerinden (dahil) tüm segmentleri döndürür. döndürülecek ilk segment parametresi belirtilmemişse veya "0" ise varsayılan olarak "1" olur:
{{#titleparts: Talk:Foo/bar/baz/quok }}
→ Talk:Foo/bar/baz/quok{{#titleparts: Talk:Foo/bar/baz/quok | 1 }}
→ Talk:Foo See also {{ROOTPAGENAME }}.{{#titleparts: Talk:Foo/bar/baz/quok | 2 }}
→ Talk:Foo/bar{{#titleparts: Talk:Foo/bar/baz/quok | 2 | 2 }}
→ bar/baz{{#titleparts: Talk:Foo/bar/baz/quok | 2 | 3 }}
→ baz/quok{{#titleparts: Talk:Foo/bar/baz/quok | 3 | 2 }}
→ bar/baz/quok{{#titleparts: Talk:Foo/bar/baz/quok | | 2 }}
→ bar/baz/quok{{#titleparts: Talk:Foo/bar/baz/quok | | 5 }}
→
Her iki değer için de negatif değerler kabul edilir. döndürülecek segment sayısı parametresi için negatif değerler, dizenin sonundaki segmentleri etkin bir şekilde şerit eder. döndürülecek ilk segment için negatif değerler "bu segment sağdan sayılarak başla" anlamına gelir:
{{#titleparts: Talk:Foo/bar/baz/quok | -1 }}
→ Talk:Foo/bar/baz Dizenin sonundan bir segment çıkarır. Ayrıca bakınız {{BASEPAGENAME}}.{{#titleparts: Talk:Foo/bar/baz/quok | -4 }}
→ Dizenin sonundan 4 parçayı da çıkarır{{#titleparts: Talk:Foo/bar/baz/quok | -5 }}
→ Dizenin sonundan 5 parça çıkarır (var olandan fazla){{#titleparts: Talk:Foo/bar/baz/quok | | -1 }}
→ quok Son segmenti döndürür. Ayrıca bakınız {{SUBPAGENAME}}.{{#titleparts: Talk:Foo/bar/baz/quok | -1 | 2 }}
→ bar/baz Dizenin sonundan bir segmenti çıkarır, ardından ikinci segmenti ve ötesini döndürür{{#titleparts: Talk:Foo/bar/baz/quok | -1 | -2 }}
→ baz İkinci son öğeden kopyalamaya başlayın; dizenin sonundan bir segmenti çıkarın
İşlemeden önce, sayfa adı parametresinin kodu HTML ile çözülür: eğer bazı standart HTML karakter varlıkları içeriyorsa, bunlar düz karakterlere dönüştürüleceklerdir (UTF-8 ile dahili olarak kodlanmıştır, yani bu ayrıştırıcı işlevini kullanan MediaWiki kaynak sayfasındakiyle aynı kodlama).
- Örneğin, sayfa adı içindeki herhangi bir
"
,"
veya"
oluşumu"
ile değiştirilecektir. - HTML'den düz metne başka bir dönüşüm gerçekleştirilmez, bu nedenle HTML etiketleri, sayfa başlıklarında geçersiz olsalar bile bu ilk adımda olduğu gibi bırakılır.
{{PAGENAME }}
ve benzeri gibi) bazı sihirli anahtar kelimeleri veya ayrıştırıcı işlevlerinin, kendi giriş parametreleri HTML olarak kodlanmamış olsa bile, gereksiz yere HTML kodlu dizeler döndürdüğü bilinmektedir:
titleparts ayrıştırıcı işlevi daha sonra, bu döndürülen dizeleri, parametrede bir sayfa adı alan ({{PAGESINCAT: }}
gibi ancak hâlâ HTML-kodlanmış giriş dizeleri ile düzgün çalışmayan) diğer bazı ayrıştırıcı işlevler tarafından doğru şekilde işlenebilmeleri için dönüştürmek için bir geçici çözüm olarak kullanılabilir.
Örneğin, geçerli sayfa Category:Côte-d'Or ise, o zaman:
{{#ifeq: {{FULLPAGENAME}} | Category:Côte-d'Or | 1 | 0 }}
ve{{#ifeq: {{FULLPAGENAME}} | Category:Côte-d'Or | 1 | 0 }}
kodunun her ikisi de1
; (#ifeq ayrıştırıcı işlevi, giriş parametrelerinin HTML kodunu çözme işlemini gerçekleştirir).{{#switch: {{FULLPAGENAME}} | Category:Côte-d'Or = 1 | #default = 0 }}
ve{{#switch: {{FULLPAGENAME}} | Category:Côte-d'Or = 1 | #default = 0 }}
'nin her ikisi de1
; (#switch ayrıştırıcı işlevi, giriş parametrelerinin HTML kodunu çözme işlemini gerçekleştirir).{{#ifexist: {{FULLPAGENAME}} | 1 | 0 }}
,{{#ifexist: Category:Côte-d'Or | 1 | 0 }}
ve hatta{{#ifexist: Category:Côte-d'Or | 1 | 0 }}
, eğer o kategori sayfası varsa,1
değerini döndürür (#ifexist ayrıştırıcı işlevi, giriş parametrelerinin HTML kodunu çözme işlemini gerçekleştirir);{{PAGESINCAT: Côte-d'Or }}
sıfır olmayan bir sayı döndürür, eğer o kategori sayfalar veya alt kategoriler içeriyorsa ancak:{{PAGESINCAT: {{CURRENTPAGENAME}} }}
, tıpkı aşağıdaki gibi koşulsuz olarak 0 döndürebilir:{{PAGESINCAT: {{PAGENAME:Category:Côte-d'Or}} }}
{{PAGESINCAT: {{PAGENAME:Category:Côte-d'Or}} }}
Bu beklenmedik davranışın nedeni, MediaWiki'nin güncel sürümlerinde iki uyarı olmasıdır:
{{FULLPAGENAME}}
, hatta{{FULLPAGENAME:Côte-d'Or}}
bile, beklenenCategory:Côte-d'Or
değil, gerçekte HTML kodluCategory:Côte-d'Or
dizesini döndürebilir ve:{{PAGESINCAT: Côte-d'Or }}
koşulsuz şekilde 0 döndürür (PAGESINCAT sihirli anahtar kelimesi, giriş parametresinin HTML kodunu çözmez).
titleparts kullanan basit geçici çözüm (ki bu, MediaWiki'nin sonraki bir sürümünde iki uyarı düzeltilirse çalışmaya devam edecektir):
{{PAGESINCAT: {{#titleparts: {{CURRENTPAGENAME}} }} }}
{{PAGESINCAT: {{#titleparts: {{PAGENAME:Category:Côte-d'Or}} }} }}
{{PAGESINCAT: {{#titleparts: {{PAGENAME:Category:Côte-d'Or}} }} }}
, hepsi aynı kategorideki gerçek sayfa sayısını döndürür.
Ardından, kodu çözülen sayfa adı mümkün olduğunca MediaWiki tarafından desteklenen standart bir sayfa başlığına standart hâle getirilir:
- Tüm alt çizgiler otomatik olarak boşluklarla değiştirilir:
{{#titleparts: Talk:Foo/bah_boo|1|2}}
→ bah boo Orijinaldeki alt çizgiye rağmen bah_boo değil.
- Dize en fazla 25 kez bölünür; daha fazla eğik çizgi yok sayılır ve 25. öğe dizenin geri kalanını içerecektir. Dize ayrıca sayfa başlığı olarak kabul edildiğinden 255 karakterle sınırlıdır:
{{#titleparts: a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z/aa/bb/cc/dd/ee | 1 | 25 }}
→ y/z/aa/bb/cc/dd/ee- Herhangi bir nedenle bu işlevi sınırına kadar zorlamanız gerekiyorsa, pek olası olmasa da, işlev çağrılarını iç içe geçirerek 25 bölme sınırını atlamak mümkündür:
{{#titleparts: {{#titleparts: a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z/aa/bb/cc/dd/ee| 1 | 25 }} | 1 | 2}}
→ z
- Son olarak, ilk alt dize yerel vikinin büyük harf kullanımı ayarlarına göre büyük harfle yazılır (bu alt dize de yerel bir ad alanı adıyla başlıyorsa, bu ad alanı adı da normalleştirilir).
{{#titleparts: talk:a/b/c }}
→ Talk:A/b/c
{{#titleparts: one/two/three/four|1|1 }}
→ One{{#titleparts: one/two/three/four|1|2 }}
→ two
Küçük harf gerekiyorsa, çıkışı kontrol etmek için lc: işlevini kullanın:
{{lc: {{#titleparts: one/two/three/four|1|1 }} }}
→ one
Doğru ilk alt dize büyük harf kullanımını (büyük harf veya küçük harf) elde etmek için dizenin başına bir sahte eğik çizgi ekleyebilirsiniz. döndürülecek ilk segment için 1
yerine 2
kullanın:
{{#titleparts: /one/two/three/four|1|2 }}
→ one{{#titleparts: /One/two/three/four|1|2 }}
→ One
StringFunctions
The ParserFunctions extension optionally defines various string functions if $wgPFEnableStringFunctions
is set to true
:
#len
#pos
#rpos
#sub
#count
#replace
#explode
#urldecode
See the dedicated subpage for documentation, and Manual:Performing string operations with parser functions for examples.
Here is a short overview of Module:String functions:
- #len (length of string):
{{#invoke:String|len|target_string}}
- #sub (substring):
{{#invoke:String|sub|target_string|start_index|end_index}}
- #match:
{{#invoke:String|match|source_string|pattern_string|start_index|match_number|plain_flag|nomatch_output}}
- #pos (position of target):
{{#invoke:String|pos|target_string|index_value}}
- #find:
{{#invoke:String|find|source_string|target_string|start_index|plain_flag}}
- #replace:
{{#invoke:String|replace|source_str|pattern_string|replace_string|replacement_count|plain_flag}}
- #rep (repeat):
{{#invoke:String|rep|source|count}}
- #escapePattern:
{{#invoke:String|escapePattern|pattern_string}}
- #count:
{{#invoke:String|count|source_str|pattern_string|plain_flag}}
- #join:
{{#invoke:String|join|separator|string1|string2|...}}
Genel noktalar
Yerine koyma
Ayrıştırıcı işlevleri, karma karakterinin önüne subst:
eklenerek yerine koyabilir:
{{subst:#ifexist: Help:Extension:ParserFunctions/tr | [[Help:Extension:ParserFunctions/tr]] | Help:Extension:ParserFunctions/tr }}
→[[Help:Extension:ParserFunctions/tr]]
kodu, Help:Extension:ParserFunctions/tr var olduğu sayfasından itibaren vikimetne eklenecektir.
Yerine koyma <ref>
…</ref>
içinde çalışmaz; bu amaçla {{subst:#tag:ref|
…}}
kullanabilirsiniz.
Yönlendirmeler
Özellikle {{#time:
…|now-
…}}, tarihler içeren sayfalara yönlendirmeler için kullanışlı olabilir, ancak bu işe yaramaz.
Tablolarda kaçan boru karakterleri
Ayrıştırıcı işlevleri, vikitablo sözdizimini ve düz çizgi karakterlerini (|
) yönetecek ve tüm ham boru karakterlerini parametre bölücüler olarak değerlendirecektir.
Bunu önlemek için çoğu viki, içeriği yalnızca ham boru karakteri (|
) olan bir şablon Template:! kullandı, çünkü MW 1.24 bir {{!}}
sihirli kelime bu çamurun yerini aldı.
Bu, boruyu MediaWiki ayrıştırıcısından 'gizler' ve bir sayfadaki tüm şablonlar ve değişkenler genişletilene kadar dikkate alınmamasını sağlar.
Daha sonra bir tablo satırı veya sütun ayırıcısı olarak yorumlanacaktır.
Alternatif olarak, daha az sezgisel ve hataya daha açık olmasına rağmen ham HTML tablosu sözdizimi kullanılabilir.
Ayrıca, bir HTML varlığı kullanarak düz, yorumlanmamış bir karakter olarak görüntülemek için boru karakterinden de çıkabilirsiniz: |
.
Açıklama | Yazdığın | Yaptığın |
---|---|---|
Tablo satırı/sütun ayırıcısı olarak çıkış borusu karakteri | {{!}} |
| |
Düz karakter olarak çıkış borusu karakteri | | |
| |
Boşlukları çıkarma
Yeni satırlar, sekmeler ve boşluklar dahil olmak üzere boşluk, bu ayrıştırıcı işlevlerinin tüm parametrelerinin başından ve sonundan çıkarılır. Bu istenmiyorsa, dizeler tırnak içine alındıktan sonra karşılaştırma yapılabilir.
{{#ifeq: foo | foo | equal | not equal }}
→ equal{{#ifeq: "foo " | " foo" | equal | not equal }}
→ not equal
then ve else bölümlerinin kırpılmasını önlemek için, $meta-tpl-if sayfasına bakın. Then ve else bölümlerinin kırpılmasını önlemek için, bkz. $meta-tpl-if. Bazı insanlar bunu boşluklar yerine <Template:$markup-nw> </nowiki> kullanarak başarır.
foo{{#if:|| bar }}foo
→ foobarfoofoo{{#if:||<nowiki /> bar <nowiki />}}foo
→ foo bar foo
Ancak, ayrıştırıcı bir satırdaki birden çok boşluk karakterini tek bir karaktere sıkıştırdığından, bu yöntem yalnızca tek bir boşluk karakteri oluşturmak için kullanılabilir.
<span style="white-space: pre;">foo{{#if:||<nowiki/> bar <nowiki/>}}foo</span>
→ foo bar foo
Bu örnekte, boşlukları tarayıcı tarafından korunmaya zorlamak için white-space: pre
stili kullanılır, ancak bununla bile boşluklar gösterilmez. Bunun nedeni, tarayıcıya gönderilmeden önce boşlukların yazılım tarafından çıkarılmasıdır.
Boşlukları  
(kırılabilir boşluk) veya
yazılım tarafından değiştirilmediği için (kırılmaz boşluk) ile değiştirerek bu davranışa geçici bir çözüm bulmak mümkündür:
<span style="white-space: pre;">foo{{#if:||   bar   }}foo</span>
→ foo bar foofoo{{#if:|| bar }}foo
→ foo bar foo
Beware that not all parameters are created equal. In ParserFunctions, whitespace at the beginning and end is always stripped. In templates , whitespace at the beginning and end is stripped for named parameters and named unnamed parameters but not from unnamed parameters:
foo{{1x|content= bar}}foo
→ foobarfoofoo{{1x|1= bar}}foo
→ foobarfoofoo{{1x| bar }}foo
→ foo bar foo
Other parser functions
Case conversion functions
- Lowercase:
"{{lc: AbC}}"
→ "abc" [1] - Uppercase:
"{{uc: AbC}}"
→ "ABC" [2] - Lowercase first character:
"{{lcfirst: AbC}}"
→ "abC" [3] - Uppercase first character:
"{{ucfirst: abc}}"
→ "Abc" [4]
Encoding functions
- URL encoding:
"{{urlencode: AbC
dEf ghi}}"
renders as
"AbC%0AdEf+ghi"
So inner new lines convert into %0A, and inner spaces convert into +.
Anchor encoding
{{anchorencode: AbC dEf ghi}}
renders as
AbC_dEf_ghi
Padding functions
Formatting functions
"{{formatnum: 1234567890}}"
gives "1.234.567.890" [7]
Ayrıca bakınız
- Help:Şablonlarda ayrıştırıcı işlevler
- Parser extension tags
- Parser function hooks - an (incomplete) list of parser functions added by core and extensions.
- Manual:Newlines and spaces
- Manual:Converting between ParserFunctions syntax and TeX syntax
- Help:Sihirli kelimeler
- Module:String, Extension:StringFunctions eskiliyor
- Extension:PhpTags
- Parser functions for Wikibase (the extensions that enables Wikidata): How to use data on Wikimedia projects#Parser function
Kaynakça
- ↑ 2011'de r86805 önce durum böyle değildi.
- ↑ ParserFunctions.php phabricator.wikimedia.org adresinde