Documentize'i NuGet ile Kurma

NuGet Paket Yöneticisi Konsolu ile Nasıl Kurulur

1. Projenizi Açın:

   • Visual Studio’yu başlatın ve .NET uygulamanızı açın.

2. Paket Yöneticisi Konsoluna Erişim Sağlayın:

   • Araçlar > NuGet Paket Yöneticisi > Paket Yöneticisi Konsolu’na gidin.

3. Paketi Kurun:

   • En son tam sürümü kurmak için Install-Package Documentize komutunu girin.
   • Güncellemeleri de içeren en son sürümü kurmak için Install-Package Documentize -prerelease komutunu kullanın.
   • Komutu çalıştırmak için Enter‘a basın.

NuGet Paket Yöneticisi Konsolu ile Paketi Nasıl Güncelleyebilirsiniz

Documentize’i NuGet ile kurduysanız ve en son sürüme güncellemek istiyorsanız:

1. Projenizi Açın:

   • Visual Studio’yu başlatın ve .NET uygulamanızı açın.

2. Paket Yöneticisi Konsoluna Erişim Sağlayın:

   • Araçlar > NuGet Paket Yöneticisi > Paket Yöneticisi Konsolu’na gidin.

3. Paketi Güncelleyin:

   • En son tam sürüme güncellemek için Update-Package Documentize komutunu girin.
   • Güncellemeleri de içeren en son sürüme güncellemek için Update-Package Documentize -prerelease komutunu kullanın.
   • Komutu çalıştırmak için Enter‘a basın.

NuGet Paket Yöneticisi GUI ile Nasıl Kurulur

1. Projenizi Açın:

   • Visual Studio’yu başlatın ve .NET uygulamanızı açın.

2. NuGet Paketlerini Yönetmeye Gidin:

   • Proje menüsünden NuGet Paketlerini Yönet seçeneğini seçin.

3. Documentize için Arama Yapın:

   • Gözat sekmesine gidin ve arama kutusuna Documentize yazın.

4. Paketi Kurun:

   • Documentize’in en son sürümünün yanındaki Kur/Güncelle düğmesine tıklayın.
   • Açılan pencerede Kabul Et’e tıklayarak onaylayın.

NuGet Kullanmanın Artıları

• Otomatik Bağımlılık Yönetimi:

  • NuGet, bağımlılıkları otomatik olarak yönetir ve gerekli tüm kütüphanelerin dahil edilmesini ve doğru şekilde güncellenmesini sağlar. Bu, kayıp veya uyumsuz bağımlılık riskini azaltır.

• Kolay Güncellemeler:

  • Paketleri güncellemek NuGet ile basittir; ister Paket Yöneticisi Konsolu ile ister GUI aracılığıyla. Bu, kütüphanelerinizi en son özellikler ve hata düzeltmeleri ile güncel tutmayı kolaylaştırır.

• Visual Studio ile Entegre:

  • NuGet, Visual Studio ile sorunsuz bir şekilde entegre edilmiştir ve geliştirici ortamından çıkmadan paketleri yönetmek için kullanıcı dostu bir arayüz sunar.

• Sürümleme:

  • NuGet, kütüphanelerin farklı sürümlerini belirtmenizi ve yönetmenizi sağlar; böylece önceki sürümlere kolayca geri dönebilir veya yeni sürümleri test edebilirsiniz.

NuGet Kullanmanın Eksileri

• Sadece Visual Studio ile Sınırlı:

  • NuGet, öncelikle Visual Studio içinde kullanılmak üzere tasarlanmıştır. Diğer ortamlarda kullanılabilse de, entegrasyon en sağlam Visual Studio’dadır.

• Sürüm Çatışması Potansiyeli:

  • Birçok bağımlılığı olan büyük projelerde, sürümlerin yönetimi ve çatışmaların çözülmesi karmaşık hale gelebilir. NuGet, bunu yönetmek için araçlar sunar, ancak dikkatli bir dikkat gerektirir.

