Wikipedia:Lua

Ini adalah halaman informasi yang menerangkan konsensus komunal mengenai aspek norma dan praktik Wikipedia. Meski bukan berupa kebijakan atau pedoman, halaman ini bertujuan melengkapi atau mengklarifikasi praktik dan kebijakan Wikipedia yang lain. Mohon patuhi kebijakan atau pedoman yang relevan jika ada ketidaksamaan antara halaman tersebut dan halaman ini.

Pintas: WP:Lua WP:LUA

Lua adalah bahasa pemrograman yang sekarang tersedia melalui ekstensi MediaWiki Scribunto, di Wikipedia bahasa Indonesia. Kode Lua dapat digunakan pada templat-templat wiki dengan fungsi scribunto "{{#invoke:}}". Ekstensi ini mendukung Lua versi 5.1 hinggaJuli 2015^[update].

Kode sumber Lua disimpan di halaman bernama modul (misalnya Modul:Pisang). Kode-kode tunggal ini dapat dipanggil (dengan perintah {{#invoke:}}) di halaman templat (contoh pada halaman Modul:Pisang/doc menggunakan kode {{#invoke:Pisang|hello}} untuk menghasilkan teks "Hello, world!").

Menjalankan modul

Modul dapat dijalankan di halaman wiki normal menggunakan fungsi parser #invoke. Sintaks #invoke mirip dengan sintaks templat, tetapi terdapat beberapa perbedaan. Perbedaan yang paling penting adalah Anda memerlukan nama fungsi. Sebuah fungsi adalah satu set perintah yang mengambil nilai input, memprosesnya, dan menghasilkan suatu nilai output.^[1] Sistemnya sangat mirip dengan templat: Anda memasukan argumen, kemudian modul akan memprosesnya, dan Anda akan mendapat hasil keluaran. Bagaimanapun, Anda dapat mendefinisikan beberapa fungsi dalam satu modul, sedangkan templat, Anda hanya dapat menggunakan satu fungsi untuk satu halaman.

Tambahan lagi, Anda tidak dapat menjalankan modul secara langsung — Anda hanya dapat menjalankan salah satu fungsi modul. Modul hanyalah tempat untuk menampung fungsi, dan tidak bisa bekerja sendiri. Jadi ada dua alasan mengapa kita perlu memasukan nama fungsi: kita tidak bisa menjalankan modul tanpanya, dan tanpa merinci nama fungsi, Lua tidak akan tahu fungsi mana yang akan kita jalankan.

Cara paling sederhana untuk menjalankan lua dari halaman wiki adalah:

{{#invoke:<Module name>|<Function name>|(optional) param1 | param2...}}, for example:

Menggunakan argumen

Argumen pada modul bekerja dengan cara yang sama seperti pada templat, tetapi setelah karakter pipa pertama selalu berisi nama fungsi; argumen pertama adalah teks setelah tanda "pipa" kedua.

{{#invoke:module name|function name|first positional argument|second positional argument|named argument = value}}

Sebagai contoh, pada Modul:PisangArgs, fungsi "hai" menyapa orang yang berbeda tergantung pada argumen pertama. Seperti ini:

• {{#invoke:PisangArgs|hai|Om Joko}} → Hai, Om Joko!
• {{#invoke:PisangArgs|hai|Mbah Darmo}} → Hai, Mbah Darmo!

Pada modul PisangArgs juga memiliki fungsi bernama "hitung_semua" yang menggunakan argumen bernama pisang dan donat untuk menghitung jumlah pisang dan donat yang kita miliki. Seperti ini:

• {{#invoke:PisangArgs|hitung_semua|donat=13|pisang=21}} → Aku punya 21 pisang dan 13 donat
• {{#invoke:PisangArgs|hitung_semua|pisang=17|donat=6}} → Aku punya 17 pisang dan 6 donat

Modul memiliki halaman dokumentasi yang akan menjelaskan tentang argumen dan cara penggunaannya.

Contoh modul

• Modul:Pisang: Skrip paling sederhana, berisi fungsi tunggal tanpa argumen.
• Modul:PisangArgs: Mendemonstrasikan bagaimana mengakses dan menggunakan parameter.

Tentang Lua

Lihat juga Brad Jorsch's short presentation for a basic example of how to convert a wikitext template into a Lua module.

Lua adalah bahasa skrip yang dapat digunakan untuk menganalisis data, mengeksekusi suatu ekspresi, dan memformat hasil menggunakan fungsi atau pemrograman berorientasi objek. Meskipun beberapa skrip Lua dibuat sederhana, untuk mempermudah pemahaman, Lua memungkinan juga struktur kompleks termasuk tabel, fungsi dinamis, susunan asosiatif dimana indeks subskrip bisa berupa kata atau nomor indeks. Lua juga mendukung rekursi fungsi 're-nested', sehingga pemeliharaan harus dilakukan untuk menghindari kompleksitas yang berlebihan yang mengakibatkan pengguna lain tidak akan mengerti bagaimana mengatur modul Lua. Berikut ini adalah contoh kode sumber Lua untuk fungsi hello world yang terdapat di modul Modul:HelloWorld:

localp={};--Setiap modul Lua di Wikipedia harus dimulai dengan mendefinisikan
--sebuah variabel yang akan memegang fungsinya yang dapat diakses
--secara eksternal.
--Variabel-variabel tersebut dapat dinamai sesuai keinginan Anda
--dan mungkin mengandung bermacam-macam data maupun fungsi juga.
p.hello=function(frame)--Menambahkan sebuah fungsi ke "p".
--Fungsi tersebut dapat dipanggil di Wikipedia
--melalui perintah #invoke.
--"frame" akan berisi data yang dikirim Wikipedia
--ketika fungsi ini dijalankan.
-- 'Hello' adalah nama yang Anda pilih. Nama yang sama dirujuk ketika modul digunakan.

localstr="Hello World!"--Mendeklarasikan variabel lokal dan mengaturnya
--sama dengan "Hello World!"

returnstr--Pemberitahuan untuk keluar dari fungsi ini dan mengirimkan
--informasi di "str" kembali ke Wikipedia.

end--akhir dari fungsi "hello"
functionp.hello_to(frame)--Menambahkan fungsi lain
localname=frame.args[1]--Untuk mengakses argumen yang diteruskan ke modul,
--gunakan `frame.args`, `frame.args[1]` merujuk
--kepada parameter tanpa nama pertama yang diberikan
--kepada modul.
return"Halo, "..name.."!"-- `..` menggabungkan string. Ini akan memunculkan
-- salam yang disesuaikan dengan nama yang diberikan,
-- seperti "Halo, Fred!"
end
functionp.count_fruit(frame)
localnum_bananas=frame.args.bananas-- Argumen bernama ({{#invoke:Example|count_fruit|foo=bar}}) yang juga 
localnum_apples=frame.args.apples-- diakses dengan mengindeks `frame.args` dari nama (`frame.args["bananas"]`, or)
-- ekuivalen dengan `frame.args.bananas`.
return'Aku punya '..num_bananas..' pisang dan '..num_apples..' apel'
-- Sama seperti yang di atas, menggabungkan
-- sekelompok string bersama-sama untuk
-- menghasilkan sebuah kalimat berdasarkan
-- argumen yang diberikan.
end

returnp--Semua modul diakhiri dengan me-return variabelnya yang berisi fungsinya ke Wikipedia.
-- Sekarang kita bisa gunakan modulnya dengan memanggil {{#invoke: Example | hello }},
-- {{#invoke: Example | hello_to | foo }}, atau {{#invoke:Example|count_fruit|bananas=5|apples=6}}
-- Perhatikan bahwa bagian pertama invoke adalah nama halaman wiki dari Modul,
-- dan bagian kedua adalah nama salah satu fungsi yang melekat kepada 
-- variabel yang Anda return-kan.

-- Fungsi "print" tidak diperbolehkan di Wikipedia. Semua output diselesaikan
-- melalui string "returned" (dikembalikan) ke Wikipedia.

A sample of Lua is highlighted by tag <syntaxhighlight>...</syntaxhighlight> terletak diantara kode sumber Lua. Untuk melihat beberapa contoh yang lebih kompleks, lihat artikel: "Lua (bahasa pemrograman)".

Untuk instruksi tentang penggunaan Lua dalam lingkup MediaWiki (dan tentu saja Wikipedia), lihat mw:Extension:Scribunto/Lua reference manual.

Catatan

Lihat pula

• Special:PrefixIndex/Module: – indeks modul Special:PrefixIndex
• Help:Lua debugging
• Modul:Bak pasir
• Kategori:Templat berbasis Lua
• Kategori:Meta modul Lua
• Manual:Coding conventions/Lua
• Extension:Scribunto/Lua reference manual and all Modules.
• Wikipedia:Advanced template coding

l b s Kebijakan dan pedoman Wikipedia
Prinsip dasar Yayasan Wikimedia / Kebijakan Yayasan Wikimedia Pancapilar Daftar kebijakan dan pedoman Wikipedia bahasa Indonesia Prosedur penetapan kebijakan dan pedoman
Berkontribusi	Penyuntingan Penyangkalan umum Penyangkalan isi Penyangkalan hukum Penyangkalan medis Penyangkalan risiko Penyangkalan survei Topik kontroversial Wikipedia bukanlah Bukan riset asli Pemastian Sudut pandang netral Biografi tokoh yang masih hidup Pedoman penamaan Disambiguasi Jangan membuat kebohongan Jangan menyertakan salinan naskah asli Kelayakan artikel Tokoh Geografi Organisasi dan perusahaan Sekolah Situs Film dan acara televisi Musik Bahasa Konflik kepentingan Sumber tepercaya Tulisan mengawur Vanitas Spam Bangun jaringan halaman Masuk log sebelum melakukan penyuntingan drastis
Menyunting	Catatan atas Panjang artikel Halaman pembicaraan Jangan ragu menyunting Subhalaman Tanda tangani pembicaraan Daftar Manual gaya (aksesibilitas) Pedoman gaya Pedoman tata letak Penulisan tanggal dan angka Pembatasan gelar Pranala luar Kategori, daftar, dan templat navigasi Kategorisasi Templat
Memelihara	Kebijakan penghapusan Kebijakan pelindungan Penghapusan revisi Meninjau perubahan tertunda
Bertingkah laku	Halaman serangan Jangan terbebani aturan Keamanan dalam menyunting pedoman penanganan Konsensus Pengguna siluman Perang suntingan Pembatasan penyuntingan Proksi terbuka Etikawiki Kesopanan Mempermainkan sistem Asumsikan niat baik Kepemilikan artikel Keamanan akun pengguna Penyelesaian perselisihan Mengamankan data pribadi Jangan menyerang pribadi Jangan membuat ancaman hukum Jangan menggigit pengguna baru Jangan mengacau untuk membuktikan sesuatu
Hukum	Perlindungan anak Memberitahukan kontribusi yang dibayar Hak cipta Plagiarisme Kriteria isi nonbebas (revisi 2020) Pelanggaran hak cipta Menggunakan kembali konten Wikipedia
Konten	Ruang nama proyek ProyekWiki Halaman pengguna Kotak pengguna
Rumah tangga	Sistem pemilihan pengurus Prosedur penetapan kebijakan dan pedoman Penyerapan istilah Pedoman penerjemahan
Kebijakan · Pedoman · Kamus istilah