Fractionner un document

Splitting ou diviser un document est le processus consistant à diviser un document volumineux en un plus grand nombre de fichiers plus petits. Il existe plusieurs raisons de diviser un fichier. Par exemple, vous n’avez besoin que de quelques pages d’un document spécifique et non de la totalité. Ou, pour des raisons de confidentialité, vous souhaitez partager uniquement certaines parties d’un document avec d’autres. Avec la fonction de fractionnement, vous pouvez obtenir uniquement les parties requises du document et effectuer les actions nécessaires avec elles, par exemple annoter, enregistrer ou envoyer.

Aspose.Words vous offre un moyen efficace de diviser un document en plusieurs documents par titres ou sections. Vous pouvez également diviser un document par pages ou par plages de pages. Les deux options de fractionnement seront décrites dans cet article.

Pour diviser un document en fichiers plus petits à l’aide de Aspose.Words, vous devez suivre ces étapes:

  1. Chargez le document dans n’importe quel format pris en charge.
  2. Divisez le document.
  3. Enregistrez les documents de sortie.

Après avoir divisé un document, vous pourrez ouvrir tous les documents de sortie qui commenceront par les pages, le texte, etc. requis.

Fractionner un document en utilisant différents critères

Aspose.Words vous permet de diviser les documents EPUB ou HTML en chapitres selon divers critères. Ce faisant, le style et la mise en page du document source sont conservés pour les documents de sortie.

Vous pouvez spécifier des critères à l’aide de l’énumération DocumentSplitCriteria. Vous pouvez ainsi diviser un document en chapitres en utilisant l’un des critères suivants ou combiner plusieurs critères ensemble:

  • paragraphe de titre,
  • saut de section,
  • saut de colonne,
  • saut de page.

Lors de l’enregistrement de la sortie au format HTML, Aspose.Words enregistre chaque chapitre individuel dans un fichier HTML distinct. En conséquence, le document sera divisé en plusieurs fichiers HTML. Lors de l’enregistrement de la sortie au format EPUB, Aspose.Words enregistre le résultat dans un seul fichier EPUB, quelle que soit la valeur DocumentSplitCriteria que vous avez utilisée. Ainsi, l’utilisation de DocumentSplitCriteria pour les documents EPUB n’affecte que l’apparence de leur contenu dans les applications de lecture: le contenu sera divisé en chapitres et le document n’apparaîtra plus continu.

Dans cette section, nous considérons seulement certains des critères de répartition possibles.

Diviser un document par titres

Pour diviser un document en chapitres par titres, utilisez la valeur HeadingParagraph de la propriété DocumentSplitCriteria.

Si vous devez diviser un document par un niveau spécifique de paragraphes de titre, tels que les titres 1, 2 et 3, utilisez également la propriété DocumentSplitHeadingLevel. La sortie sera divisée en paragraphes formatés avec le niveau de titre spécifié.

L’exemple de code suivant montre comment diviser un document en parties plus petites par titre:

Veuillez noter que pour ce critère, Aspose.Words ne prend en charge que l’enregistrement au format HTML lors du fractionnement.

Lors de l’enregistrement au format EPUB, le document n’est pas divisé en plusieurs fichiers et il n’y aura qu’un seul fichier de sortie.

Diviser un document par sections

Aspose.Words vous permet également d’utiliser des sauts de section pour diviser des documents et les enregistrer au format HTML. Pour cela, utilisez SectionBreak comme DocumentSplitCriteria:

Il existe une autre façon de diviser le document source en plusieurs documents de sortie, et vous pouvez choisir n’importe quel format de sortie pris en charge par Aspose.Words.

L’exemple de code suivant montre comment diviser un document en parties plus petites par des sauts de section (sans utiliser la propriété DocumentSplitCriteria):

Divisé par pages

Vous pouvez également diviser un document page par page, par plages de pages ou en commençant par les numéros de page spécifiés. Dans ce cas, la méthode ExtractPages peut faire l’affaire.

Cette section décrit plusieurs cas d’utilisation de division de documents par pagination à l’aide de la classe Document et de la méthode ExtractPages.

Diviser un document page par page

Aspose.Words vous permet de diviser un document de plusieurs pages page par page.

L’exemple de code suivant montre comment diviser un document et enregistrer chaque page en tant que document distinct:

Diviser un document par plages de pages

Aspose.Words permet de diviser un document de plusieurs pages par plages de pages. Vous pouvez diviser un fichier en plusieurs fichiers avec différentes plages de pages ou simplement sélectionner une plage et enregistrer uniquement cette partie du document source. Notez que vous pouvez choisir la plage de pages en fonction du numéro de page maximum et minimum d’un document.

L’exemple de code suivant montre comment diviser un document en parties plus petites par plage de pages avec des index de début et de fin spécifiques:

Option de rappel pour enregistrer un document

Vous pouvez utiliser la propriété DocumentPartSavingCallback pour contrôler la manière dont Aspose.Words enregistre les parties du document lorsque ce document est exporté au format HTML. Cette propriété vous permet de renommer les fichiers de sortie ou même de les rediriger vers des flux personnalisés.

Veuillez noter que ce rappel n’est pas utile lors de l’enregistrement au format EPUB car toutes les parties de sortie doivent être enregistrées dans un seul conteneur: le fichier .epub. Ainsi, la redirection de flux n’est pas prise en charge et l’effet du changement de nom n’est pas visible puisque les fichiers sont renommés à l’intérieur du conteneur.

Fusionner le document fractionné avec un autre document

Aspose.Words vous permet de fusionner le document fractionné en sortie avec un autre document pour former un nouveau document. Cela peut être appelé fusion de documents.

L’exemple de code suivant montre comment fusionner un document fractionné avec un autre document: