Çevirileri uygulamamın kullanması için nasıl yayınlarım?

Yayınlama, bir çeviriyi uygulamanız için gerçek kılan adımdır. Yayınlayana kadar yazdığınız her şey yalnızca panoda yaşar.

Arada ne bir derleme ne de bir dağıtım vardır.

Ne oluyor #

Code

Publish
  → çeviriler CDN kaynağına yazılır
  → değişen ne varsa önbelleği temizlenir
  → uygulamanız bir sonraki istekte yeni sürümü çeker

Nasıl yapılır #

Projenizi açın
Publish'e tıklayın
Listelediklerini okuyun — asıl önemli kısım burası
Onaylayın

Açılan pencere, canlıya çıkmak üzere olanı tam olarak listeler; bir sayıya güvenmek yerine görebilesiniz diye gruplanmış hâlde.

Onaylamadan önce listeyi okuyun #

Taslaklar da yayınlanır. Bu insanları şaşırtıyor, o yüzden açık söylemekte fayda var: yayınlama işlemi hem onaylanmış çevirileri hem de taslakları kapsar. API'nin kendi varsayılanı yalnızca onaylananlardır; pano bunu bilerek genişletir, böylece pencerede listelenen şey gerçekten gönderilen şey olur — "12 hazır" deyip 9 tanesini yayınlamak daha kötü olurdu.

Sonucu şu: taslak, "canlıya çıkamaz" demek değildir. "Henüz kimse buna kefil olmadı" demektir. Onayın gerçek bir kapı olmasını istiyorsanız, durumun işleri geride tutmasına güvenmek yerine yayınlamadan önce inceleyin. Bkz. Çevirileri nasıl inceleyip onaylarım?.

Ziyaretçiler ne kadar sonra görür #

CDN çevirileri bir dakikalık önbellekle sunar ve yayınlama değişen ne varsa onu temizler — yani her zamanki cevap saniyelerdir ve bir dakika tavandır.

Kendi gecikmesini ekleyebilecek katmanlar:

Katman	Gecikme
CDN edge	Yayında temizlenir; aksi hâlde `max-age=60`
SDK bellek içi önbelleği	Yenileme aralığı kadar
Next.js ISR	Ayarladığınız `revalidate` değeri kadar

Uygulamanız çevirileri derleme zamanında işliyorsa ya da bir saat önbellekliyorsa, o sayı sizindir, bizim değil. Yayınladım ama uygulamam hâlâ eski çevirileri gösteriyor hangi katmanın tuttuğunu bulmayı anlatır.

CLI'dan #

Bash

better-i18n publish:status   # şu anda ne canlıya çıkardı
better-i18n publish          # yap

publish:status'ü bir işlem hattında önce çalıştırmakta fayda var; "bekleyen bir şey var mı" sorusunun dürüst cevabı odur.

Geri alma yoktur #

Yayınlama sürümlenmez ve geri yüklenecek bir anlık görüntü yoktur. Hatalı bir yayını düzeltmek, çeviriyi düzenleyip yeniden yayınlamak demektir — bu yaklaşık bir dakika sürer, dolayısıyla nadiren bir kriz olur; ama incelemenin butondan önce olması gerektiği anlamına da gelir.

Her yayın, inceleyebileceğiniz bir iş kaydı olarak tutulur: