Bantuan:Gambar

This page is a translated version of the page Help:Images and the translation is 71% complete.
Outdated translations are marked like this.
PD Catatan: Ketika Anda menyunting halaman ini, Anda setuju untuk melepas kontribusi Anda di bawah CC0. Lihat Laman Bantuan Domain Publik untuk informasi lebih lanjut. PD

Halaman ini menjelaskan sintaks gambar ketika menyunting wiki. Anda atau pengguna lain biasanya harus mengunggah gambar sebelum Anda bisa menggunakannya di halaman.

Gambar yang disimpan di sebuah server MediaWiki biasanya ditampilkan menggunakan prefiks ruang nama File: (tapi prefiks ruang nama warisan Image: masih didukung sebagai sinonim) sebagai target suatu pranala MediaWiki. Prefiks ruang nama Media: juga bisa digunakan untuk mengacu pada konten berkas media yang asli (untuk menampilkan atau mengunduhnya secara terpisah, di luar halaman MediaWiki apapun).

Before using images in your page, the system administrator of your wiki must have enabled file uploads and a user has to upload the file. System administrators may also set the wiki to accept files from foreign repositories, such as the Wikimedia Commons. For server side image resizing it is necessary to have a scaler configured (such as GD2, ImageMagick, etc.).

Jenis media yang didukung untuk gambar

Format berkas berikut didukung secara standar:

  • .jpg atau .jpeg - gambar bitmap dimampatkan dalam format JPEG standar (format lossy ini paling cocok untuk hasil fotografi).
  • .png - gambar bitmap dalam format Portable Network Graphics (ditetapkan oleh W3 Consortium).
  • .gif - gambar bitmap dalam Graphics Interchange Format warisan.
  • .webp - WebP supports both lossy and lossless compression while reducing image size by up to 45%.

Fotmat lain yang digunakan di Wikimedia, dan biasanya diaktifkan di tempat lain (ini mungkin membutuhkan pengaturan lebih daripada yang diberikan secara standar):

  • .svg - gambar yang bisa diskalakan dalam format Scalable Vector Graphics (ditetapkan oleh W3 Consortium). Lihat Manual:Administrasi gambar#SVG.
  • .tiff - Format gambar ber-tag. Biasanya digunakan untuk foto arsip beresolusi tinggi. Biasanya digunakan dengan Extension:PagedTiffHandler .
  • .ogg, .oga, .ogv - Multimedia (audio atau video) Ogg. Bukan format gambar, tapi diperlakukan dengan cara yang mirip. Biasanya digunakan dengan Ekstensi:TimedMediaHandler .
  • .pdf - dokumen multihalaman dalam Portable Document Format (awalnya ditetapkan oleh Adobe). Biasanya digunakan bersama dengan Extension:PdfHandler .
  • .djvu - dokumen bitmap multihalaman dalam format DejaVu (biasanya, pindaian buku). Lihat Manual:How to use DjVu with MediaWiki
    Hanya satu halaman dari berkas .pdf atau .djvu yang ditampilkan pada satu waktu.

Jenis media lain mungkin didukung, tapi mungkin tidak bisa ditampilkan dalam barisan.

Menampilkan satu gambar

Sintaks

Sintaks lengkap untuk menampilkan gambar adalah:

[[File:filename.extension|options|caption]]

dengan options bisa jadi kosong atau pilihan-pilihan berikut ini, dipisahkan dengan pipa (|):

  • Pilihan format: salah satu antara border, frameless, frame (atau framed), dan/atau thumb (atau thumbnail). Note: border can be used in combination with frameless but will be ignored if used with one of the other options.
    Mengendalikan bagaimana gambar yang tampil diformat dan ditanamkan di halaman.
  • Pilihan mengatur ukuran: salah satu dari
    • {lebar}px — Mengatur ukuran gambar agar muat dalam lebar yang diberikan dalam satuan piksel, tanpa membatasi tingginya. (Hanya mendukung nilai piksel bilangan bulat. Karakter spasi di antara nilai lebar dan "px" diperbolehkan.)
    • x{tinggi}px — Mengatur ukuran gambar agar muat dengan tinggi yang diberikan dalam satuan piksel, tanpa membatasi lebarnya Hanya mendukung nilai piksel bilangan bulat. Karakter spasi di antara nilai lebar dan "px" diperbolehkan.
    • {lebar}x{tinggi}px — Mengatur ukuran agar muat dalam lebar dan tinggi yang diberikan dalam satuan piksel Hanya mendukung nilai piksel bilangan bulat. Karakter spasi di antara nilai lebar dan "px" diperbolehkan.
    • upright** upright — Mengatur gambar agar muat dengan dimensi yang masuk akal, sesuai dengan preferensi pengguna (cocok untuk gambar yang tingginya lebih besar daripada lebarnya). This option is often useful for images whose height is larger than their width. Requires either thumb or frameless. Mengatur |upright=1.0| akan menampilkan gambar sesuai lebar gambar default pengguna. |upright=2.0| akan menampilkan gambar yang dua kali lebarnya lebar default pengguna.
    Gambar akan selalu mempertahankan perbandigan aspeknya.
    Gambar dalam jenis media yang tidak bisa diskala bisa dikurang ukurannya, tapi tidak bisa diperbesar.
    Pengaturan upright tidak membutuhkan tanda sama dengan, jadi |upright 2.0| tidak berbeda dengan |upright=2.0|.
    Ketika digunakan tanpa nilai atau tanda sama dengan (contoh: |upright|), default-nya menghasilkan |upright=0.75| (meskipun |upright=| sama dengan |upright=1.0|)
    Ukuran maksimum standar bergantung pada format dan dimensi gambar internal (menurut jenis medianya).
  • Pilihan perataan horizontal: salah satu dari left, right, center, none. Jika dari pilihan-pilihan tersebut beberapa dimasukkan, hanya yang pertama yang akan digunakan
    Mengendalikan perataan horizontal (dan gaya dalam barisan atau pelayangan) dari gambar di dalam teks (tidak ada nilai standar).
  • Pilihan perataan vertikal: pilih satu dari baseline, sub, super, top, text-top, middle, bottom, dan text-bottom
    Mengendalikan perataan vertikal dari gambar dalam barisan yang tidak melayang dengan teks sebelum atau sesudah gambar, dan dalam blok yang sama (default-nya bernilai middle).
  • Pilihan pranala: pilih satu dari
    • link={target} — Membolehkan mengubah target pranala ke judul halaman manapun, atau ke URL, bisa diaktifkan di permukaan gambar yang dtiampilkan; contoh [[File:Example.jpg|20px|link=http://www.wikipedia.org]] ditampilkan sebagai   (pranala luar), atau [[File:Example.jpg|20px|link=MediaWiki]] ditampilkan sebagai   (pranala internal).
    • link= (dengan nilai kosong) — (MediaWiki 1.14+) Menampilkan gambar tanpa pranala yang bisa diaktifkan; contohnya [[File:Example.jpg|20px|link=]] ditampilkan sebagai  .
    Jika terdapat karakter spasi di antara link dan tanda sama dengan, pernyataan pranala akan dianggap sebagai keterangan gambar.
    Memasukkan beberapa karakter HTML yang ekuivalen, seperti %22 dengan ", bisa menyebabkan pernyataan pranala dianggap sebagai keterangan (lihat phabricator:T306216).
    ! untuk MW 1.24 dan di bawahnya: Jika Anda menetapkan |link=| (kosong), maka tidak ada title yang ditampilkan. (Lihat phabricator:T23454.)
  • Pilihan-pilihan lainnya:
    • alt={teks alternatif} — (MediaWiki 1.14+) Mendefinisikan teks alternatif (memetakan kepada atribut HTML alt="..." dari elemen ‎<img /> yang dihasilkan) dari gambar yang akan ditampilkan jika gambar yang diacu tidak bisa diunduh dan ditanamkan, atau jika dukungan media harus menggunakan teks deskripsi alternatif (misalnya, jika menggunakan pembaca Braille atau dengan pilihan aksesibilitas yang ditentukan oleh pengguna di penjelajahnya).
    Jika terdapat karakter spasi di antara alt dan tanda sama dengan, pernyataan alt akan dianggap sebagai keterangan gambar.
    • page={number}** $1={nomor} — Akan menampilkan halaman sesuai nomor halamannya (untuk sekarang hanya diterapkan ketika menampilkan berkas .djvu atau .pdf).
    • thumbtime={number}Renders a thumbnail from the video at the specified timestamp in seconds or MM:SS or HH:MM:SS format (only applicable when showing a video file).
    • start={number}When video playback is started it will start at the specified timestamp in seconds or MM:SS or HH:MM:SS format (only applicable when showing a video file).
    • mutedWhen media playback is started, audio will be muted.
    • loopMedia will loop continuously. (only applies to audio and video)
    • lossy={false} — (PagedTiffHandler ) For using PNG instead of JPG thumbnails for Tiff images
    • class={html class} — (MediaWiki 1.20+)** ‎<span>...‎</span>={kelas html} — ($2) Mendefinisikan kelas (memetakan kepada atribut HTML class="..." dari elemen ‎<img /> yang dihasilkan).
Default behavior since MediaWiki 1.40, optional since MediaWiki 1.36.[1]Previously the class was applied directly to the ‎<img /> element.[2]
    • lang={language code} — (MediaWiki 1.22+) ** $1={kode bahasa} — ($2) Untuk berkas SVG yang mengandung pernyataan <switch> yang berbeda sesuai dengan atribut systemLanguage-nya, memilih bahasa apa yang digunakan untuk menampilkan berkas. Standarnya adalah bahasa halaman (yang standarnya adalah bahasa default proyek dalam kebanyakan proyek).

Jika parameter tidak memenuhi semua pilihan di atas, maka akan diasumsikan bahwa itu merupakan teks keterangan. Jika terdapat lebih dari satu string non-parameter, string non-parameter yang terakhir akan digunakan sebagai keterangan. Teks keterangan ditampilkan di bawah gambar dalam format thumb dan frame, atau sebagai teks tooltip dalam format lainnya. Teks keterangan yang ditampilkan dalam format thumb dan frame bisa mengandung pranala wiki dan pemformatan lainnya. Ekstensi MediaWiki bisa menambahkan pilihan lain.

Jika 'alt' tidak ditentukan dan sebuah keterangan diberikan, teks alternatif akan dibuat secara otomatis dari keterangan, dihapus pemformatannya, kecuali ketika dalam mode thumb atau frame karena keterangannya sudah bisa dibaca oleh pembaca layar dalam kasus itu.

Perilaku standar yang sebenarnya adalah menampilkan berkas multimedia dalam ukurang lengkapnya. Ini bisa menyebabkan masalah responsivitas jika lebar berkas lebih besar daripada lebar halaman. Lihat Task phab:T113101 untuk detail lebih lanjut.


Format

Tabel berikut menunjukkan efek dari semua format yang tersedia.

Jika tinggi gambar dalam thumbnail lebih besar dari lebarnya (orientasinya portrait bukannya landscape) dan Anda merasa gambarnya terlalu besar, Anda bisa bencoba pilihan upright=N, dengan N melambangkan perbandingan aspek gambar (lebarnya dibagi tingginya, standarnya adalah 0,75). Cara lainnya adalah menetapkan tinggi maksimum (dalam satuan piksel) yang diinginkan secara eksplisit.

Perhatikan bahwa dengan menulis thumb={filename}, Anda bisa menggunakan gambar yang berbeda untuk thumbnailnya.

Ukuran dan bingkai

Dalam format yang berbeda, efek dari parameter ukuran juga bisa jadi berbeda, seperti yang akan ditampilkan di bawah.

  • Untuk bagaimana penampilannya apabila tidak ditetapkan ukurannya, lihat bagian Format di atas.
  • Ketika format tidak ditetapkan, atau hanya di-border, ukurannya bisa diperkecil maupun diperbesar menjadi ukuran berapapun.

Dalam contoh di bawah, ukuran asli dari gambar adalah 400 x 267 piksel.

  • Gambar dengan frame selalu mengabaikan penetapan ukuran, gambar yang asli akan diperkecil apabila melebihi ukurang maksimum yang ditetapkan di preferensi pengguna, dan informasi halaman akan menampilkan galat Linter.
  • Ukuran gambar dengan thumb atau frameless bisa diperkecil, tapi tidak bisa diperbesar lebih dari ukuran asli gambar.
Format Diperkecil Diperbesar
(tidak ditetapkan)
[[File:example.jpg|50px]]

 

[[File:example.jpg|500px]]

 


border
[[File:example.jpg|border|50px]]

 

[[File:example.jpg|border|500px]]

 


frame
[[File:example.jpg|frame|50px]]
 
[[File:example.jpg|frame|500px]]
 


thumb
[[File:example.jpg|thumb|50px]]
 
[[File:example.jpg|thumb|500px]]
 


frameless
[[File:example.jpg|frameless|50px]]

 

[[File:example.jpg|frameless|500px]]

 

Perataan horizontal

Perhatikan bahwa ketika menggunakan format frame atau thumb[nail], perataan horizontal standarnya selalu right untuk bahasa kiri-ke-kanan dan left untuk bahasa kanan-ke-kiri.

Deskripsi Anda mengetik Hasilnya
tidak ditetapkan perataan horizontalnya, atau perataan standar
Ditampilkan sebagai blok yang melayang: tidak
Ditampilkan sejajar baris: ya
... teks teks teks
[[File:example.jpg|100px|tulisan]]
teks teks teks ...
... teks teks teks

  teks teks teks ...

perataan horizontal ditetapkan sebagai: none
Ditampilkan sebagai blok yang melayang: tidak
Ditampilkan sejajar baris: tidak
... teks teks teks
[[File:example.jpg|none|100px|tulisan]]
teks teks teks ...
... teks teks teks
 
tulisan

teks teks teks ...

perataan horizontal ditetapkan sebagai: center
Ditampilkan sebagai blok yang melayang: tidak
Ditampilkan sejajar baris: tidak
... teks teks teks
[[File:example.jpg|center|100px|tulisan]]
teks teks teks ...
... teks teks teks
 
tulisan

teks teks teks ...

perataan horizontal ditetapkan sebagai: left
Ditampilkan sebagai blok yang melayang: ya
Ditampilkan sejajar baris: tidak
... teks teks teks
[[File:example.jpg|left|100px|tulisan]]
teks teks teks ...
... teks teks teks
 
tulisan

teks teks teks ...

perataan horizontal ditetapkan sebagai: right
Ditampilkan sebagai blok yang melayang: ya
Ditampilkan sejajar baris: tidak
... teks teks teks
[[File:example.jpg|right|100px|tulisan]]
teks teks teks ...
... teks teks teks
 
tulisan

teks teks teks ...

Perataan vertikal

Pilihan perataan vertikal hanya akan berpengaruh apabila gambar ditampilkan sebagai elemen dalam barisan dan tidak melayang. Mereka memengaruhi bagaimana gambar dalam barisan akan diratakan vertikal terhadap teks yang berada di blok yang sama sebelum dan/atau sesudah gambar ini di baris yang sama.

Perhatikan bahwa teks di mana gambar dalam barisan dimasukkan (dan barisan teks yang ditampilkan setelahnya) mungkin akan diturunkan (ini akan meningkatkan tinggi baris secara kondisional dengan tambahan spasi baris, seperti yang bisa terjadi pada teks dengan ukuran fon beragam, atau dengan superskrip dan subskrip) agar tinggi gambar bisa ditampilkan penuh dengan batasan perataan ini.

Beralih ke/dari mode kode sumber
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''top:''' [[File:Example.jpg|20px|top]] [[File:Example.jpg|40px|top]] [[File:Example.jpg|100px|top]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''text-top:''' [[File:Example.jpg|20px|text-top]] [[File:Example.jpg|40px|text-top]] [[File:Example.jpg|100px|text-top]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
<sup>super:</sup> [[File:Example.jpg|20px|super]] [[File:Example.jpg|40px|super]] [[File:Example.jpg|100px|super]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''baseline:''' [[File:Example.jpg|20px|baseline]] [[File:Example.jpg|40px|baseline]] [[File:Example.jpg|100px|baseline]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
<sub>'''sub:'''</sub> [[File:Example.jpg|20px|sub]] [[File:Example.jpg|40px|sub]] [[File:Example.jpg|100px|sub]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''default:''' [[File:Example.jpg|20px]][[File:Example.jpg|40px]] [[File:Example.jpg|100px]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''middle:''' [[File:Example.jpg|20px|middle]] [[File:Example.jpg|40px|middle]] [[File:Example.jpg|100px|middle]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''text-bottom:''' [[File:Example.jpg|20px|text-bottom]] [[File:Example.jpg|40px|text-bottom]] [[File:Example.jpg|100px|text-bottom]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''bottom:'' [[File:Example.jpg|20px|bottom]] [[File:Example.jpg|40px|bottom]] [[File:Example.jpg|100px|bottom]]
<del>text</del></u></span></p>

Untuk menampilkan hasil perataan dengan lebih jelas, teksnya digarisatasi dan digarisbawahi, ukuran fon diperbesar 200%, dan blok paragraf dikotaki dengan tepian tipis; serta beberapa gambar dengan ukuran berbeda diratakan:

text top:       text

text text-top:       text

text super:       text

text baseline:       text

text sub:       text

text default:       text

text middle:       text

text text-bottom:       text

text bottom:       text

Catatan:

  1. Posisi perataan vertikal "middle" dari gambar (yang juga merupakan standar) biasanya mengacu pada pertengahan antara tinggi-x dan garis dasar teks (di mana garis tengah gambar dijajarkan, dan di mana teks biasanya digaristengahi), tapi tidak pada pertengahan tinggi-baris dari tinggi fon yang mengacu pada ruang di antara posisi "text-top" dan "text-botttom"; tinggi fon tidak memasukkan:
    • spasi pembatas baris tambahan biasanya membagi rata menjadi dua margin baris (di sini 0,5em, menurut tinggi baris yang diatur menjadi 200%) di atas dan di bawah tinggi baris.
    • ruang antar baris tambahan yang bisa ditambahkan dengan superskrip dan subskrip.
  2. Namun, jika tinggi gambar menyebabkan posisi atas atau bawahnya menjadi di atas atau di bawah teks dengan tinggi-baris biasa, posisi tengah akan disesuaikan setelah meningkatkan margin-baris atas dan/atau bawah agar gambar bisa muat dan diratakan dengan benar, dan semua gambar (termasuk yang tingginya lebih kecil) akan ditengahkan secara vertikal di posisi tengah yang disesuaikan (untuk memperhitungkan tinggi-baris yang lebih efektif, teks dari masing-masing baris dengan tinggi-fon yang lebih besar akan dipertimbangkan).
  3. Posisi perataan "text-top" dan "text-bottom" juga tidak memasukkan ruang antar baris yang ditambahkan superskrip dan subskrip, tapi tetap memasukkan ruang antar baris tambahan dari tinggi-baris.
  4. Posisi perataan "top" dan "bottom" memperhitungkan semua ruang antar baris tambahan (termasuk superskrip dan subskrip, jika terdapat dalam jangkauan baris yang dihasilkan). When the image alignment constrains the image to grow above or below the normal line-spacing, and the image is not absolutely positioned, the image will cause the "top" and "bottom" positions to be adjusted (just like superscripts and subscripts), so the effective line-height between rendered lines of text will be higher.
  1. The "underline", "overline" and "overstrike" text-decoration positions should be somewhere within these two limits and may depend on the type and height of fonts used (the superscript and subscript styles may be taken into account in some browsers, but usually these styles are ignored and the position of these decorations may not be adjusted); so these decorations normally don't affect the vertical position of images, relatively to the text.

Menghentikan aliran teks

Dalam keadaan di mana diinginkan untuk menghentikan teks (atau gambar tidak melayang lainnya) agar tidak mengalir di sekitar gambar yang melayang. Bergantung pada resolusi layar peramban web dan sebagainya, aliran teks di sisi kanan gambar bisa menyebabkan judul baigan (contohnya, == Judul bagian ==) muncul di sisi kanan gambar, bukannya di bawahnya, seperti yang pengguna harapkan. Aliran teks bisa dihentikan dengan menaruh <br clear=all> (atau jika Anda lebih suka, <div style="clear: both"></div>) sebelum teks yang sebaiknya dimulai di bawah gambar melayang. (Ini juga bisa dilakukan tanpa baris kosong dengan cara membungkus bagian dengan gambar melayang menggunakan <div style="overflow: hidden"></div>, yang membersihkan semua pelayang di dalam elemen div.)

Semua gambar yang ditampilkan sebagai blok (di antaranya gambar center yang tidak melayang, gambar yang melayang di left atau right, serta gambar melayang frame atau thumbnail) secara implisit memecahkan barisan teks yang mengelilinginya (mematikan blok teks sebelum gambar, dan membuat paragraf baru untuk teks setelahnya). Mereka kemudian akan bertumpuk secara vertikal di margin perataan kiri atau kanan mereka (atau di garis tengah di antara margin untuk gambar center).

Mengubah target pranala default

Tabel berikut menunjukkan cara mengubah target pranala (yang standarnya adalah halaman keterangan gambar) atau cara menghapusnya. Mengubah pranala tidak mengubah format yang dijelaskan di bagian-bagian sebelumnya.

Peringatan:

Persyaratan lisensi di wiki Anda mungkin tidak membolehkan Anda menghapus semua pranala ke halaman keterangan yang menampilkan atribusi pembuat yang diharuskan, pernyataan hak cipta, ketentuan lisensi yang diterapkan, atau keterangan lebih lengkap dari gambar yang ditampilkan (termasuk riwayat perubahannya).
Jika Anda mengubah atau menghapus pranala target gambar, Anda harus memberikan di tempat lain di halaman Anda sebuah pranala eksplisit ke halaman keterangan, atau menampilkan pernyataan hak cipta dan pembuat serta pranala ke lisensi yang diterapkan, jika mereka berbeda dari elemen yang diterapkan ke halaman itu sendiri.
Kebijakan wiki Anda mungkin membatasi penggunaan parameter pranala alternatif, atau bahkan melarang parameter pranala alternatif untuk berkas media yang ditanam (dalam kasus tersebut, parameter pranala akan diabaikan), atau hanya menerima mereka setelah di validasi oleh pengguna yang berwenang atau pengurus.

Menampilkan galeri gambar

Sintaks galeri

Mudah untuk membuat galeri berisi thumbnail menggunakan tag ‎<gallery>. Sintaksnya adalah:

<gallery>
File:file_name.ext|caption|alt=alt language
File:file_name.ext|caption|alt=alt language
{...}
</gallery>

Perhatikan bahwa kode gambar tidak ditutup oleh tanda kurung siku ketika ditutup tag galeri.

Keterangan bersifat opsional, dan bisa mengandung pranala wiki atau pemformatan lainnya.

The words "center", "left", and "right" used as captions cause false-positive Linter errors. See task T275074 for details.

Beberapa parameter yang mengendalikan keluaran thumb bisa digunakan di sini, tepatnya yang mengubah berkas (bukan yang mengendalikan peletakan gambar). Misalnya, dengan media multihalaman seperti pdf, Anda bisa menggunakan kode seperti $code.

Prefiks File: bisa dihilangkan. Namun, akan membantu jika tetap dimasukkan untuk membantu menemukan penanda gambar dalam teks wiki (misalnya, ketika merapikan tata letak halaman).

Sebagai contoh:

<gallery>
File:Example.jpg|Item 1
File:Example.jpg|a link to [[Help:Contents]]
File:Example.jpg
File:Example.jpg|alt=An example image. It has flowers
File:Example.jpg|''italic caption''
File:Example.jpg|Links to external website|link=https://example.com
File:Example.jpg|link=w:Main_Page|Internal link
Example.jpg|on page "{{PAGENAME}}"
File:Using Firefox.pdf|page=72
</gallery>

diformat menjadi:

Parameter mode

Versi MediaWiki:
1.22

Mulai dari 1.22, tersedia sebuah parameter mode, dengan pilihan sebagai berikut:

  • traditional adalah jenis galeri yang aslinya digunakan oleh MediaWiki.
  • nolines mirip dengan traditional, tetapi tanpa garis pembatas.
  • packed menyebabkan gambar memiliki tinggi yang sama tetapi lebarnya berbeda, dengan sedikit ruang di antara gambar. Baris-baris dalam mode responsif ini mengatur diri mereka sendiri sesuai lebar layar.
  • packed-overlay menampilkan keterangan di depan gambar, dalam kotak putih semi-transparan.
  • packed-hover mirip dengan packed-overlay, tetapi keterangan dan kotaknya hanya muncul ketika kursor diarahkan ke depannya.
  • slideshow membuat rangkaian salindia dari gambar-gambarnya.

Contohnya:

<gallery mode="packed-hover">
Image:Astronotus_ocellatus.jpg|''[[commons:Astronotus ocellatus|Astronotus ocellatus]]'' (Oscar)
Image:Salmonlarvakils.jpg|''[[commons:Salmo salar|Salmo salar]]'' (Salmon Larva)
Image:Georgia Aquarium - Giant Grouper.jpg|''[[commons:Epinephelus lanceolatus|Epinephelus lanceolatus]]'' (Giant grouper)
Image:Pterois volitans Manado-e.jpg|''[[commons:Pterois volitans|Pterois volitans]]'' (Red Lionfish)
Image:Macropodus opercularis - front (aka).jpg|''[[commons:Macropodus opercularis|Macropodus opercularis]]'' (Paradise fish)
Image:Canthigaster valentini 1.jpg|''[[commons:Canthigaster valentini|Canthigaster valentini]]'' (Valentinni's sharpnose puffer)
Image:Flughahn.jpg|[[Image:POTY ribbon 2007.svg|25px]] ''[[commons:Dactylopterus volitans|Dactylopterus volitans]]'' (Flying gurnard)
Image:Fishmarket 01.jpg|''[[commons:Semicossyphus pulcher|Semicossyphus pulcher]]'' (California Sheephead)
Image:Pseudorasbora parva(edited version).jpg|''[[commons:Category:Pseudorasbora parva|Pseudorasbora parva]]'' (Topmouth gudgeon)
Image:MC Rotfeuerfisch.jpg|''[[commons:Category:Pterois antennata|Pterois antennata]]'' (Antennata Lionfish)
Image:Cleaning station konan.jpg|''[[commons:Novaculichthys taeniourus|Novaculichthys taeniourus]]''
Image:Synchiropus splendidus 2 Luc Viatour.jpg|''[[commons:Synchiropus splendidus|Synchiropus splendidus]]'' (Mandarin fish)
File:Psetta maxima Luc Viatour.jpg|''[[commons:Psetta maxima|Psetta maxima]]'' (Turbot)
File:Australian blenny.jpg|''[[commons:Category:Ecsenius|Ecsenius axelrodi]]''
</gallery>

Memberikan (mode: packed-hover):

Contoh untuk mode lain:

mode="traditional"

mode="nolines"

mode="packed"

mode="packed-overlay"

mode="packed-hover"

Versi MediaWiki:
1.28

mode="slideshow"

Atribut galeri opsional

Tag galeri sendiri menerima beberapa parameter tambahan, ditetapkan sebagai pasangan atribut nama-nilai:

<gallery {parameters}>
{images}
</gallery>
  • caption="{keterangan}": (teks keterangan di antara tanda petik untuk teks yang lebih dari satu kata) mengatur keterangan yang diletakkan rata tengah di atas galeri. Hanya teks polos yang digunakan dalam keterangan; pemformatan, templat, dan sejenisnya tidak akan bekerja.
  • widths={lebar}px: mengatur lebar (maksimum) gambar; nilai standarnya adalah 120px. (It has no effect if mode is set to one of the following: packed, packed-overlay, packed-hover, slideshow.) Perhatikan jamaknya: widths.
  • heights={tinggi}px: mengatur tinggi (maksimum) gambar; nilai standarnya adalah 120px. (It has no effect if mode is set to slideshow.)
  • perrow={bilangan bulat}: mengatur banyak gambar per baris. (It has no effect if mode is set to one of the following: packed, packed-overlay, packed-hover, slideshow.) 0 berarti menyesuaikan secara otomatis pada lebar layar.
  • showfilename={apapun}: Menampilkan nama berkas gambar dalam keterangan masing-masing gambar (1.17+).
  • mode={traditional|nolines|packed|packed-hover|packed-overlay|slideshow}: Lihat bagian di atas (1.22+; 1.28+ untuk "slideshow").
  • showthumbnails: Khusus mode "slideshow", tampilkan baris berisi thumbnail gambar di bawah rangkaian salindia secara default (1.29+).
Parameter lebar dan tinggi dianggap saran bukan nilai tegas dalam mode packed dan mode terkaitnya. Mode-mode packed akan menyesuaikan lebar gambar agar setiap baris memiliki panjang yang sama.
Contoh 1

Sintaksis:

<gallery widths=300px heights=200px>
File:Example.jpg|Lorem ipsum
File:Example.jpg|Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut
</gallery>

Hasil:

Contoh 2

Sintaksis:

<gallery widths=60px heights=60px perrow=7 caption="sunflowers are groovy">
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
</gallery>

Hasil:

Barisan gambar yang membungkus lebar peramban

Salah satu cara yang bekerja untuk menghasilkan sebaris gambar dengan lebar yang beragam adalah dengan cara tidak menggunakan "thum", "left", atau "none". Jika "thumb" tidak digunakan (sehingga tidak ada keterangan), maka sebaris gambar akan tampil sesuai lebar peramban. Jika perlu, sempitkan jendela peramban untuk melihat gambarnya masuk ke baris berikutnya.

[[File:Example.jpg|220px]]
[[File:Example.jpg|100px]]
[[File:Example.jpg|150px]]
[[File:Example.jpg|250px]]
[[File:Example.jpg|200px]]
[[File:Example.jpg|50px]]
[[File:Example.jpg|220px]]
[[File:Example.jpg|175px]]

               

To wrap images of varying widths with captions it is necessary to use div HTML for an unordered list. Along with style="display: inline-block;". For more info and ideas see: Give Floats the Flick in CSS Layouts.

<div><ul> 
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|220px|Caption 1]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|100px|Caption 2]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|150px|Caption 3]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|250px|Caption 4]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|200px|Caption 5]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|50px|Caption 6]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|220px|Caption 7]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|175px|Caption 8]] </li>
</ul></div>
  •  
    Caption 1
  •  
    Caption 2
  •  
    Caption 3
  •  
    Caption 4
  •  
    Caption 5
  •  
    Caption 6
  •  
    Caption 7
  •  
    Caption 8

