Instalace Documentize přes NuGet

Jak nainstalovat přes konzoli správce balíčků NuGet

1. Otevřete svůj projekt:

   • Spusťte Visual Studio a otevřete svou .NET aplikaci.

2. Získejte přístup k konzoli správce balíčků:

   • Přejděte na Nástroje > Správce balíčků NuGet > Konzole správce balíčků.

3. Nainstalujte balík:

   • Pro instalaci nejnovější plné verze zadejte příkaz Install-Package Documentize.
   • Pro instalaci nejnovější verze včetně oprav chyb použijte Install-Package Documentize -prerelease.
   • Stiskněte Enter pro provedení příkazu.

Jak aktualizovat balík přes konzoli správce balíčků NuGet

Pokud jste již nainstalovali Documentize přes NuGet a chcete aktualizovat na nejnovější verzi:

1. Otevřete svůj projekt:

   • Spusťte Visual Studio a otevřete svou .NET aplikaci.

2. Získejte přístup k konzoli správce balíčků:

   • Přejděte na Nástroje > Správce balíčků NuGet > Konzole správce balíčků.

3. Aktualizujte balík:

   • Pro aktualizaci na nejnovější plnou verzi zadejte Update-Package Documentize.
   • Pro aktualizaci na nejnovější verzi včetně oprav chyb použijte Update-Package Documentize -prerelease.
   • Stiskněte Enter pro provedení příkazu.

Jak nainstalovat přes grafické rozhraní správce balíčků NuGet

1. Otevřete svůj projekt:

   • Spusťte Visual Studio a otevřete svou .NET aplikaci.

2. Přejděte na správu balíčků NuGet:

   • Z nabídky Projekt vyberte Spravovat balíčky NuGet.

3. Hledejte Documentize:

   • Přejděte na kartu Procházet a zadejte Documentize do vyhledávacího pole.

4. Nainstalujte balík:

   • Klikněte na Nainstalovat/Aktualizovat vedle nejnovější verze Documentize.
   • Potvrďte kliknutím na Přijmout v pop-up okně.

Výhody používání NuGet

• Automatická správa závislostí:

  • NuGet automaticky zpracovává závislosti, zajišťuje, že všechny potřebné knihovny jsou zahrnuty a správně aktualizovány. To snižuje riziko chybějících nebo nekompatibilních závislostí.

• Zjednodušené aktualizace:

  • Aktualizace balíků je s NuGet jednoduchá, buď přes konzoli správce balíčků, nebo grafické rozhraní. To usnadňuje udržování vašich knihoven aktuálních s nejnovějšími funkcemi a opravami chyb.

• Integrace s Visual Studio:

  • NuGet je bezproblémově integrován s Visual Studio, což poskytuje uživatelsky přívětivé rozhraní pro správu balíčků bez opuštění vývojového prostředí.

• Verzování:

  • NuGet vám umožňuje specifikovat a spravovat různé verze knihoven, což vám umožňuje snadno se vrátit k předchozím verzím nebo testovat nové verze bez narušení vašeho vývoje.

Nevýhody používání NuGet

• Omezeno na Visual Studio:

  • NuGet je primárně navržen pro použití v rámci Visual Studio. Ačkoliv může být použit v jiných prostředích, integrace je nejrobustnější ve Visual Studio.

• Potenciál pro konflikty verzí:

  • Větší projekty s mnoha závislostmi mohou mít problémy s řízením verzí a řešením konfliktů. NuGet poskytuje nástroje pro správu tohoto, ale vyžaduje pečlivou pozornost.

• Závislost na síti:

  • Instalace a aktualizace balíků vyžaduje internetové připojení. Pokud pracujete v prostředí s omezeným nebo žádným přístupem k internetu, může být nutné použít offline metody nebo předem stáhnout balíky.

• Složitost pro velké projekty:

  • Pro velmi velké projekty s rozsáhlými stromy závislostí může být správa balíků prostřednictvím NuGet obtížná. V takových případech může být potřeba dalších nástrojů nebo strategií pro účinnou správu závislostí.

Instalace Documentize pomocí MSI

