Belge Dönüştürme

Genel Bakış

Colpan, çeşitli belge formatlarını PDF’e dönüştürebilir. İki farklı dönüştürücü motoru sunar.

Desteklenen Formatlar:

Giriş	Dönüşüm Zinciri	Çıkış
.udf (UYAP)	Direkt	PDF
.rtf	RTF → UDF → PDF	PDF
.fodt	FODT → UDF → PDF	PDF
.docx	LibreOffice → RTF → UDF → PDF	PDF
.doc	LibreOffice → RTF → UDF → PDF	PDF
.odt	LibreOffice → RTF → UDF → PDF	PDF

Dönüştürücü Motorları

1. Java Daemon (OriginalUyapEditor)

Varsayılan dönüştürücü. UYAP editörün Java kütüphanelerini kullanır.

Özellikler:

• Yüksek uyumluluk
• UYAP formatı ile birebir uyum
• Embedded JRE (kurulum gerektirmez)
• Socket tabanlı IPC (port 39876)

Avantajlar:

• En doğru rendering
• Tüm UDF özelliklerini destekler
• Karmaşık tablolar ve görüntüler

Dezavantajlar:

• İlk başlatma yavaş (JVM warm-up)
• Daha fazla bellek kullanımı

2. Native Qt Converter (ColpanUdf2Pdf)

C++/Qt tabanlı native dönüştürücü. Daemon gerektirmez.

Özellikler:

• Direkt kütüphane entegrasyonu
• Daha hızlı başlatma
• Daha düşük bellek kullanımı

Avantajlar:

• Anında dönüştürme
• Daha az kaynak tüketimi
• Daemon yönetimi yok

Dezavantajlar:

• Bazı karmaşık formatlar eksik olabilir
• Sürekli geliştirme altında

Motor Seçimi

1. Ayarlar > PDF Dönüştürücü
2. “Java Daemon” veya “Native Qt” seçin
3. Değişiklik hemen uygulanır

UDF → PDF Dönüştürme

Otomatik Dönüştürme

1. Sonuç listesinde UDF dosyasına çift tıklayın
2. PDF otomatik oluşturulur
3. Yerleşik viewer’da açılır

Manuel Dönüştürme

1. Sonuç listesinde sağ tıklayın
2. “PDF Olarak Kaydet” seçin
3. Kayıt konumu seçin
4. PDF oluşturulur

Dönüştürme Akışı

UDF Dosyası
    ↓
[İmza Kontrolü] → İmzalı mı?
    ↓ Evet           ↓ Hayır
[İmza Kaldırma]  → Direkt işle
    ↓
[Temp UDF Oluştur]
    ↓
[Dönüştürücü Motor]
    ↓
PDF Dosyası

İmza Kaldırma

UDF dosyalarındaki dijital imza (sign.sgn) dönüştürme öncesi geçici olarak kaldırılır.

Neden?

• İmzalı UDF’ler dönüştürülemez
• Orijinal dosya değiştirilmez
• Geçici kopya kullanılır

RTF → UDF → PDF Dönüştürme

RTF dosyaları önce UDF formatına, sonra PDF’e dönüştürülür.

RTF Import Özellikleri

Özellik	Destek
Metin formatları	Evet
Paragraf stilleri	Evet
Tablolar	Kısmi
Görüntüler	Evet
Sayfa düzeni	Evet
Üst/alt bilgi	Kısmi

Kullanım

1. Dosya > “RTF’den Dönüştür”
2. RTF dosyası seçin
3. UDF oluşturulur
4. PDF önizleme açılır

FODT → UDF → PDF Dönüştürme

FODT (Flat ODF Text), LibreOffice’in sıkıştırılmamış XML formatıdır.

FODT Avantajları

• Tek XML dosyası (ZIP değil)
• Versiyon kontrolüne uygun
• Kolay düzenlenebilir

Kullanım

1. Dosya > “FODT’den Dönüştür”
2. FODT dosyası seçin
3. UDF oluşturulur
4. PDF önizleme açılır

LibreOffice Zinciri

DOCX, DOC ve ODT dosyaları LibreOffice üzerinden dönüştürülür.

Gereksinimler

• LibreOffice kurulu olmalı
• soffice.exe PATH’te olmalı

Dönüşüm Zinciri

