Zahit | Sadelik, Eksiklik Değil Derinliktir

Zahit Teması: Gelişmiş Özelleştirme ve Stil Ayarları

Sat, 23 May 2026 00:00:00 GMT

Zahit gelişmiş özelleştirme rehberine hoş geldiniz! Zahit, saf minimalist estetik ilkelerine uygun tasarlandığı için kod yapısı oldukça sade, şeffaf ve düzenlemesi son derece kolaydır. Bu rehberde, yazar profil kartınızı güncellemeyi, global tasarım sistemindeki temel CSS parametrelerini ayarlamayı ve çeviri sözlüklerini değiştirmeyi öğreneceğiz.

👤 1. Temel Site Ayarlarını Düzenleme: `src/config.ts`

Adınızı, mevcut rolünüzü, kısa biyografinizi ve sosyal medya adreslerinizi değiştirmek için src/config.ts dosyasını açmanız yeterlidir. Bu dosya dışa aktarılan üç ana yapılandırma nesnesi barındırır:

SITE_CONFIG

Web sitenizin global parametrelerini belirler:

title: Tarayıcı sekmelerinde ve sayfa başlıklarında görüntülenir.
description: Varsayılan SEO açıklaması (meta description) olarak kullanılır.
url: Blogunuzun yayında olduğu alan adı adresi.

AUTHOR

Sol taraftaki profil kartınızın verilerini barındırır:

name: Tam adınız.
role: Türkçe (tr) ve İngilizce (en) dillerine göre rolleriniz.
bio: Profil fotoğrafınızın altında yer alacak kısa biyografi yazınız.
avatar: Profil fotoğrafınızın klasör yolu (Örn: /src/assets altına eklenen /profile.jpg).

SOCIALS

Sidebar veya mobil footer alanında ikon şeklinde gösterilecek sosyal medya hesaplarınızın listesidir:

export const SOCIALS = [
  {
    label: 'GitHub',
    href: 'https://github.com/johndoe',
    icon: 'mdi:github',
  },
  // Benzer şablonu kopyalayarak yeni sosyal ağlar ekleyebilirsiniz
];

Not: İkonlar için Iconify MDI kodlarını doğrudan kullanabilirsiniz.

🎨 2. Temayı ve Renkleri Özelleştirme

Zahit’in tüm tasarımı src/styles/global.css içerisindeki CSS değişkenleri ile yönetilir. :root seçicisi altındaki değerleri değiştirerek sitenizin tüm renklerini ve yazı tiplerini anında değiştirebilirsiniz:

:root {
  /* Renkler */
  --bg-color: #00022b;     /* Derin uzay mavisi arka plan */
  --dark: #010e54;         /* Kartlar ve koyu panel alanları */
  --accent: #0855b1;       /* Birincil vurgu rengi (Bağlantılar ve sınırlar) */
  --light: #4fa5d8;        /* Hover durumları ve parlak detay renkleri */
  --text-color: #daeaff;   /* Yüksek okunabilirlik sağlayan buz mavisi metin tonu */

  /* Tipografi */
  --font-family-body: 'Source Sans 3', sans-serif;
  --font-family-heading: 'Source Sans 3', sans-serif;

  /* Genişlikler */
  --site-width: 80%;       /* Global genişlik oranı */
  --content-padding: 2rem;
}

Örnek: Orman Yeşili Tema Oluşturma

Temayı mavi tonlardan koyu yeşil bir orman temasına dönüştürmek için renk kodlarını şu şekilde güncelleyebilirsiniz:

:root {
  --bg-color: #0d1a0d;
  --dark: #1b331b;
  --accent: #2e662e;
  --light: #66cc66;
  --text-color: #e2f2e2;
}

🗣️ 3. Çeviri Kelimelerini Güncelleme: `src/i18n/ui.ts`

Sitedeki tüm navigasyon menüleri, “Yayınlanma Tarihi” veya “İçindekiler” gibi statik kelimeler src/i18n/ui.ts dosyasında saklanır.

Bu kelimeleri değiştirmek veya yeni bir kelime eklemek için ui nesnesini düzenlemeniz yeterlidir:

export const ui = {
  tr: {
    'nav.home': 'Ana Sayfa',
    'toc.title': 'İçindekiler',
  },
  en: {
    'nav.home': 'Home',
    'toc.title': 'Contents',
  },
} as const;

Değişiklikleri kaydettiğinizde sitenizdeki tüm statik butonlar ve navigasyon metinleri güncellenecektir.

Sonuç

Zahit, dikkatinizi dağıtmadan sadece yazmaya odaklanabilmeniz için sade tasarlandı. CSS değişkenleri, config.ts ayrımı ve statik çeviri sözlüğü sayesinde portföyünüzü dakikalar içinde tamamen kendinize ait bir alana dönüştürebilirsiniz.

Keyifli kodlamalar ve yazımlar dileriz!

Zahit Teması: İçerik Kullanımı ve Çoklu Dil Yapısı

Thu, 21 May 2026 00:00:00 GMT

