تبدیل یک فایل PowerPoint ثابت به یک مجموعهٔ برند شده اغلب نیاز به افزودن یک سرصفحه و پاورقی ثابت در تمام اسلایدها دارد. Aspose.Slides Cloud SDK for Python یک API مبتنی بر ابر فراهم می‌کند که این کار را به سادگی انجام می‌دهد. در این راهنما خواهید آموخت که چگونه سرصفحه/پاورقی را به PowerPoint در Python اضافه کنید، ارائهٔ خود را بارگذاری کنید، متن سفارشی اعمال کنید و فایل به‌روز شده را بازیابی کنید. در پایان یک اسکریپت قابل استفاده مجدد خواهید داشت که می‌تواند در هر خط لولهٔ خودکارسازی ادغام شود.

پیش‌نیازها و راه‌اندازی

قبل از شروع، مطمئن شوید که موارد زیر را دارید:

  • Python 3.7+ نصب شده بر روی ماشین توسعه شما.
  • یک حساب Aspose Cloud با client_id و client_secret. می‌توانید این‌ها را در Aspose Cloud console ایجاد کنید.
  • دسترسی به یک پوشه در ذخیره‌سازی Aspose Cloud که ارائه در آن بارگذاری خواهد شد.

کتابخانه را با pip نصب کنید:

pip install asposeslidescloud

در ادامه، کلاس‌های مورد نیاز را وارد کنید و کلاینت API را پیکربندی کنید. قطعه کد زیر مستقیماً از پیاده‌سازی مرجع گرفته شده است.

import os
from asposeslidescloud import SlidesApi, Configuration
from asposeslidescloud.models import HeaderFooter
from asposeslidescloud.rest import ApiException

# Replace with your actual Aspose Slides Cloud credentials
client_id = "YOUR_CLIENT_ID"
client_secret = "YOUR_CLIENT_SECRET"

config = Configuration(client_id, client_secret)
slides_api = SlidesApi(config)

شما همچنین به یک فایل محلی PPTX (input.pptx) و یک مسیر مقصد (output.pptx) نیاز دارید. بخش‌های زیر هر مرحله از فرآیند را مرور می‌کنند.

افزودن سرصفحه/پاورقی به PowerPoint در Python: راهنمای گام‌به‌گام

مرحله 1: بارگذاری سند منبع و ایجاد پوشهٔ ابری

ابتدا اطمینان حاصل کنید که پوشه هدف در ذخیره‌سازی ابری وجود دارد. اگر وجود نداشته باشد، SDK آن را ایجاد می‌کند.

cloud_folder = "TempSlidesSDK"           # Folder in Aspose Cloud storage
cloud_file_name = "sample.pptx"           # Name of the file in cloud storage

try:
    slides_api.create_folder(cloud_folder)
except ApiException:
    pass  # Folder may already exist; ignore the error

مرحله ۲: بارگذاری فایل PPTX منبع

فایل محلی را باز کنید و محتوای باینری آن را به پوشهٔ ابری بارگذاری کنید.

local_input_path = "input.pptx"          # Existing PowerPoint file on local disk

with open(local_input_path, "rb") as f:
    slides_api.upload_file(os.path.join(cloud_folder, cloud_file_name), f.read())

مرحله ۳: تعریف تنظیمات سرصفحه/پاورقی

یک شیء HeaderFooter را با قابلیت نمایش و متن دلخواه ایجاد کنید. این جایی است که هدر و فوتر سفارشی که در هر اسلاید ظاهر می‌شود را مشخص می‌کنید.

header_footer = HeaderFooter(
    is_header_visible=True,
    header_text="My Custom Header",
    is_footer_visible=True,
    footer_text="Confidential",
    is_slide_number_visible=True,
    is_date_time_visible=False
)

مرحله 4: اعمال سرصفحه/پاورقی به تمام اسلایدها

فراخوانی put_set_header_footer با slide_index=None تنظیمات را برای کل ارائه اعمال می‌کند.

slides_api.put_set_header_footer(
    name=cloud_file_name,
    header_footer=header_footer,
    folder=cloud_folder
)

برای جزئیات بیشتر در مورد این متد، مستندات SlidesApi.put_set_header_footer documentation را ببینید.

