Hakkında

Polyglot, Jekyll blogları için açık kaynaklı bir uluslararasılaştırma eklentisidir. Polyglot'u herhangi bir projeyle kurmak ve kullanmak kolaydır ve desteklemek istediğiniz dillere göre ölçeklenir. Eksik içerik için yedek destek, otomatik URL göreceliştirme ve güçlü SEO tarifleri ile Polyglot, herhangi bir çok dilli blogun gereksiz işler olmadan içeriğe odaklanmasını sağlar.

jekyll-polyglot henüz github-actions’da yerel olarak desteklenmiyor

Kurulum

gem install jekyll-polyglot

Desteklenen Dilleri Yönetme

_config.yml dosyasında, aşağıdaki özellikler web sitenizin hangi dilleri desteklediğini yönetir. Bu değerlere ekleyerek yeni bir dil için destek sağlayabilirsiniz (aşağıya bakın). Diller, resmi yerel ayar kodları ile tanımlanır.

languages: ["en", "es", "fr", "de"]
default_lang: "en"
exclude_from_localization: ["images", "fonts", "sitemap"]
url: https://polyglot.untra.io

languages: web sitesi tarafından desteklenen dilleri tanımlayan yerel ayar kodları dizisi.
default_lang: web sitesi için varsayılan dil.
exclude_from_localization: oluşturulan web sitesinin parçası olan ancak yerelleştirilmesi gerekmeyen klasörler ve dizinler. Bu öncelikle derleme sürelerini kısaltmak içindir ve resimler ve yazı tipleri gibi varlık dosyaları web sitesinin büyük bölümlerini oluşturduğundan, bunların gereksiz yere “çevrilmemesini” veya çıktıda çoğaltılmamasını sağlar.
url üretim statik web sitenizin url’si.

Yeni Bir Dil Ekleme

Zaten çalışan tek dilli bir web siteniz olduğunu varsayarsak, yeni bir dil eklemek önemsiz olmayacaktır. Gerçekten çok dilli bir web sitesi yapmak için tüm içeriğinizi yeni dilde yeniden oluşturmanız gerekecektir. Bu büyük bir girişim gibi görünebilir, ancak çeviriyi parçalar halinde düşünün. İçerik kraldır; yeni sayfaların ve gönderilerin çeviride güncellenmesi daha önemlidir. Çok dilli bir web sitesi yapmak, yalnızca baştan mükemmel çevrilmesini gerektirirseniz zordur.

İlk olarak, siz (ve ekibiniz ve etrafınızda varsa yöneticileriniz de) yeni web sitesine hangi içeriğin çevrilmesi gerektiğini tartışmalı ve seçmelisiniz. Çevirilecek tercih ettiğiniz temel içeriği seçmelisiniz. Analizleri, popüler sayfaları ve blog gönderilerini ve mevcut ve gelecekteki kullanıcıların web sitenize akışını göz önünde bulundurun. Şüphe durumunda, sayfalara eski blog gönderilerinden öncelik verin. Yeni bir dili daha erken başlatmak anlamına geliyorsa, eski gönderileri çevirmek için harcanan çaba, değerine değmeyebilir.

İkinci olarak, siteniz boyunca zengin içeriğin %100 kapsamını sağlamalısınız (veya güçlü bir şekilde sağlamalısınız). Bunlar daha karmaşık şekillerde gömülü küçük dizelerdir. Zengin içerik üzerinde yinelemenin birden fazla yolu vardır. Unutmayın, zengin içeriğinizdeki tüm dil küçük dizelerini desteklemelisiniz.

Çok Dilli İçerik

Web sitesi içeriği iki çeşittir: temel ve zengin.

Temel içerik, blog gönderilerinin, sayfaların ve etkileşimli olmayan içeriğin düz metnidir. Sayfaları ve gönderileri düşünün. Temel içerik, web sitelerinizin tıklamaları için yakıttır. Polyglot, temel içerik için yedek destek sağlar.

Zengin içerik etkileşimli, gösterişli ve daha kısa dizelerden oluşur. Gezinme çubuklarını ve açılır menüleri düşünün. Zengin içerik daha tekniktir ve ziyaretçilerinizi sitede tutar. Eksik zengin içerik için yedek destek yoktur.

Liquid Araçları

Aşağıdaki liquid araçları jekyll-polyglot ile kullanılabilir:

site.languages

{% for lang in site.languages %}
  {{lang}}
{% endfor %}

site.languages doğrudan _config.yml’deki languages dizisine işaret eder. Liquid aracılığıyla erişilebilir.

site.default_lang

  {{site.default_lang}}

site.default_lang doğrudan _config.yml’deki default_lang dizesine işaret eder. Liquid aracılığıyla erişilebilir.

site.active_lang

{% if site.active_lang == "es" %}
  <h1>Hola! Como estas?</h1>
{% endif %}

site.active_lang, sayfanın oluşturulduğu yerel ayar kodudur. Bu, bir sayfanın Almanca sürümü için "de", İspanyolca sürümü için "es" vb. şeklindedir. Liquid aracılığıyla erişilebilir.

Bu araçları kullanarak, doğru zengin içeriği nasıl ekleyeceğinizi belirleyebilirsiniz.

page.rendered_lang

{% if page.rendered_lang == site.active_lang %}
  <p>Welcome to our {{ site.active_lang }} webpage!</p>
{% else %}
  <p>webpage available in {{ page.rendered_lang }} only.</p>
{% endif %}

page.rendered_lang değişkeni, bir sayfanın içeriğinin gerçek dilini belirtir ve şablonların bir sayfanın yedek içerik olarak sunulup sunulmadığını algılamasını sağlar.

GitHub Pages Desteği

Varsayılan olarak GitHub, Jekyll bloglarının eklenti kullanmasını engeller. Bu, GitHub sunucularında kötü amaçlı kodun çalıştırılmasını önlemek için kasıtlı olarak yapılır. Bu, Polyglot’u (ve diğer Jekyll eklentilerini) kullanmayı zorlaştırsa da, yine de yapılabilir.

`_site/`‘ı gh-pages’e Oluşturma

Jekyll blog motorunuzu GitHub’da barındırmak yerine, Jekyll web sitenizi ayrı bir dalda geliştirebilir ve ardından oluşturulan _site/ içeriklerini gh-pages dalınıza itebilirsiniz. Bu, web sitesi geliştirmenizi GitHub ile yönetmenize ve sürüm kontrolü yapmanıza olanak tanır GitHub’ın web sitenizi oluşturmasına güvenmek zorunda kalmadan!

Bunu, Jekyll içeriğinizi ayrı bir dalda tutarak ve yalnızca _site/ klasörünü gh-pages dalınıza işleyerek yapabilirsiniz. Bunlar klasörlerdeki statik HTML sayfaları olduğundan, GitHub bunları diğer gh-pages içerikleri gibi barındıracaktır.

Otomatikleştirin!

Bu süreç, web sitenizi oluşturacak ve _site/ klasörünü gh-pages’inize işleyecek basit bir komut dosyasıyla büyük ölçüde kolaylaştırılır. Birçok kişinin böyle bir komut dosyası var. İşte biri. İşte başka biri. İşte benim yayınlama komut dosyam:

#! /bin/sh
# dal adlarını uygun şekilde değiştirin
rm -rf site/_site/
cd site && bundle exec jekyll build && cd ..
git add site/_site/ && git commit -m "$(date)"
git subtree push --prefix site/_site origin gh-pages

Polyglot