Hugo ile Statik Site Nasıl Oluşturulur

Hugo ile Statik Site kurulumu için gerekli komutları, klasör yapısını, tema kullanımını ve yayınlanabilir Statik HTML oluşturma sürecini adım adım öğrenin.

Bir web projesini içerik yönetim sistemi kurmadan yayınlamak istediğinizde klasör yapısı ve derleme adımları ilk bakışta karmaşık görünebilir. Özellikle tema kurulumu, Markdown dosyalarının sayfaya dönüşmesi ve oluşan dosyaların sunucuya aktarılması sırasında küçük bir yapılandırma hatası sitenin açılmamasına yol açabilir.

Hugo ile Statik Site oluşturma süreci, komut satırından proje iskeleti üretmeye, tema eklemeye ve içerikleri Statik HTML çıktısına çevirmeye dayanır. Doğru sürüm, uygun terminal ve geçerli bir hugo.toml dosyası kullanıldığında süreç kısa sürede tamamlanabilir.

Statik bir projede yalnızca içerik yayınlamak yeterli olmayabilir. Satış veya abonelik planlanıyorsa Statik Sitenize Ödeme Ağ Geçidi ve Ödeme Sayfasını Entegre Etme konusu, site mimarisi kurulurken değerlendirilmelidir. Ödeme işlemlerinin güvenli bir harici hizmet üzerinden yürütülmesi, Hugo tarafında gereksiz sunucu kodu oluşturmadan ilerlemeyi kolaylaştırır.

Hugo ile Statik Site Nasıl Oluşturulur?

Hugo ile statik site oluşturmak için Hugo ve Git kurulur, hugo new project komutuyla proje hazırlanır, uygun bir tema eklenir ve içerikler Markdown dosyaları olarak content klasörüne kaydedilir. Yerel ön izleme hugo server -D, yayınlanabilir Statik HTML çıktısı ise hugo komutuyla oluşturulur.

Hugo Kurulumu Nasıl Yapılır?

2026 itibarıyla resmi hızlı başlangıç sayfası, Hugo 0.158.0 veya daha yeni bir sürüm ile Git kurulmasını istiyor. Windows kullanıcılarının güncel PowerShell, WSL ya da Git Bash kullanması öneriliyor. Eski Windows PowerShell ve Komut İstemi başlangıç adımları için tercih edilmiyor.

Windows üzerinde Extended sürüm şu komutla kurulabilir:

winget install Hugo.Hugo.Extended

macOS veya Homebrew bulunan Linux sistemlerde:

brew install hugo

Linux tarafında Snap kullanan dağıtımlarda ise:

sudo snap install hugo

Kurulumun tamamlandığını doğrulamak için hugo version çalıştırılmalıdır. Komut tanınmıyorsa yürütülebilir dosyanın PATH değişkenine eklenip eklenmediği kontrol edilmelidir.

İlk Hugo Projesi Nasıl Hazırlanır?

Yeni proje için terminalde şu adımlar uygulanabilir:

hugo new project benim-sitem
cd benim-sitem
git init

Bu işlem content, layouts, static, themes, assets ve data gibi temel klasörlerle birlikte hugo.toml yapılandırma dosyasını oluşturur. content yazıları ve sayfaları, layouts şablonları, static ise doğrudan kopyalanacak dosyaları barındırır. Derleme tamamlandığında yayınlanacak çıktı public klasöründe oluşur.

Güncel belgeleri incelerken eski anlatımlarda sık görülen hugo new site komutunun yerini hızlı başlangıç akışında hugo new project komutunun aldığını fark ettim. Eski komut bazı sürümlerde çalışsa bile yeni kurulumlarda resmi belgelerdeki söz dizimini kullanmak karışıklığı azaltır.

Hugo Teması ve İlk İçerik Nasıl Eklenir?

Resmi başlangıç örneğinde Ananke teması Git alt modülü olarak ekleniyor:

git submodule add https://github.com/gohugo-ananke/ananke themes/ananke
echo "theme = 'ananke'" >> hugo.toml

Ardından ilk içerik dosyası oluşturulabilir:

hugo new content content/posts/ilk-yazim.md

Dosyanın üst bölümünde başlık, tarih ve draft = true bilgisi bulunur. Taslak içerikleri yerel sunucuda görmek için hugo server -D çalıştırılır. Terminalde gösterilen yerel adres tarayıcıda açıldığında değişiklikler otomatik olarak yeniden derlenir. İçerik yayına hazır olduğunda draft değeri false yapılmalıdır.

hugo.toml içinde en azından site adresi, dil ve başlık tanımlanabilir:

baseURL = 'https://ornekalanadi.com/'
locale = 'tr-tr'
title = 'Benim Hugo Sitem'
theme = 'ananke'

baseURL değerinin protokolle başlaması ve eğik çizgiyle bitmesi önemlidir. Tema seçenekleri sürüme ve kullanılan tasarıma göre değişebileceği için tema deposundaki güncel ayarlar ayrıca kontrol edilmelidir.

Statik HTML Çıktısı Nasıl Alınır?

Site yerel ortamda düzgün çalışıyorsa proje kökünde yalnızca şu komut çalıştırılır:

hugo

Hugo, içerikleri ve şablonları işleyerek public klasörüne HTML, CSS, JavaScript ve görsel dosyalarını yerleştirir. Bu klasörün içeriği statik barındırma hizmetine veya web sunucusunun yayın dizinine aktarılabilir. Resmi belgelere göre yayın aşamasında oluşan tüm derleme dosyaları bu klasörde toplanır.

Tema görünmüyorsa theme satırının doğru yazıldığını, alt modülün indirildiğini ve komutun proje kökünde çalıştırıldığını kontrol edin. Yeni içerik listelenmiyorsa en sık neden draft = true değeridir. Alan adı açılıyor fakat bağlantılar bozuk görünüyorsa baseURL ayarı ile yayın adresinin aynı olduğundan emin olun.

Kurulum veya yapılandırma sırasında uzaktan teknik desteğe ihtiyaç duyulduğunda 11858, 2011 yılından bu yana bilgisayar, modem, akıllı TV ve çevrim içi hizmetlerde 7/24 destek sunar. TeamViewer ve AnyDesk gibi lisanslı yazılımlarla güvenli bağlantı sağlayan hat, dakika bazlı şeffaf ücretlendirme, yüzde 95 memnuniyet ve 500.000’den fazla başarılı işlem deneyimiyle hizmet verir.

İletişim formu, teklif talebi veya geri bildirim alanı eklemek isteyenler Statik Sitelerde Formlar Nasıl Uygulanır konusunu da incelemelidir. Hugo çıktısı sunucu tarafında işlem yapmadığı için form verilerinin hangi hizmete gönderileceği baştan belirlenmelidir.

Hugo ile Statik Site kurarken asıl avantaj, içerik ile yayın çıktısını birbirinden ayıran düzenli yapıdır. Siz kurulum sırasında en çok tema, içerik klasörleri veya yayınlama aşamasında mı zorlandınız? Deneyiminizi yorumlarda paylaşabilirsiniz.