Jekyll ile Koşullu Betik ve Stil Dosyası Yükleme: Performans ve Optimizasyon Rehberi
Web sitelerinin performansı, kullanıcı deneyimi ve arama motoru optimizasyonu (SEO) açısından kritik öneme sahiptir. Özellikle statik site oluşturucularıyla hazırlanan sitelerde bile, gereksiz kaynakların yüklenmesi performansı olumsuz etkileyebilir. Jekyll, statik siteler oluşturmak için popüler ve güçlü bir araçtır. Ancak bir Jekyll sitesinde tüm betik (script) ve stil (stylesheet) dosyalarını her sayfaya koşulsuz olarak yüklemek, sayfa yükleme sürelerini uzatabilir ve bant genişliği tüketimini artırabilir. Bu makalede, Jekyll ile betik ve stil dosyalarını koşullu olarak nasıl yükleyeceğimizi, bunun faydalarını ve en iyi uygulamaları ayrıntılı bir şekilde inceleyeceğiz.
Giriş: Koşullu Yüklemenin Önemi
Modern web uygulamaları, etkileşimli özellikler ve zengin görsel içerik sunmak için çeşitli JavaScript betiklerine ve CSS stil sayfalarına ihtiyaç duyar. Ancak bir e-ticaret sitesindeki ürün galerisi için gereken bir JavaScript kütüphanesi, bir blog yazısı sayfasında gereksiz olabilir. Benzer şekilde, bir harita bileşeni için gerekli CSS ve JS dosyaları, iletişim sayfası dışında çoğu sayfada fazlalık yaratır. Bu gereksiz kaynakların yüklenmesi:
* Sayfa Yükleme Süresini Uzatır: Tarayıcının indirmesi, ayrıştırması ve çalıştırması gereken dosya sayısı ve boyutu artar.
* Bant Genişliği Tüketimini Artırır: Özellikle mobil kullanıcılar veya sınırlı internet bağlantısı olanlar için maliyetli olabilir.
* Tarayıcı Kaynaklarını Tüketir: JavaScript’in ayrıştırılması ve yürütülmesi, CPU ve bellek kaynaklarını kullanır, bu da özellikle düşük güçlü cihazlarda kullanıcı arayüzünün takılmasına neden olabilir.
* Arama Motoru Sıralamasını Etkiler: Google gibi arama motorları, sayfa hızını sıralama faktörlerinden biri olarak değerlendirir.
Jekyll, Liquid şablon motorunu kullanarak bu tür koşullu yüklemeleri kolayca yapmamıza olanak tanır. Bu sayede, her sayfanın yalnızca ihtiyaç duyduğu kaynakları yüklemesini sağlayarak sitenizin genel performansını önemli ölçüde artırabiliriz.
Jekyll’in Çalışma Prensibi ve Liquid Şablon Motoru
Jekyll, Markdown veya Textile formatındaki içerikleri ve Liquid şablonlarını kullanarak statik HTML sayfaları, CSS ve JavaScript dosyaları üretir. Bu dosyalar daha sonra herhangi bir web sunucusunda barındırılabilir. Dinamik içerik oluşturmak için bir veritabanına veya sunucu tarafı bir dile (PHP, Python, Node.js vb.) ihtiyaç duymaz.
Liquid Şablon Motoru
Liquid, Shopify tarafından geliştirilen ve Jekyll’in kalbinde yer alan bir şablon dilidir. İçeriği dinamik olarak işlemek için kullanılır, ancak bu dinamizm sunucu tarafında değil, Jekyll’in derleme (build) sürecinde gerçekleşir. Liquid’in temel yapı taşları şunlardır:
* Nesneler (Objects): Çift süslü parantez {{ }} içine alınır ve çıktıya bir değer yazdırır. Örnek: {{ page.title }} sayfanın başlığını yazdırır.
* Etiketler (Tags): Süslü parantez ve yüzde işareti {% %} içine alınır ve şablon mantığını kontrol eder. Döngüler, koşullu ifadeler ve atamalar gibi işlemler için kullanılır. Örnek: {% if page.load_script %}.
* Filtreler (Filters): Nesnelerin çıktısını değiştirmek için kullanılır ve bir boru | sembolü ile nesneye eklenir. Örnek: {{ page.title | downcase }} başlığı küçük harfe çevirir.
Jekyll, site genelindeki verileri site nesnesi altında, mevcut sayfanın verilerini ise page nesnesi altında sunar. Bu nesneler, koşullu yükleme mantığımızı oluştururken en çok kullanacağımız araçlardır.
Koşullu Yüklemenin Temelleri: Liquid ile Karar Yapıları
Jekyll’de koşullu yükleme yapmanın temelinde Liquid’in if, else, elsif ve endif etiketleri bulunur. Bu etiketler, belirli bir koşulun doğru olup olmadığını kontrol etmemizi ve buna göre farklı içerikler (bu durumda betik veya stil bağlantıları) oluşturmamızı sağlar.
page ve site Değişkenleri
* page Nesnesi: Mevcut sayfanın Front Matter’ında tanımlanan tüm verileri ve Jekyll tarafından otomatik olarak eklenen bazı meta verileri içerir. Önemli özellikleri:
* page.title: Sayfanın başlığı.
* page.url: Sayfanın URL’si.
* page.layout: Sayfanın kullandığı layout.
* page.categories: Sayfanın kategorileri (bir dizi).
* page.tags: Sayfanın etiketleri (bir dizi).
* page.permalink: Sayfanın kalıcı bağlantısı.
* page.custom_variable: Front Matter’da tanımladığınız özel bir değişken.
* site Nesnesi: Jekyll sitesinin tamamıyla ilgili verileri içerir. _config.yml dosyasında tanımlanan tüm ayarlar, tüm sayfalar, yazılar, koleksiyonlar ve global veriler bu nesne altında bulunur. Önemli özellikleri:
* site.title: Sitenin başlığı (_config.yml‘den).
* site.url: Sitenin ana URL’si (_config.yml‘den).
* site.baseurl: Sitenin alt dizin URL’si (_config.yml‘den).
* site.data: _data dizinindeki tüm veriler.
* site.posts: Tüm blog yazıları.
* site.custom_variable: _config.yml‘de tanımladığınız özel bir değişken.
* jekyll.environment: Jekyll’in çalıştığı ortam (development veya production).
Bu nesneleri kullanarak, belirli bir sayfanın veya sitenin genel durumuna göre betik ve stil dosyalarını koşullu olarak yükleyebiliriz.
Sayfa Bazında Koşullu Yükleme (Page-Specific)
En yaygın koşullu yükleme senaryosu, belirli bir sayfanın özel bir kaynağa ihtiyaç duymasıdır. Bu, genellikle sayfanın Front Matter’ı aracılığıyla kontrol edilir.
Front Matter Kullanımı
Front Matter, bir Markdown veya HTML dosyasının en üstünde yer alan, üç tire (---) ile ayrılmış YAML formatındaki bir veri bloğudur. Bu blok, sayfa için meta verileri tanımlamamızı sağlar.
Adım 1: Sayfanın Front Matter’ında Özel Bir Anahtar Tanımlama
Örneğin, bir contact.md dosyasında bir harita betiği yüklemek istediğimizi varsayalım:
---
layout: default
title: İletişim
permalink: /iletisim/
load_map_script: true
---
Bu sayfa iletişim bilgilerini ve bir haritayı içerir.
Burada load_map_script: true adında özel bir anahtar tanımladık. Bu anahtarın adı tamamen size kalmıştır.
Adım 2: Layout Dosyasında Bu Anahtarı Kontrol Etme
Şimdi, sitenizin ana layout dosyası olan _layouts/default.html (veya ilgili layout dosyası) içinde bu anahtarı kontrol edebiliriz:
{{ page.title }} - {{ site.title }}
{% if page.load_gallery_css %}
{% endif %}
{% include header.html %}
{{ content }}
{% if page.load_map_script %}
{% endif %}
{% if page.load_chart_js %}
{% endif %}
Bu örnekte:
* page.load_gallery_css true ise gallery.css yüklenir.
* page.load_map_script true ise Google Haritalar API’si ve özel map.js betiği yüklenir.
* page.load_chart_js true ise Chart.js kütüphanesi ve özel charts.js betiği yüklenir.
Bu yöntem, sayfa özelinde çok esnek bir kontrol sağlar.
Sayfa URL’sine Göre Yükleme
Bazen Front Matter’a her sayfa için özel bir anahtar eklemek yerine, sayfanın URL’sine göre yükleme yapmak daha pratik olabilir. Bu, genellikle belirli bir dizindeki tüm sayfalar veya belirli bir permalink’e sahip sayfalar için kullanılır.
{% if page.url contains '/iletisim/' %}
{% endif %}
{% if page.url == '/galeri/' %}
{% endif %}
contains operatörü, page.url dizesinin belirli bir alt dizeyi içerip içermediğini kontrol eder. Bu, /iletisim/ dizinindeki tüm sayfalar için geçerli olacaktır. == operatörü ise tam eşleşme arar.
Layout’a Göre Yükleme
Farklı sayfa düzenleri (layouts) genellikle farklı işlevselliklere sahiptir. Örneğin, bir blog yazısı layout’u kod vurgulama için bir betiğe ihtiyaç duyarken, bir “hakkımızda” layout’u duymayabilir.
{% if page.layout == 'post' %}
{% endif %}
{% if page.layout == 'portfolio' %}
{% endif %}
Bu örnekte, post layout’unu kullanan tüm sayfalar için kod vurgulama CSS’i ve JavaScript’i yüklenirken, portfolio layout’unu kullanan sayfalar için portföy özel CSS ve JS yüklenir.
Kategori veya Etikete Göre Koşullu Yükleme
Blog yazıları gibi içeriklerde, belirli kategori veya etiketlere sahip yazılar için özel betik veya stil dosyaları yüklemek isteyebilirsiniz. Örneğin, “JavaScript” kategorisindeki yazılar için özel bir kod örneği çalıştırıcı.
{% if page.categories contains 'javascript' %}
{% endif %}
{% if page.tags contains 'harita' %}
{% endif %}
page.categories ve page.tags değişkenleri bir dizi olduğu için, Liquid’in contains operatörü ile dizide belirli bir öğenin olup olmadığını kontrol edebiliriz. Bu, aynı kategoriye veya etikete sahip tüm yazılar için tutarlı bir şekilde kaynak yüklemenizi sağlar.
Koleksiyonlara Göre Koşullu Yükleme
Jekyll, blog yazıları dışında özel içerik türleri oluşturmak için koleksiyonları kullanır (örneğin, _projects, _docs, _team). Bir koleksiyondaki tüm öğeler için belirli kaynakları yüklemek isteyebilirsiniz.
{% if page.collection == 'projects' %}
{% endif %}
{% if page.collection == 'docs' %}
{% endif %}
Bu örnekte, projects koleksiyonundaki tüm sayfalar için project-detail.css ve project-gallery.js yüklenir. Benzer şekilde, docs koleksiyonundaki sayfalar için dokümantasyon özel stil ve betik yüklenir.
Global Ayarlara Göre Koşullu Yükleme (_config.yml)
Bazen, bir betiğin veya stilin yüklenip yüklenmeyeceği, sitenin genel yapılandırmasına bağlı olabilir. Örneğin, bir analitik betiği veya belirli bir özelliğin etkin olup olmadığı. Bu tür global ayarlar _config.yml dosyasında tutulur ve site nesnesi aracılığıyla erişilebilir.
_config.yml:
title: Benim Harika Sitem
description: Jekyll ile oluşturulmuş bir site.
enable_analytics: true
enable_comments: false
Layout Dosyasında Kontrol:
{% if site.enable_analytics %}
{% endif %}
{% if site.enable_comments and page.layout == 'post' %}
{% endif %}
Bu yaklaşım, sitenin genel davranışını tek bir yerden kontrol etmenizi sağlar. Özellikle bir özelliği tüm sitede etkinleştirmek veya devre dışı bırakmak istediğinizde kullanışlıdır.
_includes Kullanarak Modüler Koşullu Yükleme
Kod tekrarını önlemek ve yapıyı daha düzenli hale getirmek için _includes dizinini kullanabiliriz. Her bir betik veya stil bloğunu ayrı bir include dosyasına taşıyıp, bunları koşullu olarak çağırmak mantıklı bir yaklaşımdır.
Adım 1: Include Dosyalarını Oluşturma
Örneğin, _includes/scripts/map.html ve _includes/styles/gallery.html gibi dosyalar oluşturabiliriz.
_includes/scripts/map.html:
_includes/styles/gallery.html:
Adım 2: Layout Dosyasında Koşullu Çağırma
Şimdi, ana layout dosyanızda bu include’ları koşullu olarak çağırabilirsiniz:
{% if page.load_gallery_css %}
{% include styles/gallery.html %}
{% endif %}
{% if page.load_map_script %}
{% include scripts/map.html %}
{% endif %}
Bu yaklaşım, layout dosyalarınızın daha okunabilir olmasını sağlar ve betik/stil bloklarını kolayca yönetmenize olanak tanır. Ayrıca, include’lara parametreler de geçirebilirsiniz:
{% include script_loader.html name="map" condition=page.load_map_script %}
Ve _includes/script_loader.html içinde:
{% if include.condition %}
{% if include.name == "map" %}
{% elsif include.name == "gallery" %}
{% endif %}
{% endif %}
Bu, daha karmaşık ve merkezi bir betik/stil yükleyici include’u oluşturmanıza olanak tanır.
Gelişmiş Teknikler ve En İyi Uygulamalar
Koşullu yüklemeyi uygularken performansı daha da artırmak için bazı gelişmiş teknikler ve en iyi uygulamalar mevcuttur.
Ortam Değişkenlerine Göre Yükleme (Development vs. Production)
Jekyll, JEKYLL_ENV ortam değişkenini kullanarak farklı ortamlar için farklı derleme davranışları sergileyebilir. Bu, özellikle geliştirme sırasında hata ayıklama betiklerini yüklerken veya üretimde sadece minifiye edilmiş dosyaları kullanırken faydalıdır.
Jekyll’i genellikle şu şekilde çalıştırırız:
* Geliştirme için: bundle exec jekyll serve (varsayılan olarak JEKYLL_ENV “development” olur)
* Üretim için: JEKYLL_ENV=production bundle exec jekyll build
Layout dosyanızda bu ortam değişkenini kontrol edebilirsiniz:
{% if jekyll.environment == "development" %}
{% else %}
{% endif %}
{% if jekyll.environment == "production" and site.enable_analytics %}
{% endif %}
Bu, geliştirme sürecini kolaylaştırırken, üretimdeki sitenizin performansını optimize etmenize olanak tanır.
Performans İpuçları ve Optimizasyon
Koşullu yükleme tek başına yeterli değildir; diğer web performansı en iyi uygulamalarıyla birleştirilmelidir.
* Asenkron ve Ertelenmiş Yükleme (Async/Defer): JavaScript betiklerini async veya defer nitelikleriyle yüklemek, tarayıcının HTML ayrıştırmasını ve sayfa oluşturmasını engellemesini önler.
* async: Betik, HTML ayrıştırması devam ederken indirilir ve indirildikten hemen sonra yürütülür. Sıra garantisi yoktur.
* defer: Betik, HTML ayrıştırması devam ederken indirilir ancak tüm HTML ayrıştırıldıktan sonra, DOMContentLoaded olayından hemen önce yürütülür. Yükleme sırası korunur.
Genellikle sayfanın ilk render’ı için kritik olmayan betikler için defer tercih edilir. Kritik olmayan ve birbirine bağımlı olmayan betikler için async kullanılabilir.
* CSS için media Nitelikleri: Belirli medya türleri veya ekran boyutları için CSS dosyalarını koşullu olarak yüklemek, gereksiz stillerin indirilmesini önler.
* Kritik CSS (Critical CSS): Sayfanın ilk ekran görüntüsü için gerekli olan CSS’i (above-the-fold content) HTML içine inline olarak yerleştirmek, tarayıcının ek bir CSS dosyası indirmesini beklemeden içeriği hızla render etmesini sağlar. Geri kalan CSS daha sonra asenkron olarak yüklenebilir. Jekyll’de bu, bir include dosyası aracılığıyla veya bir build aracı (örneğin Gulp/Webpack ile Critical CSS eklentisi) kullanılarak yapılabilir.
* CDN Kullanımı: Betik ve stil dosyalarını bir İçerik Dağıtım Ağı (CDN) üzerinden sunmak, kullanıcıların coğrafi konumlarına daha yakın sunuculardan kaynakları indirmelerini sağlayarak gecikmeyi azaltır. Google Fonts, jQuery CDN gibi yaygın kütüphaneler için CDN’ler mevcuttur. Kendi statik varlıklarınız için Cloudflare, Netlify CDN gibi hizmetleri kullanabilirsiniz.
* Minifikasyon ve Birleştirme: Betik ve stil dosyalarının boyutunu küçültmek (minifikasyon) ve birden fazla dosyayı tek bir dosyada birleştirmek, HTTP isteği sayısını azaltır. Jekyll’in doğrudan bir minifikasyon aracı yoktur ancak build sürecinize Gulp, Grunt, Webpack gibi araçları veya Jekyll eklentilerini (örneğin jekyll-compress-html, jekyll-assets) entegre edebilirsiniz.
* Gereksiz Dosyalardan Kaçınma: Her zaman “ihtiyacın yoksa yükleme” prensibini benimseyin. Bir kütüphanenin sadece küçük bir özelliğine ihtiyacınız varsa, tüm kütüphaneyi yüklemek yerine o özelliği kendiniz yazmayı veya daha hafif bir alternatif bulmayı düşünün.
Sık Karşılaşılan Hatalar ve Çözümleri
Koşullu yükleme uygularken karşılaşılabilecek bazı yaygın sorunlar ve çözümleri:
* Liquid Syntax Hataları: {% endif %} veya {% endfor %} gibi kapanış etiketlerini unutmak veya yanlış yazmak, derleme hatalarına neden olur. Jekyll’in hata mesajları genellikle sorunun nerede olduğunu gösterir.
* Yanlış Değişken Kullanımı: page.load_script yerine site.load_script kullanmak veya tam tersi. Hangi verinin page nesnesinde, hangisinin site nesnesinde olduğunu anlamak önemlidir. page mevcut sayfanın meta verilerini, site ise global site ayarlarını ve koleksiyonlarını içerir.
* Yol Hataları: Betik veya stil dosyalarının yollarını yanlış belirtmek (href veya src niteliklerinde). relative_url filtresini kullanarak baseurl sorunlarını önleyin: {{ "/assets/css/main.css" | relative_url }}.
* Önbellekleme Sorunları: Tarayıcılar veya CDN’ler, eski betik/stil dosyalarını önbelleğe alabilir. Yeni bir sürümü dağıttığınızda, kullanıcılar eski dosyaları görmeye devam edebilir. Bu durumu önlemek için dosya adlarına sürüm numaraları veya hash değerleri ekleyebilirsiniz (örneğin main.12345.css) veya CDN önbelleğini temizleyebilirsiniz. Jekyll eklentileri veya build araçları bu süreci otomatikleştirebilir.
* Liquid contains Kullanımında Dikkat: page.tags contains 'javascript' gibi ifadelerde, page.tags bir dizi olmalıdır. Eğer Front Matter’da tek bir etiket tanımladıysanız (tags: javascript), bu bir dize olarak kabul edilir. Diziler için tags: [javascript, web] şeklinde tanımlama yapmalısınız.
Sonuç
Jekyll ile koşullu betik ve stil dosyası yükleme, web sitelerinizin performansını ve genel kullanıcı deneyimini önemli ölçüde iyileştirebilecek güçlü bir tekniktir. Liquid şablon motorunun esnekliği sayesinde, Front Matter değişkenlerinden URL’lere, kategorilerden global site ayarlarına kadar çeşitli kriterlere göre kaynakları yükleyebiliriz.
Bu makalede ele aldığımız yöntemleri uygulayarak:
* Daha Hızlı Yükleme Süreleri: Kullanıcılar sitenizin sayfalarını daha hızlı göreceklerdir.
* Azaltılmış Bant Genişliği Tüketimi: Özellikle mobil kullanıcılar için maliyetleri düşürecektir.
* Daha İyi Kullanıcı Deneyimi: Duyarlı ve akıcı bir arayüz sunarak ziyaretçilerinizi memnun edecektir.
* Geliştirilmiş SEO: Arama motorları hızlı siteleri ödüllendirdiği için sıralamanız yükselebilir.
* Daha Kolay Bakım: Modüler ve koşullu yapı sayesinde kodunuz daha düzenli ve yönetilebilir olacaktır.
Unutmayın ki koşullu yükleme, web performans optimizasyonunun sadece bir parçasıdır. Asenkron/ertelenmiş yükleme, minifikasyon, CDN kullanımı ve kritik CSS gibi diğer en iyi uygulamalarla birleştirildiğinde, Jekyll sitenizin potansiyelini tam olarak ortaya çıkarabilirsiniz. Web teknolojileri sürekli geliştiği için, performans optimizasyonuna yönelik yeni yaklaşımları takip etmek ve sitenizi düzenli olarak analiz etmek, uzun vadeli başarı için kritik öneme sahiptir.
