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

Aspose.Note FOSS עבור Python

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

Aspose.Note FOSS for Python Aspose.Note FOSS
for Python

לִלמוֹד GitHub

ספרייה Python בקוד פתוח לקבצי OneNote

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

התקן מ‑PyPI באמצעות pip install aspose-note (או pip install "aspose-note[pdf]" כדי לאפשר ייצוא ל‑PDF). דורש Python 3.10 או גרסה מאוחרת יותר.

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

קרא ונווט מסמכי OneNote

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

היכן ניתן להשתמש ב-Aspose.Note FOSS

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

ייצוא, תמונות וקבצים מצורפים

  • ייצוא PDF: שמור כל Document שנטען ל-PDF באמצעות Document.Save(path, SaveFormat.Pdf). הגרסה הפתוחה (FOSS) משתמשת ברינדור ברירת מחדל; אפשרויות PDF מתקדמות לכל עמוד אינן זמינות במהדורה זו.
  • ייצוא תמונה: עבור על צמתים Image כדי לאחזר בתים גולמיים (Bytes), שם קובץ (FileName), וממדים (OriginalWidth, OriginalHeight).
  • שמירת קבצים מצורפים: עבור על AttachedFile צמתים כדי לשמור קבצים מצורפים משובצים לדיסק.
  • טעינה מבוססת זרם: פתח קבצי .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 עבור Python?

זהו library חינמי, ברישיון MIT Python, לקריאת קבצי Microsoft OneNote (.one) ללא צורך ב‑Microsoft Office, COM automation, או כל runtime קנייני.

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

OneNote 2010, OneNote Online, וגרסאות הפורמט של OneNote 2007. כל קובץ קטע .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 נדרשת?

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

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

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

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

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

היכן ניתן למצוא את ה‑source code?

הספרייה מורשית ברישיון MIT ומתארחת ב‑GitHub. דיווחי באגים ובקשות משיכה (pull requests) מוזמנים.

  

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

 עברית