Petakan halaman dokumen terjemahan berdasarkan kandungan dan tujuannya yang sama, kemudian catat URL tepat bagi setiap bahasa. Slug yang berbeza tidak menjadi masalah. Aliran kerja Mac ini membantu editor dokumen awam membina pemetaan tersebut dan menyediakan pautan bahasa serta anotasi carian yang tepat.

Mengapa slug yang sepadan tidak diperlukan

Andaikan sebuah dokumen bahasa Inggeris menerangkan cara menyusun grid segi empat sama berwarna. Terjemahan bahasa Perancisnya menerangkan tugasan yang sama, tetapi alamat kedua-duanya berakhir secara berbeza. Google secara jelas membenarkan perkataan setempat dalam URL dan mengesyorkan URL berasingan untuk versi bahasa yang berlainan. Anda tidak perlu menamakan semula terjemahan supaya laluannya sepadan. Mengurus tapak berbilang wilayah dan berbilang bahasa.

Terdapat dua soalan berasingan yang perlu dijawab: “Adakah URL ini serupa?” dan “Adakah dokumen ini terjemahan antara satu sama lain?” Piawaian URL WHATWG mentakrifkan kesamaan URL melalui perbandingan URL bersiri. Perbandingan itu tidak membuktikan hubungan terjemahan antara alamat yang berbeza. Untuk aliran kerja ini, tentukan hubungannya berdasarkan dokumen, kemudian catatkannya secara jelas. Piawaian URL, kesetaraan URL.

Contoh di bawah ialah alamat dokumen awam rekaan di bawah example.com; contoh ini menggambarkan pemetaan yang dicadangkan, bukannya halaman langsung yang telah diambil. Tugasnya adalah menghubungkan arahan bahasa Inggeris dan Perancis yang setara sambil mengekalkan alamat sedia ada bagi setiap halaman.

Bina rekod pemetaan pada Mac anda

Mulakan dengan sepasang dokumen. Buka halaman sumber dan terjemahan yang dicadangkan dalam tab Safari berasingan, bersama dokumen pemetaan setempat. Anda memerlukan teks penuh kedua-dua versi dan, untuk pelaksanaan kelak, akses kepada tetapan penerbitan yang mengawal hubungan bahasa atau metadata halaman.

Catat alamat yang tepat

Dalam Safari, tekan Command-L untuk memilih medan Carian Pintar, kemudian Command-C untuk menyalin alamat. Ulangi langkah ini untuk terjemahan selepas pemuatannya selesai. Apple mendokumenkan kedua-dua pintasan ini. Mencatat alamat yang dicapai selepas navigasi juga memberi anda tempat untuk mengesan destinasi yang tidak dijangka. Pintasan papan kekunci dan gerak isyarat dalam Safari pada Mac.

Untuk koleksi kecil, TextEdit sudah memadai. Cipta dokumen baharu, pilih Format > Jadikan Teks Biasa, lalu simpan sebagai translation-map.txt. Menukar dokumen teks berformat sedia ada akan membuang pemformatannya, jadi gunakan dokumen baharu untuk rekod ini. Langkah ini mengikut arahan TextEdit Apple. Cipta, buka dan tukar dokumen dalam TextEdit pada Mac.

Gunakan pengecam dokumen stabil yang menerangkan tugasan asas. Berikut ialah rekod ilustrasi lengkap, bukannya fail konfigurasi yang akan dibaca secara automatik oleh sistem penerbitan:

ID Dokumen: tile-grid
Tugasan pembaca: Susun grid empat lajur segi empat sama berwarna
URL bahasa Inggeris: https://example.com/en/docs/arrange-tiles
URL bahasa Perancis: https://example.com/fr/guides/disposer-les-carres
Kod bahasa Inggeris: en
Kod bahasa Perancis: fr
Semakan skop: Arahan, rajah dan edisi dokumen yang sama
Keputusan pemetaan: Pasangan terjemahan

Pengecam ini menjadi titik rujukan apabila tajuk atau slug berubah. Simpan alamat sebagai medan berasingan dan jangan terbitkan satu daripada yang lain. Menggantikan /en/ dengan /fr/ dalam contoh ini akan menghasilkan alamat yang belum disahkan dan tidak menangani laluan terjemahan sebenar.

Semak sama ada kedua-dua dokumen menyelesaikan tugasan yang sama

