ما خوشحالیم که انتشار GroupDocs.Editor برای Python نسخه 26.5 را اعلام می‌کنیم که از مه 2026 در دسترس است. این اولین انتشار عمومی GroupDocs.Editor برای Python از طریق .NET است که به‌صورت یک چرخ‌دنده (wheel) خودکفا در PyPI ارائه می‌شود. این کتابخانه تمام قابلیت‌های ویرایش اسناد کتابخانهٔ .NET زیرین را به Python می‌آورد: بارگذاری یک سند، تبدیل آن به HTML/CSS تمیز و قابل ویرایش، برنامه‌نویسی یا ویرایش آن مارکاپ در هر ویرایشگر WYSIWYG، سپس ذخیرهٔ آن به فرمت اصلی — یا تبدیل به فرمت دیگری — تنها با یک pip install و بدون نیاز به MS Office، OpenOffice یا زمان‌اجرای جداگانهٔ .NET.

جدیدهای این انتشار

  • [ویژگی جدید] ویرایش دورانی HTML (EDTPY-1)
  • [ویژگی جدید] سطح API پایتونیک با نام‌گذاری خودکار (EDTPY-2)
  • [ویژگی جدید] پشتیبانی چندفرمت در پردازش واژه‌پرداز، صفحات گسترده، ارائه‌ها، PDF، ایمیل، کتاب‌های الکترونیکی و فرمت‌های متن/مارکاپ (EDTPY-3)
  • [ویژگی جدید] تبدیل فرمت از طریق میانهٔ HTML (EDTPY-4)
  • [ویژگی جدید] ویرایش جزئی (برگه/اسلاید/بازهٔ صفحات) با صفحه‌بندی و تغییر وضعیت متادیتای زبان (EDTPY-5)
  • [ویژگی جدید] استخراج منابع (تصاویر، فونت‌ها، CSS، صدا) و حفظ در پوشه (EDTPY-6)
  • [ویژگی جدید] بررسی سند از طریق get_document_info() (EDTPY-7)
  • [ویژگی جدید] بازرسی و به‌روزرسانی فیلدهای فرم از طریق editor.form_field_manager (EDTPY-8)
  • [ویژگی جدید] بارگذاری از جریان (stream) و پروتکل مدیر زمینه برای آزادسازی قطعی (EDTPY-9)
  • [ویژگی جدید] سازگار با AI Agent و LLM: AGENTS.md بسته‌بندی‌شده، سرور MCP و اسناد ماشین‌خوان (EDTPY-10)

تغییرات API عمومی

تمام API .NET از طریق نام‌گذاری بومی پایتون در دسترس است. کلاس‌ها از PascalCase استفاده می‌کنند، متدها و ویژگی‌ها از snake_case (به‌صورت خودکار به PascalCase .NET زیرین نگاشته می‌شوند) و مقادیر enum از UPPER_SNAKE_CASE.

کلاس‌ها

  • Editor — نقطهٔ ورود؛ باز کردن با مسیر یا جریان، edit()، save()، get_document_info()، form_field_manager
  • EditableDocument — نمایش HTML/CSS؛ get_content()، get_body_content()، get_embedded_html()، get_css_content()، save()، مجموعه‌های منابع (images، fonts، css، audio، all_resources) و کارخانه‌های from_markup() / from_markup_and_resource_folder() / from_file()
  • FormFieldManager — خواندن و به‌روزرسانی فیلدهای فرم پردازش واژه
  • License، Metered — APIهای مجوزدهی

گزینه‌ها

  • بارگذاری: WordProcessingLoadOptions، SpreadsheetLoadOptions، PresentationLoadOptions، PdfLoadOptions
  • ویرایش: WordProcessingEditOptions، SpreadsheetEditOptions، PresentationEditOptions، PdfEditOptions، EbookEditOptions، EmailEditOptions، MarkdownEditOptions، TextEditOptions، XmlEditOptions، DelimitedTextEditOptions
  • ذخیره: WordProcessingSaveOptions، SpreadsheetSaveOptions، PresentationSaveOptions، PdfSaveOptions، HtmlSaveOptions، MhtmlSaveOptions، MarkdownSaveOptions، XpsSaveOptions، TextSaveOptions، EbookSaveOptions، EmailSaveOptions، DelimitedTextSaveOptions

