Documentation – العمل مع مصنوعات PDF في بايثون

Python-Net: إضافة ترقيم بيتس إلى PDF في بايثون

Thu, 11 Jun 2026 00:00:00 +0000

يُستخدم ترقيم بيتس على نطاق واسع في عمليات سير العمل القانونية والطبية والتجارية لتعيين معرفات فريدة ومتسلسلة للصفحات داخل مجموعة المستندات. يقدم Aspose.PDF لـ Python عبر .NET واجهة برمجة تطبيقات بسيطة ومرنة لأتمتة هذه العملية، مما يتيح لك تطبيق أرقام Bates القياسية برمجيًا عبر أي ملف PDF.

استخدام BatesNArtifact الفئة، يمكن للمطورين تخصيص سلوك الترقيم بالكامل - بما في ذلك رقم البداية وعدد الأرقام والبادئات واللواحق والمحاذاة والهوامش. بمجرد التهيئة، يمكن تطبيق الأداة على Document من خلال add_bates_numbering الطريقة على PageCollection أو تمت إضافتها كجزء من قائمة PaginationArtifact الكائنات. يدعم Aspose.PDF أيضًا نمط التكوين القائم على المندوبين، مما يسمح بالتحكم الديناميكي في إعدادات القطع الأثرية في وقت التشغيل.

بالإضافة إلى إنشاء أرقام Bates، توفر واجهة برمجة التطبيقات طريقة سهلة لإزالتها باستخدام delete_bates_numbering، مما يوفر مرونة كاملة في عمليات سير عمل معالجة المستندات.

تعرض هذه المقالة طرقًا متعددة لإضافة وإزالة ترقيم Bates في ملف PDF باستخدام Aspose.PDF لـ Python عبر .NET، مع أمثلة واضحة لتكوين القطع الأثرية وتطبيقها وإزالتها.

إضافة أداة ترقيم بيتس

يوضح هذا المثال كيفية إضافة ترقيم Bates برمجيًا إلى مستند PDF باستخدام Aspose.PDF لـ Python عبر .NET. من خلال تكوين BatesNArtifact باستخدام الإعدادات المطلوبة وتطبيقها على صفحات المستند، يمكنك أتمتة عملية إضافة معرفات موحدة إلى كل صفحة.

لإضافة قطعة أثرية بترقيم بيتس إلى Document، اتصل بـ AddBatesNumbering(BatesNArtifact) طريقة التمديد على PageCollection، اجتياز BatesNArtifact المثيل كمعامل:

import sys
from os import path
import aspose.pdf as ap

def _create_bates_artifact():
    """Create a Bates numbering artifact with default settings."""
    artifact = ap.BatesNArtifact()
    artifact.start_page = 1
    artifact.end_page = 0
    artifact.subset = ap.Subset.ALL
    artifact.number_of_digits = 6
    artifact.start_number = 1
    artifact.prefix = ""
    artifact.suffix = ""
    artifact.artifact_vertical_alignment = ap.VerticalAlignment.BOTTOM
    artifact.artifact_horizontal_alignment = ap.HorizontalAlignment.RIGHT
    artifact.right_margin = 72
    artifact.left_margin = 72
    artifact.top_margin = 36
    artifact.bottom_margin = 36
    return artifact

import sys
from os import path
import aspose.pdf as ap

def add_bates_n_artifact(infile, outfile):
    """Add Bates numbering artifact to a PDF document."""
    with ap.Document(infile) as document:
        for _ in range(2):
            document.pages.add()

        bates_artifact = _create_bates_artifact()
        ap.PageCollectionExtensions.add_bates_numbering(document.pages, bates_artifact)
        document.save(outfile)

إضافة ترقيم بيتس باستخدام مصنوعات ترقيم الصفحات

أضف ترقيم بيتس إلى ملف PDF باستخدام مجموعة عناصر ترقيم الصفحات في Aspose.PDF لـ Python:

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

import sys
from os import path
import aspose.pdf as ap

def add_bates_n_artifact_pagination(infile, outfile):
    """Add Bates numbering using pagination artifacts collection."""
    with ap.Document(infile) as document:
        for _ in range(2):
            document.pages.add()

        bates_artifact = _create_bates_artifact()
        ap.PageCollectionExtensions.add_pagination(document.pages, [bates_artifact])
        document.save(outfile)

حذف ترقيم بيتس

لإزالة ترقيم بيتس من Document، استخدم delete_bates_numbering() الطريقة على PageCollection:

import sys
from os import path
import aspose.pdf as ap

def delete_bates_numbering(infile, outfile):
    """Delete Bates numbering from a PDF document."""
    with ap.Document(infile) as document:
        ap.PageCollectionExtensions.delete_bates_numbering(document.pages)
        document.save(outfile)

موضوعات القطع الأثرية ذات الصلة

Python-Net: إضافة خلفيات PDF في بايثون

Thu, 11 Jun 2026 00:00:00 +0000

إضافة صورة خلفية إلى PDF

يمكن استخدام صور الخلفية لإضافة علامة مائية أو أي تصميم دقيق آخر إلى المستندات. في Aspose.PDF لـ Python عبر .NET، كل مستند PDF عبارة عن مجموعة من الصفحات وتحتوي كل صفحة على مجموعة من القطع الأثرية. ال قطعة أثرية في الخلفية يمكن استخدام الفئة لإضافة صورة خلفية إلى كائن صفحة.

هذا الأسلوب مفيد عندما تحتاج إلى وضع صورة زخرفية خلف محتوى PDF الرئيسي دون تحويلها إلى نص مستند يمكن البحث فيه.

يوضح مقتطف الشفرة التالي كيفية إضافة صورة خلفية إلى صفحات PDF باستخدام كائن BackgroundArtifact مع Python.

قم بتحميل وثيقة PDF.
قم بإنشاء قطعة أثرية في الخلفية.
قم بتحميل ملف الصورة.
أرفق القطعة الأثرية بصفحة.
احفظ المستند المحدث.


from os import path
from io import FileIO
import aspose.pdf as ap
import sys

def add_background_image_to_pdf(infile, imagefile, outfile):
    """Add a background image to a PDF document as an artifact."""
    with ap.Document(infile) as document:
        artifact = ap.BackgroundArtifact()
        artifact.background_image = FileIO(imagefile, "rb")
        document.pages[1].artifacts.append(artifact)
        document.save(outfile)

أضف صورة خلفية ذات عتامة إلى PDF

أضف صورة خلفية شبه شفافة إلى صفحة PDF باستخدام Aspose.PDF لـ Python.

من خلال تطبيق التعتيم، تصبح صورة الخلفية شفافة جزئيًا، مما يسمح لمحتوى الصفحة الأصلية (النص والصور وما إلى ذلك) بالبقاء مرئيًا بوضوح. هذا مفيد بشكل خاص لـ:

علامات مائية
تراكبات العلامات التجارية
تحسينات التصميم الدقيقة

تتم إضافة الخلفية كقطعة أثرية، مما يضمن بقائها خلف كل محتوى الصفحة.

قم بتحميل وثيقة PDF.
قم بإنشاء قطعة أثرية في الخلفية.
قم بتحميل ملف الصورة.
قم بتعيين مستوى العتامة.
أرفق القطعة الأثرية بصفحة.
احفظ المستند المحدث.


from os import path
from io import FileIO
import aspose.pdf as ap
import sys

def add_background_image_with_opacity_to_pdf(infile, imagefile, outfile):
    """Add a background image with opacity to a PDF document as an artifact."""
    with ap.Document(infile) as document:
        artifact = ap.BackgroundArtifact()
        artifact.background_image = FileIO(imagefile, "rb")
        artifact.opacity = 0.5
        document.pages[1].artifacts.append(artifact)
        document.save(outfile)

