Templat:Flagicon/doc: Perbedaan antara revisi

Konten dihapus Konten ditambahkan
Borgx (bicara | kontrib)
kTidak ada ringkasan suntingan
RaFaDa20631 (bicara | kontrib)
Tidak ada ringkasan suntingan
 
(17 revisi perantara oleh 6 pengguna tidak ditampilkan)
Baris 1:
Templat ini menampilkan bendera dari parameter yang diinput dalam ukuran "icon", 22x20 pixel ditambah garis pinggir satu pixel. Gambarnya juga memiliki ''alt attribute'' (biasanya "Flag of <var>name</var>"), yang ditampilkan oleh penjelajah web ketika pointer mouse berada di atas gambar, atau diinterpretasikan oleh perangkat lunak ''screen reader'' dan penjelajah web ketika gambar diatur untuk tidak ditampilkan.
<noinclude>{{kerjaansi|-iNu-}}</noinclude>{{documentation subpage}}{{terjemah|Inggris}}
==Description==
Displays a flag of the named parameter in "icon" size, currently 22x20 pixels plus a one pixel border. The image also has an [[alt attribute]] (usually "Flag of <var>name</var>"), which is displayed by Internet Explorer when hovering over the flag image, or interpreted by [[screen reader]] software and browsers with images disabled.
 
Harap baca dan cermati [[MOS:BENDERA]] sebelum menggunakan templat ini!
==Usage==
<code><nowiki>{{flagicon|name|variant=|size=}}</nowiki></code>
;name: The first parameter is mandatory, and identifies the name of the country, region, city, etc. A full list of available parameters can be found in [[:Category:Country data templates]]. For example, [[:Template:Country data Poland]] is used when the ''name'' parameter is specified as <code>Poland</code>. Many flags are also available via shortened "aliases", such as standard three letter country codes as specified by [[ISO 3166-1 alpha-3]], [[List of IOC country codes|IOC]], or [[List of FIFA country codes|FIFA]]. The list of available "aliases" are found in [[:Category:Country data redirects]]. Many of these country codes could be considered obscure, so it is recommended to use the full country name.
;variant: The second parameter is optional, and identifies a flag variant to be used instead of the standard flag. This is most often used for historical flags but can also be used to specify naval flags, sport-use flags, etc. The list of available flag variants for each country is documented on the specific page for the country data template. For example, [[Template:Country data Poland]] includes a description of each of the available flag variations for Poland. This parameter can be a named parameter (e.g. "<code>variant=1815</code>"), or a positional parameter, always after the country name.
;size: This parameter is optional, and is used to specify the maximum width and/or height of the flag image. This parameter is specified using standard [[Wikipedia:Extended image syntax|image syntax]].
 
==Contoh Penggunaan ==
<code><nowiki>{{flagicon|name|variant=|size=|noredlink=}}</nowiki></code>
;nama: Parameter pertama ini wajib, dan mengidentifikasi nama dari negara, wilayah, kota, dll. Daftar lengkap parameter yang tersedia dapat dilihat pada [[:Kategori:Templat data negara]]. Sebagai contoh, [[:Templat:Country data Polandia]] digunakan ketika parameter ''name'' diisi dengan <code>Polandia</code>. Beberapa bendera juga tersedia dengan "alias" singkatan, seperti kode negara tiga-huruf [[ISO 3166-1 alpha-3]], [[Daftar kode negara Komite Olimpiade Internasional|IOC]], atau [[Daftar kode negara FIFA|FIFA]]. Daftar "alias" untuk setiap negara dicantumkan di halaman templat terkait. Kode negara ini dapat berubah-ubah, sehingga disarankan untuk menggunakan nama lengkap saja.
;varian: Parameter kedua ini opsional, dan mengidentifikasi jenis bendera yang akan ditampilkan selain bendera standar. Paling sering digunakan untuk menampilkan bendera masa lalu tetapi juga dapat digunakan untuk bendera angkatan laut, bendera untuk olahraga (apabila berbeda), dll. Daftar variant untuk setiap negara dicantumkan di halaman templat terkait. Sebagai contoh, dalam [[Templat:Country data Polandia]] tersedia berbagai jenis bendera yang berbeda-beda untuk Polandia. Parameter ini dapat berupa parameter nama (seperti "<code>variant=1815</code>"), atau parameter posisional, selalu setelah nama negara.
;size: Parameter ini juga opsional, dan digunakan untuk mengatur lebar dan/atau tinggi maksimum gambar bendera. Parameter ini dijelaskan menggunakan sintaks gambar standar.
 
