Periksa salinan sitemap XML lokal dengan PowerShell: namespace, elemen loc yang hilang atau kosong, daftar URL, dan pengulangan alamat.

Mulai dari isi berkas sebelum menilai penggunaannya

Sitemap dapat membantu pengelola menyajikan daftar alamat halaman kepada mesin pencari. Namun, memiliki berkas bernama sitemap.xml belum menjelaskan apakah elemen URL di dalamnya tersusun sesuai format yang dimaksud. Pemeriksaan lokal berguna untuk menemukan masalah awal sebelum pengelola menindaklanjuti penerapan di website. Tutorial ini berfokus pada beberapa pemeriksaan elemen dan daftar alamat, bukan sertifikasi lengkap terhadap seluruh aturan protokol atau hasil indeks mesin pencari.

Latihan dilakukan pada salinan XML yang tersimpan di komputer Windows. Anda akan membaca dokumen, mencocokkan namespace, mengambil elemen loc, mencari entri yang tidak memiliki tepat satu loc berisi teks, lalu meninjau pengulangan alamat. Perintah tidak mengirim sitemap ke layanan lain dan tidak mengunjungi URL yang tercantum. Hasilnya adalah catatan temuan yang dapat dibahas bersama pengelola situs tanpa mengubah sitemap aktif selama pemeriksaan awal.

Pohon urlset dengan namespace standar, entri url, dan anak loc yang menyimpan URL lengkap dalam sitemap.
Pemeriksaan mengikat namespace yang sesuai agar kueri membaca elemen pada jenis dokumen yang dimaksud.

Prasyarat dan jenis dokumen yang digunakan

Siapkan PowerShell dengan Select-Xml serta salinan sitemap yang boleh Anda periksa dalam folder kerja sendiri. Gunakan berkas XML UTF-8 biasa bernama sitemap.xml, dengan akar urlset. Berkas terkompresi atau sitemapindex memerlukan penanganan berbeda dan tidak menjadi masukan latihan ini. Menurut protokol Sitemaps, urlset memiliki namespace standar, berisi entri url, dan tiap entri memerlukan loc. Pastikan Anda mengetahui jenis dokumen sebelum menganggap hasil pencarian elemen kosong sebagai masalah pada daftar URL.

Simpan juga catatan mengenai asal salinan, waktu pengambilan, dan host yang diharapkan. Bekerjalah pada salinan agar temuan dapat dibandingkan kembali dengan sumbernya. Untuk latihan hipotetis, bayangkan berkas berisi tiga URL lengkap pada example.com: beranda, halaman layanan, dan panduan. Jumlah tiga hanya acuan contoh, bukan jumlah yang seharusnya ada pada website Anda. Gunakan inventaris situs sendiri untuk menilai apakah daftar nyata memang sesuai kebutuhan.

Tiga pemeriksaan salinan sitemap: dokumen dapat diuraikan, tiap entri memiliki loc berisi teks, dan alamat ditinjau.
Lolos parsing berbeda dari ketepatan tiap entri dan keputusan atas daftar alamat; hasil lokal tidak menjamin pengindeksan.

Langkah 1: Baca salinan sebagai objek XML

Buka PowerShell pada folder kerja yang berisi salinan, lalu jalankan $xml = [xml](Get-Content -LiteralPath '.\sitemap.xml' -Raw -Encoding UTF8). Perintah membaca isi berkas dan menafsirkannya sebagai XML. Jika muncul kesalahan penguraian, simpan pesan dan posisi yang dilaporkan sebelum melanjutkan. Jangan menjalankan pemeriksaan berikutnya dengan menganggap variabel berisi dokumen yang benar apabila pembacaan belum berhasil.

Buka salinan melalui editor teks untuk meninjau bagian yang dilaporkan bila diperlukan. Masalah pasangan tag atau penulisan karakter dapat menghentikan penguraian, tetapi perbaikannya tetap harus mengikuti struktur dokumen. Hindari penggantian teks massal tanpa memahami akibatnya. Jika salinan ternyata berisi halaman kesalahan dari website, minta sumber XML yang sesuai kepada pengelola. Nama berkas yang benar tidak menjamin isi unduhan merupakan sitemap yang dimaksud.

Langkah 2: Cocokkan akar dan namespace dokumen