إضافة لون خلفية إلى PDF

قم بتطبيق لون خلفية صلب على صفحة PDF باستخدام Aspose.PDF لـ Python.

قم بتحميل وثيقة PDF.
قم بإنشاء قطعة أثرية في الخلفية.
قم بتعيين لون الخلفية.
أرفق القطعة الأثرية بصفحة.
احفظ المستند المحدث.


from os import path
from io import FileIO
import aspose.pdf as ap
import sys

def add_background_color_to_pdf(infile, outfile):
    """Add a solid color background to a PDF document as an artifact."""
    with ap.Document(infile) as document:
        artifact = ap.BackgroundArtifact()
        artifact.background_color = ap.Color.dark_khaki
        document.pages[1].artifacts.append(artifact)
        document.save(outfile)

إزالة الخلفية من PDF

قم بإزالة عناصر الخلفية من صفحة PDF باستخدام Aspose.PDF لـ Python. غالبًا ما يتم تخزين الخلفيات في ملفات PDF كعناصر أثرية، وهذه الطريقة تحدد وتزيل بشكل انتقائي فقط تلك القطع الأثرية المصنفة كعناصر خلفية.

قم بتحميل وثيقة PDF.
عناصر صفحة الوصول.
تصفية القطع الأثرية في الخلفية.
اجمع عناصر الخلفية.
احذف عناصر الخلفية.
احفظ المستند المحدث.


from os import path
from io import FileIO
import aspose.pdf as ap
import sys

def remove_background(infile, outfile):
    with ap.Document(infile) as document:
        backgrounds = [
            artifact
            for artifact in document.pages[1].artifacts
            if artifact.type == ap.Artifact.ArtifactType.PAGINATION
            and artifact.subtype == ap.Artifact.ArtifactSubtype.BACKGROUND
        ]

        for background in backgrounds:
            document.pages[1].artifacts.delete(background)

        document.save(outfile)

موضوعات القطع الأثرية ذات الصلة

Python-Net: إضافة علامات مائية إلى PDF في Python

Thu, 11 Jun 2026 00:00:00 +0000

أضف قطعة أثرية للعلامة المائية إلى PDF Document باستخدام Aspose.PDF لبيثون عبر.NET. العلامة المائية عبارة عن تراكب مرئي يتم تطبيقه على الصفحات لأغراض العلامة التجارية أو الأمان أو المعلومات. يوضح المثال كيفية التكوين TextState المظهر وتحديد المواقع مع HorizontalAlignment و VerticalAlignmentوالدوران والشفافية قبل تطبيق العلامة المائية على Page.

استخراج العلامات المائية من PDF

قم بتحميل وثيقة PDF.
عناصر صفحة الوصول.
تصفية آثار العلامة المائية.
اجمع عناصر العلامة المائية.
استخراج خصائص العلامة المائية.
معلومات العلامة المائية الناتجة.

from os import path
import sys
import aspose.pdf as ap

def extract_watermark_from_pdf(infile):
    with ap.Document(infile) as document:
        watermarks = [
            artifact
            for artifact in document.pages[1].artifacts
            if artifact.type == ap.Artifact.ArtifactType.PAGINATION
            and artifact.subtype == ap.Artifact.ArtifactSubtype.WATERMARK
        ]

        for watermark in watermarks:
            print(f"{watermark.text} {watermark.rectangle}")

إضافة علامة مائية إلى PDF

أضف علامة مائية نصية إلى مستند PDF باستخدام Aspose.PDF لـ Python:

قم بتحميل وثيقة PDF.
قم بإنشاء حالة نصية.
قم بإنشاء قطعة أثرية للعلامة المائية.
قم بتعيين نص العلامة المائية ونمطها.
تكوين تحديد المواقع والدوران.
قم بتعيين العتامة وسلوك الخلفية.
أرفق العلامة المائية بصفحة.
احفظ المستند المحدث.

