Wikipedia:Pedoman gaya/Kotak info

Halaman ini akan diajukan sebagai kebijakan, pedoman, atau proses. Proposal ini sedang dikembangkan, didiskusikan, atau sedang menjalani proses konsensus.

Pintas: WP:INFOBOX

Templat kotak info (bahasa Inggris: infobox) adalah panel yang umumnya muncul di sudut kanan atas artikel yang biasanya ditempatkan di sebelah kanan paragraf pertama artikel (pada versi desktop) atau di bawah paragraf pembuka artikel (pada versi seluler), yang merangkum hal-hal penting yang dibahas terhadap subjek. Templat kotak info dapat memuat gambar maupun peta, dan masih banyak lagi.

Hampir seluruh templat kotak info ditulis menggunakan fitur perangkat lunak templat. (Dapat juga dibuat menggunakan markah tabel, tetapi akan sukar untuk dirawat dan dikelola). Templat kotak info memiliki parameter yang dapat dengan mudah dikelola oleh pengguna ketika akan dimasukkan ke halaman. Hal ini akan memudahkan dalam menampilkan informasi yang relevan terhadap subjek, dengan sedikit pengkodean dalam artikel.

Tujuan

Berkaitan dengan aspek-aspek yang diperlukan dalam mendesain kotak info, harap untuk memastikan apa tujuan Anda membuat kotak info tersebut, yakni untuk merangkum (bukan memperjelas) fakta yang tersedia pada batang tubuh artikel. Sangat disarankan untuk memberikan informasi yang sesingkat-singkatnya pada kotak info sehingga efektif bagi para pembaca untuk mengidentifikasi fakta secara secara cepat. Tidak disarankan membuat pranala ke subbab atau sub-subbab, karena fitur "Daftar isi" sudah tersedia.

Beberapa pengecualian tertentu dapat dirumuskan, apabila informasi tersebut lebih cocok dimasukkan dalam kotak info. Contohnya kode ISO 639 dalam {{Infobox bahasa}} dan banyak sekali parameter dalam {{Chembox}}.

Menggunakan kotak info yang sederhana juga memungkinkan data dapat ditampilkan oleh pengguna pihak ketiga seperti DBpedia dalam format yang mudah terbaca mesin, sering kali menggunakan mikroformat. Kotak info boleh menampilkan data yang diimpor dari Wikidata (contohnya templat yang ada dalam Kategori:Templat kotak info yang menggunakan Wikidata), meski data yang diimpor wajib mematuhi kebijakan dan pedoman Wikipedia yang berlaku.

Merancang kotak info baru

Cara membuat

Secara umum, proses pembuatan kotak info cukuplah sederhana seperti mengumpulkan sebanyak-banyaknya persyaratan. Anda dapat menguji format kotak info sebagai tabel statis, kemudian dimigrasikan ke format templat bila konsensus oleh anggota lain di proyek Anda dicapai. Templat harus diperiksa sebelum digunakan secara ekstensif dalam artikel jika templat atau parameter perlu dimodifikasi untuk meminimalkan pengerjaan ulang. Jika bidang dan parameter baru ditambahkan, artikel yang menggunakan templat tersebut perlu diperbarui untuk mencerminkan persyaratan baru. Jika parameter diganti namanya atau dihapus, tidak akan mempengaruhi isinya, karena biasanya diabaikan.

Secara umum, kotak info dapat dibuat baru jika ada parameter yang memiliki ciri khas tertentu, atau tidak dapat digantikan dengan kotak info lain yang lebih cocok.

Gaya, warna, dan konsistensi

Pintasan

WP:GAYAINFOBOX

Konsistensi harus ditunjukkan pada setiap artikel yang menggunakan kotak info yang sama. Desain kotak info sangat disarankan menampilkan informasi yang sesingkat-singkatnya, dengan tampilan yang sederhana dan format terbaca mesin. Pedoman umum WP:NBSP (non-break spacing), WP:ANGKA (angka dan tanggal), dan WP:WARNA (penggunaan warna) dapat digunakan.

Gambar

