Πώς να ξεκινήσετε με Aspose.Note FOSS για Python

aspose-note Για το Python είναι μια δωρεάν, MIT-licensed βιβλιοθήκη για ανάγνωση και διάβασμα. Μετατροπή του Microsoft OneNote .one αρχεία σε PDF — δεν απαιτείται Microsoft Office, δεν είναι εγχώρια Η εκτεταμένη Python από το PyPI.

Βήμα προς βήμα οδηγός

pip install aspose-note>=26.3.2

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

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

from aspose.note import Document

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

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]}")

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())}")

Κοινά προβλήματα και τακτοποιήσεις

ModuleNotFoundError: No module named 'aspose' Το πακέτο δεν είναι εγκατεστημένο στο ενεργό περιβάλλον Python. pip install aspose-note στο ίδιο εικονικό περιβάλλον που χρησιμοποιείτε για να εκτελέσετε το σενάριο σας. επιβεβαιώστε με pip show aspose-note.

FileNotFoundError Όταν καλείται Document("path") Ο δρόμος που πέρασες δεν υπάρχει ή χρησιμοποιεί το λάθος διαχωριστικό. pathlib.Path Για να Κτίστε τα μονοπάτια με φορητό τρόπο:

from pathlib import Path
from aspose.note import Document

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

GetChildNodes() Επιστρέφει μια κενή λίστα Βεβαιωθείτε ότι καλείτε GetChildNodes(Page) Στον Document Σκηνή - όχι σε ένα Page κόμβοι - όταν περιμένετε παιδιά επίπεδα σελίδας. κάθε επίπεδο του δέντρου επιστρέφει μόνο το δικό της άμεσων απογόνων του καθορισμένου τύπου.

Το PDF είναι άδειο ή λείπει περιεχόμενο Το PDF Renderer διαβάζει RichText Αν το αρχείο περιέχει μόνο εικόνες ή συνημμένα αρχεία Με το ΝΑΙ RichText Σύνδεσμοι, οι σελίδες PDF θα είναι κενές. Ελέγξτε το δέντρο εγγράφου για να επαληθεύσετε Αυτό το RichText Οι κόμβοι είναι παρόντες και περιέχουν κείμενο.

page.Title Είναι None Δεν είναι κάθε σελίδα με τίτλο.Πάντα να το κρατάτε: if page.Title and page.Title.TitleText: ... Πριν από την πρόσβαση στο κείμενο τίτλου για να αποφύγετε AttributeError.

Συχνές ερωτήσεις

Το Microsoft Office απαιτεί το Microsoft?

Η βιβλιοθήκη διαβάζει το OneNote δυαδικό μορφότυπο και εξάγει στο PDF με φυσικό τρόπο σε καθαρό Python χωρίς καμία εξάρτηση από το Microsoft Office, την αυτοματοποίηση COM ή τα API των Windows.

Ποια εκδόσεις Python υποστηρίζονται;?

Το πακέτο λειτουργεί στα Windows, macOS, Linux, δοχεία Docker και τις λειτουργίες χωρίς διακομιστή.

Είναι η βιβλιοθήκη ελεύθερη για εμπορική χρήση;?

Μπορείτε να το χρησιμοποιήσετε, να τροποποιήσουν και να αναδιανέμουν για οποιονδήποτε σκοπό, συμπεριλαμβανομένων των εμπορικών εφαρμογών.

Μπορώ να γράψω νέα αρχεία του OneNote από το scratch;?

Ναι. Δημιουργήστε ένα έγγραφο χρησιμοποιώντας Document(),προσθέστε Page Κονδάλια μέσω AppendChildLast(),ΑΡΧΙΚΗ Outline και RichText Παιδιά, και εξαγωγή σε PDF με Document.Save("output.pdf", SaveFormat.Pdf).Σώστε πίσω στο .one Η μορφή δεν υποστηρίζεται.

Μπορώ να αποθηκεύσω σε μορφές που δεν είναι PDF;?

Η τρέχουσα έκδοση 26.3.2 υποστηρίζει την εξαγωγή σε PDF μόνο. Αποθήκευση πίσω στο OneNote .one Η μορφή ή η εξαγωγή σε PNG, HTML ή άλλες μορφές δεν είναι διαθέσιμη στην παρούσα έκδοση FOSS.

Δείτε επίσης

• FAQ — Aspose.Note FOSS για το Python
• Πώς να εξάγετε ένα αρχείο OneNote σε PDF στο Python
• Πώς να εξαγάγετε κείμενο από το OneNote στο Python
• Ξεκινάει το Docs
• Πυροβολισμοί αναφοράς