Petakan halaman dokumen terjemahan berdasarkan kesamaan konten dan tujuannya, lalu catat URL persis untuk setiap bahasa. Slug yang berbeda tidak masalah. Alur kerja Mac ini membantu editor dokumen publik menyusun pemetaan tersebut dan menyiapkan tautan bahasa serta anotasi penelusuran yang akurat.

Mengapa slug yang sama tidak diperlukan

Misalkan sebuah dokumen berbahasa Inggris menjelaskan cara menyusun kisi persegi berwarna. Terjemahan bahasa Prancisnya menjelaskan tugas yang sama, tetapi akhiran kedua alamatnya berbeda. Google secara eksplisit mengizinkan kata-kata yang dilokalkan dalam URL dan menyarankan URL terpisah untuk versi bahasa yang berbeda. Anda tidak perlu mengganti nama terjemahan agar jalurnya sama. Mengelola situs multiregional dan multibahasa.

Ada dua pertanyaan terpisah yang perlu dijawab: “Apakah URL ini identik?” dan “Apakah dokumen-dokumen ini merupakan terjemahan satu sama lain?” WHATWG URL Standard mendefinisikan kesamaan URL melalui perbandingan URL yang diserialisasi. Perbandingan itu tidak menetapkan hubungan penerjemahan antara alamat yang berbeda. Untuk alur kerja ini, tentukan hubungannya berdasarkan dokumen, lalu catat secara eksplisit. URL Standard, kesetaraan URL.

Contoh di bawah ini adalah alamat dokumen publik sintetis di bawah example.com; contoh tersebut menunjukkan pemetaan yang diusulkan, bukan halaman aktif yang diambil. Tugasnya adalah menghubungkan petunjuk bahasa Inggris dan Prancis yang setara sambil mempertahankan alamat yang sudah ada untuk setiap halaman.

Buat catatan pemetaan di Mac Anda

Mulailah dengan satu pasang dokumen. Buka halaman sumber dan terjemahan yang diusulkan di tab Safari terpisah, bersama dokumen pemetaan lokal. Anda memerlukan teks lengkap dari kedua versi dan, untuk penerapan nanti, akses ke pengaturan penerbitan yang mengatur hubungan bahasa atau metadata halaman.

Catat alamat persisnya

Di Safari, tekan Command-L untuk memilih bidang Pencarian Cerdas, lalu Command-C untuk menyalin alamat. Ulangi untuk terjemahannya setelah selesai dimuat. Apple mendokumentasikan kedua pintasan tersebut. Mencatat alamat yang dituju setelah navigasi juga memberi Anda cara untuk mengetahui jika tujuan akhirnya tidak sesuai harapan. Pintasan papan ketik dan gerakan di Safari pada Mac.

Untuk koleksi kecil, TextEdit sudah memadai. Buat dokumen baru, pilih Format > Jadikan Teks Biasa, lalu simpan sebagai translation-map.txt. Mengubah dokumen teks kaya yang sudah ada akan menghapus pemformatannya, jadi gunakan dokumen baru untuk catatan ini. Langkah-langkah ini mengikuti petunjuk TextEdit dari Apple. Membuat, membuka, dan mengonversi dokumen di TextEdit pada Mac.

Gunakan pengenal dokumen stabil yang menggambarkan tugas dasarnya. Berikut catatan ilustratif lengkap, bukan berkas konfigurasi yang akan dibaca secara otomatis oleh sistem penerbitan:

Document ID: tile-grid
Reader task: Arrange a four-column grid of colored squares
English URL: https://example.com/en/docs/arrange-tiles
French URL: https://example.com/fr/guides/disposer-les-carres
English language code: en
French language code: fr
Scope check: Same instructions, diagram, and document edition
Mapping decision: Translation pair

Pengenal tersebut menjadi acuan saat judul atau slug berubah. Simpan alamat sebagai kolom terpisah, alih-alih menyimpulkan salah satunya dari alamat lain. Mengganti /en/ dengan /fr/ dalam contoh ini akan menghasilkan alamat yang belum diverifikasi dan melewatkan jalur terjemahan yang sebenarnya.

Periksa apakah dokumennya menyelesaikan tugas yang sama

Bandingkan pengantar, petunjuk, label diagram, contoh, dan edisi. Judul terjemahan tidak harus menyerupai satu sama lain kata demi kata. Sebaliknya, tanyakan apakah pembaca yang memilih bahasa lain akan mendapatkan petunjuk yang setara untuk kegiatan yang sama.

