1. מוצרים
  2.   Aspose.Note
  3.   Aspose.Note FOSS for Python

Aspose.Note FOSS for Python

קרא, נווט וייצא קבצי Microsoft OneNote (.one) מ-Python — חינמי וקוד פתוח, ללא צורך ב-Microsoft Office.

ספריית פיתון מקורות פתוחים לקבצים OneNote

Aspose.Note FOSS for Python הוא ספרייה חופשית ב-100% עם רישיון MIT המאפשרת לך לקרוא קבצים של Microsoft OneNote (.one) לחלוטין מ-Python, ללא מיקרוסופט אופיס, בלי אוטומציה COM ולא נדרש זמן פעלה פרטי. היא חושפת API ציבורי נקיה (aspose.note.*) המודלת על פני ה Aspose.Note הידוע עבור ממשק .NET, שמוצאת באמצעות ניתוח בינארי MS-ONE / OneStore שבוצע ב- Python טהור.

התקנה מ-PyPI עם pip install aspose-note (או pip install "aspose-note[pdf]" כדי לאפשר ייצוא PDF). דורש פייטון 3.10 או יותר.

הספרייה מתאימה לסריפטים אוטומטיים של מסמכים, צינורות אינדקס תוכן, כלים ארכיוויריים וכל זרימת עבודה בצד השרת שדרושה לצרוך את התוכן OneNote ללא תלויות Microsoft Office. עבור משפחת המוצרים הארגוניים ראה Aspose.Note — Enterprise Product Family.

קריאה וביצוע מעקב במסמכים של OneNote

  • Load .one files: פתח כל קטע של OneNote מדרך קובץ או זרם בינארי באמצעות Document.
  • העברה DOM מלא: ניווט Document → Page → Outline → OutlineElement → RichText / Image / Table / AttachedFile.
  • קריאת טקסט עשיר: לקרוא טקסט גולמי באמצעות RichText.Text או לבדוק את קטעי TextRun עבור מטא-נתונים בעומס, איטלקי, צבע, וגיבור קישור.
  • ניתוח טבלה: חוצה Table → TableRow → TableCell היררכיות; לקרוא רוחבי עמודה באמצעות TableColumn.Width.
  • בדיקת תגיות: לקרוא NoteTag מטא-מידע (צורה, תווית, צבע, מצב השלמת) על טקסט, תמונה ונקודות שולחן.

איפה Aspose.Note FOSS יכול לשמש

  • אינדקס תוכן: להוציא וליידקס את כל הטקסט מאארכיבי OneNote עבור צינורות חיפוש.
  • העברת מסמך: לייצוא קטעים של OneNote ל- PDF, טקסט פשוט או נתונים מובנים.
  • כלים ארכיוטיים: שמור תמונות מותקפות וצורכים לדיסק מ .one קבצים.
  • טיפולי עבודה של CI/CD: אימות או עיבוד תוכן OneNote בתוך מיכלים של Docker.
  • צינור בסיס הידע: להוציא תוכן מובנה ממדפי OneNote של צוות.

ייצוא, תמונות ופרטים ממוספים

  • PDF export: שמור כל Document טעון ל‑PDF באמצעות Document.Save(path, SaveFormat.Pdf). גרסת ה‑FOSS משתמשת ברינדור ברירת מחדל; אפשרויות PDF מתקדמות לכל עמוד אינן זמינות בגרסה זו.
  • Image export: עבור על צמתים Image כדי לקבל את הבייטים הגולמיים (Bytes), שם הקובץ (FileName) והמידות (OriginalWidth, OriginalHeight).
  • Attachment saving: עבור על צמתים AttachedFile כדי לשמור קבצי צירוף משובצים לדיסק.
  • Stream-based loading: פתח קבצי .one מזרם בינארי (למשל, io.BytesIO) מבלי לכתוב לדיסק.

ניסיון מפתחה

Aspose.Note FOSS מותקנת עם פקודה pip install aspose-note אחת. לחבילה הבסיסית אין תלותות אופציונליות; ייצוא PDF דורש את ReportLab, המותקן דרך pip install "aspose-note[pdf]".

ה-API מודל על ה-Aspose.Note המוכר עבור ממשק .NET: Document, Page, Outline, RichText, Image, Table, AttachedFile. הספרייה ברישיון MIT, קוד פתוח, ומקבלת דיווחי באגים ותרומות ב‑GitHub.

להטיל קובץ OneNote ולסלק את כל הטקסט

התקנה עם pip, ואז העבירו נתיב קבצים ל Document() כדי לחקור את פורמט הבינארי של OneNote. GetChildNodes(RichText) מבצע חיפוש רוקוריבי עמוק ומחזיר כל צומת טקסט במסמך, אשר שימושי עבור אינדקס מלא טכני או צינורות מיגרציה.

pip install aspose-note
from aspose.note import Document, RichText
doc = Document("notebook.one")
print(f"Pages: {len(list(doc))}")
# Extract all text across the entire document
texts = [rt.Text for rt in doc.GetChildNodes(RichText) if rt.Text]
for text in texts:
   print(text)

לייצוא ל- PDF ולשמור תמונות מצורפות

ייצוא PDF דורש את התלות ReportLab אופציונלית. התקנה עם pip install "aspose-note[pdf]". אותו אובייקט Document ניתן גם לשחזר עבור צמתים Image כדי לחלץ ולחסוך את כל התמונות המופשטות לדיסק במעבר אחד.

from aspose.note import Document, SaveFormat, Image
import pathlib

doc = Document("notebook.one")

# Export the document to PDF (requires aspose-note[pdf])
doc.Save("output.pdf", SaveFormat.Pdf)

# Save all embedded images to disk
out_dir = pathlib.Path("images")
out_dir.mkdir(exist_ok=True)
for i, img in enumerate(doc.GetChildNodes(Image)):
   name = img.FileName or f"image_{i}.bin"
   (out_dir / name).write_bytes(img.Bytes)

שאלות נפוצות

מה זה Aspose.Note FOSS עבור פייטון?

זהו ספריית פייטון חופשית בעלת רישיון MIT לקריאת קבצי Microsoft OneNote (.one) ללא צורך ב-Microsoft Office, אוטומציה COM או זמן תפעול פרטי.

אילו גרסאות פורמט OneNote נתמכות?

ניתן להטיל כל קובץ קטע .one תקף.

איך אני מתקין את זה?

תפעיל pip install aspose-note עבור הספרייה הבסיסית, או pip install "aspose-note[pdf]" כדי לכלול את התלות ReportLab החופשית לייצוא PDF.

האם אני יכול לייצא קבצים של OneNote ל- PDF?

כן. לקרוא Document.Save(path, SaveFormat.Pdf). PDF ייצוא דורש את תלוי ReportLab אופציונלי מותקן באמצעות [pdf] נוסף.

אני יכול להעלות .one קבצים מזרם?

כן. כיתה Document מקבלת זרם בינארי (למשל, io.BytesIO או גוף תגובה HTTP) כך שאתה יכול לעבד קבצים מבלי לכתוב לדיסק.

איזה גרסה של פייטון נדרשת?

Python 3.10 או מאוחר יותר נדרש.

האם אני יכול לכתוב או לשנות קבץ .one?

לא. המהדורה הנוכחית היא קריאה בלבד. היא יכולה לפתוח ולפרס כל קובץ קטע .one תקף, אך כתיבה חזרה לצורת בינארית של OneNote אינה נתמכת.

האם מסמכים OneNote מוצפנים נתמחים?

לא. עריכת קובץ מגן על סיסמה .one יוצרת את ה- IncorrectPasswordException מסמכים מוצפנים אינם נתמחים במהדורה הנוכחית.

איפה אני יכול למצוא את קוד המקור?

הספרייה מורשה על ידי MIT ומוצגת ב- GitHub. דיווחי פג וביקורי הפיק הם רצויים.

  

משאבי תמיכה ולמידה

 עברית