Next.js 15 ve MDX ile Başlangıç Rehberi
Merhaba! Bu rehberde, Next.js 15 ve MDX kullanarak statik site geliştirmenin temellerini öğreneceğiz. Öncelikle, Next.js’in ne olduğunu ve neden MDX ile birlikte kullanılmasının faydalı olduğunu inceleyelim. Ardından, adım adım kurulum ve içerik oluşturma sürecini detaylı bir şekilde ele alacağız. Hazırsanız başlayalım!
Next.js Nedir?
Next.js, React tabanlı bir framework olup, hızlı, ölçeklenebilir ve SEO dostu web uygulamaları oluşturmayı kolaylaştırır. Statik site oluşturma özelliği, performansı artırırken, geliştirme sürecini de hızlandırır. Bu özellik, özellikle bloglar veya dokümantasyon siteleri gibi içerik odaklı projeler için oldukça idealdir.
MDX’in Gücü
MDX (Markdown + JSX), Markdown’ın gücünü JavaScript’in esnekliği ile birleştiren bir dildir. Bu sayede, Markdown syntax’ını kullanarak zengin içerik oluşturabilir ve aynı zamanda React bileşenlerini doğrudan Markdown dosyalarınızda kullanabilirsiniz. Bu, içeriklerinizi daha dinamik ve etkileşimli hale getirmenizi sağlar. Örneğin, kod bloklarının sentax highlight’ı veya özel React bileşenlerinin kullanımı ile içerikleri daha zenginleştirebilirsiniz.
Kurulum ve Yapılandırma
İlk olarak, yeni bir Next.js projesi oluşturalım. Bunun için npm veya yarn kullanabiliriz:
npx create-next-app my-mdx-blog --typescript
Ardından, MDX desteğini eklemek için gerekli paketleri kuracağız:
npm install @mdx-js/react remark-gfm
Şimdi, Next.js konfigürasyon dosyasında (next.config.js) MDX desteğini etkinleştirmemiz gerekiyor:
/** @type {import('next').NextConfig} */
const nextConfig = {
pageExtensions: ['ts', 'tsx', 'js', 'jsx', 'mdx'],
}
module.exports = nextConfig
Bu konfigürasyon, Next.js’in .mdx uzantılı dosyaları sayfa olarak işlemesini sağlar. Detaylı bilgi için Next.js resmi dokümanlarına göz atabilirsiniz. Bu adım oldukça önemlidir, aksi halde MDX dosyalarınız çalışmayacaktır.
İçerik Oluşturma
Şimdi, ilk MDX dosyanızı oluşturabilirsiniz. Örneğin, pages/blog/ilk-makale.mdx adında bir dosya oluşturup aşağıdaki içeriği ekleyebilirsiniz:
---
title: İlk Makalem
date: 2024-10-27
---
Merhaba Dünya! Bu benim ilk MDX makalem.
javascript
console.log("Merhaba, Next.js ve MDX!")
Gördüğünüz gibi, frontmatter (— ile başlayan ve biten kısım) ile meta veriler tanımlayabiliyoruz. Bu meta veriler, makale başlığı ve tarihi gibi bilgileri içerir ve sayfada kullanılmak üzere React komponenti gibi davranırlar. Ardından, standart Markdown syntax’ını kullanarak içerik yazabilirsiniz. Ayrıca, React bileşenlerini de ekleyebilirsiniz.
Sonuç
Bu rehberde, Next.js 15 ve MDX kullanarak statik site geliştirmeye nasıl başlayacağınızı adım adım gösterdik. Umarım bu rehber, size Next.js ve MDX ile projeler geliştirmenizde yardımcı olmuştur. Daha fazla bilgi ve örnekler için fatihsoysal.com adresini ziyaret edebilirsiniz. Sorularınız veya önerileriniz varsa lütfen yorumlarda paylaşın!
Bu makaleyi hazırlarken şu kaynaklardan faydalandım:
#Etiketler: Next.js, MDX, Statik Site, İçerik Oluşturma, Rehber, Tutorial, JavaScript, React, SEO, Blog