Halaman ini menjelaskan mengenai sintaksis berkas untuk menampilkan suatu berkas gambar atau media lainnya di sebuah artikel wiki.

Sebelum dapat menampilkan berkas, Anda biasanya harus memuatkan (upload) berkas tersebut terlebih dahulu. Anda juga dapat menemukan berkas-berkas lokal yang telah dimuatkan pengguna lain di halaman berkas baru dan daftar berkas.

Selain berkas-berkas yang telah diunggah ke Wikipedia bahasa Indonesia, Anda juga dapat menampilkan langsung (tanpa perlu memuatkan kembali di sini) berkas-berkas dari Wikimedia Commons (gudang berkas dan media). Halaman gambar pilihan Commons mungkin dapat menjadi tempat kunjungan pertama Anda di Wikimedia Commons.

Halaman berkas

Setiap berkas yang dimuat memiliki halaman gambar atau halaman deskripsi gambar. Istilah ini digunakan tidak hanya untuk gambar, melainkan juga untuk jenis berkas lain, terutama berkas suara. Untuk berkas gambar, halaman ini akan menampilkan keseluruhan gambar atau tergantung dari preferensi pengguna, versi kecil yang jika diklik akan menampilkan versi penuhnya. Halaman ini digunakan pula sebagai halaman untuk memberikan informasi mengenai gambar atau berkas tersebut. Lihat pula: m:Help:Image page

Sintaksis

Sintaksis lengkap untuk menampilkan berkas adalah:

[[Berkas:{NamaBerkas}|{Parameter}]]

Parameter-parameter yang dapat digunakan (tidak diharuskan), masing-masing dipisahkan dengan karakter pipa (|):

Opsi Keterangan
tepi, bingkai, jmpl, atau nirbing Mengatur pemformatan gambar.

Jika dituliskan parameter jmpl={NamaBerkas}, maka akan ditampilkan miniatur gambar yang berbeda.

ki, ka, pusat, nir Mengatur penjajaran horisontal gambar di dalam teks.
garis_dasar, sub, super, atas, atas-teks, tengah, bawah, bawah-teks Mengatur penjajaran vertikal gambar pada baris teks.
{lebar}px Menampilkan gambar menurut ukuran lebar (piksel).
Ini adalah parameter yang paling umum digunakan di Wikipedia bahasa Indonesia.
x{tinggi}px Menampilkan gambar menurut ukuran tinggi (piksel).
{lebar}x{tinggi}px Menampilkan gambar menurut ukuran lebar dan tinggi (piksel)
pranala={tujuan} Mengatur pranala tujuan jika gambar diklik, bisa ke judul tertentu atau URL (MW 1.14+)

Parameter link tidak dapat digunakan bersamaan dengan thumb maupun frame.

pranala= Menampilkan gambar tanpa pranala (tidak bisa diklik). Contoh: [[Berkas:Nama.jpg|link=]].
alt={alternative text} Mengganti teks alternatif (alt="") suatu gambar (MW 1.14+).
hal=1 Kasus khusus. Menampikan halaman tertentu ketika menampilkan sebuah berkas djvu.

Parameter-parameter ini dapat diberikan tanpa memandang urutan. Jika suatu parameter berselisih dengan parameter lain, maka yang digunakan adalah parameter terakhir, kecuali untuk parameter pemformatan, yang memiliki prioritas urutan berikut: bingkai, jmpl, dan nirbing dan/atau tepi.

Jika suatu parameter yang dimasukkan tidak terdapat dalam tabel di atas, maka parameter tersebut akan dianggap sebagai teks judul dari gambar tersebut. Teks judul dapat berisikan pranala wiki dan pemformatan umum lainnya.


Tabel berikut menampilkan efek dari semua format yang ada.

Jika tinggi gambar dalam miniatur ternyata lebih lebar dari lebarnya, dan menurut Anda terlalu menonjol, Anda dapat mencoba parameter upright, yang akan mencoba untuk menyesuaikan ke ukuran yang lebih diinginkan.

Penjajaran (alignment)

Penjajaran horisontal

Perlu dicatat bahwa jika Anda menggunakan bingkai atau jmpl, maka secara standar gambar akan ditampilkan menggunakan parameter ka.

Keterangan Yang diketikkan Hasil tampilan

tanpa parameter penjajaran apapun, atau menyuruh program untuk menggunakan penjajaran standar

