Cara menemukan dan memperbaiki tautan jangkar rusak serta fragmen yang hilang

Apa itu tautan jangkar atau fragmen URL?#

Tautan jangkar menggunakan pengenal fragmen setelah # untuk merujuk lokasi atau keadaan dalam sumber daya. Pada URL dokumentasi umum seperti /help/#installation, jalur halaman mengidentifikasi dokumen dan fragmen mengidentifikasi target di dalamnya.

Untuk tautan bagian HTML biasa, fragmen umumnya sesuai dengan ID elemen. Jika dokumen dimuat tetapi target tidak lagi ada, pengunjung mungkin tetap berada di atas halaman atau mencapai lokasi yang tidak diharapkan. Kode respons tetap dapat menunjukkan keberhasilan karena dokumennya sendiri ada.

Mengapa tautan jangkar rusak setelah penyuntingan konten#

Banyak sistem konten membuat ID judul dari teks judul. Mengganti “Instalasi” menjadi “Memulai” dapat mengubah fragmen yang dihasilkan meskipun topiknya tetap di halaman yang sama. Mengurutkan ulang atau menduplikasi judul juga dapat mengubah ID yang dibuat otomatis.

Masalah lain timbul akibat menyalin alamat yang tidak lengkap, mengubah tanda baca, atau menempatkan target dalam konten yang baru dimuat setelah interaksi. Tautan yang berfungsi pada halaman terbuka dapat gagal saat seseorang memasukkan URL langsung di tab baru. Perlakukan ini sebagai kondisi navigasi berbeda dan uji keduanya.

Cara menyelidiki jangkar yang hilang#

Buka URL tujuan lengkap beserta fragmennya. Tunggu dokumen dimuat, lalu periksa apakah bagian yang dimaksud ada dan apakah peramban mencapainya. Bandingkan fragmen dengan ID persis yang digunakan halaman; jangan berasumsi teks judul yang terlihat sama dengan ID yang dihasilkan.

Gunakan Linky untuk mengidentifikasi temuan jangkar yang hilang, lalu verifikasi keadaan halaman terkait secara manual. Pemeriksa URL dan fragmen di situs ini dapat memisahkan komponen alamat yang ditempelkan, tetapi tidak mengambil halaman tujuan atau membuktikan keberadaan elemen di sana.

1. Salin tautan sumber lengkap, termasuk fragmennya.
2. Buka di tab baru dan tunggu halaman selesai dimuat.
3. Identifikasi judul atau elemen target yang dimaksud.
4. Bandingkan ID-nya dengan fragmen.
5. Perbaiki sumber atau target dan uji kembali alur pada situs yang diterbitkan.

Pilih ID yang stabil untuk konten yang ditautkan orang#

Untuk dokumentasi yang sering dirujuk, pilih ID stabil yang menjelaskan topik dan dapat dipertahankan saat redaksi berubah. Judul yang terlihat dapat diperbaiki tanpa merusak setiap markah yang menautkan ke sana. Catat ID penting saat memindahkan konten antar sistem.

Jika jangkar lama memiliki banyak referensi, pertimbangkan mempertahankan target yang kompatibel di dekat bagian pengganti. Pastikan tidak membuat ID duplikat atau mengganggu aksesibilitas. Jika kompatibilitas tidak praktis, perbarui tautan yang Anda kendalikan dan sampaikan tujuan baru jika perlu.

Fragmen, perutean, dan format tautan khusus#

Tidak setiap fragmen merupakan ID elemen sederhana. Beberapa aplikasi menggunakan fragmen untuk perutean sisi klien atau keadaan aplikasi. Tautan fragmen teks juga dapat mengidentifikasi teks, bukan elemen target biasa. Identifikasi format sebelum menafsirkan hasil pemeriksa.

Jika aplikasi Anda bergantung pada rute fragmen khusus, uji navigasi langsung dan perilaku pemuatan ulang. Jika tautan dimaksudkan sebagai referensi konten biasa, pilih tujuan stabil yang dapat dibuka dan dibagikan pengunjung tanpa memerlukan keadaan aplikasi sebelumnya. Dokumentasikan pengecualian dalam audit alih-alih memaksakan satu aturan pada setiap URL.

Periksa tautan langsung ke bagian tertentu saat migrasi dan rilis#

Tambahkan fragmen penting ke daftar periksa migrasi bersama jalur halaman. Navigasi dokumentasi, daftar isi, dan catatan rilis sering memuat banyak tautan tingkat bagian. Migrasi URL dapat terlihat berhasil tetapi membuat referensi tersebut tidak berfungsi.

Sebelum menerbitkan, uji tautan dari halaman lain, bukan hanya daftar isi pada halaman itu sendiri. Setelah penerbitan, jalankan pemindaian halaman dan tinjau referensi langsung yang diketahui. Simpan topik yang dimaksud, halaman sumber, dan target baru bersama dalam catatan perbaikan agar editor lain dapat memastikan alasan perubahan tujuan.

• Periksa ID judul yang dihasilkan setelah penyuntingan.
• Hindari ID duplikat dalam dokumen yang sama.
• Pertahankan target stabil untuk bagian yang sering dibagikan.
• Uji navigasi langsung ke konten yang dimuat secara dinamis.
• Tinjau fragmen saat memindahkan atau menggabungkan dokumentasi.

Pertanyaan yang sering diajukan#

Terapkan alur kerja ini

Baca dokumentasi Linky terkait untuk kontrol produk dan batas yang digunakan dalam artikel ini. Hubungi dukungan jika hasil memerlukan penyelidikan lebih lanjut.