Wikipedia:Lua

Dari Wikipedia bahasa Indonesia, ensiklopedia bebas
Lompat ke: navigasi, cari
Ruangnama Wikipedia
Ruangnama dasar Ruangnama pembicaraan
0 Utama Pembicaraan 1
2 Pengguna Pembicaraan Pengguna 3
4 Wikipedia Pembicaraan Wikipedia 5
6 Berkas Pembicaraan berkas 7
8 MediaWiki Pembicaraan MediaWiki 9
10 Templat Pembicaraan Templat 11
12 Bantuan Pembicaraan bantuan 13
14 Kategori Pembicaraan kategori 15
100 Portal Pembicaraan portal 101
108 Buku Pembicaraan buku 109
Ruangnama virtual
-1 Istimewa
-2 Media

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 .

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[sunting sumber]

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:nama modul|nama fungsi}}

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

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

Menggunakan argumen[sunting sumber]

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:nama modul|nama fungsi|argumen pertama|argumen kedua|isi argumen = 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 13 pisang dan 13 donat
  • {{#invoke:PisangArgs|hitung_semua|pisang=17|donat=6}} → Aku punya 6 pisang dan 6 donat

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

Contoh modul[sunting sumber]

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

Tentang Lua[sunting sumber]

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.

Catatan[sunting sumber]

  1. ^ Anda juga dapat menggunakan lebih dari satu nilai keluaran, tapi bukan berarti bahwa fungsi yang melakukanya dapat diakses dari sebuah halaman wiki normal.

Lihat pula[sunting sumber]