Jalankan $xml.DocumentElement.LocalName dan $xml.DocumentElement.NamespaceURI sebagai dua pemeriksaan terpisah. Untuk cakupan latihan ini, nama akar yang diharapkan adalah urlset dan URI namespace adalah http://www.sitemaps.org/schemas/sitemap/0.9. Cocokkan nilainya dengan tepat. URI namespace merupakan identitas ruang nama pada dokumen; membacanya dari objek XML tidak berarti PowerShell mengunduh daftar URL yang ada dalam sitemap.

Jika akar menunjukkan sitemapindex, jangan meneruskan dengan menganggap file rusak. Dokumen itu menunjuk kumpulan sitemap, sedangkan latihan ini memeriksa entri URL pada satu urlset. Bila namespace berbeda atau tidak ada, catat temuannya dan periksa sumber berkas. Pencarian yang mengikat namespace standar dapat menghasilkan nol kecocokan pada dokumen berbeda, sehingga angka nol perlu ditafsirkan bersama hasil pemeriksaan akar dan namespace, bukan langsung disebut tidak ada halaman.

Langkah 3: Ambil elemen loc dengan XPath yang sesuai

Buat pemetaan namespace dengan $ns = @{sm='http://www.sitemaps.org/schemas/sitemap/0.9'}. Setelah itu jalankan $loc = @(Select-Xml -Xml $xml -XPath '/sm:urlset/sm:url/sm:loc' -Namespace $ns). Prefix sm adalah nama yang Anda pilih dalam pemetaan lokal. Dokumentasi Microsoft menjelaskan penggunaan pemetaan namespace pada Select-Xml, termasuk dokumen yang memakai namespace bawaan tanpa prefix pada teks XML aslinya.

Lihat jumlah elemen melalui $loc.Count. Untuk membaca teks alamat, jalankan $urls = @($loc | ForEach-Object { $_.Node.InnerText }) lalu tampilkan $urls. Pada contoh tiga entri yang masing-masing memiliki satu loc, jumlahnya tiga. Hasil ini baru menunjukkan kecocokan kueri. Anda masih perlu memeriksa entri yang kehilangan loc, isi kosong, serta alamat yang tidak sesuai sebelum menyebut daftar siap ditindaklanjuti.

Langkah 4: Cari entri yang kehilangan loc atau berisi teks kosong

Jalankan $bad = @(Select-Xml -Xml $xml -XPath '/sm:urlset/sm:url[count(sm:loc) != 1 or normalize-space(sm:loc) = ""]' -Namespace $ns), kemudian lihat $bad.Count. Kueri ini mencari entri url yang tidak mempunyai tepat satu loc atau loc-nya kosong setelah spasi dirapikan oleh XPath. Bila ada hasil, tampilkan $bad untuk mengenali entri yang perlu ditinjau pada salinan dokumen.

Membandingkan jumlah url dan loc saja belum cukup, karena kesalahan pada beberapa entri dapat saling menutupi dalam jumlah total. Periksa temuannya per entri. Pada contoh lokal dengan satu loc yang dihilangkan, kueri menandai entri tersebut meskipun dokumen masih dapat diuraikan sebagai XML. Pemeriksaan ini juga memiliki batas: ia tidak menilai seluruh tag tambahan, semua aturan skema, ataupun kesesuaian halaman yang akan ditemukan ketika alamat akhirnya diakses.

Langkah 5: Tinjau pengulangan serta bentuk alamat

Untuk meninjau pengulangan yang dikelompokkan secara peka huruf, jalankan $urls | Group-Object -CaseSensitive | Where-Object { $_.Count -gt 1 } | Select-Object Count,Name. Dokumentasi Group-Object menjelaskan bahwa CaseSensitive membedakan huruf besar dan kecil dalam pengelompokan. Jika hasil muncul, baca alamat serta jumlahnya sebelum menentukan koreksi. Jangan otomatis menghapus atau mengubah bentuk URL hanya untuk membuat hasil pemeriksaan terlihat bersih.

