Bantuan:Pedoman pemula tentang transklusi
Bagaimana menghubungkan dan menambahkan buku ke ruang nama utama.
Apa itu transklusi?
[sunting]"Transklusi" adalah cara kita mendapatkan teks dari ruang nama Halaman ke ruang nama utama. Ruang nama Halaman adalah tempat teks hendak diuji-baca. Ruang nama utama adalah tempat teks akan dibaca.
Transklusi akan mengkopi bagian teks di bagian halaman manapun yang Anda ingin baca di ruang nama utama. Hal ini masih terhubung dengan ruang nama Halaman. Maka perubahan apapun pada teks di ruang nama Halaman maka akan mengubah hal yang terlihat di ruang nama utamanya juga.
Kapan mentransklusikan
[sunting]Waktu yang tepat untuk mentransklusi teks ke ruang nama utama adalah ketika seluruh halaman telah divalidasi (status halaman hijau) dan semua halaman telah diuji-baca.
Kadang-kadang, transklusi juga dapat membantu uji-baca jika Anda dapat melihat seperti apa versi akhirnya di ruang nama utama. Jika begitu, Anda dapat mentransklusikan halaman ke ruang nama utama sebelum semua uji-bacanya selesai. Karena halaman di ruang nama utama akan dibaca orang, maka kita harus berusaha membuatnya serapi dan sebaik mungkin. Maka, usahakan untuk melakukan transklusi teks sebaik mungkin.
Transklusi sederhana
[sunting]Untuk memulai transklusi:
- Mulailah sebuah halaman baru tempat Anda ingin melihat versi akhir dari teks untuk dimunculkan.
- Sunting halaman ini.
- Tambahkan kode transklusi (ditunjukkan di bawah ini).
- Simpan halaman.
Kode yang digunakan tergantung dari berapa jumlah halaman yang mau Anda transklusikan ke satu halaman.
Jumlah halaman | Kode yang digunakan |
---|---|
Satu | <pages index="filename" include=X header=1 /> |
Dua atau lebih | <pages index="filename" from=X to=X header=1 /> |
Teks merah diganti dengan detail dari karya Anda dan halaman yang mau Anda transklusi:
- Nama berkas adalah nama yang digunakan untuk halaman Indeks dan berkas pindaian.
- X adalah nomor halaman dalam pindaian yang mau Anda transklusi. Ini halaman nomor halaman dari pindaian, bukan nomor halaman yang terdapat pada karya.
Contohnya: Jika Anda mau mentransklusikan sebuah bab dari Index:My example book.djvu
yang berada pada halaman 20 sampai 35 dari pindaian (yaitu halaman Page:My example book.djvu/20
, Page:My example book.djvu/21
, ... Page:My example book.djvu/35
) Maka kodenya akan menjadi:
<pages index="My example book.djvu" from=20 to=35 header=1 />
.
Manual header
[sunting]Transklusi sederhana menggunakan "header ajaib" yang mengambil informasi dari halaman Indeks untuk membuat header yang terlihat pada bagian atas halaman. Jika ada masalah dengan header ini atau Anda ingin pengaturan lain, Anda mungkin perlu menambahkan header manual.
Untuk menambahkan header manual:
- Mulailah halaman baru dimana Anda ingin versi akhir dari teks untuk tampil.
- Sunting halaman ini.
- Tambahkan kode header (ditunjukkan di bawah ini).
- Isilah bagian-bagian header tersebut.
- Tambahkan kode transklusi (ditunjukkan di bawah ini).
- Simpan.
Kode header manual yang mesti ditambahkan diatas kode transklusi adalah:
{{header | title = | author = | translator = | section = | previous = | next = | year = | portal = | notes = }}
Judul dan pengarang harusnya diisi. Lihat {{header}} untuk informasi lebih lanjut.
Kode transklusi sama dengan transklusi sederhana kecuali bagian "header=1
" dibuang. (This is the part of the code that creates the "magic header".) Untuk membuatnya mudah, kodenya ditunjukkan di bawah ini:
Jumlah halaman | Kode yang digunakan |
---|---|
Satu | <pages index="filename" include=X /> |
Dua atau lebih | <pages index="filename" from=X to=X /> |
Fitur lanjutan
[sunting]Masih banyak hal lain yang dapat dilakukan dengan transklusi. Anda dapat mengecualikan atau melewati halaman. Anda juga dapat saja mentransklusi sebagian teks. Untuk lebih lanjutnya mengenai hal ini, lihat Bantuan:Transklusi.