To align the top edge of images add the vertical-align command

<div><ul> 
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|220px|Caption 1]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|100px|Caption 2]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|150px|Caption 3]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|250px|Caption 4]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|200px|Caption 5]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|50px|Caption 6]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|220px|Caption 7]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|175px|Caption 8]] </li>
</ul></div>
  •  
    Caption 1
  •  
    Caption 2
  •  
    Caption 3
  •  
    Caption 4
  •  
    Caption 5
  •  
    Caption 6
  •  
    Caption 7
  •  
    Caption 8

Some wiki farms do not have all gallery options (such as "widths"). Also, sometimes one wants varying widths for images in a row. Outside of a gallery, or the div HTML, it is impossible to have individual captions for images in a row of images that will wrap to the browser width. Try it and see. Nothing else using wikitext works correctly. Images will either overlap stuff on the right, or force a horizontal scroll bar.

Using a left float ("left") for some images, combined with "none" for some of the images, will not work consistently either, especially if there is also a right sidebar of images. Weird things will occur. At narrower browser or screen widths an image out of the row may appear far down the page after the end of the right sidebar of images.

Link behavior

By default an image links to its file description page. The "link=" option modifies this behavior to link to another page or website, or to turn off the image's linking behavior.

Alternatively, you can create a text link to a file description page or to the file itself. See Help:Linking to files .