• Ağ Bağlantısı Gereksinimi:

  • Paketleri kurmak ve güncellemek için internet bağlantısı gereklidir. Kısıtlı veya internet erişimi olmayan bir ortamda çalışıyorsanız, çevrimdışı yöntemler veya paketleri önceden indirme yöntemlerini kullanmanız gerekebilir.

• Büyük Projeler İçin Karmaşıklık:

  • Çok büyük projelerle geniş bağımlılık ağaçlarına sahip olduğunda, NuGet aracılığıyla paket yönetiminin getirdiği yük zorlayıcı hale gelebilir. Bu tür durumlarda, bağımlılıkları etkili bir şekilde yönetmek için ek araçlar veya stratejiler gerekebilir.

Documentize'yi MSI ile Kurma

MSI Yükleyici ile Nasıl Kurulur

1. MSI Yükleyicisini İndirin:

   • En son versiyon için MSI yükleyicisini indirmek üzere v24.12 MSI üzerine tıklayın.

2. Yükleyiciyi Çalıştırın:

   • İndirilen MSI dosyasına çift tıklayarak kurulum sihirbazını başlatın.

3. Kurulum Sihirbazını Takip Edin:

   • Yükleyici tarafından sağlanan ekrandaki talimatları takip edin. Lisans anlaşmasını kabul etmeniz ve kurulum seçeneklerini seçmeniz gerekebilir.

4. Kurulumu Tamamlayın:

   • Kurulum tamamlandığında, Documentize DLL’leri sisteminizin Global Assembly Cache (GAC) veya başka bir belirtilen konuma kurulmuş olacaktır.

5. Kurulumu Doğrulayın:

   • DLL’lerin belirtilen kurulum dizininde veya GAC’de mevcut olduğunu doğrulayarak doğru bir şekilde kurulduğundan emin olun.

MSI Yükleyicisini Kullanmanın Artıları

• Kullanım Kolaylığı:

  • MSI yükleyicisi, basit ve yönlendirilmiş bir kurulum süreci sunar. Gerekli tüm yapılandırmaları halleder ve DLL’leri merkezi bir konuma yerleştirir, böylece Documentize’i birden fazla projede kullanmak kolaydır.

• Sistem genelinde Kurulum:

  • MSI yöntemi, Documentize’i sistemin Global Assembly Cache (GAC) veya başka bir merkezi konuma kurar. Bu, sistemdeki herhangi bir uygulamanın DLL’lere erişmesini sağlar, her projede bireysel olarak referans vermek gerekmez.

• Otomatik Güncellemeler:

  • Documentize bir güncellenmiş yükleyici sağlarsa, yeni MSI dosyasını çalıştırarak kurulumunuzu kolayca güncelleyebilirsiniz; bu genellikle güncelleme sürecini sorunsuz bir şekilde yönetir.

• Tutarlılık:

  • MSI yükleyicisini kullanmak, gerekli tüm dosyaların farklı ortamlar arasında doğru ve tutarlı bir şekilde kurulmasını sağlar, bu da kaybolmuş veya hatalı DLL’lerin riskini azaltır.

MSI Yükleyicisini Kullanmanın Eksileri

• Sınırlı Esneklik:

  • MSI yükleyicisi, Documentize’i sistem genelinde bir konuma kurar, bu da tüm geliştirme ortamları için uygun olmayabilir. Proje özel yapılandırmaları veya sürümleri barındırma esnekliğinden yoksun olabilir.

• Potansiyel Üst Yük:

  • DLL’leri GAC’a yüklemek, özellikle birden fazla versiyonun aynı anda gerekebileceği senaryolarda üst yük ve karmaşıklık getirebilir.