Zahit temasının en güçlü özelliklerinden biri, iki dilli (Türkçe ve İngilizce) içerik yönetimine sunduğu yerleşik ve akıcı destektir. Bu rehberde, yazılarınızın klasör yapısını nasıl düzenleyeceğinizi, gönderi üst bilgilerini (frontmatter) nasıl biçimlendireceğinizi ve akıllı dil geçiş sistemini nasıl verimli kullanacağınızı öğreneceğiz.

📂 İçerik Klasör Yapısı

Tüm blog yazıları src/content/blog/ klasörü altında tutulur. Bu dizin içinde, yazılar dillere göre iki alt klasöre ayrılmıştır:

src/content/blog/tr/ — Türkçe yazılarınızın bulunacağı klasör.
src/content/blog/en/ — İngilizce yazılarınızın bulunacağı klasör.

Astro, src/content.config.ts dosyasında tanımlanan koleksiyon yükleyicisi sayesinde bu klasörler içindeki .md ve .mdx uzantılı tüm dosyaları otomatik olarak tarar ve derler.

📋 Gönderi Şablonu ve Parametreler (Frontmatter)

Her markdown yazısının en başında, üç tire --- işaretleri arasına yerleştirilmiş bir üst bilgi (meta veri) bloğu yer almalıdır. Zahit şemasının zorunlu kıldığı alanlar şunlardır:

---
title: 'Yazınızın Başlığı'
description: 'Yazınızın kısa bir özeti veya açıklaması.'
pubDate: '2026-05-17'
tags: ['etiket1', 'etiket2']
translationKey: 'benzersiz-yazi-anahtari'
---

Alanların Açıklamaları:

title & description: Yazının başında gösterilen ve arama motorları (SEO) için HTML <head> etiketlerine dinamik olarak aktarılan zorunlu alanlardır.
pubDate: Yayınlanma tarihi. Zahit bu tarihi yazıları kronolojik sıralamak ve arşiv sayfasında yıllara göre otomatik gruplamak için kullanır.
tags: Yazı etiketleri. Bu yazıların rehber arşivinde listelenmesi için etiketler arasına zahit-guide eklemeyi unutmayın.
translationKey: Bir yazının Türkçe ve İngilizce karşılıklarını birbirine bağlayan tamamen benzersiz ortak bir metin anahtarıdır.

🌐 Akıllı Dil Geçiş Mekanizması Nasıl Çalışır?

Zahit, sayfa üst bilgi alanındaki (Header.astro) dil yönlendirmesinde akıllı bir mantık barındırır. Bir ziyaretçi Türkçe bir yazı okurken sağ üstteki “EN” butonuna tıkladığında, sistem onu İngilizce ana sayfaya fırlatmaz.

Bunun yerine, tüm içerik havuzunu tarayarak o sırada okunan yazı ile tamamen aynı translationKey değerine sahip İngilizce yazıyı arar:

Eğer eşleşen bir yazı bulunursa: Ziyaretçiyi doğrudan o yazının İngilizce çeviri sayfasına yönlendirir.
Eğer eşleşen bir yazı bulunamazsa: Ziyaretçiyi güvenli bir şekilde İngilizce arşiv sayfasına (/en/archive/) yönlendirir.

Uygulamalı Örnek:

Örneğin, minimal tasarım üzerine iki dilde bir yazı hazırlamak istiyorsunuz:

src/content/blog/tr/sadelik.md dosyasını oluşturun ve içine translationKey: 'simplicity-post' ekleyin.
src/content/blog/en/simplicity.md dosyasını oluşturun ve içine translationKey: 'simplicity-post' ekleyin.

Bu basit ayar sayesinde, okuyucularınız diledikleri anda hiçbir içerik kaybı veya kopukluk yaşamadan Türkçe ve İngilizce çeviriler arasında geçiş yapabilirler.

Sonraki Adımlar

Artık yazılarınızı nasıl düzenleyeceğinizi ve yayınlayacağınızı biliyorsunuz. Bir sonraki aşamada tasarım şablonlarını, CSS renk tonlarını ve sosyal medya ağınızı nasıl güncelleyeceğinizi öğrenebilirsiniz.

Son rehberimize geçiş yapın: Zahit Teması: Gelişmiş Özelleştirme ve Stil Ayarları

Zahit Teması: Adım Adım Kurulum Rehberi

Sun, 17 May 2026 00:00:00 GMT

Zahit kurulum rehberine hoş geldiniz! Zahit, sadeliğin eksiklik değil derinlik olduğu felsefesiyle üretilmiş, ham ve düz minimalist bir Astro v6 temasıdır. Bu rehberde, depoyu klonlamaktan yerel geliştirme sunucusunu ayağa kaldırmaya kadar tüm kurulum adımlarını öğreneceğiz.

Gereksinimler

Kuruluma başlamadan önce sisteminizde aşağıdaki araçların kurulu olduğundan emin olun:

Node.js: 22.12.0 veya üzeri bir sürüm tavsiye edilir. Sürümünüzü kontrol etmek için terminalde şu komutu çalıştırabilirsiniz:
```
node --version
```
Git: Proje kodlarını indirmek ve versiyonlamak için gereklidir.

