Mistrovství substituce fontů s GroupDocs.Conversion pro Java

Převod note dokumentů do PDF při zachování konzistentní typografie může být náročný. V tomto průvodci se naučíte jak převést note do pdf pomocí GroupDocs.Conversion pro Java, nahradit chybějící fonty a nastavit výchozí náhradní font, aby váš výstup vypadal stejně na každém zařízení.

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í převod? 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“ označuje převod formátů souborů pro poznámky (jako .ONE, .ENEX atd.) do univerzálně zobrazitelného formátu PDF. Tento proces často narazí na problémy s chybějícími fonty, proto je substituce fontů nezbytná.

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

Bezproblémové zpracování fontů – automaticky nahrazuje chybějící fonty.
Vysoce věrný výstup PDF – zachovává rozvržení, obrázky a stylování.
Jednoduchá integrace – nastavení založené na Maven se hodí do jakéhokoli Java projektu.
Optimalizováno pro výkon – efektivní využití paměti pro velké dokumenty.

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ů převodu dokumentů.

Nastavení GroupDocs.Conversion pro Java

Add the GroupDocs repository and dependency to your 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 zkušební verzi a dočasné licence pro testování, nebo si můžete zakoupit plnou licenci pro produkční použití.

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

Jak nahradit fonty během convert note to pdf

Krok 1: Konfigurace substituce fontů

Create a NoteLoadOptions object, define the font pairs you want to replace, and set a fallback font for any unmatched cases:

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 – konfiguruje možnosti načtení specifické pro note dokumenty.
FontSubstitute.create() – mapuje chybějící font na náhradu.
setDefaultFont() – definuje náhradní font, když neexistuje explicitní substituce.

Krok 2: Převod dokumentu do PDF

Pass the configured load options to the Converter and execute the conversion:

// 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 – načte zdrojový soubor pomocí poskytnutých možností.
convert() – zapíše PDF soubor do cílové lokace.

Převod Note dokumentu do PDF (bez vlastních fontů)

Pokud potřebujete jen 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

Sdílení dokumentů – Odesílejte PDF, které vypadají identicky na Windows, macOS nebo Linuxu.
Archivace – Zachová vizuální věrnost starých note souborů pro soulad s předpisy.
Kompatibilita napříč platformami – Zajistěte, že každý uživatel vidí stejné fonty, bez ohledu na nainstalované typy písma.

Možnosti integrace

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

Úvahy o výkonu

Správa paměti – Streamujte velké soubory místo jejich kompletní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.
Nejlepší praktiky v Javě – Ladte garbage collector a pokud možno znovu používejte instance Converter.

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

Problém	Pravděpodobná příčina	Řešení
Chybějící font po převodu	Žádná substituce definovaná pro font	Přidejte položku `FontSubstitute` nebo nastavte správný výchozí font.
`NullPointerException` na `loadOptions`	`loadOptions` nebyl předán do `Converter`	Ujistěte se, že při vytváření `Converter` používáte lambda `() -> loadOptions`.
Pomalý převod velkých souborů	Načítání celého dokumentu do paměti	Použijte streaming API nebo vhodně zvýšte velikost haldy JVM.

Často kladené otázky

Q: Mohu nahradit 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: Převod se vrátí k výchozímu fontu systému, který se může lišit napříč platformami.

Q: Jak odladit chyby při převodu?
A: Ověřte cesty k souborům, ujistěte se, ž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ů.

Zdroje

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