Jak nainstalovat pomocí MSI instalátoru

1. Stáhněte MSI instalátor:

   • Klikněte na v24.12 MSI pro stažení MSI instalátoru pro poslední verzi Documentize.

2. Spusťte instalátor:

   • Dvakrát klikněte na stažený MSI soubor pro spuštění instalačního průvodce.

3. Postupujte podle instalačního průvodce:

   • Postupujte podle pokynů na obrazovce, které poskytuje instalátor. Můžete být požádáni, abyste souhlasili s licenční smlouvou a vybrali možnosti instalace.

4. Dokončete instalaci:

   • Jakmile je instalace dokončena, DLL knihovny Documentize budou nainstalovány do globálního vyrovnávacího prostoru Assembly Cache (GAC) nebo do jiného určeného umístění.

5. Ověřte instalaci:

   • Zkontrolujte, že jsou DLL knihovny správně nainstalovány ověřením jejich přítomnosti ve vyhrazeném instalačním adresáři nebo GAC.

Výhody použití MSI instalátoru

• Jednoduchost použití:

  • MSI instalátor poskytuje jednoduchý a vedený proces instalace. Zvládá všechny potřebné konfigurace a umisťuje DLL knihovny na centrální místo, což usnadňuje použití Documentize napříč více projekty.

• Instalace systémově:

  • MSI metoda instaluje Documentize do globálního vyrovnávacího prostoru Assembly Cache (GAC) nebo na jiné centrální místo. To umožňuje jakékoli aplikaci v systému přistupovat k DLL knihovnám, aniž by je bylo potřeba jednotlivě specifikovat v každém projektu.

• Automatizované aktualizace:

  • Pokud Documentize poskytuje aktualizovaný instalátor, můžete snadno aktualizovat svou instalaci spuštěním nového MSI souboru, což obvykle zajišťuje plynulý proces aktualizace.

• Konzistence:

  • Použití MSI instalátoru zajišťuje, že všechny potřebné soubory jsou nainstalovány správně a konzistentně napříč různými prostředími, čímž se snižuje riziko chybějících nebo nesprávně umístěných DLL knihoven.

Nevýhody použití MSI instalátoru

• Omezená flexibilita:

  • MSI instalátor instaluje Documentize na systémově centrální místo, což nemusí být vhodné pro všechny vývojové prostředí. Může postrádat flexibilitu pro přizpůsobení specifickým konfiguracím nebo verzím projektu.

• Potenciální režie:

  • Instalace DLL knihoven do GAC může zavést režii a složitost, zejména v scénářích, kdy může být potřeba mít současně více verzí Documentize.

• Manuální odstranění:

  • Pokud potřebujete odinstalovat Documentize, musíte použít odinstalátor poskytovaný MSI, což může zanechat zbylé soubory nebo konfigurace, pokud není správně spravováno.

• Konflikty verzí:

  • Systémové instalace mohou vést ke konfliktům verzí, pokud různé projekty vyžadují různé verze Documentize. Správa těchto konfliktů může vyžadovat dodatečné konfigurace nebo úklid.

Instalace Documentize pomocí ZIP

Jak nainstalovat pomocí ZIP archivu

1. Stáhněte ZIP archiv:

   • Klikněte na v24.12 ZIP pro stažení nejnovější verze Documentize ve formátu archivu.

2. Extrahujte obsah:

   • Po stažení extrahujte obsah ZIP souboru do vybraného adresáře. Můžete si vybrat, zda tyto soubory uchováte ve sdíleném adresáři, nebo v rámci struktury vašeho projektu.

3. Přidejte odkazy do vašeho projektu:

   • Otevřete svůj projekt ve svém IDE (např. Visual Studio).
   • Přejděte na Projekt > Přidat odkaz > Procházet a přejděte do adresáře, kde jste extrahovali DLL soubory.
   • Vyberte relevantní DLL soubory a přidejte je jako odkazy do vašeho projektu.

4. Manuální aktualizace:

   • Pokud bude vydána nová verze Documentize, budete muset manuálně stáhnout aktualizovaný ZIP archiv a nahradit staré DLL soubory ve vašem projektu novými.