from os import path
import sys
import aspose.pdf as ap

def add_watermark_artifact(infile, outfile):
    with ap.Document(infile) as document:
        text_state = ap.text.TextState()
        text_state.font_size = 72
        text_state.foreground_color = ap.Color.blue_violet
        text_state.font_style = ap.text.FontStyles.BOLD
        text_state.font = ap.text.FontRepository.find_font("Arial")

        watermark = ap.WatermarkArtifact()
        watermark.set_text_and_state("WATERMARK", text_state)
        watermark.artifact_horizontal_alignment = ap.HorizontalAlignment.CENTER
        watermark.artifact_vertical_alignment = ap.VerticalAlignment.CENTER
        watermark.rotation = 60
        watermark.opacity = 0.2
        watermark.is_background = True

        document.pages[1].artifacts.append(watermark)
        document.save(outfile)

قم بإزالة آثار العلامة المائية من صفحة PDF

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

قم بتحميل وثيقة PDF.
عناصر صفحة الوصول.
تصفية آثار العلامة المائية.
احذف عناصر العلامة المائية.
احفظ المستند المحدث.

from os import path
import sys
import aspose.pdf as ap

def delete_watermark_artifact(infile, outfile):
    with ap.Document(infile) as document:
        watermarks = [
            artifact
            for artifact in document.pages[1].artifacts
            if artifact.type == ap.Artifact.ArtifactType.PAGINATION
            and artifact.subtype == ap.Artifact.ArtifactSubtype.WATERMARK
        ]

        for watermark in watermarks:
            document.pages[1].artifacts.delete(watermark)

        document.save(outfile)

موضوعات القطع الأثرية ذات الصلة

Python-Net: عد مصنوعات PDF في بايثون

Thu, 11 Jun 2026 00:00:00 +0000

عد القطع الأثرية من نوع معين

فحص وإحصاء آثار ترقيم الصفحات في ملف PDF Document باستخدام Aspose.PDF لبيثون عبر.NET. تتضمن عناصر ترقيم الصفحات عناصر مثل العلامات المائية والخلفيات والرؤوس والتذييلات التي يتم تطبيقها على الصفحات لأغراض التخطيط والتعريف. عن طريق التصفية Artifact الكائنات الموجودة على Page وتجميعها حسب النوع الفرعي (Artifact.ArtifactSubtype)، يمكن للمطورين تحليل بنية المستند بسرعة والتحقق من وجود عناصر محددة.

لحساب العدد الإجمالي للقطع الأثرية من نوع معين (على سبيل المثال، العدد الإجمالي للعلامات المائية)، استخدم التعليمة البرمجية التالية. يقوم المثال بتصفية الصفحات Artifacts مجموعة (و) ArtifactCollection) بواسطة Artifact.ArtifactType ثم يحسب الأنواع الفرعية (Artifact.ArtifactSubtype).

افتح وثيقة PDF (انظر Document).
تصفية عناصر ترقيم الصفحات باستخدام الصفحة Artifacts مجموعة.
عد القطع الأثرية حسب النوع الفرعي (Artifact.ArtifactSubtype).
نتائج الطباعة.


from os import path
from collections import Counter
import sys
import aspose.pdf as ap

def count_pdf_artifacts(infile):
    """Count and display artifacts of different types on the first page."""
    with ap.Document(infile) as document:
        pagination_artifacts = [
            artifact
            for artifact in document.pages[1].artifacts
            if artifact.type == ap.Artifact.ArtifactType.PAGINATION
        ]

        subtypes = [artifact.subtype for artifact in pagination_artifacts]
        counts = Counter(subtypes)

        print(f"Watermarks: {counts.get(ap.Artifact.ArtifactSubtype.WATERMARK, 0)}")
        print(f"Backgrounds: {counts.get(ap.Artifact.ArtifactSubtype.BACKGROUND, 0)}")
        print(f"Headers: {counts.get(ap.Artifact.ArtifactSubtype.HEADER, 0)}")
        print(f"Footers: {counts.get(ap.Artifact.ArtifactSubtype.FOOTER, 0)}")

