Salah satu fitur hebat dari Basis Pengetahuan kami adalah kemampuan untuk menampilkan instruksi yang disesuaikan untuk sistem operasi (Windows, macOS, Linux) dan versi Firefox. Kita bisa mengatakan, misalnya, bahwa bagian tertentu dari artikel bantuan adalah "untuk" pengguna Windows dan pengguna Mac dan Linux tidak akan melihatnya. Fitur ini dirancang untuk bekerja secara tidak terlihat. Ketika seseorang membuka artikel bantuan, kami akan secara otomatis mendeteksi sistem operasi dan versi Firefox apa yang mereka gunakan dan menampilkan instruksi yang sesuai. Artikel ini membahas detail tentang cara menggunakan markup {for} di artikel Basis Pengetahuan.
Daftar Isi
- 1 Cara mengganti instruksi ke sistem operasi atau versi Firefox yang berbeda
- 2 Sintaks dan perilaku dasar
- 3 Praktik terbaik untuk menggunakan {for} di artikel
- 4 Panduan lengkap Basis Pengetahuan
Cara mengganti instruksi ke sistem operasi atau versi Firefox yang berbeda
Untuk mengikuti contoh dalam artikel ini, Anda harus mengganti pemilih artikel ke sistem operasi dan versi Firefox yang berbeda. Itu terletak di panel kanan artikel, di bawah Alat Penyuntingan.
Sintaks dan perilaku dasar
Sistem operasi
Berikut adalah sintaks untuk menampilkan gambar untuk Windows 11:
{for win11}[[Image:Windows Logo]]{/for}
- Ubah pemilih ke Windows 11 untuk melihat gambar:
- Jika Anda mengubah pemilih ke Windows XP, Windows 7, Windows 8, Windows 10, Mac atau Linux, gambar di atas tidak akan ditampilkan karena tidak "untuk" mereka.
Meskipun pemilih Windows tidak ada, Anda dapat menulis instruksi yang berlaku untuk semua versi Windows:
{for win}[[Image:Image:vista.jpg]]{/for}
- Ubah pemilih ke Windows XP, Windows 7/Vista, Windows 8, Windows 10 atau Windows 11 untuk melihat gambar:
- Jika Anda mengubah pemilih ke Mac atau Linux, gambar di atas tidak akan ditampilkan karena tidak "untuk" mereka.
Versi Firefox
Berikut adalah sintaks untuk menampilkan sesuatu untuk Firefox 153 ke atas:
{for fx153}[[Image:Firefox Quantum Logo]]{/for}
- Ubah pemilih ke Firefox 153 atau lebih tinggi untuk melihat gambar:
- Jika Anda mengubah pemilih ke Firefox 152 atau lebih rendah, gambar di atas akan hilang karena tidak "untuk" versi tersebut.
Tampilkan instruksi hanya untuk satu versi Firefox
Untuk menampilkan instruksi hanya untuk Firefox 153, gunakan operator "=":
{for =fx153}[[Image:Firefox Quantum Logo]]{/for}
- Sekarang gambar hanya muncul saat Anda mengubah pemilih ke Firefox 153:
Menggabungkan sistem operasi dan versi Firefox
Anda dapat menentukan sistem operasi dan versi Firefox dengan memisahkannya dengan koma:
{for win,fx153}[[Image:Windows Logo]][[Image:Quantum Logo]]{/for}
- Ubah pemilih ke Windows dan Firefox 153 atau lebih tinggi untuk melihat gambar:
Situasi yang lebih kompleks dengan "for" tersirat dapat ditulis seperti ini:
{for mac, win10, win11, =fx150, fx153}[[Image:Windows Logo]][[Image:macos.jpg]][[Image:Firefox Quantum Logo]]{/for}
- Ubah pemilih ke Mac atau Windows 10 atau Windows 11 dan Firefox 150 atau Firefox 153 ke atas untuk melihat gambar:
Menyangkal kondisi
Anda dapat menyangkal suatu kondisi dengan mendahuluinya dengan kata not. Kondisi yang disangkal adalah benar jika dan hanya jika kondisi tersebut salah. Sebagai contoh, kondisi
not fx153
adalah benar jika versi Firefox kurang dari 153.
Manfaatkan tag {for} untuk kontrol versi tingkat lanjut
Dengan pembaruan dan rilis fitur yang sering di Firefox, tag for memainkan peran kunci untuk kurasi konten yang ditargetkan, memungkinkan kami untuk menyampaikan informasi yang relevan kepada pengguna berdasarkan versi Firefox spesifik mereka. Aplikasi utama dari tag ini meliputi:
- Akses awal untuk Pengguna Nightly dan Beta: Ini memungkinkan kami untuk menyajikan fitur atau perubahan yang akan datang kepada pengguna yang berada di saluran Nightly dan Beta, memberi mereka pemberitahuan awal tentang apa yang mungkin mereka temukan. Ini memastikan bahwa pengguna kami yang paling terlibat dan teknis dapat mulai menjelajahi fungsionalitas baru sebelum komunitas yang lebih luas.
- Pelokalan sebelum peluncuran: Tag for memungkinkan kami untuk menerbitkan konten untuk versi yang akan datang sebelum rilis publiknya. Ini memungkinkan komunitas pelokalan kami untuk menyiapkan terjemahan lebih awal, menjamin dukungan multi-bahasa saat versi baru ditayangkan di saluran Produksi.
- Hindari kebingungan di antara audiens umum: Menggunakan tag for, kami secara strategis menghindari mengekspos audiens umum kami ke informasi prematur, sehingga mencegah kebingungan tentang apa yang saat ini tersedia di versi Firefox mereka saat ini.
Kapan konten ditampilkan
Secara formal, markup antara {for} dan {/for} akan ditampilkan jika kedua kondisi ini terpenuhi:
- {for} tidak memiliki kondisi sistem operasi (OS), atau memiliki setidaknya satu kondisi OS yang benar terkait OS yang dijalankan pengguna (atau telah dipilih secara manual).
- {for} tidak memiliki kondisi versi Firefox, atau memiliki setidaknya satu kondisi versi Firefox yang benar terkait versi Firefox yang dijalankan pengguna (atau telah dipilih secara manual).
Jika tidak, konten dari {for}…{/for} tidak ditampilkan.
Beberapa hal lain yang perlu diperhatikan:
- Spasi setelah koma bersifat opsional.
- {for} dan markup wiki lainnya tidak berfungsi dalam ringkasan pencarian artikel.
- Judul yang disembunyikan oleh blok {for} tidak muncul di daftar isi halaman. Jika pengguna menyebabkannya muncul dengan memilih kombinasi OS/peramban yang tepat secara manual, entri daftar isi akan langsung muncul.
Singkatan sistem operasi dan produk
Ini adalah singkatan sistem operasi dan produk yang tersedia untuk digunakan dengan {for}:
- win (Windows)
- winxp (Windows XP/2000/Server 2003)
- win7 (Windows 7/Vista/Server 2008)
- win8 (Windows 8/8.1/Server 2012)
- win10 (Windows 10)
- win11 (Windows 11)
- mac (macOS)
- linux (Linux)
- fxN di mana N = versi Firefox (desktop), misalnya fx151, fx152, fx153, dll.
- mN di mana N = versi Firefox for Android (seluler), misalnya m151, m152, m1153, dll.
- tbN di mana N = versi Thunderbird, misalnya tb151, tb152, tb153, dll.
Anda harus menggunakan fxN di artikel dukungan Firefox, mN di artikel dukungan Firefox for Android dan tbN di artikel dukungan Thunderbird.
Konteks inline dan tingkat blok
{for} dapat digunakan dalam konteks inline dan tingkat blok (dalam pengertian HTML). Bentuk inline berlaku saat bekerja dalam satu baris teks:
Ini adalah {for win}penggunaan inline{/for}.
Bentuk blok digunakan untuk membungkus seluruh paragraf, daftar berurutan, judul, dan sebagainya. Satu-satunya peringatan adalah bahwa, saat menggunakan bentuk blok, {for} dan {/for} masing-masing harus berada di barisnya sendiri. Jika tidak, itu mungkin dianggap sebagai bagian dari paragraf tetangga dan menghasilkan hasil yang mengejutkan.
- {for win}
- Ini adalah tingkat blok.
- *Satu
- *Dua
- {/for}
Praktik terbaik untuk menggunakan {for} di artikel
Saat menulis instruksi untuk sistem operasi yang berbeda, yang terbaik adalah menulis kalimat dan paragraf lengkap untuk setiap versi OS/Firefox, bahkan jika itu berarti menduplikasi beberapa hal. Ini membuat artikel lebih mudah dipahami, dipelihara, dan dilokalkan. Ketika tiba saatnya, misalnya, untuk menghapus instruksi spesifik untuk Firefox 152 ke bawah, bagian-bagian tersebut bisa langsung dihapus daripada mencoba memotongnya dari bagian yang lebih besar.
- Cara yang salah untuk menggunakan {for}:
- #{for not fx153}{for win,linux}Di bagian atas jendela Firefox{/for}{for mac}Pada bilah menu{/for}, klik pada {/for}{for fx153}Klik tombol menu, arahkan ke {menu History} menu{/for}{for winxp,mac,linux,not fx153}{menu Tools} menu{/for}{for win10,win11,not fx153}{menu Firefox} menu, arahkan ke {menu History} menu{/for} dan pilih {menu Clear Recent History…}
- Cara yang benar untuk menggunakan {for}:
- {for not fx153}
- #{for win10,win11}Di bagian atas jendela Firefox, klik {menu Firefox} menu, arahkan ke {menu History} menu dan pilih {menu Clear Recent History…}{/for}{for mac}Pada bilah menu, klik {menu Tools} menu dan pilih {menu Clear Recent History…}{/for}{for winxp,linux}Di bagian atas jendela Firefox, klik {menu Tools} menu dan pilih {menu Clear Recent History…}{/for}
- {/for}
- {for fx153}
- #Klik tombol menu, arahkan ke {menu History} menu dan pilih {menu Clear Recent History…}
- {/for}
- Dalam contoh berikut, kami memperlakukan Firefox 152 ke bawah, Firefox 153/154, dan Firefox 155 ke atas sebagai tiga set instruksi yang berbeda. Seringkali demikian, tetapi semakin sering kami mengubah Firefox setiap empat minggu, kami akan melihat lebih banyak perubahan di versi yang lebih baru. Mereka akan terlihat seperti ini:
- {for not fx153}
- #Instruksi lama.
- {/for}
- {for =fx153,=fx154}
- #Instruksi baru.
- {/for}
- {for fx155}
- #Instruksi BARU yang baru.
- {/for}
Panduan lengkap Basis Pengetahuan
Lihat panduan lebih lanjut tentang kontribusi Basis Pengetahuan.