Hugo extended sürümü gerekir mi, Sass kullanan temalarda ne değişti

Tema kullanıyorsanız ve tema Sass dosyalarını Hugo’nun gömülü LibSass’ıyla derliyorsa extended sürüm gerekir; değilse standart sürüm yeter. Hugo belgeleri bunu tek cümleyle söyler: ek özelliklere ihtiyacınız yoksa standart sürümü kullanın. Kafa karışıklığının nedeni, birçok tema README’sinin yıllar önce yazılmış “extended sürümü kurun” cümlesini hâlâ taşıması ve Hugo’nun bu alanda yön değiştirmiş olmasıdır.

20 Ekim 2026 ölçümümüzde izlediğimiz 80 Hugo temasının 33 tanesinin assets/ klasöründe .scss ya da .sass dosyası vardı. Aynı gün GitHub’daki son Hugo sürümü 0.168.0 idi.

Dört sürüm, iki ek özellik

Hugo’nun kurulum sayfasındaki tabloya göre dört sürüm var: standard, deploy, extended ve extended/deploy. Temel özelliklerin tamamı dördünde de aynıdır. Farklar yalnızca iki özellikte:

Doğrudan bulut dağıtımı, hugo deploy ile siteyi bir Google Cloud Storage kovasına, AWS S3 kovasına ya da Azure Storage kapsayıcısına göndermenizi sağlar. Siteyi GitHub Pages, Netlify ya da Cloudflare Pages ile yayımlıyorsanız bu özelliğe ihtiyacınız olmaz; o hizmetler kendi derleme ve yükleme adımlarını kullanır.

Gömülü LibSass ise Sass dosyalarını Hugo’nun kendi içinden CSS’e çevirmeye yarar. Belgedeki dipnot onu “gömülü LibSass ile Sass’ı CSS’e dönüştürme” diye tanımlar. Extended sürümün tek farkı budur.

LibSass kullanımdan kalkıyor

Hugo belgeleri, gömülü LibSass’ın v0.153.0 sürümünde kullanımdan kaldırıldığını (deprecated) ve gelecekteki bir sürümde tamamen çıkarılacağını yazıyor. Önerilen yol Dart Sass. Belgeye göre Dart Sass her sürümle uyumlu; yani standart Hugo ile birlikte de çalışır. Kurulum sayfası ayrıca Dart Sass’ın Sass dilinin en yeni özelliklerini kullanırken gerekli olduğunu belirtir.

Bu, iki ayrı durumu doğurur:

1. Tema LibSass’a göre yazılmış. Hugo’nun css.Sass işlevi belgesine göre dönüştürücü (transpiler) seçeneğinin varsayılan değeri hâlâ libsass; yani şablonda ayrı bir ayar yoksa Hugo LibSass’ı kullanır. Bu temayı bugün extended sürümle çalıştırabilirsiniz, ama LibSass Hugo’dan çıkarıldığında çalışmaz hâle gelir. Tema bakımı sürüyorsa geliştiricinin bu geçişi yapmasını bekleyebilirsiniz.
2. Tema Dart Sass’ı seçmiş. Şablon, Sass dönüştürme ayarında Dart Sass’ı açıkça istiyorsa standart Hugo yeterlidir; ancak makinenizde ya da derleme ortamınızda sass komutunun (Dart Sass) kurulu olması gerekir.

Hangi durumda olduğunuzu anlamanın en kolay yolu, temanın layouts klasöründe Sass dönüştürmesini yapan şablon parçasına bakmaktır. Belgedeki örnekte bu ayar, css.Sass işlevine verilen seçenek sözlüğünde dict "transpiler" "dartsass" biçiminde yazılır. Şablonda böyle bir dartsass ifadesi geçiyorsa ikinci durumdasınız. Böyle bir ayar yoksa tema büyük olasılıkla birinci durumdadır.

Sass dosyası olmayan temalar

İzlediğimiz Hugo temalarının çoğunda assets altında Sass dosyası yok. Bu temalar CSS’i düz dosya olarak verir, Tailwind gibi ayrı bir araçla derler ya da hiç ön işleme yapmaz. Bunlar için standart sürüm yeterlidir. Tema sayfalarındaki teknik kontrol listesinde “assets klasöründe Sass dosyası görünmüyor” satırını görüyorsanız ek bir sürüme gerek duymadan başlayabilirsiniz. Listenin tamamı Hugo temaları sayfasında.

Bir uyarı: kontrolümüz yalnızca assets/ altındaki dosya adlarına bakar. Bazı temalar Sass dosyalarını başka bir klasörde tutup kendi derleme betiğiyle CSS üretir; bu temalar bizim listede “Sass yok” görünse bile kendi araç zincirlerini ister. Ayrıntılar veri ve yöntem sayfasında.

Hangi sürümü kurduğunuzu nasıl anlarsınız