DOCX/DOC/ODT
    ↓
[LibreOffice] → RTF dışa aktar
    ↓
RTF dosyası
    ↓
[RTF Parser] → UDF oluştur
    ↓
UDF dosyası
    ↓
[PDF Converter] → PDF oluştur
    ↓
PDF dosyası

Kullanım

1. Dosya > “Office Belgesinden Dönüştür”
2. DOCX/DOC/ODT seçin
3. LibreOffice RTF’e çevirir
4. RTF → UDF → PDF zinciri çalışır

LibreOffice Bulunamadı Hatası

Çözümler:

1. LibreOffice’i kurun
2. PATH’e ekleyin:

   C:\Program Files\LibreOffice\program\

3. Uygulamayı yeniden başlatın

Java Daemon Yönetimi

Daemon Durumu

Durum çubuğunda PDFc göstergesi:

Gösterge	Anlam
PDFc ✓ (Yeşil)	Daemon çalışıyor
PDFc ⏳ (Sarı)	Daemon başlatılıyor
PDFc ✗ (Kırmızı)	Daemon başlatılamadı

Manuel Kontrol

Başlatma:

1. Ayarlar > PDF Dönüştürücü
2. “Daemon Başlat” tıklayın

Durdurma:

1. Ayarlar > PDF Dönüştürücü
2. “Daemon Durdur” tıklayın

Fire-and-Forget Başlatma

Daemon arka planda başlatılır, UI bloklanmaz.

Akış:

1. Başlatma komutu gönderilir
2. UI hemen devam eder
3. Health check timer çalışır
4. Hazır olunca durum güncellenir

İstek Kuyruğu

Daemon hazır değilken gelen istekler otomatik kuyruğa alınır.

İstek geldi → Daemon READY mi?
    ↓ Hayır           ↓ Evet
[Kuyruğa ekle]    [Hemen işle]
[Daemon başlat]
    ↓
Daemon READY olunca
    ↓
[Kuyruk işle]

Geçici Dosya Yönetimi

PDF Önbellek

Dönüştürülen PDF’ler geçici dizinde saklanır:

%TEMP%\Colpan\pdf_cache\
├── doc1_abc123.pdf
├── doc2_def456.pdf
└── ...

Temizlik

Otomatik:

• Uygulama kapanışında
• Belirli süre sonra (1 saat)

Manuel:

1. Ayarlar > Genel
2. “Önbelleği Temizle” tıklayın

Sorun Giderme

PDF açılmıyor

Belirtiler:

• PDFc durumu kırmızı
• “Dönüştürme hatası” mesajı

Çözümler:

1. Port 39876 kontrolü
2. Daemon’u yeniden başlatın
3. Native converter’ı deneyin

Dönüştürme çok yavaş

Belirtiler:

• İlk PDF uzun sürüyor (>10 sn)

Nedenler:

• JVM warm-up (ilk defa)
• Büyük dosya

Çözümler:

1. İlk dönüştürme sonrası hızlanır
2. Native converter kullanın

Bozuk PDF çıktısı

Belirtiler:

• Eksik karakterler
• Bozuk tablo
• Görüntü yok

Çözümler:

1. Java Daemon’a geçin
2. Orijinal UDF’i kontrol edin
3. Font eksikliği olabilir

RTF dönüşüm hatası

Belirtiler:

• “RTF parse error” mesajı

Çözümler:

1. RTF’in geçerli olduğunu kontrol edin
2. Farklı bir RTF kaynağı deneyin
3. LibreOffice ile önce temizleyin

Performans İpuçları

İpucu	Etki
SSD kullanın	2-3x hızlı I/O
Native converter	Daha hızlı başlatma
Önbellek aktif	Tekrar dönüştürme yok
Küçük dosyalar	Daha hızlı işlem

Teknik Detaylar

Java Daemon Port

Port: 39876 (localhost)
Protokol: TCP Socket
Format: Dosya yolu + newline
Yanıt: PDF yolu veya hata

Native Converter API

// Direkt fonksiyon çağrısı
QString pdfPath = ColpanUdf2Pdf::convert(udfPath);

Desteklenen Kodlamalar

• UTF-8 (varsayılan)
• Windows-1254 (Türkçe)
• ISO-8859-9 (Latin-5)