Dividir um documento

Splitting ou dividir um documento é o processo de dividir um documento grande em um número maior de arquivos menores. Existem vários motivos para dividir um arquivo. Por exemplo, você só precisa de algumas páginas de um documento específico e não do documento inteiro. Ou, por motivos de privacidade, você deseja compartilhar apenas algumas partes de um documento com outras pessoas. Com o recurso de divisão, você pode obter apenas as partes necessárias do documento e realizar as ações necessárias com elas, por exemplo, marcar, salvar ou enviar.

Aspose.Words fornece uma maneira eficiente de dividir um documento em vários documentos por títulos ou seções. Você também pode dividir um documento por páginas ou intervalos de páginas. Ambas as opções de divisão serão descritas neste artigo.

Para dividir um documento em arquivos menores usando Aspose.Words, você precisa seguir estas etapas:

  1. Carregue o documento em qualquer formato compatível.
  2. Divida o documento.
  3. Salve os documentos de saída.

Depois de dividir um documento, você poderá abrir todos os documentos de saída que começarão com as páginas, texto, etc. necessários.

Dividir um documento usando diferentes critérios

Aspose.Words permite dividir documentos EPUB ou HTML em capítulos de acordo com vários critérios. No processo, o estilo e o layout do documento de origem são preservados para os documentos de saída.

Você pode especificar critérios usando a enumeração DocumentSplitCriteria. Portanto, você pode dividir um documento em capítulos usando um dos seguintes critérios ou combinar mais de um critério:

  • parágrafo de título,
  • quebra de seção,
  • quebra de coluna,
  • quebra de página.

Ao salvar a saída em HTML, o Aspose.Words salva cada capítulo individual como um arquivo HTML separado. Como resultado, o documento será dividido em vários arquivos HTML. Ao salvar a saída em EPUB, o Aspose.Words salva o resultado em um único arquivo EPUB, independentemente do valor DocumentSplitCriteria usado. Assim, usar DocumentSplitCriteria para documentos EPUB afeta apenas a aparência de seu conteúdo nos aplicativos de leitura: o conteúdo será dividido em capítulos e o documento não aparecerá mais contínuo.

Nesta seção, consideramos apenas alguns dos possíveis critérios de divisão.

Dividir um documento por títulos

Para dividir um documento em capítulos por títulos, use o valor HEADING_PARAGRAPH da propriedade document_split_criteria.

Se você precisar dividir um documento por um nível específico de parágrafos de título, como títulos 1, 2 e 3, use também a propriedade document_split_heading_level. A saída será dividida por parágrafos formatados com o nível de título especificado.

O exemplo de código a seguir mostra como dividir um documento em partes menores por título:

Observe que, para este critério, Aspose.Words só suporta salvar no formato HTML durante a divisão.

Ao salvar em EPUB, o documento não será dividido em vários arquivos e haverá apenas um arquivo de saída.

Dividir um documento por seções

Aspose.Words também permite usar quebras de seção para dividir documentos e salvá-los em HTML. Para isso, use SECTION_BREAK como document_split_criteria:

Existe outra maneira de dividir o documento de origem em vários documentos de saída e você pode escolher qualquer formato de saída suportado pelo Aspose.Words.

O exemplo de código a seguir mostra como dividir um documento em partes menores por quebras de seção (sem usar a propriedade document_split_criteria):

Divisão por páginas

Você também pode dividir um documento página por página, por intervalos de páginas ou começando com os números de página especificados. Nesse caso, o método extract_pages pode fazer o trabalho.

Esta seção descreve vários casos de uso de divisão de documentos por paginação usando a classe Document e o método extract_pages.

Dividir uma página de documento por página

Aspose.Words permite dividir um documento de várias páginas página por página.

O exemplo de código a seguir mostra como dividir um documento e salvar cada página como um documento separado:

Dividir um documento por intervalos de páginas

Aspose.Words permite dividir um documento de várias páginas por intervalos de páginas. Você pode dividir um arquivo em vários arquivos com vários intervalos de páginas ou apenas selecionar um intervalo e salvar apenas esta parte do documento de origem. Observe que você pode escolher o intervalo de páginas de acordo com o número máximo e mínimo de páginas de um documento.

O exemplo de código a seguir mostra como dividir um documento em partes menores por intervalo de páginas com índices iniciais e finais específicos:

Mesclar o documento dividido com outro arquivo

Aspose.Words permite mesclar o documento dividido de saída com outro documento para formar um novo documento. Isso pode ser chamado de mesclagem de documentos.

O exemplo de código a seguir mostra como mesclar um documento dividido com outro documento: