Maîtriser la substitution de polices avec GroupDocs.Conversion pour Java

Convertir des documents note en PDF tout en conservant une typographie cohérente peut être difficile. Dans ce guide, vous apprendrez comment convertir note en pdf en utilisant GroupDocs.Conversion pour Java, remplacer les polices manquantes et configurer une police de secours par défaut afin que votre sortie ait le même aspect sur chaque appareil.

Quick Answers

Quel est le but principal de la substitution de polices ? Elle remplace les polices indisponibles par celles que vous spécifiez, en conservant l’apparence du document cohérente.
Quelle bibliothèque gère la conversion ? GroupDocs.Conversion for Java.
Ai-je besoin d’une licence pour la production ? Oui – une licence complète ou temporaire est requise.
Puis-je définir une police par défaut pour les cas inconnus ? Absolument, en utilisant setDefaultFont() dans NoteLoadOptions.
Est‑ce compatible avec JDK 8 et supérieur ? Oui, la bibliothèque prend en charge Java 8+.

Qu’est‑ce que “convert note to pdf” ?

“convert note to pdf” désigne la transformation des formats de prise de notes (tels que .ONE, .ENEX, etc.) en format PDF universellement lisible. Ce processus rencontre souvent des problèmes de polices manquantes, d’où l’importance de la substitution de polices.

Why use GroupDocs.Conversion for Java?

Gestion transparente des polices – remplace automatiquement les polices manquantes.
Sortie PDF haute fidélité – préserve la mise en page, les images et le style.
Intégration facile – la configuration basée sur Maven s’intègre directement à tout projet Java.
Optimisé pour la performance – utilisation efficace de la mémoire pour les gros documents.

Prerequisites

Java Development Kit (JDK) version 8 ou supérieure.
Un IDE tel que IntelliJ IDEA ou Eclipse.
Maven installé pour la gestion des dépendances.
Connaissances de base en Java et concepts de conversion de documents.

Setting Up GroupDocs.Conversion for 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>

Acquisition de licence

GroupDocs propose un essai gratuit et des licences temporaires pour les tests, ou vous pouvez acheter une licence complète pour une utilisation en production.

Essai gratuit : Téléchargez depuis here.
Licence temporaire : Demandez‑en une via this link.
Achat : Pour des solutions à long terme, achetez une licence here.

Comment substituer les polices lors de la conversion note en pdf

Étape 1 : Configurer les substitutions de polices

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 – configure les options de chargement spécifiques aux documents note.
FontSubstitute.create() – associe une police manquante à une police de remplacement.
setDefaultFont() – définit une police de secours lorsqu’aucune substitution explicite n’existe.

Étape 2 : Convertir le document en 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 – charge le fichier source en utilisant les options fournies.
convert() – écrit le fichier PDF à l’emplacement cible.

Conversion d’un document Note en PDF (sans polices personnalisées)

Si vous avez simplement besoin de java document to pdf sans substitutions personnalisées, les étapes sont encore plus courtes :

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

Applications pratiques

Partage de documents – Envoyez des PDF qui ont le même aspect sous Windows, macOS ou Linux.
Archivage – Conservez la fidélité visuelle des fichiers note hérités pour la conformité.
Compatibilité multiplateforme – Assurez‑vous que chaque partie prenante voit les mêmes polices, quel que soit le jeu de caractères installé.

Possibilités d’intégration

Vous pouvez intégrer ce flux de conversion dans un système de gestion de contenu d’entreprise, un micro‑service qui traite les téléchargements, ou un travail batch qui migre les archives note héritées vers PDF.

Considérations de performance

Gestion de la mémoire – Diffusez les gros fichiers au lieu de les charger entièrement en mémoire.
Mise en cache – Mettez en cache les fichiers de police fréquemment utilisés pour éviter des accès disque répétés.
Bonnes pratiques Java – Ajustez le ramasse‑miettes et réutilisez les instances de Converter lorsque c’est possible.

Problèmes courants et solutions

Problème	Cause probable	Solution
Police manquante après conversion	Aucune substitution définie pour la police	Ajoutez une entrée `FontSubstitute` ou définissez une police par défaut appropriée.
`NullPointerException` sur `loadOptions`	`loadOptions` non transmis au `Converter`	Assurez‑vous d’utiliser la lambda `() -> loadOptions` lors de la construction du `Converter`.
Conversion lente pour les gros fichiers	Chargement complet du document en mémoire	Utilisez les API de streaming ou augmentez la taille du tas JVM de manière appropriée.

Questions fréquentes

Q : Puis‑je substituer plusieurs polices à la fois ?
R : Oui, ajoutez plusieurs entrées FontSubstitute à la liste fontSubstitutes.

Q : Que se passe‑t‑il si la police par défaut n’est pas trouvée ?
R : La conversion revient à la police par défaut du système, qui peut varier selon les plateformes.

Q : Comment dépanner les erreurs de conversion ?
R : Vérifiez les chemins de fichiers, assurez‑vous que toutes les dépendances Maven sont résolues, et consultez la console pour les traces de pile.

Q : GroupDocs.Conversion est‑il compatible avec toutes les versions de Java ?
R : Il prend en charge JDK 8 et supérieur.

Q : La substitution de polices peut‑elle être utilisée avec d’autres formats comme Word ou Excel ?
R : Absolument – le même mécanisme FontSubstitute fonctionne pour de nombreux types de documents.

Ressources

Dernière mise à jour : 2026-01-28
Testé avec : GroupDocs.Conversion 25.2 for Java
Auteur : GroupDocs