1. محصولات
  2.   Aspose.Note
  3.   Aspose.Note FOSS for Python

Aspose.Note FOSS for Python

فایل‌های Microsoft OneNote (.one) را از Python بخوانید، مرور کنید و صادر کنید — رایگان و متن باز، بدون نیاز به Microsoft Office.

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

مستندات GitHub

کتابخانه ی منبع باز پایتون برای فایل های OneNote

Aspose.Note FOSS برای پایتون یک کتابخانه 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 برای متاداتا در bold، italic، font, color و hyperlink.
  • ** تجزیه جدول:** از هرم های Table → TableRow → TableCell عبور کنید؛ عرض ستون ها را از طریق TableColumn.Width بخوانید.
  • ** بازرسی برچسب:** خواندن NoteTag متاداتا (شکل، برچسب، رنگ، حالت تکمیل) در متن، تصویر و گره های جدول.

جایی که Aspose.Note FOSS می تواند مورد استفاده قرار گیرد

  • ** شاخص بندی محتوا:** استخراج و فهرست کردن تمام متن از آرشیو های OneNote برای جستجوی پایپ لاین.
  • ** مهاجرت سند:** بخش های OneNote را به PDF، متن ساده یا داده های ساختار یافته صادر کنید.
  • ** ابزار آرشیو:** تصاویر و توابع ضمیمه شده را از فایل های .one به دیسک ذخیره کنید.
  • ** جریان های کاری CI/CD:** اعتباردهی یا پردازش محتوای OneNote در داخل کانتینر Docker.
  • نابرها دانش پایه: محتوای ساختار یافته را از دفترچه های یادداشت تیم OneNote استخراج کنید.

صادرات، تصاویر و ضمیمه ها

  • ** صادرات PDF:** هر نوع Document بارگیری شده را با استفاده از Document.Save(path, SaveFormat.Pdf) به PDF ذخیره کنید. نسخه FOSS از یک نمایش پیش فرض استفاده می کند؛ گزینه های پیشرفته در هر صفحه PDF در این نسخه موجود نیست.
  • صوری صادر: Image گره ها را برای بازیابی بایت خام (Bytes) ، نام فایل ( FileName) و ابعاد ( OriginalWidth، OriginalHeight تکرار کنید.
  • ** ذخیره سازی ضمیمه:** Iterate AttachedFile nodes برای ذخیره کردن فایل های متصل به دیسک.
  • ** بارگیری مبتنی بر جریان:** فایل های .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 پشتیبانی می شوند؟

نسخه های قالب OneNote 2010، OneNOte Online و OneNot 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) بنابراین می توانید فایل ها را بدون نوشتن به دیسک پردازش کنید.

چه نسخه ی پایتون مورد نیاز است؟

پایتون 3.10 یا بالاتر مورد نیاز است.

آیا می توانم یک فایل .one بنویسم یا اصلاح کنم؟

نه. نسخه فعلی فقط برای خواندن است. می تواند هر فایل بخش .one معتبر را باز و تجزیه کند، اما نوشتن به قالب باینری OneNote پشتیبانی نمی شود.

آیا اسناد رمزگذاری شده OneNote پشتیبانی می شوند؟

نه. بارگیری یک فایل محافظت شده از کلمه عبور .one باعث ایجاد یک IncorrectPasswordException می شود . اسناد رمزگذاری شده در نسخه فعلی پشتیبانی نمی شوند.

کجاش میتونم کد منبع رو پیدا کنم؟

این کتابخانه دارای مجوز MIT است و در GitHub میزبانی می شود. گزارشات خطا و درخواست های کشیدن خوش آمدید هستند.

  

منابع پشتیبانی و آموزش

 فارسی