Adım 1: Projeyi Klonlayın

Zahit temasını kullanmak için öncelikle GitHub deposunu bilgisayarınıza indirmelisiniz. Terminali açın ve aşağıdaki komutu girin:

git clone https://github.com/kuscadev/Zahit.git

Klonlama işlemi tamamlandıktan sonra proje klasörünün içerisine geçiş yapın:

cd Zahit

Adım 2: Bağımlılıkları Yükleyin

Zahit, yazıların işlenmesi için @astrojs/mdx ve ikonların yönetimi için astro-icon gibi hafif kütüphaneler kullanır. Projenin ana dizininde aşağıdaki komutu çalıştırarak gerekli tüm paketleri yükleyin:

npm install

Bu komut package.json dosyasını okuyacak ve yerel node_modules klasörünü oluşturacaktır.

Adım 3: Geliştirme Sunucusunu Başlatın

Paket kurulumları tamamlandığına göre Astro’nun hızlı ve dinamik yerel sunucusunu başlatmaya hazırsınız:

npm run dev

Terminal ekranınızda projenin çalıştığı yerel adres görüntülenecektir (genellikle):

  ┃ Local    http://localhost:4321/

Tarayıcınızı açıp http://localhost:4321/ adresine giderek minimalist ve şık sitenizi anında görüntüleyebilirsiniz! Kod üzerinde yapacağınız her değişiklik tarayıcıda anlık olarak yenilenecektir.

Sonraki Adımlar

Tebrikler, Zahit temanız başarıyla kuruldu ve çalışıyor! Artık yazar biyografinizi özelleştirebilir ve ilk iki dilli blog yazınızı kaleme alabilirsiniz.

Yazı oluşturma ve çoklu dil sistemini öğrenmek için bir sonraki rehberimize göz atın: Zahit Teması: İçerik Kullanımı ve Çoklu Dil Yapısı

Markdown Rehberi: Temel Sözdizimi

Sat, 10 May 2025 00:00:00 GMT

Markdown, düz metin kullanarak biçimlendirilmiş belgeler oluşturmanıza olanak tanıyan hafif bir işaret dilidir. Zahit gibi Astro tabanlı sitelerde içerik üretmenin en doğal yolu budur. ## Başlıklar ``` # H1 Başlık ## H2 Başlık ### H3 Başlık ``` ## Metin Biçimlendirme **Kalın metin** için çift yıldız, *italik* için tek yıldız kullanılır. ~~Üstü çizili~~ metin için ise çift tilde. > Alıntı blokları için `>` karakterini kullanabilirsiniz. Okuyucunun dikkatini çekmek istediğiniz önemli cümleleri bu şekilde vurgulayabilirsiniz. ## Listeler Sırasız liste: - Birinci madde - İkinci madde - İç içe madde - Üçüncü madde Sıralı liste: 1. Önce bunu yap 2. Sonra şunu 3. En son bunu ## Bağlantılar ve Görseller [Astro resmi sitesi](https://astro.build) formatında bağlantı ekleyebilirsiniz. ## Kod Blokları Satır içi `kod` için backtick kullanılır. ```javascript function zahit() { return 'Sadelik, eksiklik değil derinliktir.'; } ``` ## Tablolar | Sözdizimi | Açıklama | |-----------|----------| | `**kalın**` | Kalın metin | | `*italik*` | İtalik metin | | `[metin](url)` | Bağlantı | Markdown öğrenmek birkaç dakika alır; ustalaşmak ise sizi özgür kılar.

Zahit | Sadelik, Eksiklik Değil Derinliktir

Zahit Teması: Gelişmiş Özelleştirme ve Stil Ayarları

👤 1. Temel Site Ayarlarını Düzenleme: src/config.ts

SITE_CONFIG

AUTHOR

SOCIALS

🎨 2. Temayı ve Renkleri Özelleştirme

Örnek: Orman Yeşili Tema Oluşturma

🗣️ 3. Çeviri Kelimelerini Güncelleme: src/i18n/ui.ts

Sonuç

Zahit Teması: İçerik Kullanımı ve Çoklu Dil Yapısı

📂 İçerik Klasör Yapısı

📋 Gönderi Şablonu ve Parametreler (Frontmatter)

Alanların Açıklamaları:

🌐 Akıllı Dil Geçiş Mekanizması Nasıl Çalışır?

Uygulamalı Örnek:

Sonraki Adımlar

Zahit Teması: Adım Adım Kurulum Rehberi

Gereksinimler

Adım 1: Projeyi Klonlayın

Adım 2: Bağımlılıkları Yükleyin

Adım 3: Geliştirme Sunucusunu Başlatın

Sonraki Adımlar

Markdown Rehberi: Temel Sözdizimi

👤 1. Temel Site Ayarlarını Düzenleme: `src/config.ts`

🗣️ 3. Çeviri Kelimelerini Güncelleme: `src/i18n/ui.ts`