Výhody používání ZIP archivu

• Úplná kontrola:

  • Máte plnou kontrolu nad tím, kde a jak jsou DLL soubory uloženy a odkazovány ve vašem projektu. To může být výhodné, pokud preferujete vlastní nastavení nebo potřebujete spravovat závislosti manuálně.

• Žádná závislost na správcích balíčků:

  • Na rozdíl od NuGet se nespolehnete na správce balíčků pro provádění instalací. To může být výhodné v prostředích, kde správci balíčků nejsou k dispozici nebo preferováni.

• Přenositelnost:

  • ZIP archiv lze snadno sdílet a přesouvat mezi různými systémy, což ho činí ideálním pro projekty, které potřebují být přenosné nebo distribuovány bez spolehnutí na externí nástroje.

Nevýhody používání ZIP archivu

• Manuální správa:

  • Na rozdíl od NuGet, kde jsou aktualizace a správa závislostí automatizovány, s ZIP archivem musíte manuálně spravovat aktualizace a zajistit, že všechny potřebné DLL soubory jsou správně odkazovány.

• Riziko konfliktů verzí:

  • Pokud spravujete více projektů nebo pracujete v týmu, existuje riziko konfliktů verzí, pokud různé projekty používají různé verze DLL souborů. To vyžaduje pečlivé sledování verzí napříč projekty.

• Žádné automatické aktualizace:

  • Nebudete dostávat automatické aktualizace nebo oznámení, když bude k dispozici nová verze. To může vést k riziku používání zastaralých knihoven, pokud pravidelně nekontrolujete aktualizace.

Nenárodní prostředí

Práce s .NET Core DLL v nenárodním prostředí

Jelikož Documentize pro .NET poskytuje podporu pro .NET Standard 2.0 (.NET Core 2.0), může být použit v Core aplikacích běžících v operačních systémech podobných Linuxu. Neustále pracujeme na zlepšení podpory .NET Core v našem API. Existují však některé operace, které doporučujeme našim zákazníkům provádět, aby dosáhli lepších výsledků při používání funkcí Documentize pro .NET. Nainstalujte prosím:

• balíček libgdiplus
• Balíček s písmem kompatibilním s Microsoftem: ttf-mscorefonts-installer (např. sudo apt-get install ttf-mscorefonts-installer). Tato písma by měla být umístěna v adresáři /usr/share/fonts/truetype/msttcorefonts, protože Documentize pro .NET skenuje tuto složku v operačních systémech podobných Linuxu. V případě, že má operační systém jinou výchozí složku/adresář pro písma, měli byste použít následující řádek kódu před provedením jakékoli operace pomocí Documentize:

  Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<cesta uživatele k ms písmům>"));

v24.12

Přidán nový plugin: PDF na PNG převodník

• Třída PngConverter: Reprezentuje plugin Documentize.PngConverter. Používá se k převodu PDF dokumentů do formátu PNG.
• Třída PdfToPngOptions: Reprezentuje možnosti převodu PDF na PNG pro plugin Documentize.PngConverter.

Příklad použití:

// vytvořit PngConverter
var plugin = new PngConverter();
// vytvořit objekt PdfToPngOptions pro nastavení pokynů
var opt = new PdfToPngOptions();
// přidat cestu k vstupnímu souboru
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// nastavit cestu k výstupnímu souboru
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// provést proces
plugin.Process(opt);

Přidán nový plugin: PDF na TIFF převodník

• Třída TiffConverter: Reprezentuje plugin Documentize.TiffConverter. Používá se k převodu PDF dokumentů do formátu TIFF.
• Třída PdfToTiffOptions: Reprezentuje možnosti převodu PDF na TIFF pro plugin Documentize.TiffConverter.

Příklad použití:

// vytvořit TiffConverter
var plugin = new TiffConverter();
// vytvořit objekt PdfToTiffOptions pro nastavení pokynů
var opt = new PdfToTiffOptions();
// přidat cestu k vstupnímu souboru
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// nastavit cestu k výstupnímu souboru
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// provést proces
plugin.Process(opt);