مرحله 5: دانلود ارائه به‌روزشده و پاک‌سازی

فایل اصلاح‌شده را دریافت کنید، به‌صورت محلی ذخیره کنید و در صورت تمایل فایل موقت را از ذخیره‌سازی ابری حذف کنید.

local_output_path = "output.pptx"        # Destination for the modified file

updated_bytes = slides_api.download_file(os.path.join(cloud_folder, cloud_file_name))
with open(local_output_path, "wb") as out_file:
    out_file.write(updated_bytes)

# Optional cleanup
slides_api.delete_file(os.path.join(cloud_folder, cloud_file_name))

اکنون یک فایل PPTX دارید که سرصفحه و پاورقی سفارشی شما بر روی هر اسلاید اعمال شده است.

مثال کامل کد: افزودن سرصفحه و پاورقی به PowerPoint در Python

مثال زیر کل جریان کار را از ابتدا تا انتها نشان می‌دهد.

این مثال نشان می‌دهد که چگونه می‌توان یک سرصفحه و پاورقی سفارشی را به یک فایل PowerPoint با استفاده از Aspose.Slides Cloud SDK for Python اضافه کرد.

# pip install asposeslidescloud
import os
from asposeslidescloud import SlidesApi, Configuration
from asposeslidescloud.models import HeaderFooter
from asposeslidescloud.rest import ApiException

# -------------------- Configuration --------------------
# Replace with your actual Aspose Slides Cloud credentials
client_id = "YOUR_CLIENT_ID"
client_secret = "YOUR_CLIENT_SECRET"

config = Configuration(client_id, client_secret)
slides_api = SlidesApi(config)

# -------------------- File paths --------------------
local_input_path = "input.pptx"          # Existing PowerPoint file on local disk
local_output_path = "output.pptx"        # Destination for the modified file
cloud_folder = "TempSlidesSDK"           # Folder in Aspose Cloud storage
cloud_file_name = "sample.pptx"          # Name of the file in cloud storage

# -------------------- Upload source file --------------------
# Ensure the target folder exists
try:
    slides_api.create_folder(cloud_folder)
except ApiException:
    pass  # Folder may already exist; ignore the error

# Upload the local presentation to cloud storage
with open(local_input_path, "rb") as f:
    slides_api.upload_file(os.path.join(cloud_folder, cloud_file_name), f.read())

# -------------------- Define Header/Footer --------------------
header_footer = HeaderFooter(
    is_header_visible=True,
    header_text="My Custom Header",
    is_footer_visible=True,
    footer_text="Confidential",
    is_slide_number_visible=True,
    is_date_time_visible=False
)

# -------------------- Apply Header/Footer to all slides --------------------
# slide_index=None applies the settings to the whole presentation
slides_api.put_set_header_footer(
    name=cloud_file_name,
    header_footer=header_footer,
    folder=cloud_folder
)

# -------------------- Download the updated presentation --------------------
updated_bytes = slides_api.download_file(os.path.join(cloud_folder, cloud_file_name))
with open(local_output_path, "wb") as out_file:
    out_file.write(updated_bytes)

# -------------------- Cleanup (optional) --------------------
# Remove the file from cloud storage if no longer needed
slides_api.delete_file(os.path.join(cloud_folder, cloud_file_name))

توجه: این مثال کد عملکرد اصلی را نشان می‌دهد. قبل از استفاده از آن در پروژه خود، مطمئن شوید که مسیرهای فایل و مقادیر پیکربندی را به‌گونه‌ای به‌روز کنید که با محیط واقعی شما مطابقت داشته باشد، اطمینان حاصل کنید که تمام وابستگی‌های مورد نیاز به‌درستی نصب شده‌اند و به‌طور کامل در محیط توسعه خود تست کنید. اگر با مشکلی مواجه شدید، لطفاً به مستندات رسمی مراجعه کنید یا برای دریافت کمک با تیم پشتیبانی تماس بگیرید.

درج سرصفحه و پاورقی از طریق REST API با استفاده از cURL

اگر ترجیح می‌دهید مستقیماً با رابط REST کار کنید، همان عملیات می‌تواند با یک سری دستورات cURL انجام شود.

