Templat:Flagicon/doc: Perbedaan antara revisi

Konten dihapus Konten ditambahkan
Borgx (bicara | kontrib)
kTidak ada ringkasan suntingan
RaFaDa20631 (bicara | kontrib)
Tidak ada ringkasan suntingan
 
(10 revisi perantara oleh 4 pengguna tidak ditampilkan)
Baris 1:
MenampilkanTemplat 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.
==Deskripsi==
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.
 
Harap baca dan cermati [[MOS:BENDERA]] sebelum menggunakan templat ini!
==Penggunaan==
 
<code><nowiki>{{flagicon|name|variant=|size=}}</nowiki></code>
== Penggunaan ==
;name: 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.
<code><nowiki>{{flagicon|name|variant=|size=|noredlink=}}</nowiki></code>
;variant: 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.
;namenama: 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.
;variantvarian: 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.
 
==ContohTemplat 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 29 ⟶ 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 40 ⟶ 78:
* <code>alias</code> — digunakan untuk menampilkan ''alt attribute'' 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>
Baris 53 ⟶ 87:
 
<!-- ADD INTERWIKIS BELOW THIS LINE -->
</includeonly><noinclude>[[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>[[Kategori:Dokumentasi templat]]</noinclude>
== Templat terkait ==
* [[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]]).
** <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]]