Jangan menggunakan keluku (thumbnail) saat menambahkan gambar. Selalu gunakan InfoboxImage untuk membantu memformat gambar. Contohnya, untuk menambah File:Image PlaceHolder.png, Anda boleh menggunakan |image=Image PlaceHolder.png. Takarir harus disediakan menggunakan |caption=. Setiap kotak info berbeda-beda dan dokumentasi kotak info harus didiskusikan supaya memberikan kecocokan gambar dan takarir. Jika modul tersebut belum diimplementasikan, Anda boleh mengajukan permohonan untuk menambahkan modul tersebut ke templat.

Konsistensi

Untuk konsistensi, petunjuk berikut ini perlu dipertimbangkan:

Pastikan apakah templat kotak info lainnya (dengan penyajian yang sama) dapat digunakan untuk subjek tersebut. Jika sudah tersedia, tidak usah membuat baru lagi. Pengecualian ini dapat berlaku jika Anda ingin membuat wrapper dari kotak info induk untuk artikel topik tertentu.
Beri nama templat tersebut [[Templat:Infobox (masukkan jenis subjek di sini)]] atau [[Templat:Kotak info (masukkan jenis subjek di sini)]] (contohnya, "Infobox settlement" atau "Infobox cagar budaya").
Infobox wajib menggunakan {{infobox}} (memanggil Modul:Infobox) sebagai templat dasar.
Kepala kotak info harus ditulis dengan ukuran lebih besar daripada batang tubuh artikel, dan ditebalkan. Secara umum dapat diisi menggunakan nama umum atau nama legal (terutama organisasi dan perusahaan), tetapi jangan menggunakan markah pranala. {{PAGENAMEBASE}} dapat digunakan secara bawaan jika parameter kepala kotak info diabaikan untuk diisi.
Parameter harus:
- bernama (untuk memudahkan penggunaan lanjut);
- menggunakan huruf kecil, seperti |birth_date=), bukan kapital di tengah kata (misal |birthDate=) atau kapitalkan tiap kata (misal |BirthDate=), kecuali nama diri; serta
- konsisten di antara kotak-kotak info lainnya. Contohnya, {{Infobox person}} menggunakan |birth_date=, maka kotak info biografi lainnya juga menggunakan label tersebut alih-alih misalnya |date of birth=.
- Spasi diwakili sebagai tanda garis bawah (underscore), contohnya |birth_place= alih-alih |birth-place= atau |birth place=.
Templat kotak info objek geografi memerlukan nama parameter |coordinates=, dengan templat {{coord}} sebagai nilai isiannya. Untuk koordinat yang berasal dari Wikidata gunakan {{WikidataCoord}}.
Mohon tidak mengisi parameter yang informasinya tidak ada atau mengada-ada, karena templat kotak info sudah diprogram untuk menyembunyikan informasi yang tidak tersedia.

Alasan inkonsistensi

Alasan yang menyebabkan inkonsistensi:

Desain: Kotak info, termasuk turunan yang dispesifikasi untuk kategori tertentu, tetap harus menggunakan tampilan yang sama dengan kotak info terkait lainnya, berkaitan dengan tata letak, struktur, dan warnanya. Contohnya, setiap pembaca tentu berkeinginan supaya ada kesamaan penyajian antara Jakarta dengan New York City, atau Kota Semarang dengan Kabupaten Bantul.
Ketidaklengkapan historis: Informasi tertentu yang diinginkan dapat saja telah hilang seiring waktu. Contohnya, kotak info untuk artikel bank modern dapat memberikan informasi laporan keuangan yang tidak ada bila digunakan untuk bank abad pertengahan.
Hierarki: Kotak info yang menampil hubungan hierarkis dapat memiliki persyaratan yang berbeda bergantung kedudukan subjek dalam hierarkinya. Misalnya, kotak info perusahaan akan menampilkan penyajian yang berbeda antara artikel tentang perusahaan holding dan entitas anaknya.
Fitur: Item dalam satu set dapat memiliki fitur opsional yang biasanya ada di kotak info. Misalnya, kotak info untuk artikel tentang universitas mungkin memuat motto; tetapi tidak semua universitas memilikinya. Sama juga dengan artikel kabupaten, tidak semua kabupaten memiliki motto di lambangnya.
Kekurangan informasi: Beberapa item dalam kotak info dapat tidak tersedia, seperti produser album atau film. Dalam kasus ini, lebih baik memberikan informasi yang tersedia sambil menyembunyikan bidang yang informasinya mungkin tidak tersedia.

