PNG JPG BMP TIFF PDF
Aspose.PDF  for Python

إضافة نص إلى رأس PDF في Python SDK

API للعمل مع النص في عنوان مستندات PDF باستخدام Cloud Python SDK.

Get Started

كيفية إضافة نص في رأس PDF عبر Cloud Python SDK

لإضافة نص في رأس PDF، سنستخدم Aspose.PDF Cloud Python SDK. يساعد هذا الـ Cloud SDK مبرمجي Python في تطوير تطبيقات إنشاء وتوضيح وتحرير وتحويل PDF السحابية باستخدام لغة برمجة Python عبر Aspose.PDF REST API. ببساطة، أنشئ حسابًا في Aspose for Cloud واحصل على معلومات التطبيق الخاصة بك. بمجرد الحصول على App SID & key، أنت جاهز لاستخدام Aspose.PDF Cloud Python SDK. إذا كانت حزمة Python مستضافة على Github، يمكنك التثبيت مباشرة من Github:

التثبيت من Github


     
    pip install git+https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-python.git

أمر وحدة التحكم في مدير الحزم

     
    pip install asposepdfcloud

خطوات لإضافة نص في رأس عبر Python

يمكن لمطوري Aspose.PDF Cloud بسهولة تحميل وإضافة نص في رأس PDF في بضع سطور من التعليمات البرمجية.

  1. تثبيت Python SDK
  2. رفع مستند PDF إلى خادم Aspose Cloud
  3. تنزيل مستند PDF المعالج من خادم Aspose Cloud
  4. إلحاق رأس نص جديد إلى الصفحة في مستند PDF
 

إضافة نص في رأس PDF باستخدام Python


    import shutil
    import json
    import logging
    from pathlib import Path
    from asposepdfcloud import ApiClient, PdfApi, TextHeader, HorizontalAlignment, TextHorizontalAlignment

    # Configure logging
    logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s")

    class Config:
        """Configuration parameters."""
        CREDENTIALS_FILE = Path(r"C:\\Projects\\ASPOSE\\Pdf.Cloud\\Credentials\\credentials.json")
        LOCAL_FOLDER = Path(r"C:\Samples")
        PDF_DOCUMENT_NAME = "sample.pdf"
        LOCAL_RESULT_DOCUMENT_NAME = "output_sample.pdf"
        HEADER_VALUE = "New header Value"
        PAGE_NUMBER = 2

    class pdfHederFooter:
        """Class for managing PDF headers and footers using Aspose PDF Cloud API."""
        def __init__(self, credentials_file: Path = Config.CREDENTIALS_FILE):
            self.pdf_api = None
            self._init_api(credentials_file)

        def _init_api(self, credentials_file: Path):
            """Initialize the API client."""
            try:
                with credentials_file.open("r", encoding="utf-8") as file:
                    credentials = json.load(file)
                    api_key, app_id = credentials.get("key"), credentials.get("id")
                    if not api_key or not app_id:
                        raise ValueError("init_api(): Error: Missing API keys in the credentials file.")
                    self.pdf_api = PdfApi(ApiClient(api_key, app_id))
            except (FileNotFoundError, json.JSONDecodeError, ValueError) as e:
                logging.error(f"init_api(): Failed to load credentials: {e}")

        def upload_document(self):
            """ Upload a PDF document to the Aspose Cloud server. """
            if self.pdf_api:
                file_path = Config.LOCAL_FOLDER / Config.PDF_DOCUMENT_NAME
                try:
                    self.pdf_api.upload_file(Config.PDF_DOCUMENT_NAME, str(file_path))
                    logging.info(f"upload_document(): File {Config.PDF_DOCUMENT_NAME} uploaded successfully.")
                except Exception as e:
                    logging.error(f"upload_document(): Failed to upload file: {e}")

        def download_result(self):
            """ Download the processed PDF document from the Aspose Cloud server. """
            if self.pdf_api:
                try:
                    temp_file = self.pdf_api.download_file(Config.PDF_DOCUMENT_NAME)
                    local_path = Config.LOCAL_FOLDER / Config.LOCAL_RESULT_DOCUMENT_NAME
                    shutil.move(temp_file, str(local_path))
                    logging.info(f"download_result(): File successfully downloaded: {local_path}")
                except Exception as e:
                    logging.error(f"download_result(): Failed to download file: {e}")

        def append_text_header(self):
            """Append a new text header to the PDF document."""
            if self.pdf_api:
                new_header = TextHeader(
                    background = True,
                    horizontal_alignment = HorizontalAlignment.CENTER,
                    text_alignment = TextHorizontalAlignment.CENTER,
                    value = Config.HEADER_VALUE
                )

                try:
                    response = self.pdf_api.post_document_text_header(
                        Config.PDF_DOCUMENT_NAME, new_header
                    )
                    if response.code == 200:
                        logging.info(f"append_text_header(): Header '{new_header.value}' added to the document '{Config.PDF_DOCUMENT_NAME}'.")
                    else:
                        logging.error(f"append_text_header(): Failed to add header '{new_header.value}' to the document '{Config.PDF_DOCUMENT_NAME}'. Response code: {response.code}")
                except Exception as e:
                    logging.error(f"append_text_header(): Error while adding header: {e}")

        def append_text_header_page(self):
            """Append a new text header to the page on PDF document."""
            if self.pdf_api:
                new_header = TextHeader(
                    background = True,
                    horizontal_alignment = HorizontalAlignment.LEFT,
                    text_alignment = TextHorizontalAlignment.CENTER,
                    value = Config.HEADER_VALUE
                )

                try:
                    response = self.pdf_api.post_document_text_header(
                        Config.PDF_DOCUMENT_NAME, new_header, start_page_number=Config.PAGE_NUMBER, end_page_number=Config.PAGE_NUMBER
                    )
                    if response.code == 200:
                        logging.info(f"append_text_header_page(): Header '{new_header.value}' added to the page #{Config.PAGE_NUMBER}.")
                    else:
                        logging.error(f"append_text_header_page(): Failed to add header '{new_header.value}' to the document #{Config.PAGE_NUMBER}. Response code: {response.code}")
                except Exception as e:
                    logging.error(f"append_text_header_page(): Error while adding header: {e}")


    if __name__ == "__main__":
        pdf_header_footer = pdfHederFooter()
        pdf_header_footer.upload_document()
        pdf_header_footer.append_text_header()
        pdf_header_footer.append_text_header_page()
        pdf_header_footer.download_result()
 

العمل مع الرأس في PDF

إضافة نص إلى رأس PDF يعزز العلامة التجارية، والتنقل، والأمان، والاحترافية. يساعد في تنظيم المستندات، والحفاظ على الامتثال، وضمان الاتساق، مما يجعله ميزة قيمة للمستندات التجارية والقانونية والأكاديمية والتقنية. أضف الرأس إلى مستندات PDF باستخدام Aspose.PDF Cloud Python SDK.

مع مكتبة Python الخاصة بنا يمكنك:

  • دمج مستندات PDF.
  • تقسيم ملفات PDF.
  • تحويل PDF إلى تنسيقات أخرى، والعكس بالعكس.
  • التلاعب بالتعليقات التوضيحية.
  • العمل مع الصور في PDF، إلخ.
  • يمكنك تجربة التطبيقات المجانية لاختبار الوظائف عبر الإنترنت.