Menampilkan gambar pada artikel
Anda di Wikipedia itu mudah!
Ini adalah sebuah contoh 
penampilan gambar di Wikipedia,
[[Berkas:MediaWiki:Image sample|judul]]
sesuai dengan format yang telah
ditentukan. Anda dapat
menggunakan gambar atau foto
buatan Anda sendiri, menggunakan
gambar yang telah ada, ataupun
menggunakan gambar dari gudang
Wikimedia Commons.

Menampilkan gambar pada artikel Anda di Wikipedia itu mudah! Ini adalah sebuah contoh penampilan gambar di Wikipedia, [[Berkas:MediaWiki:Image sample|||judul]] sesuai dengan format yang telah ditentukan. Anda dapat menggunakan gambar atau foto buatan Anda sendiri, menggunakan gambar yang telah ada, ataupun menggunakan gambar dari gudang Wikimedia Commons.


parameter penjajaran nir

Menampilkan gambar pada artikel
Anda di Wikipedia itu mudah!
Ini adalah sebuah contoh 
penampilan gambar di Wikipedia,
[[Berkas:MediaWiki:Image sample|nir|judul]]
sesuai dengan format yang telah
ditentukan. Anda dapat
menggunakan gambar atau foto
buatan Anda sendiri, menggunakan
gambar yang telah ada, ataupun
menggunakan gambar dari gudang
Wikimedia Commons.

Menampilkan gambar pada artikel Anda di Wikipedia itu mudah! Ini adalah sebuah contoh penampilan gambar di Wikipedia, [[Berkas:MediaWiki:Image sample|nir||judul]] sesuai dengan format yang telah ditentukan. Anda dapat menggunakan gambar atau foto buatan Anda sendiri, menggunakan gambar yang telah ada, ataupun menggunakan gambar dari gudang Wikimedia Commons.


pusat

Menampilkan gambar pada artikel
Anda di Wikipedia itu mudah!
Ini adalah sebuah contoh 
penampilan gambar di Wikipedia,
[[Berkas:MediaWiki:Image sample|pusat|judul]]
sesuai dengan format yang telah
ditentukan. Anda dapat
menggunakan gambar atau foto
buatan Anda sendiri, menggunakan
gambar yang telah ada, ataupun
menggunakan gambar dari gudang
Wikimedia Commons.

Menampilkan gambar pada artikel Anda di Wikipedia itu mudah! Ini adalah sebuah contoh penampilan gambar di Wikipedia, [[Berkas:MediaWiki:Image sample|pusat||judul]] sesuai dengan format yang telah ditentukan. Anda dapat menggunakan gambar atau foto buatan Anda sendiri, menggunakan gambar yang telah ada, ataupun menggunakan gambar dari gudang Wikimedia Commons.


ki

Menampilkan gambar pada artikel
Anda di Wikipedia itu mudah!
Ini adalah sebuah contoh 
penampilan gambar di Wikipedia,
[[Berkas:MediaWiki:Image sample|ki|judul]]
sesuai dengan format yang telah
ditentukan. Anda dapat
menggunakan gambar atau foto
buatan Anda sendiri, menggunakan
gambar yang telah ada, ataupun
menggunakan gambar dari gudang
Wikimedia Commons.

Menampilkan gambar pada artikel Anda di Wikipedia itu mudah! Ini adalah sebuah contoh penampilan gambar di Wikipedia, [[Berkas:MediaWiki:Image sample|ki||judul]] sesuai dengan format yang telah ditentukan. Anda dapat menggunakan gambar atau foto buatan Anda sendiri, menggunakan gambar yang telah ada, ataupun menggunakan gambar dari gudang Wikimedia Commons.


ka

Menampilkan gambar pada artikel
Anda di Wikipedia itu mudah!
Ini adalah sebuah contoh 
penampilan gambar di Wikipedia,
[[Berkas:MediaWiki:Image sample|ka|judul]]
sesuai dengan format yang telah
ditentukan. Anda dapat
menggunakan gambar atau foto
buatan Anda sendiri, menggunakan
gambar yang telah ada, ataupun
menggunakan gambar dari gudang
Wikimedia Commons.

Menampilkan gambar pada artikel Anda di Wikipedia itu mudah! Ini adalah sebuah contoh penampilan gambar di Wikipedia, [[Berkas:MediaWiki:Image sample|ka||judul]] sesuai dengan format yang telah ditentukan. Anda dapat menggunakan gambar atau foto buatan Anda sendiri, menggunakan gambar yang telah ada, ataupun menggunakan gambar dari gudang Wikimedia Commons.