Bandingkan pengenalan, arahan, label rajah, contoh dan edisi. Tajuk terjemahan tidak perlu menyerupai satu sama lain secara kata demi kata. Sebaliknya, tanyakan sama ada pembaca yang memilih bahasa lain akan menerima arahan yang setara untuk aktiviti yang sama.

Gunakan jadual keputusan ini sebelum menambahkan halaman pada pemetaan. Jadual ini ialah panduan editorial yang berasaskan keperluan untuk mengenal pasti versi alternatif bagi kandungan yang sama:

Perkara yang ditemui Keputusan pemetaan
Arahan grid dan edisi yang sama, dengan teks terjemahan Catat sebagai pasangan terjemahan
Satu halaman membincangkan grid; satu lagi tentang memilih warna Kekalkan sebagai dokumen berasingan
Satu terjemahan menerangkan edisi terdahulu Selesaikan perbezaan edisi sebelum mengumpulkannya
Hanya navigasi yang diterjemahkan Jangan catat dokumen utama sebagai terjemahan penuh
Tiada dokumen sepadan Biarkan bahasa itu tiada dalam pemetaan dokumen ini

Contohnya, tinjauan umum bahasa Perancis yang memautkan kepada beberapa aktiviti melukis tidak menggantikan arahan khusus grid dalam bahasa Inggeris. Catat terjemahan yang tiada itu sebagai tugasan kandungan yang belum selesai. Destinasi umum masih boleh berguna sebagai navigasi, tetapi destinasi itu tidak menyediakan dokumen setara yang diperlukan oleh pemetaan ini.

Hubungkan halaman yang dipetakan untuk pembaca dan Google

Rekod setempat anda ialah sumber editorial bagi hubungan tersebut. Halaman yang diterbitkan juga memerlukan cara untuk menyatakannya. Mulakan dengan pautan bahasa yang kelihatan dan membawa pembaca terus ke halaman sepadan yang dipetakan. Google mengesyorkan pautan antara versi bahasa supaya pembaca boleh memilih, dan menasihatkan agar pelawat tidak diubah hala secara automatik berdasarkan bahasa yang diandaikan. Mengurus tapak berbilang wilayah dan berbilang bahasa.

Untuk anotasi carian, Google menyokong tiga kaedah yang setara: elemen HTML, pengepala respons HTTP dan peta laman XML. Pilih satu kaedah yang mudah diselenggara. Setiap versi bahasa perlu mengenal pasti dirinya sendiri dan versi alternatifnya menggunakan URL yang lengkap, dengan pautan timbal balik. Maklumkan Google tentang versi setempat halaman anda.

Untuk halaman HTML, sediakan pautan alternatif

Piawaian HTML WHATWG mentakrifkan alternate dengan nilai hreflang yang berbeza sebagai penanda terjemahan. Berikut ialah fragmen metadata HTML untuk pasangan rekaan ini; fragmen tersebut perlu diletakkan di dalam elemen head sedia ada pada setiap halaman. Ini bukan dokumen HTML lengkap. Piawaian HTML, jenis pautan “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">

Letakkan pasangan yang sama pada kedua-dua halaman. URL destinasi kekal berbeza, termasuk slugnya. Dokumentasi Google memerlukan pautan balik dan menyokong kod bahasa sahaja seperti en dan fr. Maklumkan Google tentang versi setempat halaman anda.

Untuk PDF, gunakan kaedah penerbitan yang disokong

PDF tidak boleh menerima fragmen di atas dalam head HTML. Google mendokumenkan pengepala respons Link HTTP untuk fail bukan HTML. Bagi pasangan PDF rekaan, medan pengepala lengkapnya ialah: Maklumkan Google tentang versi setempat halaman anda.

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 medan itu pada respons bagi setiap PDF. RFC 8288 mentakrifkan sintaks pemautan HTTP, termasuk sasaran dalam kurungan sudut dan parameter hreflang. Ini ialah tetapan respons; menaip pengepala itu ke dalam teks yang kelihatan pada PDF tidak akan mengkonfigurasikannya. RFC 8288: Pemautan Web.

Jika sistem penerbitan anda tidak dapat menyunting metadata HTML atau pengepala respons, Google turut menyokong peta laman dengan anotasi bahasa. Setiap entri URL menyenaraikan semua versi, termasuk dirinya sendiri. Gunakan struktur peta laman yang didokumenkan melalui sistem penerbitan anda atau penyelenggaranya. Fail pemetaan setempat sahaja tidak melaksanakan mana-mana kaedah ini. Maklumkan Google tentang versi setempat halaman anda.

