Çevrilmiş belge sayfalarını ortak içerik ve amaçlarına göre eşleştirin, ardından her dilin tam URL’sini kaydedin. Slug’ların farklı olması sorun değildir. Bu Mac iş akışı, kamuya açık belgelerin editörlerinin bu eşlemeyi oluşturmasına ve doğru dil bağlantılarıyla arama açıklamalarını hazırlamasına yardımcı olur.

Slug’ların eşleşmesi neden gerekmez

Diyelim ki İngilizce bir belge, renkli karelerden oluşan bir ızgaranın nasıl düzenleneceğini açıklıyor. Fransızca çevirisi de aynı görevi açıklıyor, ancak iki adres farklı şekilde bitiyor. Google, URL’lerde yerelleştirilmiş sözcüklere açıkça izin verir ve farklı dil sürümleri için ayrı URL’ler önerir. Yolların eşleşmesi için çevirileri yeniden adlandırmanız gerekmez. Bölgesel ve çok dilli siteleri yönetme.

Yanıtlanması gereken iki ayrı soru vardır: “Bu URL’ler aynı mı?” ve “Bu belgeler birbirinin çevirisi mi?” WHATWG URL Standardı, URL eşitliğini serileştirilmiş URL’lerin karşılaştırılmasıyla tanımlar. Bu karşılaştırma, farklı adresler arasında çeviri ilişkisi olduğunu göstermez. Bu iş akışında ilişkiyi belgelerden belirleyin, ardından açıkça kaydedin. URL Standardı, URL eşdeğerliği.

Aşağıdaki örnekler example.com altındaki yapay kamu belgesi adresleridir; alınmış canlı sayfaları değil, önerilen bir eşlemeyi gösterir. Amaç, İngilizce ve Fransızca talimatların eşdeğer olanlarını birbirine bağlarken her sayfanın mevcut adresini korumaktır.

Mac’inizde bir eşleme kaydı oluşturun

Tek bir belge çiftiyle başlayın. Kaynak sayfayı ve önerilen çevirisini ayrı Safari sekmelerinde, yerel bir eşleme belgesinin yanında açık tutun. Her iki sürümün tam metnine ve uygulama aşamasında dil ilişkilerini ya da sayfa meta verilerini denetleyen yayın ayarlarına erişmeniz gerekir.

Tam adresleri kaydedin

Safari’de Command-L tuşlarına basarak Akıllı Arama alanını seçin, ardından adresi kopyalamak için Command-C tuşlarına basın. Çeviri yüklendikten sonra aynı işlemi tekrarlayın. Apple her iki kısayolu da belgeliyor. Gezinme sonrasında ulaşılan adresi kaydetmek, beklenmedik bir hedefi fark etmenizi de sağlar. Mac’te Safari’de klavye kestirmeleri ve hareketler.

Küçük bir koleksiyon için TextEdit yeterlidir. Yeni bir belge oluşturun, Biçim > Düz Metin Yap seçeneğini belirleyin ve belgeyi translation-map.txt olarak kaydedin. Mevcut bir zengin metin belgesini dönüştürmek biçimlendirmesini kaldırır; bu nedenle bu kayıt için yeni bir belge kullanın. Bu işlemler Apple’ın TextEdit talimatlarını izler. Mac’te TextEdit’te belge oluşturma, açma ve dönüştürme.

Altta yatan görevi açıklayan sabit bir belge tanımlayıcısı kullanın. Aşağıdaki, eksiksiz ve açıklayıcı bir kayıt örneğidir; bir yayın sisteminin otomatik olarak okuyacağı bir yapılandırma dosyası değildir:

Belge kimliği: tile-grid
Okuyucu görevi: Dört sütunlu renkli kareler ızgarasını düzenleme
İngilizce URL: https://example.com/en/docs/arrange-tiles
Fransızca URL: https://example.com/fr/guides/disposer-les-carres
İngilizce dil kodu: en
Fransızca dil kodu: fr
Kapsam kontrolü: Aynı talimatlar, diyagram ve belge sürümü
Eşleme kararı: Çeviri çifti

Başlıklar veya slug’lar değiştiğinde bu tanımlayıcı bir dayanak sağlar. Adresleri birbirinden türetmek yerine ayrı alanlarda tutun. Bu örnekte /en/ yerine /fr/ yazmak, doğrulanmamış bir adres oluşturur ve gerçek çeviri yolunu gözden kaçırır.

Belgelerin aynı görevi tamamlayıp tamamlamadığını kontrol edin

Girişi, talimatları, diyagram etiketlerini, örnekleri ve sürümü karşılaştırın. Çevrilmiş başlıkların kelimesi kelimesine birbirine benzemesi gerekmez. Bunun yerine, diğer dili seçen bir okuyucunun aynı etkinlik için eşdeğer talimatlar alıp almayacağını sorun.

Bir sayfayı eşlemeye eklemeden önce bu karar tablosunu kullanın. Aynı içeriğin alternatif sürümlerini belirleme gereksiniminden türetilmiş bir editoryal yardımcıdır:

Bulduğunuz durum Eşleme kararı
Çevrilmiş metinle birlikte aynı ızgara talimatları ve sürüm Çeviri çifti olarak kaydedin
Bir sayfa ızgaraları, diğeri renk seçimini ele alıyor Ayrı belgeler olarak tutun
Çevirilerden biri önceki bir sürümü açıklıyor Gruplamadan önce sürüm farkını giderin
Yalnızca gezinme çevrilmiş Ana belgeyi tamamen çevrilmiş olarak kaydetmeyin
Karşılık gelen bir belge yok Bu belgenin eşlemesinde o dili boş bırakın

Örneğin, çeşitli çizim etkinliklerine bağlantı veren Fransızca bir genel bakış, belirli İngilizce ızgara talimatlarının yerini tutmaz. Eksik çeviriyi tamamlanmamış bir içerik görevi olarak kaydedin. Genel bir hedef gezinme açısından yine de yararlı olabilir, ancak bu eşlemenin gerektirdiği eşdeğer belgeyi sağlamaz.

Eşlenen sayfaları okuyucular ve Google için bağlayın

Yerel kaydınız, ilişkinin editoryal kaynağıdır. Yayınlanan sayfaların da bu ilişkiyi ifade edecek bir yönteme ihtiyacı vardır. Okuyucuları doğrudan eşleşen karşılıklarına götüren, görünür dil bağlantılarıyla başlayın. Google, okuyucuların seçim yapabilmesi için dil sürümleri arasında bağlantı kurulmasını önerir ve ziyaretçilerin varsayılan dillerine göre otomatik yönlendirilmemesini tavsiye eder. Bölgesel ve çok dilli siteleri yönetme.

Google, arama açıklamaları için eşdeğer üç yöntemi destekler: HTML öğeleri, HTTP yanıt başlıkları ve XML site haritaları. Sürdürülebilir bir yöntem seçin. Her dil sürümü, kendisini ve alternatiflerini tam nitelikli URL’lerle tanımlamalı ve karşılıklı bağlantılar içermelidir. Sayfanızın yerelleştirilmiş sürümlerini Google’a bildirin.

HTML sayfaları için alternatif bağlantıları hazırlayın

WHATWG HTML Standardı, farklı bir hreflang değerine sahip alternate öğesinin çeviriyi belirttiğini tanımlar. Aşağıda yapay çift için bir HTML meta veri parçası verilmiştir; bu parça, her sayfanın mevcut head öğesinin içinde yer almalıdır. Tam bir HTML belgesi değildir. HTML Standardı, “alternate” bağlantı türü.

<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">

Aynı çifti her iki sayfaya da ekleyin. Slug’ları da dahil olmak üzere hedef URL’ler farklı kalır. Google’ın belgeleri, karşılıklı bağlantıları zorunlu tutar ve en ile fr gibi yalnızca dil belirten kodları destekler. Sayfanızın yerelleştirilmiş sürümlerini Google’a bildirin.

PDF’ler için desteklenen bir yayın yöntemi kullanın

Bir PDF’ye önceki parçayı HTML head içine ekleyemezsiniz. Google, HTML dışı dosyalar için HTTP Link yanıt başlıklarını belgeliyor. Yapay bir PDF çifti için tam başlık alanı şöyle olur: Sayfanızın yerelleştirilmiş sürümlerini Google’a bildirin.

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"

Bu alanı her PDF’nin yanıtında yapılandırın. RFC 8288, köşeli ayraç içindeki hedef ve hreflang parametresi dahil HTTP bağlantı söz dizimini tanımlar. Bunlar yanıt ayarlarıdır; başlığı PDF’nin görünen metnine yazmak onları yapılandırmaz. RFC 8288: Web Bağlantıları.

Yayın sisteminiz HTML meta verilerini veya yanıt başlıklarını düzenleyemiyorsa Google, dil açıklamaları içeren bir site haritasını da destekler. Her URL girdisi, kendisi dahil tüm sürümleri listeler. Belgelenen site haritası yapısını yayın sisteminiz veya sistemin bakımından sorumlu kişi aracılığıyla kullanın. Tek başına yerel bir eşleme dosyası bu yöntemlerin hiçbirini uygulamaz. Sayfanızın yerelleştirilmiş sürümlerini Google’a bildirin.

Çeviri ilişkilerini yönlendirmelerden ve kanonik URL’lerden ayrı tutun

Dil alternatifi, tercih edilen yinelenen bir URL ve taşınmış bir sayfa farklı ilişkileri ifade eder. Bu ayrımı yapmak, iyi niyetli bir eşleme değişikliğinin okuyucuları seçtikleri belgeden uzaklaştırmasını önler.

Mekanizma Belgelenen amaç Bu görevdeki uygulaması
rel="alternate" ve hreflang Dil alternatiflerini belirlemek Eşlenen çevirileri bağlamak
rel="canonical" Yinelenen veya çok benzer sayfalar arasından tercih edilen URL’yi belirtmek Uygun dil içindeki yinelenen adresleri ele almak
Yönlendirme yanıtındaki Location Yönlendirmenin hedefini belirtmek Taşınmış bir adresi ele almak
Content-Language Sunumun hedeflediği dil kitlesini tanımlamak Yanıtın hedef kitlesini belirtmek
Content-Location Sunulan içerikle eşleşen kaynağı belirtmek Sunumun konumunu açıklamak

Google, hreflang kullanırken aynı dilde bir kanonik URL veya yoksa en iyi alternatifi önerir. Bu farklı çeviri belgeleri için her tercih edilen dil URL’sinde kendini gösteren bir kanonik URL kullanmak basit bir uygulamadır. Fransızca kanonik URL’yi yalnızca İngilizce önce yazıldı diye İngilizceye yönlendirmekten kaçının. rel="canonical" ve diğer yöntemlerle kanonik URL belirtme.

RFC 9110; yönlendirme yanıtlarındaki Location, Content-Language ve Content-Location alanlarını ayrı ayrı tanımlar. Sonuncusu, hedef URL’nin yerine geçen bir alan değil, sunum meta verisidir. Bu alanların hiçbiri tek başına bu belgenin çeviri çiftini listelemez; bu ilişki için alternatif bağlantıları koruyun. RFC 9110: HTTP Semantiği.

Her iki yönü doğrulayın ve eşlemeyi güncel tutun

Uygulama için eşlemeyi teslim etmeden önce aşağıdaki kontrolleri yapın. Daha sonraki yayın değişikliklerinden sonra da bunları herkese açık çıktı üzerinde tekrarlayın; doğru kayıt ile doğru yayınlanmış meta veriler ayrı şeylerdir.

  1. Kaydedilmiş her iki adresi açın ve gerçek belge içeriklerini karşılaştırın.
  2. Görünür dil bağlantısını izleyerek İngilizceden Fransızcaya, ardından tekrar geri dönün. Her hedefin tam olarak eşleşen karşılık olduğundan emin olun.
  3. Yapılandırılmış alternatif URL’leri eşleme kaydıyla karakter karakter karşılaştırın.
  4. Her iki sürümün de kendileri dahil aynı çeviri kümesini tanımladığını doğrulayın.
  5. Her dil için kanonik ayarlarını ayrı ayrı kontrol edin.
  6. Bir adres değişirse haritayı ve çiftte bu adrese yapılan tüm başvuruları güncelleyin.

URL’leri temizlerken dikkatli olun. RFC 9110, şema ile ana makine adının büyük küçük harfe duyarsız olduğunu, diğer bileşenlerin ise normalleştirme kuralları uyarınca büyük küçük harfe duyarlı karşılaştırıldığını belirtir. İki kaydın tutarlı görünmesi için yolu küçük harfe çevirmeyin veya sondaki eğik çizgiyi kaldırmayın; doğrulanmış hedefi koruyun. RFC 9110, HTTP(S) normalleştirme ve karşılaştırma.

Yapay çift için elde edilmesi gereken sonuç, eşdeğer içeriğe ve her iki yönde çalışan bağlantılara sahip iki tam adresi birbirine bağlayan sabit bir tile-grid kaydıdır. İleride bir çeviri veya slug değiştiğinde ilişkiyi bilinçli biçimde güncelleyebilmek için bu kaydı belgenin bakım notlarıyla birlikte saklayın.

Kaynaklar