Perguntas Frequentes

Licenciamento e código aberto

Que licença Aspose.Note FOSS para Python usa?

Aspose.Note FOSS para Python é lançado sob a Licença MIT. Você pode usar, modificar e redistribuir a biblioteca para qualquer finalidade incluindo aplicações comerciais ?? sem royalties ou requisitos de atribuição além da inclusão do texto da licença.

Posso usar esta biblioteca num produto comercial?

Sim. A Licença MIT não impõe restrições ao uso comercial, redistribuição ou modificação. Não há taxas de tempo de execução, limites de utilização ou requisitos de assinatura.

Onde está o código-fonte?

O pacote é publicado no PyPI como aspose-note. Instale com:

pip install aspose-note>=26.3.2

Instalação e requisitos

Como eu instalar Aspose.Note FOSS para Python?

Instalar a partir do PyPI usando o pip:

pip install aspose-note>=26.3.2

Verificar a instalação:

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

Quais versões do Python são suportadas?

Aspose.Note FOSS para Python requer o Python 3.10 ou posterior. É um Python puro sem extensões compiladas, por isso funciona de forma idêntica no Windows, macOS, Linux, contêineres do Docker e funções sem servidor.

Requer o Microsoft Office ou o OneNote?

Não. A biblioteca lê arquivos OneNote .one e exporta para PDF nativamente em Python. Não há dependência do Microsoft Office, da automação COM ou de qualquer API específica do Windows.

Suporte de formato

Quais formatos do OneNote posso ler?

A biblioteca lê as três variantes binárias do OneNote:

Utilize a propriedade FileFormat num documento carregado para identificar qual variante foi detectada:

from aspose.note import Document

doc = Document("notebook.one")
print(doc.FileFormat)  # e.g. FileFormat.OneNote2010

Posso exportar documentos do OneNote para o PDF?

Sim. Passe SaveFormat.Pdf como segundo argumento para ̋Document.Safe()⌒:

from aspose.note import Document, SaveFormat

doc = Document("notebook.one")
doc.Save("output.pdf", SaveFormat.Pdf)

Você também pode salvar para um buffer na memória, passando um objeto BytesIO em vez de um caminho do arquivo.

Posso salvar de volta para o formato do OneNote?

Não. A biblioteca lê os arquivos .one mas só exporta para PDF. Chamando o formato Document.Save() (^ com um não-PDF, surge a exceção de SaveFormat (não suportado). Use o saveForma.Pdf (-’) para todas as operações de salva.

Utilização da API

Como carrego um ficheiro do OneNote?

Instanciar Document com o caminho do ficheiro:

from aspose.note import Document

doc = Document("notebook.one")

O Document é a raiz do modelo de objeto. Todos os nós ̋Page⌒, ∂Outline゚ e ≫RichText› no arquivo são acessíveis a partir desta raíz.

Como itereio as páginas e o seu conteúdo de texto?

Use `GetChildNodes ((() ̋ para recuperar nós filhos tipados em qualquer nível da árvore:

from aspose.note import Document, Page, RichText

doc = Document("notebook.one")
for page in doc.GetChildNodes(Page):
    print(f"Page author: {page.Author}")
    for rt in page.GetChildNodes(RichText):
        text = "".join(rt)
        if text.strip():
            print(text)

Como é que construo um documento do zero?

Construir nós de cima para baixo e anexá-los com AppendChildLast():

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

doc = Document()
page = Page()

title_text = RichText()
title_text.Append("My Page Title", TextStyle())
title = Title()
title.TitleText = title_text
page.Title = title

outline = Outline()
page.AppendChildLast(outline)
doc.AppendChildLast(page)
doc.Save("new_notebook.pdf", SaveFormat.Pdf)

Como posso ler metadados de página, como autor e tempo de criação?

Cada nó `Page⌒ expõe ̋Author゚, ∂CreationTime゚ e ≫LastModified゚Time como propriedades. O nós ̇Title゚ fornece ゙TitlText゚ , ˆTitledDate゚e ̨TitelTime∂ como filhos de RichTexte:

from aspose.note import Document, Page

doc = Document("notebook.one")
for page in doc.GetChildNodes(Page):
    print(f"Author  : {page.Author}")
    print(f"Created : {page.CreationTime}")
    if page.Title and page.Title.TitleText:
        print(f"Title   : {page.Title.TitleText}")

Limitações conhecidas

Há alguma limitação conhecida que eu deva saber?

A versão atual (26.3.2) concentra-se na leitura dos arquivos OneNote .one e exportação para PDF. A exportações para outros formatos raster ou vetorial (PNG, SVG e HTML) não estão disponíveis nesta edição do FOSS.

Posso controlar as opções de exportação do PDF, como tamanho da página ou DPI?

O PDF é um formato de somente escrita (exportação) a biblioteca salva o conteúdo do OneNote para PDF; PDF não é aceito como um formatos de entrada. As opções avançadas de salvar em PDF são expostas na superfície da API atual. O método Document.Save() com ⌒SavesFormat.Pdfヽ produz uma renderização padrão. Se você precisar de controle de saída fino, aplique mais ajustes no arquivo resultante usando uma ferramenta dedicada ao PDF.

As dimensões da imagem estão disponíveis nos nós de imagen?

Os nós Image expõem dois pares de atributos de dimensão. ̋Width` e ∂Height⌒ são atributos mutáveis que você pode ler e definir para controlar o tamanho da tela.

Ver também:

• Como exportar um arquivo do OneNote para PDF em Python
• Como extrair texto do OneNote em Python
• Como atravessar o DOM do OneNote em Python
• Começar Docs
• Referência API