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

Aspose.Words FOSS برای Python

اسناد Word را از Python به PDF، Markdown و متن ساده صادر کنید — بدون نیاز به Microsoft Office.

Aspose.Words FOSS for Python Aspose.Words FOSS
for Python

مستندات GitHub

کتابخانه متن‌باز Python برای تبدیل اسناد Word

Aspose.Words FOSS برای Python یک کتابخانه Python دارای مجوز MIT است که برای بارگذاری اسناد Word و خروجی گرفتن از آن‌ها استفاده می‌شود. این کتابخانه فایل‌های DOCX، DOC، RTF، TXT و Markdown را می‌خواند و آن‌ها را به PDF، Markdown و متن ساده صادر می‌کند بدون اینکه به Microsoft Office یا هر زمان‌اجرای مالکیتی نیاز داشته باشد.

کتابخانه یک کلاس Document برای بارگذاری فایل‌ها و یک متد save() که ثابت‌های SaveFormat یا اشیای گزینه‌های ذخیره‌سازی مانند PdfSaveOptions و MarkdownSaveOptions را می‌پذیرد، فراهم می‌کند. نکته: بیشتر ویژگی‌های گزینه‌های ذخیره‌سازی برای سازگاری آینده API تعریف شده‌اند و هنوز توسط نویسندگان استفاده نمی‌شوند؛ فقط MarkdownSaveOptions.export_underline_formatting در حال حاضر بر خروجی تأثیر می‌گذارد.

با pip install aspose-words-foss>=26.4.0 نصب کنید. این کتابخانه به Python 3.10 یا بالاتر نیاز دارد و به olefile، fpdf2 و pydantic وابسته است. نسخه تجاری Aspose.Words for Python است.

تبدیل سند

  • ورودی چند فرمت: سندها را از فرمت‌های DOCX، DOC، RTF، TXT و Markdown از طریق کلاس Document بارگذاری کنید.
  • صدور PDF: هر سند ورودی را به PDF صادر کنید با استفاده از SaveFormat.PDF یا PdfSaveOptions.
  • Markdown export: خروجی به Markdown با SaveFormat.MARKDOWN یا MarkdownSaveOptions.
  • استخراج متن: استخراج محتوای متن ساده از اسناد با استفاده از Document.get_text().
  • صادرات متن ساده: اسناد را به صورت متن ساده با استفاده از SaveFormat.TEXT ذخیره کنید.

جایی که Aspose.Words FOSS می‌تواند استفاده شود

  • خط لوله‌های سند: تبدیل اسناد Word بارگذاری‌شده به PDF در سرویس‌های بک‌اند.
  • استخراج محتوا: متن را از فایل‌های DOCX یا DOC برای ایندکس‌گذاری و جستجو استخراج کنید.
  • انتقال فرمت: صادرات دسته‌ای آرشیوهای قدیمی Word به Markdown یا PDF مدرن.
  • CI/CD automation: تولید گزارش‌های PDF از قالب‌های Markdown یا DOCX در خطوط ساخت.

گزینه‌های ذخیره‌سازی و سفارشی‌سازی

  • PdfSaveOptions: کلاس پیکربندی خروجی PDF (ویژگی‌ها به‌عنوان استاب‌های سازگاری پیشرو هستند؛ هنوز توسط نویسنده اعمال نشده‌اند).
  • MarkdownSaveOptions: پیکربندی خروجی Markdown (فقط export_underline_formatting در حال حاضر اعمال شده است؛ سایر ویژگی‌ها استاب‌های سازگاری‑آینده هستند).
  • ثابت‌های SaveFormat: از SaveFormat.MARKDOWN، SaveFormat.PDF و SaveFormat.TEXT برای تبدیل سریع استفاده کنید.
  • خوانندگان سند: خوانندگان اختصاصی برای فرمت‌های ورودی DOC، RTF، TXT و Markdown.

تجربهٔ توسعه‌دهنده

Aspose.Words FOSS با pip install aspose-words-foss نصب می‌شود. وابستگی‌های زمان اجرا (olefile، fpdf2، pydantic) به‌صورت خودکار نصب می‌شوند.

API ساده است: یک Document را از مسیر فایل بارگذاری کنید، سپس save() را با مسیر هدف و فرمت صدا بزنید. برای کنترل پیشرفته، به جای یک ثابت فرمت، یک شیء گزینه‌های ذخیره‌سازی را پاس دهید. کتابخانه تحت مجوز MIT-licensed است، منبع باز در GitHub و نیاز به Python 3.10 یا بالاتر دارد.

تبدیل DOCX به Markdown

یک سند Word را بارگذاری کنید و آن را به‌صورت Markdown در دو خط کد ذخیره کنید.

import aspose.words_foss as aw
document = aw.Document("input.docx")  # or .doc, .rtf, .txt, .md
document.save("output.md", aw.SaveFormat.MARKDOWN)

صادرات DOCX به PDF

یک سند Word را به فرمت PDF صادر کنید.

import aspose.words_foss as aw
document = aw.Document("input.docx")
document.save("output.pdf", aw.SaveFormat.PDF)

استخراج متن از یک سند

تمام محتوای متنی یک سند Word را بخوانید.

import aspose.words_foss as aw
document = aw.Document("input.docx")
text = document.get_text()

سوالات متداول

مجوز Aspose.Words FOSS برای Python چه چیزی است؟

Aspose.Words FOSS برای Python تحت مجوز MIT منتشر شده است. می‌توانید آن را در پروژه‌های تجاری و شخصی استفاده، تغییر و توزیع کنید.

چگونه Aspose.Words FOSS برای Python را نصب کنم؟

از طریق pip با pip install aspose-words-foss>=26.4.0 نصب کنید. به Python نسخه 3.10 یا بالاتر نیاز دارد.

کدام فرمت‌های سند پشتیبانی می‌شوند؟

این کتابخانه فایل‌های DOCX، DOC، RTF، TXT و Markdown را می‌خواند و به PDF، Markdown و متن ساده صادر می‌کند.

چگونه یک فایل DOCX را به PDF صادر کنم؟

از Document("input.docx") برای مقداردهی اولیهٔ شیء سند استفاده کنید. با document.save("output.pdf", SaveFormat.PDF) به‌صورت PDF ذخیره کنید.

  

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

 فارسی