Pertimbangan desain

Ketersediaan bidang opsional bukan berarti semua bidang harus dibuat opsional, atau sejumlah bidang yang jarang digunakan harus ditambah tanpa memperhatikan tata letak dan kemudahan penggunaannya. Dalam beberapa kasus, markah untuk bidang masih perlu digunakan meskipun tidak ditampilkan. Tidak disarankan untuk membuat templat yang terlalu panjang dengan sejumlah bidang yang tidak relevan.

Mohon untuk bertanya kepada diri Anda sendiri berkait pertimbangan pembuatan kotak info baru:

Apakah bidang tersebut bermanfaat?: Apakah hanya sebatas ringkasan, atau detail yang mungkin lebih cocok ditempatkan pada dalam tubuh artikel?
Apakah bidang tersebut akan relevan dengan banyak artikel yang akan menggunakan kotak info?: Jika bidang tersebut hanya digunakan untuk sedikit sekali artikel, mungkin tidak boleh disertakan sama sekali. Namun, bidang yang sudah cukup umum dapat disertakan – dan dibuat opsional – meskipun tidak berlaku untuk banyak artikel bermasalah.
Seberapa besar kemungkinan bidang itu kosong?: Bidang apa pun yang kemungkinan dapat dikosongkan harus diset ke opsional. Namun, bidang yang kebanyakan kosong mungkin tidak berguna.
Dapatkah bidang tersebut digunakan kembali?: Misalnya, jika menambahkan bidang untuk tanggal kematian subjek, ke templat kotak info biografi, gunakan |death_date= dari {{Infobox person}}, bukan |date_of_death= atau |died=.
Apakah itu untuk tokoh atau organisasi?: Jika ya, gunakanlah microformat hCard.
Apakah itu untuk peristiwa?: Jika ya, gunakanlah microformat hCalendar.
Apakah menggunakan Wikidata atau manual saja?: Jika menggunakan Wikidata, gunakan Modul:WikidataIB.

Templat kotak info geografi

Pintasan

WP:INFOBOXGEO

Kotak info untuk objek geografis (misalnya kota dan negara) umumnya harus menggunakan judul artikel sebagai kepala di kotak infonya, meskipun nama resminya dalam bahasa Indonesia (misalnya Republik Indonesia untuk menyebut Indonesia) boleh dipakai. Jika judul artikel mempunyai disambiguasi, nama umum dapat dimasukkan ke kotak info, selama topiknya jelas (misalnya São Paulo untuk menyebut São Paulo (negara bagian)).

Templat dinamis

Secara teori, bidang dalam kotak info harus konsisten di setiap artikel yang menggunakannya. Dalam praktiknya hal ini jarang terjadi, karena beberapa alasan. Templat kotak info harus dirancang adaptif secara dinamis berkaitan ada tidaknya bidang tertentu.

Seperti templat statis, templat dinamis dirancang untuk menyajikan informasi ringkasan tentang subjek artikel, sehingga subjek serupa memiliki tampilan yang seragam dan dalam format yang sama. Teknik templat ini memungkinkan pemutakhiran gaya dan teks dari pusatnya, yakni halaman templat.

Meskipun ada cara untuk templat dinamis, seperti membuat percabangan templat atau membiarkan bidang yang kosong, penggunaannya secara umum dihindari, karena beberapa alasan:

Jumlah pembaca > jumlah penyunting: Kami mempertimbangkan pembaca Wikipedia, yang jarang melakukan penyuntingan yang berarti. Templat kotak info yang berisi banyak bidang kosong, tanda tanya, atau "Tidak diketahui" dapat menyebabkan tampilan artikel menjadi kurang profesional.
Jumlah penyunting > jumlah penyunting templat rutin > jumlah pengurus: Supaya meringankan beban mereka, kami mencoba untuk meminimalkan jumlah templat yang harus mereka urus. Oleh karena itu, membuat banyak percabangan templat tidak diperlukan, kecuali pembuatannya sudah didiskusikan di dalam proyek Anda.

Fungsi parser

