Wikipedia:Sintaks imej lanjutan

Daripada Wikipedia, ensiklopedia bebas.
Jump to navigation Jump to search

Secara ringkas, sintaks pemaparan imej ialah (lihat Sintaks multimedia untuk sintaks tambahan untuk fail bunyi dan multimedia):

[[Imej:Nama|Jenis|Sempadan|Lokasi|Penjajaran|Saiz|Pautan|alt=Alt|Kapsyen]]

Hanya Nama diperlukan. Kebanyakan imje harus menggunakan "[[Imej:Nama|thumb|alt=Alt|Kapsyen]]" dan tidak perlu menetapkan saiznya. Butiran-butiran lain adalah tidak wajib dan tidak mengira susunannya.

Jenis 
"thumb" [imej kenit] (atau "thumbnail"; boleh diikuti sama ada oleh "=filename"), "frame" [bingkai] (atau "framed"), atau "frameless" [tanpa bingkai[. Paparkan imej dengan pemformatan tertentu (lihat di bawah).
Sempadan 
"border". Meletakkan sempadan kecil di keliling imej.
Lokasi 
"right" [kanan], "left" [kiri], "center" [pusat] atau "none" [tiada]. Menentukan peletakan mengufuk imej dalam laman. Tersedia di "right" untuk imej kenit.
Penjajaran 
"baseline" [asas], "middle" [tengah], "sub", "super", "text-top" [atas teks], "text-bottom" [bawah teks], "top" [atas], atau "bottom" [bawah]. Menentukan peletakan menegak imej dari segi teks yang bersebelahan. Tersedia di "middle".
Saiz 
"Lebarpx" atau "xTinggipx" atau "LebarxTinggipx" atau "upright" [tegak] atau "upright=Faktor". Skalakan imej supaya tidak melebihi ukuran yang dinyatakan sambil mengekalkan nisbah bidangnya. Dengan "upright", skalakan imej kenit dari saiz tersedianya dengan faktor yang dinyatakan (tersedia 0.75) untuk membundarkan hasilnya kepada pekali terdekat 10 piksel.
Pautan 
Pautkan imej kepada sumber berlainan, atau tiada apa.
Alt 
Nyatakan teks alt untuk imej ini. Ini dikhususkan untuk pembaca yang mengalami masalah penglihatan.
Kapsyen 
Nyatakan kapsyen imej.

Tak kira sama ada fail itu dari Wikimedia Commons mahupun Wikipedia, sintaks yang digunakan tetap sama.

Cara memaparkan imej dalam saiz termuat naik, dengan kapsyen[sunting sumber]

Untuk memaparkan imej sebagai dimuat naik dengan kapsyen, gunakan [[Imej:Westminstpalace.jpg|frame|none|alt=teks alt|teks kapsyen]].

teks alt
teks kapsyen

Cara memaparkan imej tanpa kapsyen atau pemformatan[sunting sumber]

Sintaks laman dan sintaks lama untuk gambar tanpa kapsyen adalah [[Imej:Westminstpalace.jpg|alt text]]. Ini dipaparkan dalam baris, dan teks yang diisikan itu digunakan sebagai atribut alt imej (teks alternatif untuk program yang tidak boleh memaparkan imej, seperti pembaca skrin) dan sebagai atribut tajuk (teks tambahan yang sering dipaparkan sebagai petua alatan [tool tip] apabila kursor tetikus berada di atas imej).

Contoh[sunting sumber]

teks alt

Sintaks baru untuk imej[sunting sumber]

Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.
Istana Westminster

Sintaks baru ini serasi ke belakang, supaya rencana tidak perlu diubah.

Dalam sintaks [[Imej:filename|options]] (e.g., [[Imej:Westminstpalace.jpg|thumb|100px|left|alt=Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.|Istana Westminster]] yang ditunjukkan di kiri), anda juga boleh menetapkan beberapa pilihan apabila menyertakan imej, seperti kedudukan imej, saiznya atau cara imej itu disampaikan. Pilihannya ialah right, left, center, none, saizpx, thumbnail (thumb), frame, dan teks (kapsyen) alternatif.

Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.
Dari Sungai Thames
  • Pilihan-pilihan ini boleh digabungkan; tanda garis menegak ini ("|") digunakan untuk memisahkan pilihan-pilihan itu.
  • Jangan isikan jarak di sebelah garis menegak itu semata-mata untuk memudahkan pembacaan, kerana pilihan-pilihan itu mungkin tidak ditafsir dengan betul.
  • Pilihan-pilihan ini tidak mengikut urutan tertentu.
  • Pilihan yang tidak dikenali diambil sebagai teks kapsyen, hanya jika thumbnail atau frame dinyatakan.
  • Jika terdapat lebih daripada satu pilihan yang tidak dikenali, yang terakhir diambil kira: [[ Imej:Westminstpalace.jpg|thumb|alt=Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.|Istana Westminster|200px|right|Dari Sungai Thames]] (ditunjukkan di kanan).

Berikut ialah pemerian pilihan-pilihan teks kapsyen:

right[sunting sumber]

Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.

Imej ini dijajarkan ke kanan, dan teks terapung ke kiri imej: [[Imej:Westminstpalace.jpg|right|70px|alt=Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.]] (ditunjukkan di kanan).


left[sunting sumber]

Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.

Imej ini dijajarkan ke kiri, dan teks terapung ke kanan imej: [[Imej:Westminstpalace.jpg|left|70px|alt=Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.]] (ditunjukkan di kiri).


center[sunting sumber]

Imej ini dijajarkan ke pusat, dan...

Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.

teks selepas imej ini bermula di bawahnya: [[Imej:Westminstpalace.jpg|center|70px|alt=Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.]] (ditunjukkan di atas).


none[sunting sumber]

Imej ini dijajarkan ke kiri, dan...

Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.

teks selepas imej ini tidak terapung ke kanan (mahupun ke kiri), dan bermula di bawahnya: [[Imej:Westminstpalace.jpg|none|70px|alt=Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.]] (ditunjukkan di atas).


Catatan:
Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.
Keempat-empat pilihan di atas tidak saling serasi. Jika digunakan sekaligus, yang pertama mengatasi yang lain: [[Imej:Westminstpalace.jpg|center|left|none|right|70px|alt=Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.]] (ditunjukkan di pusat).
Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.
Apa yang berada di antara tanda garis menegak dan tanda kurungan penutup ("]]"), kosong atau tidak, diambil sebagai pilihan terakhir yang berfungsi seperti biasa. Misalnya, apabila pilihan terakhir ialah right, maka imejnya dijajarkan ke kanan, dan teksnya terapung ke kiri: [[Imej:Westminstpalace.jpg|70px|alt=Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.|right]] (ditunjukkan di kanan).
Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.
Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.
Teks ini dipaparkan.
Terutamanya, jika pilihan terakhir ialah teks kosong (iaitu, tiada apa di antara tanda garis menegak terakhir dan tanda kurungan penutup), kapsyennya tidak dipaparkan: [[Imej:Westminstpalace.jpg|thumb|alt=Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.|Teks ini tidak dipaparkan.|70px|left|]] (ditunjukkan di kiri) dan [[Imej:Westminstpalace.jpg|thumb|alt=Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.|Teks ini dipaparkan.|70px|right]] (ditunjukkan di kanan).
saizpx 
Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.
Pilihan ini memaparkan satu versi imej yang berlebar [saiz] piksel (e.g., [[Imej:Westminstpalace.jpg|right|50px|alt=Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.]] ditunjukkan di kanan). Ketinggian dikira secara automatik untuk menjaga perkadaran saiz imej)
Catatan:
Menentukan saiz bukan sahaja menukar saiz imej yang nyata dengan menggunakan HTML; ia sebenarnya menjana versi imej yang baru pada laman rencana lalu membuat pautan kepada laman imej asal. Ini berlaku sama ada anda menentukan saiznya bersama "thumb" atau tidak.
Ini bermakna pelayan melakukan segala kerja mengubah saiz imej, bukan pelayar web pengguna. Dengan menyerahkan semua kerja kepada pelayan, laman boleh dimuat turun dengan lebih cepat. Ini juga bererti imej yang lebih besar boleh disimpan dalam pelayan tanpa mengalami kelambatan proses muat turun (khususnya dalam talian telefon dailan.) Hanya data untuk saiz sebenar pada laman itu dipancarkan.
Kecuali GIF animasi yang tidak diproses oleh pelayan. Apabila ditentukannya saiz yang lebih kecil, GIF animasi asal yang bersaiz penuh dipaparkan pula. Sama ada GIF animasi itu diskalakan supaya muat dengan ruang yang diperuntukkan bergantung pada keupayaan pelayar yang menerimanya. Melaraskan saiz GIF animasi akan banyak merendahkan mutunya tanpa mengurangkan masa muat turun.
Dari MediaWiki 1.5 lebar imej kenit tersedia boleh ditentukan dalam keutamaan, maka adala disaran supaya tidak menetapkan "px" untuk menghormati keutamaan pengguna (melainkan saiz tertentu diperlukan tanpa mengira keutamaan atas sebab-sebab tertentu, atau satu saiz ditentukan di luar julat lebar 120–300px yang boleh ditentukan dalam keutamaan pengguna).
Jika anda tentukan pilihan "frame", imejnya tidak diskalakan, dan tiada penentu saiz akan digunakan dalam HTML. Imej itu akan dipaparkan pada saiz penuh
Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.
Jika terdapat dua atau lebih pilihan "saiz", hanya yang terakhir diterima: [[Imej:Westminstpalace.jpg|right|50px|80px|alt=Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.]] (ditunjukkan di kanan).
thumbnail, thumb 
Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.
Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.
Istana Westminster
Pilihan thumbnail (thumb) menjana imej. Saiznya ditentukan secara automatik jika atribut "saiz" tidak ditetapkan. Tanpa pilihan left, center, dan none, imejnya terus terletak di kanan. Jika imej ada teks kapsyen, teks itu dipaparkan di birai bawahnya. Cth., [[Imej:Westminstpalace.jpg|thumbnail|left|100px|alt=Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.]] (ditunjukkan di kiri) and [[Imej:Westminstpalace.jpg|thumb|alt=Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.|Istana Westminster]] (ditunjukkan di kanan). Catatan: thumbnail (thumb) tidak boleh digunakan dalam senarai.


upright 
Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.
Pilihan "upright" adalah sekitar 75% lebar imej kenit.
Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.
Pilihan "upright=1.5"
Pilihan upright berkesan dalam gabungan bersama option thumbnail atau thumb untuk mensaizkan semula imej kepada sekitar 75% lebar imej kenit (thumbnail) yang biasa. Pilihan upright membesarkan atau mengecilkan imej berasaskan leraian (resolusi) skrin pengguna. Saiz relatifnya boleh ditentukan dengan pekali seperti upright=x. Jika x=1 maka imejnya adalah lebar imej kenit yang biasa. Cth., [[Imej:Westminstpalace.jpg|thumbnail|upright|left|alt=Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.|Pilihan "<code>upright</code>" adalah sekitar 75% lebar imej kenit.]] (ditunjukkan di kiri) dan [[Imej:Westminstpalace.jpg|thumb|upright=1.5|right|alt=Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.|Pilihan "<code>upright=1.5</code>"]] (ditunjukkan di kanan).
frame 
Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.
Istana Westminster
Dengan pilihan ini, imej yang dibenamkan itu ditunjukkan dengan saiz asalnya ditutupi oleh bingkai, tanpa mengira atribut "thumb" atau "size", dan kapsyennya (jika ada) kelihatan dalam bingkai. Tanpa pilihan left, center, dan none, imej biasanya terletak di kanan: [[Imej:Westminstpalace.jpg|frame|thumbnail|50px|alt=Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.|Istana Westminster]].

Tanpa pilihan-pilihan selain saizpx dan alternate (caption) text, imej terbenam dipaparkan dalam baris.

text text text text text text
[[Imej:Westminstpalace.jpg|150px|alt=Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.|Istana Westminster]]
text text text text text
[[Imej:tst.png|100px|alt=glob halus|Ini ialah glob.]]
text text text text

menghasilkan

text text text text text text Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar. text text text text text glob halus text text text text

Pilihan none boleh digunakan untuk memaparkan imej kenik tanpa penjajaran ke kiri atau kanan. Ini mungkin paling sesuai untuk jadual. Cth:

Cara menggunakan none
Tempat di London
Istana Westminster
Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.
Dari Sungai Thames
[[Imej:Westminstpalace.jpg|thumb|none|100px|alt=Sebuah menara jam besar dan bangunan-bangunan lain membarisi sebatang sungai besar.|From the Thames]]
Istana Buckingham
Bangunan kota agam di bawah langit biru yang cerah dan berawan
Kediaman Ratu
[[ Imej:Buckingham palace Copyright2003KaihsuTai.jpg|thumb|none|100px|alt=Bangunan kota agam di bawah langit biru yang cerah dan berawan|Kediaman Ratu]]

Sintaks multimedia[sunting sumber]

Sintaks lanjutan juga boleh digunakan apda fail bunyi dan video. Dalam contoh-contoh ini, Fail:, ruang nama yang bersamaan dengan Imej, digunakan. Mana-mana ruang nama boleh digunakan.

Fail bunyi (Ogg)[sunting sumber]

Ikon penerangan fail 
"noicon". Jangan paparkan ikon yang berpaut dengan laman penerangan fail bunyi.

Biasanya, fail bunyi dalam format Ogg dibentangkan dalam laman Wikipedia dengan menggunakan Templat:Dengar atau templat-templat yang berkenaan. Akan tetapi, boleh juga membentangkan fail audio tanpa memakai apa-apa templat.

  Kod Output
1. [[Fail:Accordion chords-01.ogg]]
2. [[Fail:Accordion chords-01.ogg|noicon]]
3. [[Fail:Accordion chords-01.ogg|noicon|90px]]

Perhatikan bahawa tak satu contoh ini membuat pautan ke Wikipedia:Bantuan audio, dan contoh 2 dan 3 tidak menyediakan pautan yang berpandu arah ke fail-failnya sendiri. Maka, apabila kaedah ini digunakan, Templat:Inline audio mesti dipaparkan dalam laman ini, dan pembentangan butang main mesti diiringi oleh pautan yang boleh diklik ke laman bunyi. Cth:

  Kod Output
1. [[Fail:Accordion chords-01.ogg|90px|noicon|left]] [[:Fail:Accordion chords-01.ogg|Accordion chords]]
Accordion chords
2. [[:Fail:Accordion chords-01.ogg|Accordion chords]] [[Fail:Accordion chords-01.ogg|90px|noicon|right]] Accordion chords
3. [[:Fail:Accordion chords-01.ogg|Accordion chords]] [[Fail:Accordion chords-01.ogg|90px|noicon]] Accordion chords

Perhatikan bahawa penjajaran butang main secara menegak tidak berkesan, dan adalah mustahil untuk membentangkan butang main dalam baris dengan teks; oleh itu, susunan yang paling menyenangkan mata dicapai dengan contoh 1 atau 3.


Fail video (Ogg)[sunting sumber]

Untuk memaparkan video yang dimuat naik dengan kapsyen, gunakan [[Fail:First flights in aviation history.ogg|frame|none|alt=teks alt|teks kapsyen]].

caption text

Sintaks tambahan untuk video

Imej pegun permulaan 
"thumbtime=Masa". Gunakan bidang video pada kod masa yang diberi sebagai imej pegun permulaannya. Masa merupakan hitungan saat, atau jam, minit dan saat yang dipisahkan oleh tanda titik bertindih. Jika parameter thumbtime tidak dinyatakan, maka bidang di pertengahan video digunakan. Misalnya, dengan menggunakan fail video yang sama dengan di atas:
Lelaki memakai sut, tali leher dan topi kelihatan pada 21 saat. Sintaks masa dalam saat sahaja: "21"
Pesawat ekasayap kelihatan pada 23 saat. Sintaks masa dalam minit dan saat: "0:23"
Pesawat dwisayap di darat kelihatan pada 33 saat. Sintaks masa menggunakan jam, minit dan saat: "0:0:33"

Membesarkan paparan video kecil

Untuk melaraskan paparan video supaya lebih besar daripada saiz muat naiknya, gunakan"|thumb" dan "|numberpx". Ini mungkin berguna jika video aslinya terlalu kecil tetapi memaparkan butiran yang penting tapi kecil, tetapi ingat bahawa perbuatan menskala naik (upscale) ini boleh menyebabkan artifak (herotan yang mengaburkan gambar) dalam video. Misalnya, kod

[[Fail:cal16x16check_vdnocnoafr1len2.avi.q10.ogv|inline|left]] [[Fail:cal16x16check_vdnocnoafr1len2.avi.q10.ogv|right|thumb|128px]]

memaparkan video selebar 16 piksel pada saiz asalnya di kiri, dan lapan kali ganda lebarnya di kanan (petak-petaknya sepatutnya berwarna serba hitam atau serba putih, dan tepi-tepinya mestilah tajam - sebarang kekaburan atau kelunturan warna putih mungkin disebabkan oleh paparan pelayar atau pelayan Wikimedia):

Lihat juga[sunting sumber]