• Manuel Kaldırma:

  • Documentize’i kaldırmanız gerektiğinde, MSI tarafından sağlanan kaldırıcıyı kullanmalısınız; bu, doğru yönetilmediği takdirde arta kalan dosyalar veya yapılandırmalar bırakabilir.

• Sürüm Çatışmaları:

  • Sistem genelindeki kurulumlar, farklı projelerin farklı sürümlerini gerektirmesi durumunda sürüm çatışmalarına yol açabilir. Bu çatışmalarla başa çıkmak ek yapılandırma veya temizlik gerektirebilir.

ZIP ile Documentize Kurulumu

ZIP Arşivi ile Nasıl Kurulur

1. ZIP Arşivini İndirin:

   • En son sürüm Documentize’i arşiv formatında indirmek için v24.12 ZIP bağlantısına tıklayın.

2. İçeriği Çıkarın:

   • İndirdikten sonra, ZIP dosyasının içeriğini seçtiğiniz bir dizine çıkarın. Bu dosyaları paylaşılan bir dizinde veya projeniz yapısında tutmayı seçebilirsiniz.

3. Projenize Referans Ekleyin:

   • Projenizi IDE’nizde (örn. Visual Studio) açın.
   • Proje > Referans Ekle > Gözat kısmına gidin ve DLL’leri çıkardığınız dizine gidin.
   • İlgili DLL dosyalarını seçin ve projenize referans olarak ekleyin.

4. Manuel Güncellemeler:

   • Documentize’in yeni bir sürümü yayınlandığında, güncellenmiş ZIP arşivini manuel olarak indirmeniz ve eski DLL dosyalarını projenizde yenileri ile değiştirmeniz gerekecektir.

ZIP Arşivini Kullanmanın Artıları

• Tam Kontrol:

  • DLL’lerin nerede ve nasıl saklandığı ve referans verildiği üzerinde tam kontrolünüz vardır. Bu, özel bir kurulum tercih ettiğinizde veya bağımlılıkları manuel olarak yönetmeniz gerektiğinde faydalı olabilir.

• Paket Yöneticilerine Bağımlılık Yok:

  • NuGet’in aksine, kurulumları yönetmek için bir paket yöneticisine güvenmiyorsunuz. Bu, paket yöneticilerinin mevcut olmadığı veya tercih edilmediği ortamlarda avantajlı olabilir.

• Taşınabilirlik:

  • ZIP arşivi kolayca paylaşılabilir ve farklı sistemler arasında taşınabilir, bu da onu dış araçlara güvenmeden taşınabilir veya dağıtılması gereken projeler için ideal hale getirir.

ZIP Arşivini Kullanmanın Eksileri

• Manuel Yönetim:

  • Güncellemelerin ve bağımlılık yönetiminin otomatikleştirildiği NuGet’in aksine, ZIP arşivinde güncellemeleri manuel olarak yönetmeli ve gereken tüm DLL’lerin doğru bir şekilde referans verildiğinden emin olmalısınız.

• Sürüm Çatışması Riski:

  • Birden fazla projeyi yönetiyorsanız veya bir ekipte çalışırken, farklı projelerin farklı DLL sürümlerini kullanması durumunda sürüm çatışması riski vardır. Bu, projeler arasında sürümleri dikkatlice takip etmeyi gerektirir.

• Otomatik Güncelleme Yok:

  • Yeni bir sürüm mevcut olduğunda otomatik güncellemeler veya bildirimler almazsınız. Bu, düzenli olarak güncellemeleri kontrol etmezseniz eski kütüphanelerin kullanılma riskiyle sonuçlanabilir.

Windows Dışı Ortam

Windows Dışı Ortamda .NET Core DLL’leriyle Çalışmak

Documentize for .NET, .NET Standard 2.0 (.NET Core 2.0) desteği sağladığı için, Linux benzeri işletim sistemlerinde çalışan Core Uygulamalarında kullanılabilir. API’mizde .NET Core desteğini geliştirmek için sürekli çalışıyoruz. Ancak, Documentize for .NET özelliklerini kullanırken daha iyi sonuçlar elde etmek için müşterilerimizin gerçekleştirmelerini önerdiğimiz bazı işlemler vardır. Lütfen şu paketleri yükleyin:

• libgdiplus paketi
• Microsoft uyumlu yazı tipleri içeren paket: ttf-mscorefonts-installer (örneğin, sudo apt-get install ttf-mscorefonts-installer). Bu yazı tipleri, Documentize for .NET’in Linux benzeri işletim sistemlerinde bu klasörü taradığı için /usr/share/fonts/truetype/msttcorefonts dizinine yerleştirilmelidir. İşletim sistemi, yazı tipleri için başka bir varsayılan klasör/dizine sahipse, Documentize kullanmadan önce herhangi bir işlem yapmadan önce aşağıdaki kod satırını kullanmalısınız:

  Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<kullanıcının ms yazı tiplerine giden yolu>"));

v24.12

Yeni Eklenti Eklendi: PDF’den PNG Dönüştürücü

• Class PngConverter: Documentize.PngConverter eklentisini temsil eder. PDF belgelerini PNG formatına dönüştürmek için kullanılır.
• Class PdfToPngOptions: Documentize.PngConverter eklentisi için PDF’den PNG’ye dönüştürücü seçeneklerini temsil eder.

Örnek Kullanım:

// PngConverter oluştur
var plugin = new PngConverter();
// Talimatları ayarlamak için PdfToPngOptions nesnesi oluştur
var opt = new PdfToPngOptions();
// girdi dosyası yolunu ekle
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// çıktı dosyası yolunu ayarla
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// işlemi gerçekleştir
plugin.Process(opt);

Yeni Eklenti Eklendi: PDF’den TIFF Dönüştürücü

• Class TiffConverter: Documentize.TiffConverter eklentisini temsil eder. PDF belgelerini TIFF formatına dönüştürmek için kullanılır.
• Class PdfToTiffOptions: Documentize.TiffConverter eklentisi için PDF’den TIFF’ye dönüştürücü seçeneklerini temsil eder.

Örnek Kullanım:

// TiffConverter oluştur
var plugin = new TiffConverter();
// Talimatları ayarlamak için PdfToTiffOptions nesnesi oluştur
var opt = new PdfToTiffOptions();
// girdi dosyası yolunu ekle
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// çıktı dosyası yolunu ayarla
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// işlemi gerçekleştir
plugin.Process(opt);

Yeni Eklenti Eklendi: PDF Tablo Oluşturucu

• Class TableGenerator: Documentize.TableGenerator eklentisini temsil eder. Bir PDF belgesine tablo eklemek için kullanılır.
• Class TableBuilder: PDF sayfasındaki tabloyu oluşturmak için sınıfı temsil eder.
• Class TableRowBuilder: Tablo satırını oluşturmak için sınıfı temsil eder.
• Class TableCellBuilder: Tablo hücresini oluşturmak için sınıfı temsil eder.

Örnek Kullanım:

// TableGenerator oluştur
var plugin = new TableGenerator();
// Talimatları ayarlamak için TableOptions nesnesi oluştur
TableOptions opt = new TableOptions().InsertPageBefore(1)
   .AddTable()
        .AddRow()
            .AddCell().AddParagraph("İsim")
            .AddCell().AddParagraph("Yaş")
        .AddRow()
            .AddCell().AddParagraph("Bob")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("Sam")
            .AddCell().AddParagraph("20")
        .AddRow()
            .AddCell().AddParagraph("Sandy")
            .AddCell().AddParagraph("26")
        .AddRow()
            .AddCell().AddParagraph("Tom")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("Jim")
            .AddCell().AddParagraph("27");
// girdi dosyası yolunu ekle
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// çıktı dosyası yolunu ayarla
opt.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));
// işlemi gerçekleştir
plugin.Process(opt);