1. احراز هویت و دریافت توکن دسترسی

curl -X POST "https://api.aspose.cloud/connect/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

پاسخ شامل یک access_token است که در تماس‌های بعدی استفاده خواهید کرد.

2. بارگذاری فایل PPTX منبع

curl -X PUT "https://api.aspose.cloud/v3.0/slides/TempSlidesSDK/sample.pptx" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/octet-stream" \
  --data-binary "@input.pptx"

3. تنظیم سرصفحه و پاورقی برای ارائه

curl -X PUT "https://api.aspose.cloud/v3.0/slides/TempSlidesSDK/sample.pptx/headerFooter" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "IsHeaderVisible": true,
        "HeaderText": "My Custom Header",
        "IsFooterVisible": true,
        "FooterText": "Confidential",
        "IsSlideNumberVisible": true,
        "IsDateTimeVisible": false
      }'

4. دانلود فایل PPTX به‌روز شده

curl -X GET "https://api.aspose.cloud/v3.0/slides/TempSlidesSDK/sample.pptx" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -o output.pptx

این دستورات همان عملکردهای اسکریپت پایتون را انجام می‌دهند و به شما امکان می‌دهند ویژگی را در هر محیطی که می‌تواند درخواست‌های HTTP ارسال کند، ادغام کنید. برای جزئیات بیشتر، به مستندات رسمی API مراجعه کنید.

نتیجه‌گیری

اضافه کردن سرصفحه/پاورقی به PowerPoint در Python زمانی که از Aspose.Slides Cloud SDK for Python استفاده می‌کنید، تبدیل به کاری ساده می‌شود. این SDK احراز هویت، ذخیره‌سازی فایل و تزریق واقعی سرصفحه/پاورقی را تنها با چند فراخوانی متد مدیریت می‌کند. پس از یکپارچه‌سازی کد یا جریان کاری cURL، می‌توانید برندینگ، علامت‌گذاری‌های انطباق یا شماره‌گذاری اسلایدها را در مجموعه‌های بزرگ اسلاید به‌صورت خودکار انجام دهید. به یاد داشته باشید که برای استفاده در محیط تولید، یک لایسنس تجاری مناسب تهیه کنید؛ می‌توانید گزینه‌های قیمت‌گذاری را در صفحه محصول بررسی کنید و در حین ارزیابی کتابخانه، یک لایسنس موقت را از صفحه لایسنس موقت دریافت کنید.

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

  • چگونه می‌توانم به‌صورت برنامه‌نویسی هدر/فوتر را به اسلایدهای PowerPoint با پایتون اضافه کنم؟
    از مدل HeaderFooter ارائه‌شده توسط Aspose.Slides Cloud SDK برای پایتون استفاده کنید و متد put_set_header_footer را فراخوانی کنید. کد نمونه در این مقاله توالی دقیق را نشان می‌دهد.

  • آیا اسکریپت پایتونی برای به‌روزرسانی هدر و فوتر PowerPoint به‌صورت دسته‌جمعی وجود دارد؟
    بله. کد نشان‌داده‌شده را در یک حلقه که بر روی فهرستی از فایل‌های PPTX تکرار می‌شود بپیچید، هر کدام را بارگذاری کنید، همان شی HeaderFooter را اعمال کنید و نتیجه را دانلود کنید.

  • تفاوت درج سرصفحه و پاورقی در ارائه PowerPoint با استفاده از Python و استفاده از REST API چیست؟
    هر دو روش به همان نتیجه می‌رسند. SDK تماس‌های HTTP را انتزاع می‌کند، در حالی که مثال cURL نقاط انتهایی خام REST را نشان می‌دهد. روشی را انتخاب کنید که با معماری پروژه شما سازگار باشد.

  • چگونه می‌توانم یک سرصفحه و پاورقی سفارشی به یک فایل PowerPoint با استفاده از Python اضافه کنم؟
    متغیرهای header_text و footer_text را در شیء HeaderFooter تعریف کنید، پرچم‌های نمایش را تنظیم کنید و API را فراخوانی کنید. اسکریپت کامل که قبلاً ارائه شده است این کار را در یک تابع تک‌استفاده‌پذیر پیاده‌سازی می‌کند.

بیشتر بخوانید