Komut satırında hugo version çalıştırın. Çıktıda sürüm numarasının yanında +extended görüyorsanız extended sürümdesiniz; +deploy varsa dağıtım özelliği de vardır. Windows için Hugo belgeleri üç paket yöneticisini anlatır ve üçünde de doğrudan extended paketi kurar: choco install hugo-extended, scoop install hugo-extended ve winget install -e --id Hugo.Hugo.Extended. Yani Windows’ta belgeyi izleyen biri zaten extended sürümle başlar; hugo env komutu hangi Sass dönüştürücülerinin etkin olduğunu da gösterir.

Linux dağıtımlarının kendi paket depolarındaki Hugo çoğu zaman birkaç sürüm geridedir. Temanın theme.toml dosyasında en düşük sürüm yazıyorsa onu kontrol edin; izlediğimiz temaların bir kısmı bu alanı dolduruyor ve tema sayfasında “en düşük Hugo sürümü” satırında gösteriyoruz. Sürüm, paket deposundaki Hugo’dan yeniyse GitHub’daki sürümler sayfasından resmî ikili dosyayı indirmek en kısa yoldur.

Ölçümümüzde Hugo temaları

20 Ekim 2026’da izlediğimiz 80 Hugo temasının 67 tanesi theme.toml ya da yapılandırma dosyasında bir en düşük Hugo sürümü belirtiyordu; 13 temada bu bilgi yoktu. 52 tema Hugo’nun resmî galerisinde listeleniyordu. Sass dosyası taşıyan 33 temanın her birinde, tema sayfasındaki kontrol listesi “dikkat” işaretiyle bu durumu gösteriyor.

Bu iki bilgiyi birlikte okumak işe yarar. En düşük sürümü yakın tarihli bir Hugo sürümü olan ve Sass dosyası taşıyan bir tema, büyük olasılıkla geliştiricisi tarafından yakın zamanda denenmiştir; Dart Sass geçişinin yapılıp yapılmadığını şablondan kontrol etmek yine de gerekir. En düşük sürümü birkaç yıl önceki bir Hugo sürümü olan ve son commit’i de eski bir temada ise, LibSass kaldırıldığında ilk sorun yaşayacak temalardan biri olma ihtimali yüksektir.

Derleme ortamında sürüm sabitlemek

Yerelde çalışan bir sitenin sunucuda hata vermesinin en sık nedeni, iki ortamdaki Hugo sürümünün ve türünün farklı olmasıdır. GitHub Actions, Netlify ya da Cloudflare Pages gibi bir ortamda derleme yapıyorsanız iki şeyi açıkça yazın:

• Hugo sürüm numarasını (ör. yereldeki hugo version çıktısı),
• extended mi standart mı olduğunu.

Tema Dart Sass istiyorsa derleme ortamına Dart Sass kurulumunu da ekleyin. Bunu yapmadığınızda derleme, “sass bulunamadı” türünde bir hata ile durur ya da daha kötüsü, CSS olmadan tamamlanır.

Extended sürümü kurmanın bir zararı var mı

Kısa cevap, pratikte yok. Extended sürüm aynı Hugo’dur, yalnızca gömülü LibSass’ı da taşır. Windows belgelerinin paket yöneticisi komutlarında doğrudan extended paketi önermesi bunu gösteriyor. Fark iki yerde ortaya çıkabilir. Birincisi, hazır bir derleme ortamı (bir Docker imajı ya da barındırma hizmetinin sunduğu Hugo) hangi türü kuruyorsa onunla çalışırsınız; yerelde extended kullanıp sunucuda standart sürümle derlemek, Sass kullanan temalarda hatanın en sık kaynağıdır. İkincisi, LibSass Hugo’dan tamamen çıkarıldığında extended sürümün Sass avantajı da ortadan kalkacak; o noktada LibSass’a dayanan temalar, hangi sürümü kurarsanız kurun Dart Sass’a geçmek zorunda kalacak. Bu yüzden extended sürümü kalıcı bir çözüm değil, geçiş dönemi için bir köprü olarak görün.

Hızlı karar listesi

• Temanın assets klasöründe Sass dosyası yok: standart sürüm.
• Sass dosyası var, şablonda dartsass geçiyor: standart sürüm + Dart Sass kurulumu.
• Sass dosyası var, Dart Sass ayarı yok: şimdilik extended sürüm; temanın LibSass’tan çıkış planı olup olmadığını deposundaki konulardan takip edin.
• Siteyi hugo deploy ile S3, GCS ya da Azure’a gönderiyorsunuz: deploy ya da extended/deploy.

Temayı nasıl bağlayacağınızı henüz seçmediyseniz modül mü alt modül mü yazısı bir sonraki adım. Bakımı süren temaları görmek için bu hafta güncellenenler listesine bakabilirsiniz.