Templat:Teks quran blok

[lihat] [sunting] [versi terdahulu] [hapus singgahan] Ikon dokumentasi Dokumentasi templat

PenggunaanSunting

Sintaks untuk templat ini adalah:

{{Teks quran blok |nama surat= |manual= |tanpa nomor= |basmalah= |posisi= |s=
 |a1=|t1=
 |a2=|t2=
 |a3=|t3=
 |attr=
}}
Parameter
|s=: isi dengan nomor surat yang ingin ditampilkan
|an=: isi dengan nomor ayat dari surat s yang ingin ditampilkan. Templat ini mentransklusikan templat {{Teks quran}} dengan isian parameter 1 dengan nilai s dan parameter 2 dengan nilai an. n maksimal saat ini adalah 11.
|a= untuk alternatif parameter a1.
|tn=: isi dengan teks terjemahan yang sesuai.
|t= untuk alternatif parameter t1.
|attr=: per Wikipedia:Kutip sumber tulisan, maka penyunting harus memberikan referensi tulisan yang dibuat, termasuk terjemahan yang digunakan untuk ayat Al-Qur'an. (Lihat Pedoman gaya artikel bertopik Islam § Terjemahan Alquran.)
|nama surat= (opsional): jika diisi dengan sembarang nilai, akan menampilkan nama surat sebagai judul berdasarkan nomor surat yang diisikan pada s.
|manual= (opsional): jika diisi dengan sembarang nilai, parameter an akan ditampilkan apa adanya tanpa mentransklusikan templat {{Teks quran}}. Anda juga harus menuliskan nomor ayat yang dimaksud pada parameter n. (Lihat di bawah.)
|tanpa nomor= (opsional): jika diisi dengan sembarang nilai, nomor ayat terjemahan di sebelah kiri tidak akan ditampilkan.
|basmalah= (opsional): jika diisi dengan sembarang nilai, akan ditampilkan basmalah di bawah nama surat dan di atas ayat pertama.
|posisi= (opsional): untuk mengatur letaknya secara horizontal di halaman; isi dengan "kiri", "tengah", atau "kanan". Default: kiri.

Penjelasan dan contoh kasusSunting