Gunakan tabel keputusan ini sebelum menambahkan halaman ke pemetaan. Tabel ini merupakan panduan editorial yang didasarkan pada kebutuhan untuk mengenali versi alternatif dari konten yang sama:

Temuan Keputusan pemetaan
Petunjuk kisi dan edisinya sama, dengan teks yang diterjemahkan Catat sebagai pasangan terjemahan
Satu halaman membahas kisi; halaman lain membahas pemilihan warna Pisahkan sebagai dokumen berbeda
Satu terjemahan menjelaskan edisi terdahulu Selesaikan perbedaan edisi sebelum mengelompokkannya
Hanya navigasinya yang diterjemahkan Jangan catat dokumen utama sebagai dokumen yang diterjemahkan sepenuhnya
Dokumen yang bersesuaian tidak tersedia Biarkan bahasa tersebut tidak tercantum dalam pemetaan dokumen ini

Sebagai contoh, ikhtisar bahasa Prancis yang menautkan ke beberapa kegiatan menggambar tidak dapat menggantikan petunjuk kisi spesifik dalam bahasa Inggris. Catat terjemahan yang belum tersedia sebagai tugas konten yang masih tertunda. Tujuan yang lebih umum tetap dapat berguna sebagai navigasi, tetapi tidak menyediakan dokumen setara yang dibutuhkan dalam pemetaan ini.

Hubungkan halaman yang dipetakan untuk pembaca dan Google

Catatan lokal Anda adalah sumber editorial untuk hubungan tersebut. Halaman yang diterbitkan juga memerlukan cara untuk menyatakannya. Mulailah dengan tautan bahasa yang terlihat dan mengarahkan pembaca langsung ke halaman padanannya dalam bahasa lain. Google menyarankan tautan antarversi bahasa agar pembaca dapat memilih, serta menyarankan agar pengunjung tidak dialihkan secara otomatis berdasarkan bahasa yang diasumsikan. Mengelola situs multiregional dan multibahasa.

Untuk anotasi penelusuran, Google mendukung tiga metode yang setara: elemen HTML, header respons HTTP, dan peta situs XML. Pilih satu metode yang mudah dipelihara. Setiap versi bahasa harus mencantumkan dirinya sendiri dan versi alternatifnya menggunakan URL yang sepenuhnya memenuhi syarat, dengan tautan timbal balik. Beri tahu Google tentang versi halaman Anda yang dilokalkan.

Untuk halaman HTML, siapkan tautan alternatif

WHATWG HTML Standard menetapkan bahwa alternate dengan nilai hreflang yang berbeda menunjukkan suatu terjemahan. Berikut fragmen metadata HTML untuk pasangan sintetis; letakkan di dalam elemen head yang sudah ada pada setiap halaman. Ini bukan dokumen HTML lengkap. HTML Standard, jenis tautan “alternate”.

<link rel="alternate" hreflang="en" href="https://example.com/en/docs/arrange-tiles">
<link rel="alternate" hreflang="fr" href="https://example.com/fr/guides/disposer-les-carres">

Cantumkan pasangan yang sama di kedua halaman. URL tujuannya tetap berbeda, termasuk slug-nya. Dokumentasi Google mensyaratkan tautan balik dan mendukung kode bahasa saja, seperti en dan fr. Beri tahu Google tentang versi halaman Anda yang dilokalkan.

Untuk PDF, gunakan metode penerbitan yang didukung

PDF tidak dapat menerima fragmen sebelumnya di dalam head HTML. Google mendokumentasikan header respons Link HTTP untuk berkas non-HTML. Untuk pasangan PDF sintetis, kolom header lengkapnya adalah: Beri tahu Google tentang versi halaman Anda yang dilokalkan.

Link: <https://example.com/en/files/tile-grid.pdf>; rel="alternate"; hreflang="en", <https://example.com/fr/fichiers/grille-de-carres.pdf>; rel="alternate"; hreflang="fr"

Konfigurasikan kolom tersebut pada respons untuk setiap PDF. RFC 8288 mendefinisikan sintaks penautan HTTP, termasuk target di dalam tanda kurung sudut dan parameter hreflang. Ini adalah pengaturan respons; mengetikkan header ke teks PDF yang terlihat tidak akan mengonfigurasikannya. RFC 8288: Penautan Web.

