صدور فرمت صفحه‌گسترده برای Python

Aspose.Cells FOSS for Python provides straightforward export from Excel workbooks to every format the FOSS library supports. A single workbook.save() این فراخوانی کل مسیر خروجی — XLSX، CSV، TSV، Markdown یا JSON — را مدیریت می‌کند و مقادیر سلول‌ها و فرمول‌ها را بدون نیاز به Microsoft Office حفظ می‌نماید.

نصب و راه‌اندازی

pip install aspose-cells-foss

کلاس‌های اصلی را وارد کنید:

from aspose.cells_foss import Workbook, SaveFormat, Cell
from aspose.cells_foss import MarkdownHandler, MarkdownSaveOptions
from aspose.cells_foss import CSVSaveOptions

فرمت‌های خروجی پشتیبانی‌شده

مهم: Aspose.Cells FOSS انجام می‌دهد نه پشتیبانی از صادرات به PDF، HTML، PNG، TIFF، DOCX یا PPTX. این‌ها فقط در بسته تجاری موجود هستند. aspose-cells-python فقط در بسته.

نمونه‌های استفاده

ذخیره به XLSX

قالب پیش‌فرض هنگام ذخیره‌سازی با یک .xlsx پسوند:

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Product"
ws.cells["B1"].value = "Revenue"
ws.cells["A2"].value = "Widget A"
ws.cells["B2"].value = 12500
ws.cells["A3"].value = "Widget B"
ws.cells["B3"].value = 8750

workbook.save("report.xlsx")

ذخیره به CSV

from aspose.cells_foss import Workbook, Cell, SaveFormat

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Name"
ws.cells["B1"].value = "Age"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 30
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 25

workbook.save("data.csv", SaveFormat.CSV)

ذخیره به Markdown

داده‌های جدولی را به صورت جدول‌های Markdown صادر کنید — برای مستندات و تولید README مفید است:

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "First name"
ws.cells["B1"].value = "Age"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 30
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 25

workbook.save_as_markdown("data.md")

خروجی یک جدول استاندارد Markdown است:

| First name | Age |
|---|---|
| Alice | 30 |
| Bob | 25 |

Markdown با گزینه‌ها

استفاده کنید MarkdownSaveOptions برای کنترل دقیق:

from aspose.cells_foss import Workbook, Cell, MarkdownSaveOptions

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "City"
ws.cells["B1"].value = "Population"
ws.cells["A2"].value = "London"
ws.cells["B2"].value = 9000000

options = MarkdownSaveOptions()

workbook.save_as_markdown("cities.md", options)

Markdown به رشته (در حافظه)

یک رشته Markdown تولید کنید بدون نوشتن روی دیسک:

from aspose.cells_foss import Workbook, Cell, MarkdownHandler

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Key"
ws.cells["B1"].value = "Value"
ws.cells["A2"].value = "version"
ws.cells["B2"].value = "26.3.0"

md_string = MarkdownHandler.save_markdown_to_string(workbook)
print(md_string)

ذخیره به JSON

داده‌های کتاب‌کار را به صورت JSON ساختاریافته برای خطوط لوله API صادر کنید:

from aspose.cells_foss import Workbook, Cell, SaveFormat

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Name"
ws.cells["B1"].value = "Score"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 95.5
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 88.0

workbook.save("data.json", SaveFormat.JSON)

یک CSV را بارگذاری کنید و به XLSX ذخیره کنید

from aspose.cells_foss import Workbook, SaveFormat

workbook = Workbook()
workbook.load_csv("input.csv")
workbook.save("output.xlsx", SaveFormat.XLSX)

نکات و بهترین شیوه‌ها

صادرات Markdown

• استفاده کنید MarkdownHandler.save_markdown_to_string(wb) برای موارد استفاده در حافظه مانند پاسخ‌های API.

صادرات CSV

• صادرات CSV به‌طور پیش‌فرض اولین برگه کاری را می‌نویسد.
• کاراکترهای ویژه (کاما، خطوط جدید) در مقادیر سلول به‌صورت خودکار در نقل‌قول قرار می‌گیرند.

صادرات JSON

• صادرات JSON از آدرس‌های سلول به‌عنوان کلید استفاده می‌کند. برای تبادل داده مناسب است؛ فرمول‌های پیچیده به‌صورت عبارات رشته‌ای خود ذخیره می‌شوند.

مشکلات رایج و راه‌حل‌ها

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

کدام فرمت‌های خروجی توسط Aspose.Cells FOSS پشتیبانی می‌شوند؟? XLSX، CSV، TSV، Markdown و JSON.

آیا می‌توانم به PDF تبدیل کنم؟? خیر. خروجی PDF به نسخه تجاری نیاز دارد. aspose-cells-python بسته. Aspose.Cells FOSS فقط به XLSX، CSV، TSV، Markdown و JSON صادر می‌شود.

آیا می‌توانم یک فایل XLSX موجود را بارگذاری کرده و دوباره به عنوان Markdown ذخیره کنم؟? بله. Workbook("existing.xlsx") فایل را بارگذاری می‌کند، و workbook.save_as_markdown("output.md") آن را صادر می‌کند.

آیا خروجی Markdown مبتنی بر جریان پشتیبانی می‌شود؟? بله. استفاده کنید MarkdownHandler.save_markdown_to_string(workbook) برای دریافت Markdown به‌صورت رشته Python بدون هیچ عملیات I/O فایل.

کدام نسخه‌های Python پشتیبانی می‌شوند؟? Python 3.7 و بالاتر.

همچنین ببینید

• مرجع API: مستندات کامل کلاس و متد برای aspose.cells_foss
• پایگاه دانش: راهنماهای گام‌به‌گام مبتنی بر وظیفه
• نمای کلی محصول: خلاصه ویژگی‌ها و قابلیت‌ها
• شروع کار / نصب: نصب pip و راه‌اندازی
• وبلاگ: معرفی Aspose.Cells FOSS: نمای کلی کتابخانه و شروع سریع