== Templat terkait data==
{{TemplateData header}}
<templatedata>
{
"description": "Templat ini menampilkan bendera wikilink dari parameter bernama dalam ukuran 'ikon', saat ini 23×15 piksel (ditentukan dalam Templat: Ikon bendera/inti) ditambah batas satu piksel.",
"params": {
"1": {
"label": "Nama",
"description": "Nama negara, wilayah, kota, dll.; nama lengkap direkomendasikan untuk negara",
"type": "string",
"required": true
},
"variant": {
"label": "Varian",
"description": "Mengidentifikasi varian bendera untuk digunakan sebagai pengganti bendera standar, mis. 1815",
"type": "string",
"required": false,
"aliases": [
"2"
]
},
"size": {
"label": "Dimensi maksimum",
"description": "Lebar atau tinggi maksimum, ditentukan melalui 'sintaks gambar diperpanjang' standar' (e.g. x30px)",
"type": "string",
"required": false
},
"noredlink": {
"label": "No redlink",
"description": "Jika disetel ke nilai apa pun yang dievaluasi sebagai benar (yaitu '1', 'true', 'yes', atau 'y'), ini tidak menampilkan apa pun jika file data negara tidak ada. (Defaultnya adalah menampilkan redlink)",
"type": "string",
"required": false
}
}
}
</templatedata>
 
== Contoh ==
{| class="wikitable"
! Markup wiki !! Tampilan !! Catatan
Baris 30 ⟶ 67:
|}
 
== Implementasi ==
Templat ini menggunakan templat data yang ada di [[:Kategori:Templat data negara]], yang mengandung data '''apa''' yang akan ditampilkan, dan pemformat [[Templat:Country flagicon2]], yang mengandung ''logic'' '''bagaimana''' menampilkan data tersebut.
 
Baris 39 ⟶ 76:
* <code>flag alias</code> — nama berkas gambar yang akan ditampilkan
* <code>flag alias-xxxx</code> — nama berkas gambar varian bendera <code>xxxx</code>
* <code>alias</code> — digunakan untuk menampilkan atribut''alt alternatifattribute'' dari gambar (standar: "Flag of ''alias''")
 
==Kategori pelacakan==
== Templat terkait ==
*{{clc|Halaman yang menggunakan templat flagicon dengan parameter yang tidak diketahui}}
* [[Templat:flag]] digunakan untuk menampilkan teks berpranala-wiki di sebelah bendera. Teks yang ditampilkan akan sama dengan parameter yang digunakan, tetapi pranala tetap tertuju ke artikel negara yang bersangkutan (dalam contoh ini, [[Polandia]]).
Di mana <code><nowiki>{{Flagicon|Foo}}</nowiki></code> digunakan, tetapi <code><nowiki>Templat:Country data Foo</nowiki></code> tidak ada, kemudian [[WP:Red link|redlink]] ditampilkan, ''kecuali'' parameter {{para|noredlink|yes}} telah disetel. Di mana redlink ditampilkan, halaman ditambahkan ke kategori pelacakan: * [[:Kategori:Bendera dengan templat data negara tidak ada]] (populasi:{{PAGESINCATEGORY|Bendera dengan templat data negara tidak ada}})
** <code><nowiki>{{flag|Polandia}}</nowiki></code> → {{flag|Polandia}}
** <code><nowiki>{{flag|POL}}</nowiki></code> → {{flag|POL}}
* [[Templat:Flagcountry]] juga digunakan untuk menampilkan teks berpranala-wiki di sebelah bendera. Teks yang ditampilkan akan selalu sama, tanpa melihat apakah nama atau kode negara yang digunakan sebagai paramater.
** <code><nowiki>{{flagcountry|Polandia}}</nowiki></code> → {{flagcountry|Polandia}}
** <code><nowiki>{{flagcountry|POL}}</nowiki></code> → {{flagcountry|POL}}
 