Jika sistem penerbitan Anda tidak dapat mengedit metadata HTML atau header respons, Google juga mendukung peta situs dengan anotasi bahasa. Setiap entri URL mencantumkan semua versi, termasuk versinya sendiri. Gunakan struktur peta situs yang didokumentasikan melalui sistem penerbitan atau pengelolanya. Berkas pemetaan lokal saja tidak menerapkan satu pun metode ini. Beri tahu Google tentang versi halaman Anda yang dilokalkan.

Pisahkan hubungan terjemahan dari pengalihan dan kanonis

Alternatif bahasa, URL duplikat pilihan, dan halaman yang dipindahkan menunjukkan hubungan yang berbeda. Membedakannya mencegah perubahan pemetaan yang bermaksud baik mengalihkan pembaca dari dokumen yang mereka pilih.

Mekanisme Tujuan yang didokumentasikan Penerapan untuk tugas ini
rel="alternate" dengan hreflang Mengidentifikasi alternatif bahasa Menghubungkan terjemahan yang dipetakan
rel="canonical" Menunjukkan URL pilihan di antara halaman duplikat atau yang sangat mirip Menangani alamat duplikat dalam bahasa yang sesuai
Location dalam respons pengalihan Menunjukkan tujuan pengalihan Menangani alamat yang telah dipindahkan
Content-Language Menjelaskan audiens bahasa yang dituju untuk representasi tersebut Menandai audiens respons
Content-Location Mengidentifikasi sumber daya yang sesuai dengan representasi yang disertakan Menjelaskan lokasi representasi

Google menyarankan kanonis dalam bahasa yang sama saat menggunakan hreflang, atau pengganti terbaik jika tidak ada. Untuk dokumen terjemahan yang berbeda ini, penggunaan kanonis yang merujuk ke URL bahasa pilihan masing-masing merupakan penerapan yang lugas. Hindari mengarahkan kanonis bahasa Prancis ke bahasa Inggris hanya karena bahasa Inggris ditulis lebih dahulu. Cara menetapkan URL kanonis dengan rel="canonical" dan metode lainnya.

RFC 9110 mendefinisikan Location dalam respons pengalihan, Content-Language, dan Content-Location secara terpisah. Yang terakhir adalah metadata representasi, bukan pengganti URL tujuan. Tidak satu pun kolom tersebut dengan sendirinya mencantumkan pasangan terjemahan dokumen ini; tetap gunakan tautan alternatif untuk hubungan tersebut. RFC 9110: Semantik HTTP.

Verifikasi kedua arah dan pelihara pemetaan

Sebelum menyerahkan pemetaan untuk diterapkan, lakukan pemeriksaan berikut. Ulangi pemeriksaan terhadap hasil yang tersedia untuk publik setelah perubahan penerbitan berikutnya; catatan yang benar dan metadata terbitan yang benar adalah dua hal terpisah.

  1. Buka kedua alamat yang dicatat dan bandingkan konten dokumen yang sebenarnya.
  2. Ikuti tautan bahasa yang terlihat dari bahasa Inggris ke bahasa Prancis, lalu kembali lagi. Pastikan setiap tujuan mengarah ke halaman padanan yang tepat.
  3. Bandingkan URL alternatif yang dikonfigurasi dengan catatan pemetaan, karakter demi karakter.
  4. Pastikan kedua versi mencantumkan set terjemahan yang sama, termasuk dirinya sendiri.
  5. Periksa pengaturan kanonis untuk setiap bahasa secara terpisah.
  6. Jika alamat berubah, perbarui pemetaan dan setiap referensi ke alamat tersebut dalam pasangan itu.

Berhati-hatilah saat merapikan URL. RFC 9110 menetapkan bahwa huruf pada skema dan host tidak peka huruf besar-kecil, sementara komponen lain dibandingkan dengan membedakan huruf besar-kecil sesuai aturan normalisasinya. Jangan mengubah jalur menjadi huruf kecil atau menghapus garis miring di akhir hanya agar dua catatan tampak konsisten; pertahankan tujuan yang sudah diverifikasi. RFC 9110, normalisasi dan perbandingan HTTP(S).

Untuk pasangan sintetis ini, hasil yang berguna adalah catatan tile-grid yang stabil dan menghubungkan dua alamat persis, dengan konten setara dan tautan dua arah yang berfungsi. Simpan catatan tersebut bersama catatan pemeliharaan dokumen agar perubahan terjemahan atau slug di kemudian hari dapat memperbarui hubungan itu secara terencana.

Sumber