Aspose.Note FOSS
Python
איך זה "פוס פרו פייטון"?

איך זה "פוס פרו פייטון"?

aspose-note for Python è una libreria gratuita con licenza MIT per la lettura e conversione di file Microsoft OneNote ̋.one∂ in PDF senza necessità di Microsoft Office, senza estensioni native, pura Python da PyPI .

Guida passo-passo

  • Non è vero.

Passo 1: Installare il pacchetto

Installazione da PyPI con pip:

pip install aspose-note>=26.3.2

Verificare che l’installazione sia stata caricata correttamente:

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

Fase 2: Importazione delle classi richieste

Importare i moduli necessari per caricare documenti, attraversare nodi e salvare:

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

Passo 3: Caricare un file OneNote

Passare un percorso di file a Document per caricare qualsiasi formato OneNote supportato. Utilizzare la proprietà ̋FileFormat⌒ per verificare quale variante è stata rilevata:

from aspose.note import Document

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

Passo 4: attraversare le pagine e leggere il testo

Utilizzare `GetChildNodes ((()⌒ per recuperare tutti i nodi di pagina, quindi scavare fino ai nodi delle foglie RichText∂ per leggere il contenuto del testo reale:

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: Esportazione in PDF

`Document.Save()⌒ accetta ̋SafeFormat.Pdf∂ per scrivere un PDF. L’esportazione viene eseguita interamente in fase di elaborazione senza alcun renderer esterno:

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())}")
  • Non è vero.

Problemi comuni e soluzioni

ModuleNotFoundError: Nessun modulo chiamato 'aspose' Il pacchetto non è installato nell’ambiente Python attivo. Run ⌒pip install aspose-note nello stesso ambiente virtuale che stai utilizzando per eseguire il tuo script. Confirmare con ゚pip show aspone-not.

FileNotFoundError quando si chiama ̋Document(“path”)̅ Il percorso che hai passato non esiste o usa il separatore sbagliato. Utilizza ∂ pathlib.Path⌒ per costruire percorsi in modo portatile:

from pathlib import Path
from aspose.note import Document

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

`GetChildNodes()⌒ restituisce un elenco vuoto Assicurarsi che si sta chiamando ̋Get ChildNods ((Page)ヽ sulla radice del documento e non su un nodo ∂\Pages ̈. Ogni livello dell’albero restituirà solo i propri discendenti diretti del tipo specificato.

L’uscita PDF è vuota o manca contenuto Il renderer PDF legge nodi RichText. Se il file contiene solo immagini o file allegati senza nodi di ̋RicchtTexto, le pagine PDF saranno vuote. Controlla l’albero del documento per verificare che i nodi de ̈RICHTTEXT∂ siano presenti e contengano testo.

pagina.Titolo è ̋Nessuno∂ Non tutte le pagine hanno un titolo. Guardate sempre: ̨se pagina.Titolo e pagina .TitolText: …∂ prima di accedere al testo del titolo per evitare l’errore Attributo∂.

Domande frequenti

Aspose-note richiede Microsoft Office?

No. La biblioteca legge il formato binario di OneNote ed esporta in PDF nativamente in Python puro senza alcuna dipendenza da Microsoft Office, automazione COM o API Windows.

Quali versioni di Python sono supportate?

Python 3.10 o successiva. Il pacchetto funziona su Windows, macOS, Linux, container Docker e funzioni serverless.

La biblioteca è gratuita per uso commerciale?

Si. È rilasciato sotto la licenza MIT. Puoi usarlo, modificarlo e ridistribuirlo per qualsiasi scopo, comprese le applicazioni commerciali.

Posso scrivere nuovi file OneNote da zero?

Sì. Crea un documento utilizzando Document(), aggiungi nodi di pagina attraverso ̋AppendChildLast (), allegare ∂Outline∂ e ˆRichText∂ figli ed esportarlo in PDF con ›Ducument.Save∂“output.pdf”, SaveFormat.Pdf). Il salvataggio indietro al formato ≫.one∂ non è supportato.

Posso salvare in altri formati che non PDF?

La versione attuale 26.3.2 supporta l’esportazione solo in PDF. Salvare nuovamente nel formato OneNote .one o esportare in PNG, HTML o altri formati non è disponibile in questa edizione FOSS.

Vedi anche:

  • FAQ Aspose.Note FOSS per Python
  • Come esportare un file OneNote in PDF in Python
  • Come estrarre testo da OneNote in Python
  • Iniziare Docs
  • Referenza API
 Italiano