Saat teknisi atau manajer produk menautkan ke artikel dukungan SUMO dari dalam produk (seperti Firefox), mereka harus selalu menggunakan URL stabil, bukan tautan artikel langsung. Tautan langsung berubah saat judul artikel atau slug diperbarui, yang dapat merusak tautan dalam produk. Tautan stabil melindungi dari hal ini dan memastikan pengguna selalu mencapai halaman yang benar.
Artikel ini menjelaskan mengapa tautan stabil itu penting, cara memformatnya untuk berbagai platform, dan cara mengaturnya menggunakan dasbor Kitsune.
Daftar Isi
Mengapa tautan stabil itu penting
Menggunakan tautan langsung ke artikel dukungan (seperti https://support.mozilla.org/en-US/kb/example-article) dapat menimbulkan masalah:
- Mudah rusak: URL artikel berubah jika judulnya berubah kecuali editor secara manual mempertahankan slug.
- Tidak dapat dilokalkan: Tautan langsung menggunakan kode bahasa secara permanen, yang tidak ideal untuk pengguna internasional.
- Lebih sulit untuk dikelola: Kami tidak dapat memperbaruinya secara global jika digunakan langsung di dalam produk.
Sebaliknya, tautan stabil:
- Tetap konsisten, bahkan jika URL artikel berubah
- Secara otomatis mendeteksi lokal yang benar
- Dapat dialihkan atau diperbarui secara terpusat jika diperlukan
Format tautan untuk artikel dukungan dalam produk
Gunakan format standar untuk membuat tautan dukungan yang stabil untuk produk desktop dan seluler:
Catatan:
-
%VERSION%,%OS%, dan%LOCALE%diisi secara otomatis oleh produk. - Tim SUMO membuat kolom
<slug>dan<product>. - Ganti
<slug>dengan slug unik yang Anda buat.
Format ini memastikan pengguna diarahkan ke artikel terjemahan yang benar.
Contoh:https://support.mozilla.org/1/firefox/%VERSION%/%OS%/%LOCALE%/recommendations-firefox-new-tab
Cara mengatur tautan stabil dalam produk di Kitsune
Untuk membuat pengalihan yang stabil, ikuti langkah-langkah ini di dasbor admin Kitsune.
- Masuk ke dasbor admin Kitsune.
- Di bawah INPRODUCT, klik Redirects.
- Klik di sudut kanan atas.
- Lengkapi kolom yang wajib diisi Product, Topic, dan Target, seperti yang dijelaskan di bagian Kolom pengalihan di bawah ini.
- Klik .
- Bagikan tautan stabil yang sudah selesai dengan teknisi atau manajer produk, menggunakan format dalam produk:
https://support.mozilla.org/1/firefox/%VERSION%/%OS%/%LOCALE%/<slug>
Kolom pengalihan
| Kolom | Deskripsi |
|---|---|
| Product | Gunakan firefox untuk desktop atau mobile untuk produk seluler Firefox.
|
| Topic (slug) |
Masukkan pengidentifikasi singkat yang unik untuk artikel tersebut. Ini akan menjadi bagian dari tautan yang stabil.
Catatan: Slug tidak harus cocok dengan URL artikel target yang sebenarnya. Pilih sesuatu yang bermakna dan konsisten untuk penggunaan produk.
|
| Target |
Jalur ke artikel dukungan yang ingin Anda alihkan. Hanya sertakan bagian dari Contoh:
Catatan: Anda dapat menyertakan jangkar (misalnya,
kb/customize-items-on-firefox-new-tab-page#w_weather) untuk menautkan ke bagian tertentu. Jangkar hanya berfungsi dalam versi bahasa Inggris dan mungkin tidak dapat berfungsi di lokal lain. |
Kiat
- Tautan stabil memastikan pelokalan: pengguna akan secara otomatis dialihkan ke bahasa pilihan mereka jika tersedia.
- Anda dapat memperbarui atau menghapus pengalihan stabil nanti melalui antarmuka admin Kitsune.
- Gunakan metode ini setiap kali Anda menautkan dari:
- Pesan dalam produk “Pelajari lebih lanjut”
- Alur orientasi
- Pesan kesalahan atau peringatan
- Modal bantuan kontekstual