موضوعات القطع الأثرية ذات الصلة

Python-Net: إدارة رؤوس وتذييلات PDF باستخدام Python

Thu, 11 Jun 2026 00:00:00 +0000

إنشاء عناصر نصية ذات نمط

تشرح وظيفة الأداة المساعدة هذه كيفية إنشاء قطعة أثرية نصية قابلة لإعادة الاستخدام لصفحات PDF باستخدام Aspose.PDF لـ Python. تم تصميمه لإنشاء رؤوس أو تذييلات ذات نمط بتنسيق متسق، بما في ذلك إعدادات الخط واللون والحجم والمحاذاة. تقوم الوظيفة بتلخيص إنشاء القطع الأثرية بحيث يمكن إعادة استخدامها لزخارف نصية مختلفة على مستوى الصفحة.

قم بإنشاء مثيل لكائن القطع الأثرية.
قم بتعيين محتوى نص قطعة أثرية.
قم بتطبيق نمط النص.
اضبط المحاذاة.
قم بإرجاع قطعة أثرية تم تكوينها.

from os import path
import aspose.pdf as ap
import sys

def _create_text_artifact(artifact_class, text):
    """Create a text artifact (header/footer) with common styling."""
    artifact = artifact_class()
    artifact.text = text
    artifact.text_state.font_size = 14
    artifact.text_state.font = ap.text.FontRepository.find_font("Arial")
    artifact.text_state.foreground_color = ap.Color.navy
    artifact.artifact_horizontal_alignment = ap.HorizontalAlignment.CENTER
    return artifact

إضافة رأس إلى PDF

افتح ملف PDF المُدخل.
قم بإنشاء HeaderArtifact بنص «نموذج رأس».
قم بإلحاقه بالصفحة الأولى.
احفظ ملف PDF المحدث.

from os import path
import aspose.pdf as ap
import sys

def add_header_artifact(infile, outfile):
    """Add a header artifact to the first page of a PDF document."""
    with ap.Document(infile) as document:
        header = _create_text_artifact(ap.HeaderArtifact, "Sample Header")
        document.pages[1].artifacts.append(header)
        document.save(outfile)

إضافة تذييل إلى PDF

افتح ملف PDF المُدخل.
قم بإنشاء أداة تذييل تحتوي على نص «نموذج تذييل الصفحة».
قم بإلحاقه بالصفحة الأولى.
احفظ ملف الإخراج.

from os import path
import aspose.pdf as ap
import sys

def add_footer_artifact(infile, outfile):
    """Add a footer artifact to the first page of a PDF document."""
    with ap.Document(infile) as document:
        footer = _create_text_artifact(ap.FooterArtifact, "Sample Footer")
        document.pages[1].artifacts.append(footer)
        document.save(outfile)

حذف عناصر رأس الصفحة أو تذييلها

افتح ملف PDF.
ابحث عن القطع الأثرية التي تم وضع علامة عليها كرؤوس أو تذييلات لترقيم الصفحات.
قم بإزالتها من الصفحة الأولى.
احفظ المستند الذي تم تنظيفه.

from os import path
import aspose.pdf as ap
import sys

def delete_header_footer_artifact(infile, outfile):
    with ap.Document(infile) as document:
        header_footers = [
            artifact
            for artifact in document.pages[1].artifacts
            if artifact.type == ap.Artifact.ArtifactType.PAGINATION
            and (
                artifact.subtype == ap.Artifact.ArtifactSubtype.HEADER
                or artifact.subtype == ap.Artifact.ArtifactSubtype.FOOTER
            )
        ]

        for art in header_footers:
            document.pages[1].artifacts.delete(art)

        document.save(outfile)