Penjajaran vertikal

Berikut adalah teks yang diketikkan:

Tanpa parameter: [[Berkas:Flower.jpg|20px]]
Garis_dasar: [[Berkas:Flower.jpg|20px|garis_dasar]]
Sub: [[Berkas:Flower.jpg|20px|sub]]
Super: [[Berkas:Flower.jpg|20px|super]]
Atas-teks: [[Berkas:Flower.jpg|20px|atas-teks]]
Tengah: [[Berkas:Flower.jpg|20px|tengah]]
Bawah: [[Berkas:Flower.jpg|20px|bawah]]
Bawah-teks: [[Berkas:Flower.jpg|20px|bawah-teks]]

dengan hasil tampilan berikut: (teks sengaja diberi garis bawah supaya hasilnya lebih mudah dilihat)

Tanpa parameter:   Garis_dasar:   Sub:   Super:   Atas-teks:   Tengah:   Bawah:   Bawah-teks:  

Ukuran dan bingkai

Di antara berbagai format, efek dari parameter ukuran (lebar/tinggi) dapat menghasilkan tampilan yang berbeda, sebagaimana ditampilkan di bawah ini.

Catatan:

  • Jika parameter format tidak dituliskan, atau hanya menggunakan tepi, ukuran tampilan gambar dapat diperkecil maupun diperbesar dari ukuran aslinya.
  • Gambar dengan parameter bingkai selalu mengabaikan parameter ukuran.
  • Ukuran gambar dengan parameter jmpl dan nirbing dapat diperkecil dari ukuran aslinya, tetapi tidak dapat diperbesar.

Untuk melihat bagaimana tampilan gambar jika ukurannya tidak dituliskan, lihat bagian Format di atas.

Format Diperkecil Diperbesar

(tanpa parameter)

[[Berkas:MediaWiki:Image sample|100px]]

[[Berkas:MediaWiki:Image sample||100px]]

[[Berkas:MediaWiki:Image sample|400px]]

[[Berkas:MediaWiki:Image sample||400px]]

Diperkecil Diperbesar

tepi

[[Berkas:MediaWiki:Image sample|tepi|100px]]

[[Berkas:MediaWiki:Image sample|tepi|100px]]

[[Berkas:MediaWiki:Image sample|tepi|400px]]

[[Berkas:MediaWiki:Image sample|tepi|400px]]

Diperkecil Diperbesar

bingkai

[[Berkas:MediaWiki:Image sample|bingkai|100px]]

[[Berkas:MediaWiki:Image sample|bingkai|100px]]

[[Berkas:MediaWiki:Image sample|bingkai|400px]]

[[Berkas:MediaWiki:Image sample|bingkai|400px]]

Diperkecil Diperbesar

jmpl

[[Berkas:MediaWiki:Image sample|jmpl|100px]]

[[Berkas:MediaWiki:Image sample|jmpl|100px]]

[[Berkas:MediaWiki:Image sample|jmpl|400px]]

[[Berkas:MediaWiki:Image sample|jmpl|400px]]

Diperkecil Diperbesar

nirbing

[[Berkas:MediaWiki:Image sample|nirbing|100px]]

[[Berkas:MediaWiki:Image sample|nirbing|100px]]

[[Berkas:MediaWiki:Image sample|nirbing|400px]]

[[Berkas:MediaWiki:Image sample|nirbing|400px]]

Membuat galeri gambar

Adalah mudah untuk membuat galeri miniatur gambar (thumbnails), hanya dengan menggunakan tag <gallery>. Sintaksisnya adalah:

<gallery>
Berkas:{filename}|{judul}
Berkas:{filename}|{judul}
{...}
</gallery>

Perlu dicatat bahwa kode gambar tidak perlu menggunakan tanda kurung siku jika menggunakan tag gallery ini.

Judul gambar tidak diharuskan, dan dapat merupakan pranala wiki ataupun pemformatan lainnya.

Parameter

Tag gallery sendiri memiliki beberapa parameter tambahan:

<gallery {parameter}>
{daftar gambar}
</gallery>
  • caption={judul}: menampilkan judul galeri.
  • widths={lebar}px: menentukan lebar gambar.
  • heights={heights}px: menentukan tinggi (maksimal) gambar.
  • perrow={angka}: menentukan jumlah gambar di setiap barisnya.
