Ovládání substituce fontů pomocí GroupDocs.Conversion pro Java

V tomto komplexním tutoriálu se dozvíte jak převést poznámku do pdf pomocí GroupDocs.Conversion pro Java a zároveň elegantně řešit chybějící fonty. Provedeme vás nastavením Maven, konfigurací substituce fontů a strategií záložního řešení, aby vaše PDF vypadala na každém operačním systému identicky. Na konci budete schopni vložit tento konverzní tok do jakékoli Java služby nebo dávkového úkolu.

Rychlé odpovědi

  • Jaký je hlavní účel substituce fontů? Nahrazuje nedostupné fonty těmi, které určíte, a zachovává vzhled dokumentu konzistentní.
  • Která knihovna provádí konverzi? GroupDocs.Conversion for Java.
  • Potřebuji licenci pro produkci? Ano – je vyžadována plná licence nebo dočasná licence.
  • Mohu nastavit výchozí font pro neznámé případy? Ano, pomocí setDefaultFont() v NoteLoadOptions.
  • Je to kompatibilní s JDK 8 a vyššími? Ano, knihovna podporuje Java 8+.

Co je „convert note to pdf“?

convert note to pdf je proces převodu souborových formátů pro poznámky (např. .ONE, .ENEX) do PDF, které lze otevřít na jakémkoli zařízení bez speciálního softwaru. Tato konverze často narazí na problémy s chybějícími fonty, protože zdrojová poznámka může odkazovat na fonty, které nejsou nainstalovány na cílovém počítači. Substituce fontů to řeší mapováním chybějících fontů na dostupné, čímž zaručuje vizuální věrnost.

Proč používat GroupDocs.Conversion pro Java?

GroupDocs.Conversion pro Java poskytuje automatické zpracování fontů pro více než 50 + vstupních a výstupních formátů a dokáže zpracovat dokumenty s několika stovkami stránek, aniž by načítala celý soubor do paměti. Knihovna poskytuje PDF výstup s vysokou věrností, spotřebuje méně než 150 MB haldy pro 300‑stránkovou poznámku a integruje se pomocí jediné Maven závislosti, což z ní činí připravenou volbu pro produkci pro Java vývojáře.

Předpoklady

  • Java Development Kit (JDK) verze 8 nebo vyšší.
  • IDE, jako je IntelliJ IDEA nebo Eclipse.
  • Maven nainstalovaný pro správu závislostí.
  • Základní znalost Javy a konceptů konverze dokumentů.

Nastavení GroupDocs.Conversion pro Java

Přidejte repozitář GroupDocs a závislost do vašeho pom.xml:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/conversion/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-conversion</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

Získání licence

GroupDocs nabízí bezplatnou 30‑denní zkušební verzi a dočasné licence pro testování, nebo si můžete zakoupit plnou licenci pro produkční použití.

  1. Bezplatná zkušební verze: Stáhněte z zde.
  2. Dočasná licence: Požádejte o ni na tomto odkazu.
  3. Nákup: Pro dlouhodobá řešení zakupte licenci zde.

Jak substituovat fonty během convert note to pdf

Pro substituci fontů během konverze musíte vytvořit a nakonfigurovat možnosti načítání, které mapují chybějící fonty na dostupné náhrady a specifikovat záložní font. To zajišťuje, že každý znak bude vykreslen správně i když původní font v systému není přítomen.

Krok 1: Konfigurace substituce fontů

NoteLoadOptions konfiguruje, jak je načítán soubor s poznámkou, včetně nastavení substituce fontů. Vytvořte objekt NoteLoadOptions, definujte páry fontů, které chcete nahradit, a nastavte záložní font pro všechny neodpovídající případy:

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.NoteLoadOptions;
import com.groupdocs.conversion.contracts.FontSubstitute;

// Create font substitution options
NoteLoadOptions loadOptions = new NoteLoadOptions();
List<FontSubstitute> fontSubstitutes = new ArrayList<>();
fontSubstitutes.add(FontSubstitute.create("Tahoma", "Arial")); // Substitute Tahoma with Arial
fontSubstitutes.add(FontSubstitute.create("Times New Roman", "Arial")); // Substitute Times New Roman with Arial
loadOptions.setFontSubstitutes(fontSubstitutes);

