ما خوشحالیم که انتشار GroupDocs.Editor for 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

هیچ فراخوانی «تبدیل» جداگانه‌ای وجود ندارد — ذخیرهٔ یک 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