Contoh
Contoh sintaksis untuk galeri gambar sederhana
<gallery>
Berkas:Contoh.jpg|Gambar 1
Berkas:Contoh.jpg|Pranala ke [[Bantuan:Isi]]
Berkas:Contoh.jpg
Berkas:Contoh.jpg
Berkas:Contoh.jpg|''Format judul miring''
Berkas:Contoh.jpg|Ini halaman "{{PAGENAME}}"
</gallery>

akan menghasilkan tampilan sebagai berikut:

Hasil dari sintaksis galeri gambar sederhana

Tanpa bingkai

Contoh sintaksis untuk galeri gambar tanpa bingkai
<gallery mode=nolines>
Berkas:Wiki.png|1
Berkas:Wiki.png|2
Berkas:Wiki.png|3
Berkas:Wiki.png|4
</gallery>

akan menghasilkan tampilan sebagai berikut:

Hasil dari sintaksis untuk galeri gambar tanpa bingkai

Tengah & berbingkai

Contoh sintaksis untuk galeri gambar berada ditengah & berbingkai
<gallery class="center">
Berkas:Wiki.png|1
Berkas:Wiki.png|2
Berkas:Wiki.png|3
Berkas:Wiki.png|4
</gallery>

akan menghasilkan tampilan sebagai berikut:

Hasil dari sintaksis untuk galeri gambar berada ditengah & berbingkai

Galeri gambar dengan lapisan

Contoh sintaksis untuk galeri gambar dengan lapisan
<gallery mode=packed-overlay>
Berkas:Wiki.png|1
Berkas:Wiki.png|2
Berkas:Wiki.png|3
Berkas:Wiki.png|4
</gallery>

akan menghasilkan tampilan sebagai berikut:

Contoh sintaksis untuk galeri gambar dengan lapisan

Galeri dengan kursor (slideshow)

Contoh sintaksis untuk galeri gambar dengan kursor (slideshow)
<div style="max-width: 350px;">
<gallery mode=slideshow>
Berkas:Wiki.png|1
Berkas:Wiki.png|2
Berkas:Wiki.png|3
Berkas:Wiki.png|4
</gallery>
</div>

akan menghasilkan tampilan sebagai berikut:

Hasil dari sintaksis untuk galeri gambar dengan kursor (slideshow)

Galeri lainnya

Sintaksis
<gallery caption="Sample gallery" widths="160px" heights="120px" class="center" >
File:Wiki.png
File:Wiki.png|Captioned
File:Wiki.png|Captioned with alt text|alt=The Wikipedia logo
File:Wiki.png|[[Help:Contents/Links|Links]] can be put in captions.
File:Wiki.png|Full [[MediaWiki]] <br/>[[syntax]] may now be used...
</gallery>

akan menghasilkan tampilan sebagai berikut:

Hasil


Galeri lainnya (hover)

Sintaksis
<gallery mode=packed-hover>
Berkas:Wiki.png|1
Berkas:Wiki.png|2
Berkas:Wiki.png|3
Berkas:Wiki.png|4
</gallery>

akan menghasilkan tampilan berlapis apabila disentuh kursor, sebagai berikut:

Hasil

Pranala

Sebagai pranala ke halaman keterangan gambar

Jika Anda memberikan sebuah tanda titik dua (:) sebelum Berkas:, maka berkas gambar tidak akan ditampilkan dan hanya menampilkan sebuah pranala ke halaman keterangan berkas tersebut.

[[:Berkas:Flower.jpg]]
[[:Berkas:Flower.jpg|Gambar bunga]]

akan menghasilkan:

Sebagai pranala langsung ke berkas gambar

Anda dapat menggunakan ruang nama alias "Media" untuk memberikan pranala langsung ke berkas/gambar yang bersangkutan, tanpa melalui halaman keterangan gambar.

[[Media:Flower.jpg]]
[[Media:Flower.jpg|Gambar bunga]]

akan menghasilkan:

Anda juga dapat menggunakan: 

[[Istimewa:Lokasi berkas/MediaWiki:Image sample]]

sebagai pranala ke sebuah berkas, bahkan sekalipun berkas/gambar tersebut tidak ada. Anda juga dapat menggunakan:

{{FILEPATH:MediaWiki:Image sample}}

yang akan menghasilkan sebuah URL eksternal suatu berkas:

Lihat pula