Templat:Teks quran blok/doc

Penggunaan

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 a_n. 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 a_n 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 kasus

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		بِسْمِ اللَّهِ الرَّحْمَٰنِ الرَّحِيمِ ​
(2) Segala puji bagi Allah, Tuhan seluruh alam,		الْحَمْدُ لِلَّهِ رَبِّ الْعَالَمِينَ ​
—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		الرَّحْمَٰنِ الرَّحِيمِ ​
(4) Yang Merajai hari pembalasan.		مَالِكِ يَوْمِ الدِّينِ

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 "basmalah" 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.		قُلْ هُوَ اللَّهُ أَحَدٌ ​
(2) Allah tempat meminta segala sesuatu.		اللَّهُ الصَّمَدُ ​
(3) (Allah) tidak beranak dan tidak pula diperanakkan.		لَمْ يَلِدْ وَلَمْ يُولَدْ ​
(4) Dan tidak ada sesuatu yang setara dengan Dia.”		وَلَمْ يَكُن لَّهُ كُفُوًا أَحَدٌ

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 nilai kanan atau tengah

{{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.		قُلْ هُوَ اللَّهُ أَحَدٌ ​
(2) Allah tempat meminta segala sesuatu.		اللَّهُ الصَّمَدُ ​
(3) (Allah) tidak beranak dan tidak pula diperanakkan.		لَمْ يَلِدْ وَلَمْ يُولَدْ ​
(4) Dan tidak ada sesuatu yang setara dengan Dia.”		وَلَمْ يَكُن لَّهُ كُفُوًا أَحَدٌ

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.

Catatan

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 pula

• {{QuoteQuran}}
• {{Teks quran}}
• {{Teks quran float}}
• {{Verse translation}}