نحن سعداء بالإعلان عن إصدار GroupDocs.Editor for Python v26.5، المتاح اعتبارًا من مايو 2026. هذا هو الإصدار العام الأول لـ GroupDocs.Editor for Python عبر .NET، يُوزَّع كحزمة Python wheel مستقلة على PyPI. يتيح لك الاستفادة من كامل قدرات تحرير المستندات للمكتبة الأساسية المبنية على .NET في Python: تحميل مستند، تحويله إلى HTML/CSS نظيف وقابل للتحرير، تعديل هذا الترميز برمجيًا أو في أي محرر WYSIWYG، ثم حفظه مرة أخرى بالتنسيق الأصلي — أو تحويله إلى تنسيق آخر — باستخدام أمر pip install واحد دون الحاجة إلى MS Office أو OpenOffice أو بيئة تشغيل .NET منفصلة.

ما الجديد في هذا الإصدار

  • [ميزة جديدة] تحرير HTML بنظام الجولة الكاملة (EDTPY-1)
  • [ميزة جديدة] واجهة برمجة تطبيقات (API) بديهية للغة Python مع تسمية تلقائية متطابقة (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 من خلال تسميات أصلية للغة Python. تُكتب أسماء الفئات بـ PascalCase، وتُكتب الأساليب والخصائص بـ snake_case (مُطابقة تلقائيًا إلى PascalCase في .NET)، وتُكتب قيم التعداد بـ 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 — واجهات ترخيص

الخيارات

  • التحميل: 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

التعدادات

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

الاستثناءات

  • PasswordRequiredException، IncorrectPasswordException، EncryptedException، InvalidFormatException

الميزات الجديدة

تحرير HTML بنظام الجولة الكاملة

تحويل أي مستند مدعوم إلى HTML/CSS قابل للتحرير ثم حفظه مرة أخرى إلى تنسيقه الأصلي دون فقدان الدقة — وهو سير العمل الأساسي وراء GroupDocs.Editor. يمكن تحرير HTML برمجيًا أو في أي محرر WYSIWYG من الطرف الثالث مثل CKEditor أو TinyMCE.

واجهة برمجة تطبيقات بديهية للغة Python

يتم عرض كامل API الخاص بـ .NET من خلال تسميات أصلية للغة Python. تُكتب أسماء الفئات بـ PascalCase، وتُكتب الأساليب والخصائص بـ snake_case (مُطابقة تلقائيًا إلى PascalCase في .NET)، وتُكتب قيم التعداد بـ UPPER_SNAKE_CASE.

دعم متعدد الصيغ

واجهة موحدة عبر معالجة النصوص، الجداول، العروض التقديمية، 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 — وجه أداتك الذكية إلى 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()                       # document -> editable 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 .

الموارد