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 hingga Juli 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!").

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:

Galat skrip: tidak ada modul tersebut "''nama modul''".

Sebagai contoh, kita dapat menjalankan Modul:Pisang disini modul pisang memiliki satu fungsi bernama "hello".

• {{#invoke:pisang|hello}} → Hello, world!

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.

Galat skrip: tidak ada modul tersebut "''nama modul''".

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.

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

Lihat juga Presentasi singkat Brad Jorsch's untuk contoh sederhana bagaimana mengkonversikan templat wikiteks menjadi modul Lua.

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:

-- All Lua modules on Wikipedia must begin by defining a variable that will hold their
-- externally accessible functions. They can have any name and may also hold data.
my_object = {}

-- Add a function to the variable. These are callable in Wikipedia via the #invoke command.
-- "frame" will contain the data that Wikipedia sends this function when it is called.
my_object.hello = function( frame )

    -- Declare a local variable and assign data to it.
    local str = "Hello World!"  

    -- Quit this function and send the information in "str" back to Wikipedia.
    -- The "print" function is not allowed, so all output is accomplished via 
    -- returning strings in this fashion.
    return str    

-- End the function.
end

-- All modules end by returning the variable containing its functions to Wikipedia.
return my_object

-- We can now use this module by calling {{#invoke: HelloWorld | hello }}.
-- The #invoke command begins with the module's name, in this case "HelloWorld",
-- then takes the name of one of its functions as an argument, in this case "hello".

Suatu contoh dari lua yang ditandai dengan tag "<source lang="lua">...</source>" 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.

• 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