Baca daftar alamat untuk memastikan bentuknya lengkap dan sesuai host yang diharapkan. Google menyarankan URL absolut pada sitemap, sedangkan protokol Sitemaps menjelaskan cakupan satu host untuk format dasarnya. Latihan ini tidak menyamakan alamat berbeda secara otomatis, tidak mengikuti redirect, dan tidak memeriksa keputusan canonical. Jika beberapa alamat tampak merujuk materi yang sama, serahkan keputusan pemilihannya kepada pengelola berdasarkan keadaan website yang sebenarnya, bukan sekadar kemiripan tulisan.

Langkah 6: Catat temuan dan lakukan verifikasi ulang

Simpan hasil yang menyebut nama salinan, waktu pemeriksaan, akar, namespace, jumlah loc, jumlah entri bermasalah, dan kelompok pengulangan yang ditemukan. Setelah koreksi dilakukan pada sumber yang tepat oleh pengelola, ambil salinan baru dan ulangi urutan pemeriksaan. Pisahkan hasil lama dan baru agar perubahan dapat ditinjau. Jangan menimpa catatan awal hanya karena pemeriksaan berikutnya berhasil; riwayat tersebut membantu menjelaskan perbaikan yang benar-benar dilakukan.

Dokumen yang lolos rangkaian pemeriksaan ini masih memerlukan peninjauan sesuai kebutuhan penerapan situs. Pemeriksaan lokal tidak membuktikan halaman dapat diakses, layak diindeks, atau sudah digunakan mesin pencari. Google menegaskan pengiriman sitemap merupakan petunjuk, bukan jaminan bahwa sitemap akan diunduh atau dipakai untuk merayapi URL. Karena itu, laporkan hasil sesuai cakupannya: elemen dan daftar telah diperiksa pada salinan lokal, sementara pemeriksaan layanan aktif merupakan pekerjaan tersendiri.

Latihan pembanding: satu jenis kesalahan per salinan

Untuk memahami hasil kueri, buat salinan latihan lain dari contoh kecil yang telah diketahui strukturnya. Pada salinan pertama, kosongkan teks di dalam satu loc sambil mempertahankan tag pembuka serta penutup. Pada salinan kedua, hilangkan satu elemen loc dari entri url. Keduanya masih dapat menjadi XML yang terbaca, tetapi kueri langkah keempat seharusnya menandai entri tersebut. Kerjakan tiap perubahan pada salinan terpisah agar hasilnya mudah dihubungkan dengan tindakan yang sengaja dilakukan.

Pada salinan ketiga, ulangi satu alamat tanpa mengubah struktur entrinya. Kueri entri bermasalah dapat tetap menghasilkan nol, sementara pengelompokan alamat memperlihatkan pengulangan. Perbandingan ini menjelaskan mengapa pemeriksaan tidak cukup berhenti pada satu angka. Kueri loc juga sengaja mengikuti jalur dari akar urlset menuju url dan loc, bukan mencari setiap elemen bernama mirip di seluruh dokumen. Kembalilah ke salinan awal untuk pemeriksaan nyata dan simpan berkas latihan sebagai bahan pembelajaran, bukan sumber yang akan diterapkan pada website.

Kesalahan umum dan pengelolaan sitemap selanjutnya

Kesalahan umum ialah memakai kueri tanpa pemetaan namespace, mengira sitemapindex adalah urlset, atau menerima hasil parsing sebagai bukti bahwa semua entri sudah benar. Kesalahan lain adalah menormalkan seluruh URL dengan mengubah huruf tanpa meninjau maknanya. Gunakan jenis dokumen serta label hasil yang tepat, lalu pertahankan salinan awal. Jika sumber sitemap dibuat otomatis, koreksi sebaiknya dibahas pada sistem pembuatnya agar masalah tidak muncul kembali pada keluaran berikutnya.

Informasi hosting cPanel JagoWeb tersedia di https://www.jagoweb.com/hosting-cpanel dan pilihan layanan dapat ditinjau melalui https://www.jagoweb.com/. Gunakan kebutuhan website serta catatan pemeriksaan untuk membahas pembagian pekerjaan pengelolaan. Artikel ini tidak menyatakan semua layanan membuat sitemap atau menjalankan pengujian yang sama secara otomatis. Tentukan siapa yang merawat sumber, meninjau daftar halaman, dan memeriksa penerapannya agar hasil latihan lokal menjadi bagian dari proses pemeliharaan yang jelas.

Bacaan terkait

Sumber dan referensi