<includeonly>
<!-- ADD CATEGORIES BELOW THIS LINE -->
[[Kategori:TemplatSistem templat bendera|{{PAGENAME}}]]
 
<!-- ADD INTERWIKIS BELOW THIS LINE -->
</includeonly><noinclude>{{kerjaansi|-iNu-}}[[Kategori:Dokumentasi templat]]</noinclude>
 
<includeonly>
[[ca:Plantilla:Bandera]]
[[cs:TemplateŠablona:Flagicon]]
[[cy:Nodyn:Eicon baner]]
[[en:Template:Flagicon]]
[[de:Vorlage:Flagicon]]
[[es:Plantilla:Flagicon]]
[[fr:Modèle:Flagicon]]
[[it:Template:Bandiera]]
[[ko:틀:국기그림]]
[[hr:Predložak:Zastavaikonica]]
[[hsb:Předłoha:Chorhoj]]
[[hu:Sablon:Zászló]]
[[it:Template:Bandiera]]
[[ja:Template:Flagicon]]
[[ko:틀:국기그림]]
[[no:Mal:Flagicon]]
[[pt:Predefinição:Flagicon]]
[[ro:Format:Flagicon]]
[[ru:Шаблон:Флаг]]
[[sl:Predloga:Ikonazastave]]
[[sv:Mall:Flaggikon]]
[[th:Templateแม่แบบ:Flagicon]]
[[tr:Şablon:Bayrakikonu]]
[[zh:Template:Flagicon]]
</includeonly>
[[ru:Шаблон:Флаг]]
 
</includeonly><noinclude>{{kerjaansi|-iNu-}}</noinclude>
== Templat terkait ==
* [[Templat:flagFlag]] digunakan untuk menampilkan teks berpranala-wiki di sebelah bendera. Teks yang ditampilkan akan sama dengan parameter yang digunakan, tetapi pranala tetap tertuju ke artikel negara yang bersangkutan (dalam contoh ini, [[Polandia]]).
** <code><nowiki>{{flag|Polandia}}</nowiki></code> → {{flag|Polandia}}
** <code><nowiki>{{flag|POL}}</nowiki></code> → {{flag|POL}}
* [[Templat:Flagcountry]] juga digunakan untuk menampilkan teks berpranala-wiki di sebelah bendera. Teks yang ditampilkan akan selalu sama, tanpa melihat apakah nama atau kode negara yang digunakan sebagai paramater.
** <code><nowiki>{{flagcountry|Polandia}}</nowiki></code> → {{flagcountry|Polandia}}
** <code><nowiki>{{flagcountry|POL}}</nowiki></code> → {{flagcountry|POL}}
 
==Alternatif untuk menghindari [[WP:PEIS|Pasca-perluasan termasuk ukuran]] batas Wikipedia==
 
Halaman dengan banyak ikon bendera mungkin mendekati atau melebihi batas [[WP:PEIS|Pasca perluasan termasuk ukuran]] Wikipedia. Dalam kasus ini, pertimbangkan untuk menggunakan modul atau templat module-wrapper sebagai gantinya:
* {{tl|flagg}} adalah pembungkus sederhana untuk [[Modul:Flagg]]: Untuk penggunaan dasar, <code><nowiki>{{flagicon|</nowiki>''country''<nowiki>}}</nowiki></code> bisa diganti dengan <code><nowiki>{{flaggi>cxxloi></nowiki>''negara''<nowiki>}}</nowiki> </code>
 
==Lihat Juga==
* [[de:VorlageTemplat:Flagicon image]]
* [[Templat:Lambang]]
* [[Wikipedia:Templat Bendera WikiProject]]
* [[Simbol indikator wilayah]]