Přidán nový plugin: Generátor PDF tabulek

• Třída TableGenerator: Reprezentuje plugin Documentize.TableGenerator. Používá se k přidání tabulky do PDF dokumentu.
• Třída TableBuilder: Třída reprezentuje stavitele pro tabulku na pdf stránce.
• Třída TableRowBuilder: Třída reprezentuje stavitele pro řádek tabulky.
• Třída TableCellBuilder: Třída reprezentuje stavitele pro buňku tabulky.

Příklad použití:

// vytvořit TableGenerator
var plugin = new TableGenerator();
// vytvořit objekt TableOptions pro nastavení pokynů
TableOptions opt = new TableOptions().InsertPageBefore(1)
   .AddTable()
        .AddRow()
            .AddCell().AddParagraph("Jméno")
            .AddCell().AddParagraph("Věk")
        .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");
// přidat cestu k vstupnímu souboru
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// nastavit cestu k výstupnímu souboru
opt.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));
// provést proces
plugin.Process(opt);

Přejmenována třída PdfDoc na DocConverter

• Třída DocConverter: Reprezentuje plugin Documentize.DocConverter. Používá se k převodu PDF dokumentů do formátu DOC/DOCX.

Příklad použití:

// vytvořit DocConverter
var plugin = new DocConverter();
// vytvořit objekt PdfToDocOptions pro nastavení pokynů
var opt = new PdfToDocOptions();
// přidat cestu k vstupnímu souboru
opt.AddInput(new FileDataSource(inputPath));
// nastavit cestu k výstupnímu souboru
opt.AddOutput(new FileDataSource(outputPath));
// provést proces
plugin.Process(opt);

v24.11

Přidán nový plugin: PDF do JPEG konvertor

• Účel: Třída JpegConverter je navržena pro převod PDF dokumentů do formátu JPEG, což usnadňuje uživatelům zpracování a sdílení obrázků odvozených z PDF.
• Konstruktor:
  • JpegConverter(): Inicializuje novou instanci JPEG konvertoru.

Příklad použití:

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);

• Metoda:
  • Process(PdfToJpegOptions options): Zahájí proces převodu do JPEG s použitím zadaných možností.

Přidána třída DirectoryDataSource

• Účel: Třída DirectoryDataSource umožňuje uživatelům spravovat data adresáře pro operace načítání a ukládání v rámci pluginů.
• Konstruktor:
  • DirectoryDataSource(string path): Inicializuje nový objekt dat adresáře se zadanou cestou.

Příklad použití:

var directorySource = new DirectoryDataSource("path_to_your_directory");

• Vlastnosti:
  • DataType: Vrací typ datového zdroje.
  • Path: Získává cestu k aktuálnímu datovému adresáři.

Přidána třída PdfToJpegOptions

• Účel: Tato třída obsahuje možnosti pro konfiguraci procesu převodu do JPEG, což uživatelům umožňuje specifikovat rozlišení, seznamy stránek a kvalitu obrázku.
• Konstruktor:
  • PdfToJpegOptions(): Inicializuje novou instanci možností pro JPEG konvertor.

Vlastnosti:

• OutputResolution: Specifikuje rozlišení výsledných JPEG obrázků.
• PageList: Seznam stránek k převodu z PDF.
• Quality: Nastavuje kvalitu JPEG výstupu.

v24.10

Přidán nový plugin: PDF/A Converter

• Byla zavedena nová funkce pro konverzi PDF/A, která umožňuje uživatelům snadno převádět standardní PDF soubory na dokumenty vyhovující PDF/A.

Příklad použití:

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);

Opravy chyb

• Opraveny problémy související s třídou FileResult, které měly za následek nesprávné výstupní cesty.
• Vyřešeny drobné chyby ovlivňující HtmlConverter při zpracování velkých souborů.

Vylepšení

• Zlepšena výkonnost PdfExtractor a ImageExtractor pro rychlejší časy zpracování.
• Aktualizována třída RotateOptions pro podporu dalších rotačních úhlů.

v24.9

Vydáno