Sınıf PdfDoc ‘un Adı DocConverter Olarak Değiştirildi

• Class DocConverter: Documentize.DocConverter eklentisini temsil eder. PDF belgelerini DOC/DOCX formatına dönüştürmek için kullanılır.

Örnek Kullanım:

// DocConverter oluştur
var plugin = new DocConverter();
// Talimatları ayarlamak için PdfToDocOptions nesnesi oluştur
var opt = new PdfToDocOptions();
// girdi dosyası yolunu ekle
opt.AddInput(new FileDataSource(inputPath));
// çıktı dosyası yolunu ayarla
opt.AddOutput(new FileDataSource(outputPath));
// işlemi gerçekleştir
plugin.Process(opt);

v24.11

Yeni Eklenti Eklendi: PDF’den JPEG’e Dönüştürücü

• Amacı: JpegConverter sınıfı, PDF belgelerini JPEG formatına dönüştürmek üzere tasarlanmıştır, bu sayede kullanıcıların PDF’lerden türetilen görüntüleri yönetmesi ve paylaşması daha kolay hale gelir.
• Yapıcı:
  • JpegConverter(): JPEG dönüştürücünün yeni bir örneğini başlatır.

Örnek Kullanım:

var plugin = new JpegConverter();
var opt = new PdfToJpegOptions();
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
plugin.Process(opt);

• Metot:
  • Process(PdfToJpegOptions options): Belirtilen seçenekleri kullanarak JPEG dönüştürme işlemini başlatır.

DirectoryDataSource Sınıfı Eklendi

• Amacı: DirectoryDataSource sınıfı, kullanıcıların eklentiler içinde yükleme ve kaydetme işlemleri için dizin verilerini yönetmelerine olanak tanır.
• Yapıcı:
  • DirectoryDataSource(string path): Belirtilen yol ile yeni bir dizin veri nesnesi başlatır.

Örnek Kullanım:

var directorySource = new DirectoryDataSource("path_to_your_directory");

• Özellikler:
  • DataType: Veri kaynağının türünü alır.
  • Path: Mevcut veri dizininin yolunu alır.

PdfToJpegOptions Sınıfı Eklendi

• Amacı: Bu sınıf, JPEG dönüştürme işlemini yapılandırmak için seçenekler içerir ve kullanıcılara çözünürlük, sayfa listeleri ve görüntü kalitesi belirtme olanağı tanır.
• Yapıcı:
  • PdfToJpegOptions(): JPEG dönüştürücü için yeni bir seçenek örneğini başlatır.

Özellikler:

• OutputResolution: Ortaya çıkan JPEG görüntülerinin çözünürlüğünü belirtir.
• PageList: PDF’den dönüştürülecek sayfaların listesi.
• Quality: JPEG çıktısının kalitesini ayarlar.

v24.10

Yeni Eklenti Eklendi: PDF/A Dönüştürücü

• Kullanıcıların standart PDF dosyalarını PDF/A uyumlu belgelere kolayca dönüştürmelerini sağlayan yeni bir PDF/A dönüştürme özelliği tanıtıldı.

Örnek Kullanım:

var options = new PdfAConvertOptions
{
    PdfAVersion = PdfAStandardVersion.PDF_A_3B
};

options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
options.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));

var plugin = new PdfAConverter();
plugin.Process(options);

Hata Düzeltmeleri

• Yanlış çıktı yollarına neden olan FileResult sınıfıyla ilgili sorunlar düzeltildi.
• Büyük dosyalarla çalışırken HtmlConverter üzerinde etkili olan küçük hatalar çözüldü.

Geliştirmeler

• Daha hızlı işlem süreleri için PdfExtractor ve ImageExtractor performansı artırıldı.
• Ek döndürme açılarını desteklemek için RotateOptions sınıfı güncellendi.

v24.9

Yayınlandı