Fungsi parser digunakan untuk menampilkan atau menyembunyikan konten tertentu secara selektif (seperti baris tabel) dalam kotak info berdasarkan nilai satu atau beberapa parameter templat.

Misalnya, parameter dirancang untuk ditampilkan hanya jika ada parameter lain. Pengujian sederhana untuk menampilkan takarir hanya jika parameter gambar telah diisi gambar dapat berupa:

| caption        = {{#if:{{{gambar|}}}|{{{takarir|}}} }}

Entri Wikidata

Desain dan pembuatan kotak info dengan basis Wikidata masih harus menyesuaikan dengan pedoman gaya ini, dan masih harus dianggap sebagai subhalaman dari templat induk, misalnya {{Infobox person/Wikidata}} harus menginduk pada {{Infobox person}}. Umumnya, entri Wikidata pada kotak info hanya boleh ditampilkan jika entri tersebut dilengkapi dengan referensi yang memenuhi kriteria sumber tepercaya. Selalu gunakan Modul:WikidataIB untuk memformat entri yang menggunakan Wikidata. Adapun contoh sintaksisnya adalah:

{{Infobox
...
| label1 = Pendapatan
| data1 = {{#invoke:WikidataIB |getValue |rank=best |P2139 |name=revenue |qual=P585 |qid={{{qid|}}} |fetchwikidata={{{fetchwikidata|ALL}}} |suppressfields={{{suppressfields|}}} |onlysourced=yes |noicon={{{noicon|no}}} |maxvals=1 |{{{revenue|}}}{{#if:{{{revenue_year|}}} | &nbsp;({{{revenue_year}}}) }} }}
...
}}

Interaksi antartemplat

Templat dapat dirancang dengan cara modular, sehingga berbagai kombinasi dimungkinkan. Kombinasi dua kotak info dapat muncul di halaman sebagai satu kotak info.

Contohnya, di artikel seorang penyanyi dapat memuat templat dasar {{Infobox person}} yang digabungkan dengan {{Infobox musical artist}}.

Menggunakan kotak info di artikel

Pintasan

PG:PAKAIINFOBOX

Penggunaan kotak info direkomendasikan untuk artikel tentang klasifikasi biologis tertentu, unsur dan senyawa kimia, peristiwa, tokoh, tempat (pemukiman, danau, dll.), organisasi (perusahaan, perkumpulan, yayasan, dll.), karya seni (album, lagu, seni rupa, dll.). Topik luas dan artikel ikhtisar seperti filsafat atau matematika biasanya lebih baik disajikan oleh bilah sisi navigasi seperti {{filsafat}}, atau {{MathTopicTOC}}. Artikel rintisan biasanya terlalu pendek untuk dimasukkan kotak info, dan para pengguna seringkali hanya memperluas kotak info daripada memperluas isi artikel. Meskipun begitu, boleh-boleh saja menggunakan kotak info di artikel rintisan.

Kotak info harus berisi fakta-fakta dasar yang sekilas masuk akal bagi pembaca, seperti tanggal lahir atau jumlah proton dalam suatu unsur. Jangan menggunakan kotak info sebagai tempat penyimpanan informasi yang terlalu panjang dan bertele-tele karena kekacauan visual dapat mempersulit pembaca untuk menangkap informasi yang paling penting secara ringkas dan cepat. Jika informasi tersebut dirasa penting tetapi terlalu panjang untuk disertakan dalam kotak info, pertimbangkan untuk menggunakan pranala ke bagian atau artikel khusus tentang topik tersebut. Misalnya, alih-alih mencoba memutuskan karya Chairil Anwar mana yang harus dicantumkan di kotak info, parameter |works= dapat dihubungkan ke pranala Daftar karya Chairil Anwar, dengan menggunakan sintaksis berikut: |works=[[Daftar karya Chairil Anwar]].

Setiap pemaknaan parameter dalam artikel harus menyesuaikan dengan dokumentasi templat. Sebagai contoh, parameter tinggi badan itu maksudnya apa? Apakah tinggi badan saat lahir, atau tinggi badan saat berusia 20 tahun? Apakah ada bukti yang dapat menunjukkan bahwa yang bersangkutan memiliki tinggi badan demikian? Oĺeh sebab itu, templat kotak info mengharuskan adanya dokumentasi terkait bagaimana seharusnya parameter digunakan.

Per pedoman gaya bendera, jangan menambahkan ikon bendera pada kotak info, kecuali dinyatakan lain dalam pedoman gaya tersebut.

Jika Anda merasa bingung tentang kotak info apa yang cocok untuk subjek artikel yang Anda buat, Anda dapat mendiskusikannya di halaman pembicaraannya.

Referensi di kotak info

Jika Anda merasa referensi untuk sebuah parameter di kotak info telah disediakan di paragraf artikel, kutipan tidak diperlukan. Namun, jika tidak ada referensi di paragraf artikel, Anda boleh memberikannya di kotak info. Pengguna sangat disarankan menempatkannya di paragraf artikel.

SARA, kebangsaan, dan kewarganegaraan

Pintasan

WP:SARAINFOBOX

Sesuai dengan konsensus permohonan pendapat di Wikipedia bahasa Inggris berkaitan dengan suku bangsa dan agama, parameter |ethnicity= dan |religion=, atau yang sejenis dengan itu yang mencerminkan suku, agama, ras, dan antargolongan (SARA) dilarang keras ada di kotak info biografi tokoh, kecuali kasus khusus tertentu (seperti tokoh agama yang menggunakan {{Infobox religious biography}}, boleh menggunakan parameter |religion=).

Kebanyakan templat biografi juga memuat parameter |nationality= dan |citizenship= (kebangsaan/kewarganegaraan). Kecuali ada perubahan status kebangsaan/kewarganegaraan subjek, penggunaannya dapat diabaikan karena kewarganegaraan dapat dijelaskan berdasarkan tempat lahir: |birthplace=. Penggunaan |nationality= dan |citizenship= jarang digunakan dan hanya dapat dijelaskan menggunakan prosa di batang tubuh artikel, kecuali jika tokoh yang bersangkutan melakukan proses naturalisasi untuk mengukuhkan status kewarganegaraannya. Tidak ada parameter yang boleh digunakan untuk menjelaskan suku bangsa asal subjek.

Menggabungkan, mengubah, menjadikan turunan, dan menghapus templat

Sebelum Anda mengusulkan, menggabungkan, mengubah, menjadikan turunan (wrapper), dan menghapus templat kotak info (dan (meta)-templat lainnya dengan penggunaan sangat banyak atau visibilitas tinggi), pertimbangkan hal-hal berikut:

Anda harus berkomunikasi dengan pengguna lain, pengurus, dan/atau komunitas ProyekWiki Anda supaya pengguna atau pengurus lain tahu, apa yang hendak diubah, digabungkan, atau dihapus. Gunakan halaman Pembicaraan templat.
Silakan mengetes setiap perubahan yang Anda buat di halaman bak pasir.
Setiap penyuntingan atau perombakan besar-besaran pada templat harus dikonsultasikan dengan semua pengurus dan/atau anggota komunitas ProyekWiki dengan menyertakan alasan yang jelas.

Suatu templat dapat dihapus atau digabungkan jika sudah tidak digunakan lagi di artikel mana pun. Alternatifnya, jika templat tersebut memungkinkan untuk digunakan di artikel, Anda boleh menambahkannya di artikel yang belum memiliki kotak info.

Lihat pula

Wikipedia:Templat/Kotak info — daftar utama
Semua halaman dengan judul yang diawali dengan Templat:Infobox, daftar halaman dengan judul "Templat:Infobox ..."
Semua halaman dengan judul yang diawali dengan Templat:Kotak info, daftar halaman dengan judul "Templat:Kotak info ..."

Petunjuk membuat dan menggunakan kotak info lainnya

Bantuan:Kotak info
Wikipedia:Wajib beri infobox, sebuah esai
Wikidata:Wikidata:Infobox Tutorial

Templat lainnya

Wikipedia:Templat navigasi — templat yang ditempatkan di bawah artikel untuk memberikan pranala ke artikel terkait
Wikipedia:Pesan antarmuka MediaWiki — pesan yang muncul dalam kotak antarmuka dan hanya dapat disunting oleh Pengurus
Wikipedia:Templat — daftar templat