Kas ir “フース・フォー・フェイトン”?
aspose-note for Python is een gratis, MIT-gelicentieerde bibliotheek voor het lezen en converteren van Microsoft OneNote.one` bestanden naar PDF zonder Microsoft Office nodig, geen native extensies, pure Python uit PyPI .
Een stapsgewijze gids
- Ik ben een echte man.
Stap 1: Installeer het pakket
Installeer vanaf PyPI met pip:
pip install aspose-note>=26.3.2Controleer of de installatie correct is geladen:
from aspose.note import Document
print("aspose-note is ready.")Stap 2: Import van vereiste klassen
Importeer de modules die u nodig hebt voor het laden van documenten, door nodes heen reizen en opslaan:
from aspose.note import Document, Page, Outline, RichText, SaveFormatStap 3: Een OneNote-bestand laden
Geef een bestandspad door naar Document om elk ondersteund OneNote-formaat te laden. Gebruik de eigenschap ̋FileFormat⌒ om na te gaan welke variant is gedetecteerd:
from aspose.note import Document
doc = Document("notebook.one")
print(f"Format : {doc.FileFormat}")
print(f"Pages : {len(list(doc))}")Stap 4: Bekijk de pagina’s en lees tekst
Gebruik `GetChildNodes ((() ̋ om alle ∂Page∂ nodes op te halen, en drill dan naar beneden naar ゚RichText∂ bladennodes om de werkelijke tekstinhoud te lezen:
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]}")Stap 5: Exporteren naar PDF
`Document.Save()⌒ accepteert ̋SavesFormat.Pdf∂ om een PDF te schrijven. De export verloopt volledig in het proces zonder externe renderer:
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())}")- Ik ben een echte man.
Gewone problemen en oplossingen
ModuleNotFoundError: Geen module met de naam 'aspose' Het pakket is niet geïnstalleerd in de actieve Python-omgeving. Run ⌒pip installeer aspose-note in dezelfde virtuele omgeving die u gebruikt voor het uitvoeren van uw script. Bevestig met ゚pip show aspase-note.
FileNotFoundError bij het oproepen van ̋Document(“path”)̅ De doorgevoerde route bestaat niet of gebruikt de verkeerde scheider. Gebruik ∂ pathlib.Path⌒ om routes draagbaar te bouwen:
from pathlib import Path
from aspose.note import Document
doc = Document(str(Path("folder") / "notebook.one"))GetChildNodes()⌒ retourneert een lege lijst Zorg ervoor dat je ̋Get ChildNods ((Page) oproept in de root van het document en niet in een node ∂pagina ̈ wanneer je verwacht dat er kinderen zijn op pagina-niveau. Elk niveau van de boom geeft alleen direct afstammelingen terug van een bepaald type.
PDF-uitvoer is leeg of ontbreekt inhoud De PDF renderer leest `RichText⌒ nodes. Als het bestand alleen afbeeldingen bevat of bijgevoegde bestanden zonder ̋RICHTEXT∂ noden, zullen de PDF pagina’s leeg zijn. Controleer de documentboom om te controleren of ̨RicchTexte゚ nodens aanwezig zijn en tekst bevatten.
pagina.Title is ̋Nobody` Niet elke pagina heeft een titel. Let altijd op: ∂if-pagine.Titel en pagina.titel.titelText: …∂ voor het toegang krijgen tot de titeltekst om AttributeError ̈ te voorkomen.
Vaak gestelde vragen
Heeft aspose-note Microsoft Office nodig?
Nee. De bibliotheek leest het OneNote-binaryformaat en exporteert naar PDF in pure Python zonder enige afhankelijkheid van Microsoft Office, COM-automatisering of Windows API’s.
Welke Python-versies worden ondersteund?
Python 3.10 of hoger. Het pakket draait op Windows, macOS, Linux, Docker containers en serverloze functies.
Is de bibliotheek vrij voor commercieel gebruik?
Ja, het is onder de MIT-licentie vrijgegeven. Je mag het gebruiken, wijzigen en herverdelen voor elk doel, inclusief commerciële toepassingen.
Kan ik nieuwe OneNote-bestanden schrijven vanaf het begin?
Ja. Maak een document met behulp van Document(), voeg ̋Page∂ nodes toe via ̇AppendChildLast (), bevestig ̨Outline∂ en ̆RichText∂ kinderen, en voer naar PDF uit met ̓Ducument.Save (?? “output.pdf”, SaveFormat.Pdf) ̊. Het opslaan terug in het formaat ゚.one̅ wordt niet ondersteund.
Kan ik opslaan in andere formaten dan PDF?
De huidige versie 26.3.2 ondersteunt alleen export naar PDF. Het opslaan terug in het OneNote .one-formaat of exporteren naar PNG, HTML of andere formaten is niet beschikbaar in deze FOSS-editie.
Zie ook:
- FAQ Aspose.Note FOSS voor Python
- Hoe een OneNote-bestand naar PDF te exporteren in Python
- Hoe tekst uit OneNote in Python te halen
- Beginnen Docs
- API-referentie