İçeriğe geç
Starlight

Doğa Dostu Dokümanlar

Web endüstrisinin iklime etkisinin %2 ila %4 arasında küresel karbon emisyonu‘na sahip olduğu tahmin ediliyor; kabaca havayolları endüstrisindeki emisyon oranında. Bir websitesinin ekolojik etkisini hesaplamada çok fazla karmaşık etken var, ancak bu rehber dokümantasyon sitenizin çevresel ayakizini düşürmek için birkaç ipucu içerir.

İyi haber şu ki, Starlight’ı seçmek mükemmel bir başlangıç. Bu site, Carbon Calculator web sitesine göre sayfa başına ziyarette 0.01 gr CO₂ üretimiyle test edilmiş web sayfaları arasında %99 daha çevreci.

Sayfa Büyüklüğü

Bir web sayfası ne kadar veri transfer ederse, ihtiyaç duyacağı enerji o kadar yüksek olur. Nisan 2023’te HTTP Archive’daki veri‘ye göre orta büyüklükte web sayfası, kullanıcıdan 2,000 KB’tan daha fazla veri indirmeye ihtiyaç duydu.

Starlight, sayfaları mümkün olan en küçük boyutta oluşturur. Örneğin, ilk ziyarette kullanıcı 50 KB’tan daha az sıkıştırılmış veriyi indirecektir - sadece HTTP Archive medyan değerinin %2.5’i kadar. İyi bir ön belleğe alma stratejisi ile takip eden gezinmelerde 10 KB kadar küçük veri indirir.

Görseller

Starlight iyi bir temel sunmasına rağmen, dokümantasyon sayfalarına eklediğiniz görseller sayfa büyüklüğünü hızlıca artırabilir. Starlight, Astro’nun optimize edilmiş varlık desteği yardımıyla Markdown ve MDX dosyalarındaki yerel görselleri optimize etmek için kullanır.

Arayüz Bileşenleri

React ya da Vue gibi arayüz kütüphaneleri ile oluşturulmuş bileşenler, sayfaya büyük boyutta Javascript ekleyebilir. Astro Adaları ile oluşturulmuş bileşenlerin varsayılan olarak sıfır tarayıcı-tarafı Javascript yüklemesi nedeniyle Starlight, Astro üzerine kurulmuştur.

Ön Bellekleme

Ön bellekleme, halihazırda yüklenmiş verilerin tekrar kullanımı ve tarayıcının ne kadar süre bu veriyi tutacağını kontrol etmek için kullanılır. İyi bir ön bellekleme stratejisi; kullanıcının yeni içeriği değiştikten sonra mümkün olan en kısa sürede almasını sağlar, fakat buna ek olarak içerik değişmediğinde tekrar tekrar aynı içeriği yüklemesini önler.

Cache-Control HTTP header, ön belleklemeyi yapılandırmanın sık kullanılan bir yoludur. Starlight kullanarak, /_astro/ dizini içindeki her şey için uzun ön bellekleme süresi ayarlayabilirsiniz. Bu dizin CSS, Javascript ve diğer paketlenmiş dosyaları içerir ve güvenle sonsuza dek ön belleğe alınarak gereksiz indirmeleri azaltır:

Cache-Control: public, max-age=604800, immutable

Ön belleklemenin nasıl yapılandırılacağı web sunucunuza bağlıdır. Örneğin; Vercel önbellekleme stratejisini herhangi bir yapılandırmaya gerek kalmadan uygularken, Netlify’da public/_headers altına Netlify için özel header’lar ile ayarlayabilirsiniz:

/_astro/*
  Cache-Control: public
  Cache-Control: max-age=604800
  Cache-Control: immutable

Güç tüketimi

Bir web sitesinin nasıl oluşturulduğu, web sitesinin kullanıcı cihazında ne kadar güç tüketeceğini etkiler. En az Javascript kullanarak, Starlight kullanıcının telefon, tablet ve bilgisayarında yükleme ve sayfayı çizme sürecinde ihtiyaç duyulan enerjiyi düşürür.

Analitik takip scriptleri ya da gömülü video gibi ağır Javascript içeriklerini eklerken, bu özelliklerin sayfanızın güç tüketimini artıracağını aklınızda tutun. Analitik takip script’ine ihtiyacınız varsa, Cabin, Fathom, ya da Plausible gibi daha hafif seçenekleri göz önünde bulundurun. Youtube ve Vimeo gibi gömülü videolar kullanıcı etkileşimi ile videoyu yükleme. yöntemiyle geliştirilebilir. astro-embed gibi paketler ortak hizmetler için yardımcı olabilir.

Barındırma

Web sayfasının nerede barındırıldığı, dokümantasyon sitenizin ne kadar çevre dostu olduğu konusunda büyük etkisi vardır. Veri merkezleri ve sunucu çiftlikleri büyük ekolojik etkiye sahip olabilir, yüksek elektrik tüketimi ve büyük oranda su kullanımı dahil.

Yenilenebilir enerji kullanan barındırma opsiyonunu seçmek, sitenizin daha az karbon emisyonuna neden olacağı anlamına gelir. Green Web Directory size bu konuda barındırma şirketleri bulmanıza yardımcı olacak bir araçtır.

Karşılaştırmalar

Diğer dokümantasyon çerçeveleri ile nasıl kıyaslandığını merak ediyor musun? Website Carbon Calculator ile yapılan testlerle, farklı araçlarla oluşturulmuş benzer sayfaları karşılaştırın.

Çerçevesayfa başına ziyarette CO₂
Starlight0.01gr
VitePress0.05gr
Docus0.05gr
Sphinx0.07gr
MkDocs0.10gr
Nextra0.11gr
docsify0.11gr
Docusaurus0.24gr
Read the Docs0.24gr
GitBook0.71gr

14 Mayıs 2023 tarihli veriler. Güncel bilgileri görmek için linke tıkla.

Diğer Kaynaklar

Araçlar

Makaleler ve Konuşmalar