Help:Images/id

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  (tapi prefiks ruang nama warisan   masih didukung sebagai sinonim) sebagai target suatu pranala MediaWiki. Prefiks ruang nama  juga bisa digunakan untuk mengacu pada konten berkas media yang asli (untuk menampilkan atau mengunduhnya secara terpisah, di luar halaman MediaWiki apapun).

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.

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.
 * .ogg, .oga, .ogv : Multimedia (audio atau video) Ogg. Bukan format gambar, tapi diperlakukan dengan cara yang mirip. Biasanya digunakan dengan.
 * .pdf : dokumen multihalaman dalam Portable Document Format (awalnya ditetapkan oleh Adobe). Biasanya digunakan bersama dengan.
 * .djvu : dokumen bitmap multihalaman dalam format DejaVu (biasanya, pindaian buku). Lihat
 * 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.

Sintaks
Sintaks lengkap untuk menampilkan gambar adalah:

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


 * Pilihan format: salah satu antara border, frameless, frame, dan/atau thumb (atau thumbnail). Jika dari pilihan-pilihan tersebut beberapa dimasukkan, hanya yang pertama yang akan digunakan;
 * 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. (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
 * {lebar}x{tinggi}px — Mengatur ukuran agar muat dalam lebar dan tinggi yang diberikan dalam satuan piksel
 * upright — Mengatur gambar agar muat dengan dimensi yang masuk akal, sesuai dengan preferensi pengguna (cocok untuk gambar yang tingginya lebih besar daripada lebarnya). Mengatur  akan menampilkan gambar sesuai lebar gambar default pengguna.   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  tidak membutuhkan tanda sama dengan, jadi   tidak berbeda dengan.
 * Ketika digunakan tanpa nilai atau tanda sama dengan (contoh: ), default-nya menghasilkan   (meskipun   sama dengan  )
 * Jika  dan   dua-duanya ada,   yang pertama akan diabaikan. Lihat  untuk rinciannya.
 * Jika terdapat karakter spasi di antara "upright" dan tanda sama dengan (contohnya ), atau jika nilai "upright" mengantung karakter non-numerik, maka nilai   akan diabaikan. Lihat  untuk rinciannya.
 * 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  ditampilkan sebagai Example.jpg (pranala luar), atau   ditampilkan sebagai Example.jpg (pranala internal).
 * link= (dengan nilai kosong — (MediaWiki 1.14+) Menampilkan gambar tanpa pranala yang bisa diaktifkan; contohnya  ditampilkan sebagai Example.jpg.
 * Jika terdapat karakter spasi di antara  dan tanda sama dengan, pernyataan pranala akan dianggap sebagai keterangan gambar.


 * ! untuk MW 1.24 dan di bawahnya: Jika Anda menetapkan  (kosong), maka tidak ada   yang ditampilkan. (Lihat T23454.)
 * Pilihan-pilihan lainnya:
 * alt={teks alternatif} — (MediaWiki 1.14+) Mendefinisikan teks alternatif (memetakan kepada atribut HTML  dari elemen   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 penggguna di penjelajahnya).
 * Jika terdapat karakter spasi di antara  dan tanda sama dengan, pernyataan alt akan dianggap sebagai keterangan gambar.
 * page={nomor} — Akan menampilkan halaman sesuai nomor halamannya (untuk sekarang hanya diterapkan ketika menampilkan berkas .djvu atau .pdf).
 * class={kelas html} — (MediaWiki 1.20+) Mendefinisikan kelas (memetakan kepada atribut HTML  dari elemen   yang dihasilkan).
 * lang={kode bahasa} — (MediaWiki 1.22+) Untuk berkas SVG yang mengandung pernyataan &lt;switch&gt; 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.

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, 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, 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.

Dalam contoh di bawah, ukuran asli dari gambar adalah 400 x 267 piksel.
 * Untuk bagaimana penampilannya apabila tidak ditetapkan ukurannya, lihat bagian Format di atas.
 * Ketika format tidak ditetapkan, atau hanya di-, ukurannya bisa diperkecil maupun diperbesar menjadi ukuran berapapun.
 * Gambar dengan  selalu mengabaikan penetapan ukuran, gambar yang asli akan diperkecil apabila melebihi ukurang maksimum yang ditetapkan di preferensi pengguna.
 * Ukuran gambar dengan  atau   bisa diperkecil, tapi tidak bisa diperbesar lebih dari ukuran asli gambar.

Perataan horizontal
Perhatikan bahwa ketika menggunakan format  atau , perataan horizontal standarnya selalu.

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.



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:
 * 2) * 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.
 * 3) * ruang antar baris tambahan yang bisa ditambahkan dengan superskrip dan subskrip.
 * 4) 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).
 * 5) 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.
 * 6) 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.
 * 7) 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.

Stopping the text flow
On occasion it is desirable to stop text (or other inline non-floating images) from flowing around a floating image. Depending on the web browser's screen resolution and such, text flow on the right side of an image may cause a section header (for instance, == My Header == ) to appear to the right of the image, instead of below it, as a user may expect. The text flow can be stopped by placing   (or if you prefer,  ) before the text that should start below the floating image. (This may also be done without an empty line by wrapping the section with the floating images with …, which clears all floats inside the   element.)

All images rendered as blocks (including non-floating centered images, left- or right-floating images, as well as framed or thumbnailed floating images) are implicitly breaking the surrounding lines of text (terminating the current block of text before the image, and creating a new paragraph for the text after them). They will then stack vertically along their left or right alignment margin (or along the center line between these margins for centered images).

Altering the default link target
The following table shows how to alter the link target (whose default is the image description page) or how to remove it. Changing the link does not alter the format described in the previous sections.

Warning:
 * The licencing requirements on your wiki may not allow you to remove all links to the description page that displays the required authors attributions, the copyrights statements, the applicable licencing terms, or a more complete description of the rendered image (including its history of modifications).
 * If you change or remove the target link of an image, you will then have to provide somewhere else on your page an explicit link to this description page, or to display the copyright and author statement and a link to the applicable licence, if they are different from the elements applicable to the embedding page itself.
 * Your wiki policy may restrict the use of the alternate link parameter, or may even enforce a prohibition of alternate link parameters for embedded media files (in which case, the link parameter will be ignored), or may only accept them after validation by authorized users or administrators.

Gallery syntax
It's easy to make a gallery of thumbnails with the  tag. The syntax is:

Mode parameter
Starting in 1.22 a  parameter is available, taking options as follows:


 * is the original gallery type used by MediaWiki.
 * is similar to, but with no border lines.
 * causes images to have the same height but different widths, with little space between the images. The rows in this responsive mode organize themselves according to the width of the screen.
 * shows the caption overlaid on the image, in a semi-transparent white box.
 * is similar to, but with the caption and box only showing up on hover.
 * creates a slideshow of the images.

For example:

Gives (mode: packed-hover):

Optional gallery attributes
The gallery tag itself takes several additional parameters, specified as attribute name-value pairs:

Row of images that will wrap to browser width
One way that works for a row of images with varying widths is not to use "thumb" or "left" or "none". If "thumb" is not used (and thus no captions) a row of images will wrap to the browser width. If necessary, narrow the browser window to see the images wrap to the next row.





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

      </li>  </li>  </li>  </li>  </li>  </li> </ul>

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.

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:





Clicking on the below image will take you to 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:





Link to an image
Add  as a prefix to the link you need to create.

File:Wiki.png File:Wiki.png 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  can be used on MediaWiki pages:

[[Media:Wiki.png]]

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.

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

Obtaining the full URL of an image
To obtain the full path of an image (without going through redirects as shown above), some can be used.

Becomes:



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

Becomes:



Requisites
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.).

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.



Or with a different displayed text:

link text here

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

Example  rich   link text  here.

which renders as: Example  rich   link text  here.

If it is enabled on your wiki (see ), 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  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 has a value.