// Set the default font for unhandled substitutions
defaultFont = "YOUR_DOCUMENT_DIRECTORY/terminal-grotesque_open.otf";
  • NoteLoadOptions – Třída NoteLoadOptions je vstupním bodem pro konfiguraci načítání souborů s poznámkami, včetně nastavení substituce fontů.
  • FontSubstitute.create() – FontSubstitute.create() vytváří mapování, které konvertoru říká, který náhradní font použít, když původní font chybí.
  • setDefaultFont() – setDefaultFont() definuje záložní font, který engine použije, když neexistuje explicitní mapování, čímž zajišťuje, že žádné znaky nebudou nezobrazeny.

Krok 2: Převod dokumentu do PDF

Converter je hlavní komponenta, která provádí konverzi pomocí poskytnutých možností načítání. Předávejte nakonfigurované možnosti načítání do Converter a spusťte konverzi:

// Initialize Converter with specified load options
converter = new Converter("YOUR_DOCUMENT_DIRECTORY/sample_note_document", () -> loadOptions);

// Set PDF conversion options
pdfOptions = new PdfConvertOptions();

// Perform conversion
coder.convert("YOUR_OUTPUT_DIRECTORY/converted_note.pdf", pdfOptions);
  • Converter – Třída Converter je hlavní komponenta GroupDocs, která načte zdrojový soubor pomocí dodaných možností a připraví jej ke konverzi.
  • convert() – Metoda convert() zapíše PDF soubor do cílového umístění a použije všechna pravidla substituce fontů, která jste definovali.

Převod dokumentu s poznámkou do PDF (bez vlastních fontů)

Pokud jednoduše potřebujete java document to pdf bez vlastních substitucí, kroky jsou ještě kratší:

// Initialize Converter for a given document
converter = new Converter("YOUR_DOCUMENT_DIRECTORY/sample_note_document");

pdfOptions = new PdfConvertOptions(); // Configure conversion options
converter.convert("YOUR_OUTPUT_DIRECTORY/converted_note.pdf", pdfOptions);

Praktické aplikace

  1. Sdílení dokumentů – Odesílejte PDF, které vypadají identicky na Windows, macOS nebo Linuxu.
  2. Archivace – Zachovejte vizuální věrnost starých souborů s poznámkami pro soulad s předpisy.
  3. Cross‑platformová kompatibilita – Zajistěte, aby každý stakeholder viděl stejné fonty, bez ohledu na nainstalované typy písma.

Možnosti integrace

Můžete vložit tento konverzní tok do podnikového systému správy obsahu, mikro‑služby zpracovávající nahrávání nebo dávkového úkolu, který migruje staré archivy poznámek do PDF.

Úvahy o výkonu

  • Správa paměti – Streamujte velké soubory místo jejich úplného načtení do paměti.
  • Cache – Ukládejte často používané soubory fontů do cache, aby se předešlo opakovanému I/O na disku.
  • Best practices v Javě – Laděte garbage collector a pokud možno znovu používejte instance Converter.

Časté problémy a řešení

ProblémPravděpodobná příčinaŘešení
Chybějící font po konverziŽádná definovaná substituce pro fontPřidejte položku FontSubstitute nebo nastavte vhodný výchozí font.
NullPointerException na loadOptionsloadOptions nebyl předán do ConverterUjistěte se, že při vytváření Converter používáte lambda () -> loadOptions.
Pomalá konverze velkých souborůNačítání celého dokumentu do pamětiPoužijte streaming API nebo vhodně zvětšete velikost haldy JVM.

Často kladené otázky

Q: Mohu substituovat více fontů najednou?
A: Ano, přidejte více položek FontSubstitute do seznamu fontSubstitutes.

Q: Co se stane, pokud výchozí font není nalezen?
A: Konverze se vrátí k výchozímu fontu systému, který se může mezi platformami lišit.

Q: Jak řešit chyby konverze?
A: Ověřte cesty k souborům, zajistěte, že jsou všechny Maven závislosti vyřešeny, a zkontrolujte konzoli pro stack trace.

Q: Je GroupDocs.Conversion kompatibilní se všemi verzemi Javy?
A: Podporuje JDK 8 a vyšší.

Q: Lze substituci fontů použít i s jinými formáty, jako je Word nebo Excel?
A: Rozhodně – stejný mechanismus FontSubstitute funguje pro mnoho typů dokumentů, včetně DOCX a XLSX.

Zdroje

Poslední aktualizace: 2026-07-29
Testováno s: GroupDocs.Conversion 25.2 for Java
Autor: GroupDocs

Související tutoriály