Files
hMarkdown/README.md

68 lines
4.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# hMarkdown - Modern Markdown Editörü
hMarkdown, .NET Framework 4.8 ile geliştirilmiş, kullanıcı dostu ve modern özelliklere sahip bir Windows Forms Markdown editörüdür. Markdown dosyalarınızı hızlıca görüntüleyebilir, düzenleyebilir ve HTML çıktısı olarak önizleyebilirsiniz.
## 🚀 Özellikler
### **Görüntüleme ve Düzenleme**
* **Modern Arayüz**: Şık ve responsive tasarım.
* **Canlı Önizleme**: Markdown kodlarınızı yazarken anlık olarak HTML çıktısını görebilirsiniz.
* **Zengin İçerik Desteği**:
* 🎨 **Renkli Kod Blokları**: `Highlight.js` entegrasyonu ile kodlarınız otomatik olarak renklendirilir.
* 📊 **Tablolar**: Markdown tabloları, modern ve okunaklı bir formatla görüntülenir.
* 😀 **Emoji Desteği**: Emoji ve özel karakterler web standartlarında görüntülenir.
* 🖼️ **Görseller**: Resimler ve medya öğeleri düzgün şekilde boyutlandırılır.
### **Kullanım Kolaylıkları**
* **Sürükle & Bırak**: `.md` dosyalarını uygulamanın üzerine sürükleyerek anında açabilirsiniz.
* **Düzenleme Modu**: Tek bir tıkla "Görüntüleme" ve "Düzenleme" modları arasında geçiş yapabilirsiniz.
* **Responsive Adres Çubuğu**: Pencere boyutuna göre otomatik ayarlanan dosya yolu çubuğu.
* **Yardım Dokümantasyonu**: Takıldığınız yerde `F1` tuşu veya yardım butonu ile Markdown komut rehberine ulaşabilirsiniz.
## 🔄 Son Güncellemeler ve İyileştirmeler
### 📂 Dosya Açma ve Çift Tıklama İyileştirmeleri
* **Çift Tıklama Desteği (Windows İlişkilendirmesi)**: Uygulamanın Windows Explorer üzerinden çift tıklatılarak veya parametre verilerek başlatılması tamamen optimize edildi. Dosya yollarındaki tırnak işaretleri (`"`) temizlenir ve boşluklu dosya yolları otomatik olarak birleştirilir.
* **Açılışta Önizleme Yükleme Sorunu**: İlk açılışta önizleme ekranının boş kalması engellendi. `WebBrowser` kontrolü hazır olana kadar bekletilip ardından dosya içeriğinin yüklenmesi sağlandı.
* **Dosya Açma Penceresi Temizliği**: "Gözat" (...) butonuna tıklandığında açılan dosya seçme penceresindeki varsayılan `"openFileDialog"` metni temizlendi.
### 🌐 Tarayıcı ve Performans İyileştirmeleri
* **Modern Tarayıcı Motoru (IE11 Edge Modu)**: Varsayılan olarak eski IE7 modunda çalışan `WebBrowser` kontrolü, program başlangıcında Windows Kayıt Defteri (Registry - HKCU) üzerinden otomatik olarak **IE11 (Edge) moduna** yükseltilir. Bu sayede `highlight.js` ve CSS stilleri kusursuz çalışır.
* **Betik Hatalarının Engellenmesi**: Tarayıcının arka planda üretebileceği script hataları tamamen engellendi (`ScriptErrorsSuppressed = true`), kullanıcıya hata penceresi gösterilmez.
* **Senkron & Titremesiz Önizleme**: Tarayıcıya doğrudan senkron yazma (`Document.Write`) yöntemi kullanılarak sayfa geçişlerindeki titremeler giderildi.
### 🏷️ Sürüm Yönetimi
* **Dinamik Sürüm Bilgisi**: Uygulama sürümü `v1.<yil>.<ay>.<artan build numarası>` (Örn: `1.2026.7.XXXX`) formatına dönüştürüldü. Otomatik artan build numarası aktif edilerek derleme bazlı takip kolaylaştırıldı.
* **Sürüm Gösterimi**: Aktif çalışan uygulama sürümü, pencere başlığında (Title Bar) dinamik olarak gösterilir.
## 🛠️ Kurulum ve Derleme
1. **Depoyu İndirin**: Projeyi bilgisayarınıza klonlayın veya zip olarak indirin.
2. **Projeyi Açın**: `hMarkdown.sln` dosyasını Visual Studio 2022 ile açın.
3. **Derleyin**: `Build Solution` (Çözümü Derle) komutunu çalıştırın.
4. **Çalıştırın**: Uygulamayı `bin\Debug` klasöründen `hMarkdown.exe` ile başlatın.
## 📖 Kullanım
1. **Dosya Açma**:
* "Gözat" (...) butonunu kullanarak bir dosya seçin.
* Veya `.md` uzantılı dosyanızı sürükleyip uygulama penceresine bırakın.
2. **Düzenleme**:
* Üst menüdeki **"Düzenle"** ✏️ butonuna basın.
* Markdown kodlarınızı yazın / düzenleyin.
3. **Kaydetme**:
* Değişikliklerinizi kaydetmek için **"Kaydet"** 💾 butonuna basın.
4. **Önizleme**:
* Tekrar **"Görüntüle"** butonuna basarak HTML çıktısını kontrol edin.
5. **Yardım**:
* Markdown kurallarını hatırlamak için **"Yardım (F1)"** ❓ butonuna basın.
## 📋 Gereksinimler
* Windows İşletim Sistemi (10/11 önerilir)
* .NET Framework 4.8
## 📄 Lisans
Bu proje MIT Lisansı ile lisanslanmıştır.