Hanya dengan paremeter wajib
{{Teks quran blok|s=1
|a1=1|t1=Dengan nama Allah Yang Maha Pengasih, Maha Penyayang
|a2=2|t2=Segala puji bagi Allah, Tuhan seluruh alam,
|attr=[https://quran.com/1?translations=33 quran.com]}}

Menghasilkan

(1) Dengan nama Allah Yang Maha Pengasih, Maha Penyayang بِسْمِ اللَّهِ الرَّحْمَٰنِ الرَّحِيمِ Aya-1.png
(2) Segala puji bagi Allah, Tuhan seluruh alam, الْحَمْدُ لِلَّهِ رَبِّ الْعَالَمِينَ Aya-2.png
quran.com
Parameter "nama surat" dengan sembarang nilai
{{Teks quran blok|s=1 |nama surat=y
|a1=3|t1=Yang Maha Pengasih, Maha Penyayang
|a2=4|t2=Yang Merajai hari pembalasan.}}

Menghasilkan

Surah Al-Fatihah
(3) Yang Maha Pengasih, Maha Penyayang الرَّحْمَٰنِ الرَّحِيمِ Aya-3.png
(4) Yang Merajai hari pembalasan. مَالِكِ يَوْمِ الدِّينِ Aya-4.png
Parameter "manual" dengan sembarang nilai
{{Teks quran blok|manual=y
|5|a1=إياك نعبد وإياك نسيعين|t1=Hanya kepada-Mu kami menyembah dan hanya kepada-Mu kami memohon pertolongan.
|6|a2=اهدنا الصراط المستقيم|t2=Tunjukilah kami jalan yang lurus,}}

Menghasilkan

(5) Hanya kepada-Mu kami menyembah dan hanya kepada-Mu kami memohon pertolongan. إياك نعبد وإياك نسيعين
(6) Tunjukilah kami jalan yang lurus, اهدنا الصراط المستقيم

Perhatikan pada kasus ini. Sebelum parameter a1 tertulis nilai 5, tanpa parameter (Anda harus memisahkannya dengan parameter a1 dengan tanda pipa (|). Nilai inilah yang ditampilkan sebagai nomor ayat. Agar lebih rapi, Anda dapat menuliskannya dengan parameter |1= untuk ayat a1, |2= untuk ayat a2, dst., seperti berikut.

{{Teks quran blok|s=1 |manual=y
|1  = 5
|a1 = إياك نعبد وإياك نسيعين
|t1 = Hanya kepada-Mu kami menyembah dan hanya kepada-Mu kami memohon pertolongan.

|2  = 6
|a2 = اهدنا الصراط المستقيم
|t2 = Tunjukilah kami jalan yang lurus,}}
Parameter "tanpa nomor" dengan sembarang nilai
{{Teks quran blok|s=1 |tanpa nomor=y |manual=y
|a=صراط الذين أنعمت عليهم|t=(yaitu) jalan orang-orang yang telah Engkau beri nikmat kepadanya;}}

Menghasilkan

(yaitu) jalan orang-orang yang telah Engkau beri nikmat kepadanya; صراط الذين أنعمت عليهم
Parameter "basamalah" dengan sembarang nilai
{{Teks quran blok|s=112 |nama surat=y |basmalah=y
|a1=1 |t1=Katakanlah (Muhammad), “Dialah Allah, Yang Maha Esa.
...
|a4=4 |t4=Dan tidak ada sesuatu yang setara dengan Dia.”}}

Menghasilkan

Surah Al-Ikhlas
بِسْــــــــــــــــــــمِ اللَّهِ الرَّحْمَٰنِ الرَّحِـــــــــــــــــــــــيمِ
(1) Katakanlah (Muhammad), “Dialah Allah, Yang Maha Esa. قُلْ هُوَ اللَّهُ أَحَدٌ Aya-1.png
(2) Allah tempat meminta segala sesuatu. اللَّهُ الصَّمَدُ Aya-2.png
(3) (Allah) tidak beranak dan tidak pula diperanakkan. لَمْ يَلِدْ وَلَمْ يُولَدْ Aya-3.png
(4) Dan tidak ada sesuatu yang setara dengan Dia.” وَلَمْ يَكُن لَّهُ كُفُوًا أَحَدٌ Aya-4.png

Khusus untuk Surat Al-Fatihah (s=1), meskipun basmalah diisi dengan nilai, tidak akan ditambahkan basmalah lagi karena ayat pertamanya adalah basmalah.

Parameter "posisi" dengan sembarang nilai
{{Teks quran blok|s=112 |nama surat=y |basmalah=y |posisi=tengah
|a1=1 |t1=Katakanlah (Muhammad), “Dialah Allah, Yang Maha Esa.
...
|a4=4 |t4=Dan tidak ada sesuatu yang setara dengan Dia.”}}

Menghasilkan

Surah Al-Ikhlas
بِسْــــــــــــــــــــمِ اللَّهِ الرَّحْمَٰنِ الرَّحِـــــــــــــــــــــــيمِ
(1) Katakanlah (Muhammad), “Dialah Allah, Yang Maha Esa. قُلْ هُوَ اللَّهُ أَحَدٌ Aya-1.png
(2) Allah tempat meminta segala sesuatu. اللَّهُ الصَّمَدُ Aya-2.png
(3) (Allah) tidak beranak dan tidak pula diperanakkan. لَمْ يَلِدْ وَلَمْ يُولَدْ Aya-3.png
(4) Dan tidak ada sesuatu yang setara dengan Dia.” وَلَمْ يَكُن لَّهُ كُفُوًا أَحَدٌ Aya-4.png

Disarankan agar templat ini tidak ditampilkan di tengah kecuali jika di manapun letaknya di sebuah halaman artikel tidak digeser oleh blok mengambang yang berada di samping kanan atau kiri, seperti templat infobox dan berkas gambar. Hal itu dimaksudkan agar apabila suatu artikel memuat lebih dari satu templat ini, seluruh templat akan ditampilkan sejajar.

CatatanSunting

Parameter s adalah parameter wajib yang diperlukan untuk menampilkan teks quran secara otomatis dan nama surat. Jika Anda ingin menampilkan teks quran secara manual dan tidak menampilkan nama surat, maka parameter ini tidak harus ada.

Lihat pulaSunting