20 Ekim 2026 ölçümümüzde izlediğimiz 200 temanın 52 tanesi ya arşivlenmişti (8 tema) ya da iki yıldan uzun süredir ana dalına commit almamıştı. Bu temaların bir kısmı hâlâ binlerce yıldızlı; en popüler üçü Jekyll temaları poole/hyde (3.788 yıldız, son commit Mayıs 2015), qiubaiying/qiubaiying.github.io (3.310 yıldız, Mart 2022) ve poole/lanyon (3.265 yıldız, Nisan 2020). Yani bu durum az rastlanan bir istisna değil, statik site temalarının sıradan bir yaşam evresi.
Üreticiye göre tablo çok farklı. Jekyll’da izlediğimiz 60 temanın 34 tanesi bu gruptaydı, Hugo’da 80 temanın 16 tanesi, Astro’da 60 temanın yalnızca 2 tanesi. Astro’nun düşük oranı temaların genç olmasından kaynaklanıyor; ortanca Astro teması 2,3 yaşında. Jekyll’ın yüksek oranı ise kısmen GitHub Pages’in değişmeyen ortamıyla açıklanabilir: Jekyll 3.10.0 ortamında çalışan bir temanın güncelleme ihtiyacı daha azdır.
Kullandığınız tema bu gruba girdiyse acele etmenize gerek yok. Statik bir sitenin çıktısı HTML, CSS ve JavaScript dosyalarıdır; tema güncellenmiyor diye yayındaki siteniz bozulmaz. Sorun bir sonraki derlemede, üreticiyi ya da bağımlılıkları güncellediğinizde çıkar. Bu yazı o ana hazırlıklı olmanın yolunu anlatıyor.
Arşivlenmiş ile sessiz arasındaki fark
GitHub’ın belgesine göre arşivlenen bir depo herkes için salt okunur hâle gelir ve bakımının artık sürmediğinin işaretidir. Konular, çekme istekleri, kod, sürümler ve yorumlar değiştirilemez; depoya yalnızca yıldız verilebilir ya da çatal (fork) alınabilir. Belge ayrıca arşivin geri alınabildiğini, yani sahibin depoyu yeniden açabileceğini yazar.
İki yıldır commit almayan ama arşivlenmemiş bir depo ise belirsiz bir durumdadır. Geliştirici temayı “tamamlanmış” sayıyor olabilir, başka işlere geçmiş olabilir ya da bir gün geri dönebilir. Pratik fark şudur: arşivlenmiş bir depoya hata bildiremezsiniz, sessiz bir depoya bildirebilirsiniz ama cevap gelmeyebilir.
Her iki durumda da tema sayfasında son commit tarihini, son 12 aydaki commit sayısını ve açık konu oranını görebilirsiniz. Tüm listeyi terk edilmiş temalar sayfasında, her biri için bakımı süren bir alternatifle birlikte veriyoruz.
İlk iş, ortamı sabitlemek
Bakımı bırakılmış bir temayla çalışmaya devam edecekseniz önce derleme ortamını dondurun:
- Üretici sürümü. Hugo için sitenin şu an derlendiği sürümü, Astro ve Jekyll için
package.json/Gemfileile kilit dosyalarını (package-lock, pnpm-lock, Gemfile.lock) sabitleyin. Derleme sunucusunda (GitHub Actions, Netlify, Cloudflare Pages) aynı sürümün yazılı olduğundan emin olun. - Node.js ya da Ruby sürümü. Eski bir Astro ya da Jekyll teması, yeni bir Node.js ya da Ruby sürümünde derlenmeyebilir. Çalışan sürümü proje köküne bir dosya (ör.
.nvmrc,.ruby-version) olarak yazın. - Temanın kopyası. Tema deposu silinebilir ya da sahibi tarafından özel hâle getirilebilir. Temayı kendi hesabınıza alın.
Temayı kendi deponuza almak
GitHub’ın çatal belgesi, çatalı başka bir deponun kopyası olarak başlayan ve kaynağıyla bağlantısını koruyan, kendi ayarları ve izinleri olan bir depo diye tanımlar. Arşivlenmiş bir depoyu çatallamak mümkündür; çatalınız arşivli değildir, yani üzerinde değişiklik yapabilirsiniz. Belgeye göre herkese açık bir deponun çatalı da herkese açıktır.
Çatal almak iki işe yarar: tema kaynaktan silinse bile elinizde kalır, ve gereken düzeltmeleri kendi çatalınızda yapıp sitenizi oradan derleyebilirsiniz. Hugo’da alt modülün ya da modülün adresini çatalınıza çevirmeniz, Jekyll’da remote_theme satırını çatalınızı gösterecek şekilde değiştirmeniz yeterlidir. Astro’da tema zaten projenizin içindedir; ayrıca yapmanız gereken bir şey yok.
Çatalı olduğu gibi bırakmak da bir seçenektir. Başkalarının da aynı temayı kullandığını düşünüyorsanız, çatallar arasında en aktif olanı bulmak işe yarayabilir; bazen bir topluluk üyesi bakımı devralmış olur. Bunu GitHub’da deponun çatal listesinde, son commit tarihlerine bakarak görebilirsiniz.
Katmanlı geçiş, Hugo
Hugo’nun tema bileşenleri özelliği, iki temayı aynı anda kullanmayı mümkün kılar. Belgeye göre yapılandırmada theme = ['yeni-tema', 'eski-tema'] gibi bir liste yazdığınızda Hugo bir dosyayı önce projede, sonra listedeki sırayla temalarda arar ve soldaki kazanır. Şablonlar dosya düzeyinde, çeviri ve veri dosyaları ise anahtar düzeyinde birleştirilir.
Bu, geçişi parça parça yapmanıza izin verir: yeni temayı listenin başına koyun, eski temayı arkada bırakın. Yeni temada karşılığı olmayan kısa kodlar (shortcode) ve kısmi şablonlar eski temadan gelmeye devam eder. İçerikteki her kısa kodu yeni temanın karşılığına taşıdıkça eski temaya olan bağımlılık azalır; sonunda listeden çıkarırsınız.
Dikkat edilecek nokta, belgede yazdığı gibi tema bileşeninin kendi yapılandırmasının yalnızca params, menu, çıktı biçimleri ve medya türlerini ayarlayabilmesidir. İki temanın aynı parametre adını farklı anlamda kullanması karışıklık yaratabilir; geçiş sırasında parametreleri projenin kendi yapılandırmasına açıkça yazın.
Katmanlı geçiş, Jekyll
Jekyll, aynı adlı bir düzen ya da include dosyası hem sitenizde hem temada varsa sitenizdekini kullanır; tema belgesi bunu tek tek dosya değiştirmenin yolu olarak anlatır. Terk edilmiş bir Jekyll temasında bu kuralı sonuna kadar götürebilirsiniz: temanın ihtiyaç duyduğunuz tüm dosyalarını sitenize kopyalayın ve tema bağımlılığını tamamen kaldırın. Böylece tema sizin deponuzun bir parçası olur; ne gem’e ne uzak temaya ihtiyaç kalır.
Gem olarak kurulu temanın klasörünü Bundler’ın bundle info --path komutuyla bulabilirsiniz. Kopyaladıktan sonra _config.yml’den theme: ya da remote_theme: satırını çıkarın ve bir derleme alın; eksik dosya varsa Jekyll hangi düzenin bulunamadığını yazar.
Astro, içerik koleksiyonunu taşımak
Astro’da katmanlı tema yoktur; geçiş genellikle içeriği yeni temaya taşımak demektir. İçerik koleksiyonları sayesinde bu iş çoğu zaman sandığınızdan kısadır: yazılarınız src/content altında Markdown dosyalarıdır. Yeni temanın content.config.ts dosyasındaki şemayı açın, eski temadaki ön bilgi (frontmatter) alanlarıyla karşılaştırın ve farklı adlandırılmış alanları (ör. pubDate ile date) toplu olarak değiştirin. Adres yapısı farklıysa eski adresleri yeni adreslere yönlendirmeyi unutmayın; aksi hâlde arama motorlarında birikmiş bağlantılar 404’e düşer.
Ne zaman geçmek gerekir
Şu işaretlerden biri görüldüğünde planı uygulamaya koyun:
- Üreticinin yeni sürümünde derleme hata veriyor ve hatayı çatalınızda düzeltmek temanın yapısını anlamayı gerektiriyor.
- Temanın JavaScript bağımlılıklarında paket yöneticinizin güvenlik denetimi düzeltmesi olmayan bir açık gösteriyor.
- Sitenize eklemek istediğiniz bir özellik (arama, karanlık mod, çok dillilik) temanın yapısıyla çatışıyor.
Yeni temayı seçerken aynı tuzağa düşmemek için son commit tarihine ve son 12 aydaki commit sayısına bakın; bakım durumu sayfası her üreticide en çok commit alan temaları gösteriyor. Bir temanın bakımda olup olmadığını okumanın ayrıntıları tema bakımda mı yazısında.