Kas ir “フース・フォー・フェイトン”?

Kas ir “フース・フォー・フェイトン”?

aspose-note for Python é uma biblioteca gratuita, licenciada pelo MIT para ler e converter arquivos do Microsoft OneNote ̋.one∂ em PDF sem necessidade de Microsoft Office, sem extensões nativas, pura Python a partir do PyPI .

Guia passo a passo

  • Não, não.

Passo 1: Instalar o pacote

Instalar a partir do PyPI com pip:

pip install aspose-note>=26.3.2

Verifique se a instalação está correctamente carregada:

from aspose.note import Document
print("aspose-note is ready.")

Passo 2: Importar as classes necessárias

Importar os módulos que você precisa para carregar documentos, atravessar nós e salvar:

from aspose.note import Document, Page, Outline, RichText, SaveFormat

Passo 3: Carregar um arquivo do OneNote

Passe um caminho de arquivo para Document para carregar qualquer formato OneNote suportado. Use a propriedade ̋FileFormat⌒ para verificar qual variante foi detectada:

from aspose.note import Document

doc = Document("notebook.one")
print(f"Format : {doc.FileFormat}")
print(f"Pages  : {len(list(doc))}")

Passeia as páginas e leia o texto

Use `GetChildNodes ((() ̋ para recuperar todos os nós da página, em seguida, deslize até os nós de folha RichText (RichTect) para ler o conteúdo real do texto:

from aspose.note import Document, Page, RichText

doc = Document("notebook.one")
for page in doc.GetChildNodes(Page):
    if page.Title and page.Title.TitleText:
        print(f"Page: {page.Title.TitleText}")
    for rt in page.GetChildNodes(RichText):
        text = "".join(rt)
        if text.strip():
            print(f"  {text[:120]}")

Passo 5: Exportar para PDF

`Document.Save()⌒ aceita ̋SabeFormat.Pdf∂ para escrever um PDF. A exportação é executada inteiramente no processo sem qualquer renderização externa:

import io
from aspose.note import Document, SaveFormat

doc = Document("notebook.one")

# Save to a file
doc.Save("output.pdf", SaveFormat.Pdf)

# Save to an in-memory buffer
buf = io.BytesIO()
doc.Save(buf, SaveFormat.Pdf)
print(f"PDF bytes: {len(buf.getvalue())}")
  • Não, não.

Problemas comuns e soluções

ModuleNotFoundError: Não há módulo chamado 'aspose' O pacote não está instalado no ambiente ativo do Python. Run ⌒pip instala aspose-note no mesmo ambiente virtual que você está usando para executar seu script. Confirme com ゚pip show aspone-not.

FileNotFoundError quando chamar o ̋Document(“path”)̅ O caminho que você passou não existe ou usa o separador errado. Use ∂pathlib.Path∂ para construir caminhos de forma portátil:

from pathlib import Path
from aspose.note import Document

doc = Document(str(Path("folder") / "notebook.one"))

`GetChildNodes()⌒ retorna uma lista vazia Certifique-se de que está a chamar ̋Get ChildNods ((Page)ヽ na raiz do documento e não num nó da página quando espera ter filhos no nível das páginas. Cada nível da árvore só devolve os seus descendentes diretos do tipo especificado.

A saída do PDF está em branco ou o conteúdo falta O renderizador de PDF lê os nós RichText. Se o arquivo conter apenas imagens ou ficheiros anexados sem nós de ̋RicTect⌒, as páginas do pdf ficarão vazias. Inspecione a árvore do documento para verificar se os nós de∂RICTEXT∂ estão presentes e contêm texto.

page.Title is ̋None⌒ Nem todas as páginas têm um título. Sempre guardar: ∂if página.Título e página .Titre.TitoloTexto: …゚ antes de acessar o texto do título para evitar AttributeError̅.

Perguntas Frequentes

O aspose-note requer o Microsoft Office?

Não. A biblioteca lê o formato binário do OneNote e exporta para PDF nativamente em Python puro sem qualquer dependência de Microsoft Office, automação COM ou APIs do Windows.

Quais versões do Python são suportadas?

Python 3.10 ou posterior. O pacote é executado em Windows, macOS, Linux, contêineres Docker e funções sem servidor.

A biblioteca é gratuita para uso comercial?

Sim, é lançado sob a licença MIT. Você pode usá-lo, modificá -lo e redistribuí -la para qualquer finalidade, incluindo aplicações comerciais.

Posso escrever novos arquivos do OneNote a partir do zero?

Sim. Criar um documento usando Document(), adicionar nós de página através do AppendChildLast (()) ‘), anexar filhos Outline (Outline’) e RichText (‘RichTect’) , e exportar para PDF com o formato Save (.pdf). Salvar novamente no formato One () não é suportado.

Posso salvar em outros formatos que não o PDF?

A versão atual 26.3.2 suporta a exportação apenas para PDF. Salvar de volta ao formato OneNote .one ou exportar para PNG, HTML ou outros formatos não está disponível nesta edição do FOSS.

Ver também:

  • FAQ Aspose.Note FOSS para Python
  • Como exportar um arquivo do OneNote para PDF em Python
  • Como extrair texto do OneNote em Python
  • Começar Docs
  • Referência API
 Português