Enumها

  • WordProcessingFormats، SpreadsheetFormats، PresentationFormats، FixedLayoutFormats، EBookFormats، EmailFormats، TextualFormats، FontExtractionOptions، FontEmbeddingOptions

استثناها

  • PasswordRequiredException، IncorrectPasswordException، EncryptedException، InvalidFormatException

ویژگی‌های جدید

ویرایش دورانی HTML

هر سند پشتیبانی‌شده را به HTML/CSS قابل ویرایش تبدیل کنید و بدون از دست دادن دقت، آن را به فرمت اصلی خود بازگردانید — جریان کاری اصلی GroupDocs.Editor. HTML می‌تواند به‌صورت برنامه‌ای یا در هر ویرایشگر WYSIWYG شخص ثالثی مانند CKEditor یا TinyMCE ویرایش شود.

سطح API پایتونیک

تمام API .NET از طریق نام‌گذاری بومی پایتون در دسترس است. کلاس‌ها از PascalCase، متدها و ویژگی‌ها از snake_case (به‌صورت خودکار به PascalCase .NET زیرین نگاشته می‌شوند) و مقادیر enum از UPPER_SNAKE_CASE استفاده می‌کنند.

پشتیبانی چندفرمت

یک API یکپارچه برای پردازش واژه، صفحات گسترده، ارائه‌ها، PDF، ایمیل، کتاب‌های الکترونیکی و فرمت‌های متن/مارکاپ.

تبدیل فرمت از طریق HTML

فراخوانی جداگانهٔ «convert» وجود ندارد — ذخیرهٔ یک EditableDocument با *SaveOptions متفاوت، آن را از طریق میانهٔ HTML تبدیل می‌کند. ورودی یکسان، خروجی متفاوت.

ویرایش جزئی

ویرایش یک برگهٔ واحد از یک کتاب‌کار، یک اسلاید واحد از یک ارائه، یا بازه‌ای از صفحات — و تغییر وضعیت صفحه‌بندی و متادیتای زبان.

استخراج منابع

یک EditableDocument تصاویر، فونت‌ها، CSS و صداهای استخراج‌شده را به‌صورت مجموعه‌های قابل تکرار ارائه می‌دهد و می‌تواند HTML به‌همراه تمام منابع را در یک پوشه ذخیره کند.

بررسی سند

خواندن فرمت، تعداد صفحات، اندازه و وضعیت رمزنگاری بدون نیاز به یک عبور کامل ویرایشی.

فیلدهای فرم

بازرسی و به‌روزرسانی فیلدهای فرم پردازش واژه از طریق editor.form_field_manager.

جریان‌ها و مدیران زمینه

بارگذاری از هر جریان باینری و استفاده از پروتکل مدیر زمینه برای آزادسازی قطعی دستگیره‌های سند بومی.

AI Agent و سازگاری با LLM

  • AGENTS.md بسته‌بندی‌شده در داخل چرخ‌دندهٔ نصب‌شده — Claude Code، Cursor و GitHub Copilot به‌صورت خودکار سطح API، الگوهای استفاده و نکات عیب‌یابی را کشف می‌کنند.
  • سرور MCP — ابزار AI خود را به https://docs.groupdocs.com/mcp ارجاع دهید تا اسناد را به‌صورت درخواست‑به‑درخواست جستجو کنید.
  • اسناد ماشین‌خوان در https://docs.groupdocs.com/editor/python-net/llms-full.txt برای RAG و زمینهٔ LLM.

مثال کد

from groupdocs.editor import Editor, EditableDocument
from groupdocs.editor.formats import WordProcessingFormats
from groupdocs.editor.options import WordProcessingSaveOptions

with Editor("document.docx") as editor:
    editable = editor.edit()                       # سند -> HTML قابل ویرایش
    html = editable.get_embedded_html()
    edited = EditableDocument.from_markup(html.replace("Hello", "Goodbye"))
    editor.save(edited, "document.docx", WordProcessingSaveOptions(WordProcessingFormats.DOCX))

نحوه دریافت به‌روزرسانی

PyPI

نصب یا ارتقاء با استفاده از:

pip install groupdocs-editor-net

دانلود مستقیم

چرخ‌دنده را از صفحهٔ GroupDocs.Editor for Python via .NET 26.5 دریافت کنید.

منابع