Display image, link it to another page or website

Use "link=" option to link image to another page or website:

Clicking on the below image will take you to MediaWiki:

[[File:MediaWiki-2020-logo.svg|50px|link=MediaWiki]]

 

Clicking on the below image will take you to example.com:

[[File:MediaWiki-2020-logo.svg|50px|link=http://example.com]]

 

Display image, turn off link

Use "link=" option with no value assigned to turn link off entirely; the below image is not a link:

[[File:MediaWiki-2020-logo.svg|50px|link=]]

 

Link to an image

Add : as a prefix to the link you need to create.

[[:File:MediaWiki-2020-logo.svg]]

File:MediaWiki-2020-logo.svg

[[:File:MediaWiki-2020-logo.svg|Wiki]]

Wiki

Directly linking to an image

The above examples link to the image's description page. To directly link to an image, the pseudo-namespace Media: can be used on MediaWiki pages:

[[Media:MediaWiki-2020-logo.svg]]

Media:MediaWiki-2020-logo.svg

Direct links from external sites

Another possibility is to use the Special:Redirect/file page (or its alias Special:Filepath). Unlike the above example, you can link to it from external websites as well as from MediaWiki pages.

[[Special:Redirect/file/Wikipedia.png]]

The parameters height and width can also be added to return a specific size of the image. The image aspect ratio is always preserved.

https://www.mediawiki.org/w/index.php?title=Special:Redirect/file/Wikipedia.png&width=100&height=100

Obtaining the full URL of an image

To obtain the full path of an image (without going through redirects as shown above), some Bantuan:Kata ajaib can be used.

{{filepath:MediaWiki-2020-logo.svg}}

Becomes:

//upload.wikimedia.org/wikipedia/commons/d/dd/MediaWiki-2020-logo.svg

In the event that this is used from a template where the File: namespace needs to be removed, {{PAGENAME}} can do so:

{{filepath:{{PAGENAME:File:MediaWiki-2020-logo.svg}}}}

Becomes:

//upload.wikimedia.org/wikipedia/commons/d/dd/MediaWiki-2020-logo.svg

Files at other websites

You can link to an external file available online using the same syntax used for linking to an external web page. With these syntaxes, the image will not be rendered, but only the text of the link to this image will be displayed.

[http://url.for/some/image.png]

Or with a different displayed text:

[http://url.for/some/image.png link text here]

Additional MediaWiki markup or HTML/CSS formatting (for inline elements) is permitted in this displayed text (except for embedded links that would break the surrounding link):

[http://www.example.com/some/image.png Example '''<del>rich</del>''' ''<ins>link text</ins>'' here.]

which renders as:

Example rich link text here.

If it is enabled on your wiki (see Manual:$wgAllowExternalImages ), you can also embed external images. To do that, simply insert the image's URL:

http://url.for/some/image.png

Embedded images can be resized by the CSS transform property. They also may be formatted by surrounding MediaWiki markup or HTML/CSS code.

If this wiki option is not enabled, the image will not be embedded but rendered as a textual link to the external site, just like above, unless the site's Manual:$wgAllowExternalImagesFrom has a value.

Lihat pula