Asingkan hubungan terjemahan daripada ubah hala dan URL kanonik

Alternatif bahasa, URL pendua pilihan dan halaman yang telah dipindahkan mewakili hubungan yang berbeza. Membezakan perkara ini mengelakkan perubahan pemetaan yang berniat baik daripada mengalihkan pembaca daripada dokumen yang mereka pilih.

Mekanisme Tujuan yang didokumenkan Penggunaan untuk tugasan ini
rel="alternate" dengan hreflang Mengenal pasti alternatif bahasa Menghubungkan terjemahan yang dipetakan
rel="canonical" Menunjukkan URL pilihan antara halaman pendua atau yang sangat serupa Mengendalikan alamat pendua dalam bahasa yang berkenaan
Location dalam respons ubah hala Mengenal pasti destinasi ubah hala Mengendalikan alamat yang telah dipindahkan
Content-Language Menerangkan khalayak bahasa yang disasarkan oleh representasi Melabel khalayak respons
Content-Location Mengenal pasti sumber yang sepadan dengan representasi yang disertakan Menerangkan lokasi representasi

Google mengesyorkan URL kanonik dalam bahasa yang sama apabila menggunakan hreflang, atau pengganti terbaik jika tiada. Bagi dokumen terjemahan yang berbeza ini, URL kanonik yang merujuk kepada dirinya sendiri pada setiap URL bahasa pilihan ialah pelaksanaan yang mudah. Elakkan menghalakan URL kanonik bahasa Perancis kepada bahasa Inggeris hanya kerana dokumen bahasa Inggeris ditulis terlebih dahulu. Cara menentukan URL kanonik dengan rel="canonical" dan kaedah lain.

RFC 9110 mentakrifkan Location dalam respons ubah hala, Content-Language dan Content-Location secara berasingan. Medan yang terakhir ialah metadata representasi, bukannya pengganti URL sasaran. Tiada satu pun medan itu dengan sendirinya menyenaraikan pasangan terjemahan dokumen ini; kekalkan pautan alternatif untuk hubungan tersebut. RFC 9110: Semantik HTTP.

Sahkan kedua-dua arah dan selenggara pemetaan

Sebelum menyerahkan pemetaan untuk pelaksanaan, lakukan semakan berikut. Ulangi semakan pada output awam selepas sebarang perubahan penerbitan kemudian; rekod yang betul dan metadata terbitan yang betul ialah dua perkara berasingan.

  1. Buka kedua-dua alamat yang dicatat dan bandingkan kandungan dokumen sebenar.
  2. Ikuti pautan bahasa yang kelihatan daripada bahasa Inggeris ke bahasa Perancis, kemudian kembali semula. Pastikan setiap destinasi ialah halaman sepadan yang khusus.
  3. Bandingkan URL alternatif yang dikonfigurasikan dengan rekod pemetaan, aksara demi aksara.
  4. Pastikan kedua-dua versi mengenal pasti set terjemahan yang sama, termasuk dirinya sendiri.
  5. Semak tetapan URL kanonik secara berasingan bagi setiap bahasa.
  6. Jika alamat berubah, kemas kini pemetaan dan setiap rujukan kepada alamat itu dalam pasangan tersebut.

Berhati-hati semasa mengemas URL. RFC 9110 menganggap huruf besar dan kecil dalam skema serta hos sebagai tidak sensitif huruf besar dan kecil, manakala komponen lain dibandingkan dengan mengambil kira huruf besar dan kecil di bawah peraturan penormalannya. Jangan tukar laluan kepada huruf kecil atau buang garis miring di hujung semata-mata supaya dua rekod kelihatan konsisten; kekalkan destinasi yang telah disahkan. RFC 9110, penormalan dan perbandingan HTTP(S).

Bagi pasangan rekaan ini, hasil yang berguna ialah rekod tile-grid yang stabil dan menghubungkan dua alamat tepat, dengan kandungan setara serta pautan yang berfungsi dalam kedua-dua arah. Simpan rekod itu bersama nota penyelenggaraan dokumen supaya terjemahan atau perubahan slug pada masa hadapan dapat mengemas kini hubungan tersebut secara terancang.

Sumber