Documentation – العمل مع روابط PDF في بايثون

Python-Net: إنشاء روابط PDF في بايثون

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

روابط في مستندات PDF

وفقًا لمواصفات PDF 1.7 (ISO 32000-1:2008)، يمكن أن يؤدي التعليق التوضيحي للرابط ** إلى تشغيل عدة أنواع من الإجراءات التي تحدد ما يحدث عند تنشيط التعليق التوضيحي. فيما يلي الإجراءات الأساسية المدعومة:

GoTo - ينتقل إلى وجهة داخل نفس المستند.
GoTor - ينتقل إلى وجهة في ملف PDF آخر (الانتقال عن بُعد).
URI - يفتح معرف مورد موحد، عادةً رابط ويب.
إطلاق - يقوم بتشغيل تطبيق أو فتح ملف (يعتمد على النظام الأساسي وغالبًا ما يكون مقيدًا للأمان).
Named - ينفذ إجراءً محددًا مسبقًا، مثل الانتقال إلى الصفحة التالية أو طباعة المستند.
جافا سكريبت - ينفذ شفرة جافا سكريبت المضمنة (تُستخدم بحذر بسبب مخاوف أمنية).
submitForm - يرسل بيانات النموذج إلى عنوان URL محدد.
ResetForm - يعيد تعيين حقول النموذج إلى قيمها الافتراضية.
** ImportData** - استيراد البيانات إلى المستند من ملف خارجي.

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

لإنشاء رابط تطبيق بـ «LaunchAction»:

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

def create_link_annotation_launch_action(infile, outfile):
    document = ap.Document(infile)
    page = document.pages[1]

    link = ap.annotations.LinkAnnotation(page, ap.Rectangle(10, 580, 120, 600, True))
    border = ap.annotations.Border(link)
    border.width = 5
    border.dash = ap.annotations.Dash(1, 1)
    link.color = ap.Color.green
    link.action = ap.annotations.LaunchAction(document, "sample.pdf")
    page.annotations.append(link)
    document.save(outfile)

إنشاء رابط مستند PDF في ملف PDF

استخدام «الانتقال إلى العمل عن بُعد»

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

افتح مستند PDF
حدد الصفحة الثانية من المستند (الفهرس 1)
إنشاء تعليق توضيحي للرابط:
تم وضعه عند الإحداثيات (10، 580، 120، 600)
أخضر ملون
روابط إلى ‘sample.pdf’ على صفحتها الأولى
أضف التعليق التوضيحي للرابط إلى الصفحة
احفظ المستند المعدل إلى مسار ملف الإخراج

لإنشاء رابط مستند PDF باستخدام «GoToreRemoteAction»:

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

def create_link_annotation_go_to_remote_action(infile, outfile):
    document = ap.Document(infile)
    page = document.pages[1]

    link = ap.annotations.LinkAnnotation(page, ap.Rectangle(10, 580, 120, 600, True))
    link.color = ap.Color.green
    link.action = ap.annotations.GoToRemoteAction("sample.pdf", 1)
    page.annotations.append(link)
    document.save(outfile)

استخدام GoToAction

يوضح هذا الرمز كيفية إضافة تعليق توضيحي للرابط إلى صفحة معينة من مستند PDF باستخدام Aspose.PDF لـ Python. يظهر الارتباط كمستطيل أخضر ذو حدود متقطعة ويسمح للمستخدم بالانتقال إلى صفحة أخرى داخل نفس ملف PDF. لإنشاء رابط مستند PDF باستخدام «GoToAction»:

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

def create_link_annotation_go_to_action(infile, outfile):
    document = ap.Document(infile)
    page = document.pages[1]

    link = ap.annotations.LinkAnnotation(page, ap.Rectangle(10, 580, 120, 600, True))
    border = ap.annotations.Border(link)
    border.width = 5
    border.dash = ap.annotations.Dash(1, 1)
    link.color = ap.Color.green
    if document.pages.length >= 4:
        link.action = ap.annotations.GoToAction(document.pages[4])
    else:
        link.action = ap.annotations.GoToAction(document.pages[document.pages.length])
    page.annotations.append(link)
    document.save(outfile)

تطبيق GoTouriAction

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

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

قم بتحميل وثيقة PDF. افتح ملف PDF الموجود باستخدام AP.document.
قم بالوصول إلى الصفحة الأولى. استخدم document.pages [1] للوصول إلى الصفحة الأولى (يستخدم Aspose الفهرسة المستندة إلى 1).
قم بإنشاء تعليق توضيحي للرابط. قم بإنشاء كائن LinkAnNotation وحدد المنطقة المستطيلة القابلة للنقر باستخدام AP.Rectangle.
تعيين مظهر التعليق التوضيحي. قم بتعيين لون التعليق التوضيحي إلى اللون الأخضر باستخدام link.color = AP.color.green.
قم بتعيين إجراء URI. استخدم GoTouriAction لربط التعليق التوضيحي بعنوان URL خارجي.
أضف التعليق التوضيحي إلى الصفحة. قم بإلحاق التعليق التوضيحي للرابط الذي تم تكوينه بمجموعة التعليقات التوضيحية للصفحة الأولى.
احفظ المستند المعدل. احفظ مستند PDF المحدث إلى مسار الإخراج المحدد.

import aspose.pdf as ap
from os import path
import sys
    
def create_link_annotation_go_to_URI_action(infile, outfile):
    document = ap.Document(infile)
    page = document.pages[1]

    link = ap.annotations.LinkAnnotation(page, ap.Rectangle(10, 580, 120, 600, True))
    link.color = ap.Color.green
    link.action = ap.annotations.GoToURIAction("https://docs.aspose.com/pdf/python")
    page.annotations.append(link)
    document.save(outfile)

موضوعات الارتباط ذات الصلة

Python-Net: تحديث روابط PDF في بايثون

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

تحديث لون نص التعليق على الرابط

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

يمكن استخدام هذا من أجل:

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

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

import aspose.pdf as ap
import sys
from os import path
from aspose.pycore import cast, is_assignable

def link_annotation_update_text_color(infile, outfile):
    document = ap.Document(infile)
    link_annotations = [
        a
        for a in document.pages[1].annotations
        if (a.annotation_type == ap.annotations.AnnotationType.LINK)
    ]

    for la in link_annotations:
        ta = ap.text.TextFragmentAbsorber()
        rect = la.rect
        rect.llx -= 2
        rect.lly -= 2
        rect.urx += 2
        rect.ury += 2
        ta.text_search_options = ap.text.TextSearchOptions(rect)
        ta.visit(document.pages[1])
        for textFragment in ta.text_fragments:
            textFragment.text_state.foreground_color = ap.Color.red

    document.save(outfile)

تحديث الحدود

يركز البرنامج النصي على الصفحة الأولى من المستند ويقوم بتصفية جميع التعليقات التوضيحية، مع تحديد التعليقات التوضيحية فقط من نوع LINK - وهي عادةً ما تمثل عناصر تفاعلية، مثل الارتباطات التشعبية أو مشغلات التنقل. بالنسبة لكل من هذه التعليقات التوضيحية للروابط، ترسلها الشفرة إلى نوع LinkAnNotation وتقوم بتحديث خاصية اللون الخاصة بها إلى اللون الأحمر، مع إبرازها بصريًا لتبرز عن المحتوى الآخر. بعد تعديل جميع التعليقات التوضيحية للروابط، يتم حفظ المستند المحدث في موقع الإخراج المحدد، مع الحفاظ على النمط الجديد.

import aspose.pdf as ap
import sys
from os import path
from aspose.pycore import cast, is_assignable

def link_annotation_update_border(infile, outfile):
    document = ap.Document(infile)
    link_annotations = [
        a
        for a in document.pages[1].annotations
        if (a.annotation_type == ap.annotations.AnnotationType.LINK)
    ]

    for la in link_annotations:
        link_annotation = cast(ap.annotations.LinkAnnotation, la)
        link_annotation.color = ap.Color.red

    document.save(outfile)

تحديث وجهة الويب

بمجرد وضع المسارات، يتم تحميل المستند الأصلي باستخدام مكتبة Aspose.PDF، مما يجعل محتواه متاحًا للتعديل. ثم يركز البرنامج النصي على الصفحة الأولى من المستند، ويقوم بتصفية جميع التعليقات التوضيحية وتحديد تلك التي من نوع الارتباط فقط، والتي تمثل عادةً مناطق قابلة للنقر أو ارتباطات تشعبية. لتجنب أخطاء الكتابة وضمان المعالجة الآمنة، يتم فحص كل تعليق توضيحي باستخدام is_assignable ثم إرساله إلى نوع LinkAnNotation المناسب. إذا كان الرابط مرتبطًا بـ GoTouriAction، مما يعني أنه يشير إلى عنوان ويب، فإن البرنامج النصي يقوم بتحديث عنوان URI هذا لإعادة توجيه المستخدمين إلى»https://www.aspose.com". أخيرًا، بعد تطبيق جميع التغييرات المطلوبة، يتم حفظ المستند المعدل في مسار الإخراج المحدد.

import aspose.pdf as ap
import sys
from os import path
from aspose.pycore import cast, is_assignable

def link_annotation_update_web_destination(infile, outfile):
    document = ap.Document(infile)
    link_annotations = [
        a
        for a in document.pages[1].annotations
        if (a.annotation_type == ap.annotations.AnnotationType.LINK)
    ]

    for la in link_annotations:
        if is_assignable(la, ap.annotations.LinkAnnotation):
            annotation = cast(ap.annotations.LinkAnnotation, la)
            if is_assignable(annotation.action, ap.annotations.GoToURIAction):
                action = cast(ap.annotations.GoToURIAction, annotation.action)
                action.uri = "https://www.aspose.com"
    document.save(outfile)

موضوعات الارتباط ذات الصلة

Python-Net: استخراج روابط PDF في بايثون

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

استخراج الروابط من ملف PDF

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

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

قم بتحميل وثيقة PDF. استخدم AP.document (path_infile) لفتح الملف.
يمكنك الوصول إلى التعليقات التوضيحية من الصفحة الأولى. استخدم document.pages [1] .التعليقات التوضيحية لاسترداد جميع التعليقات التوضيحية.
عامل تصفية لأنواع LinkAnNotation فقط. تحقق من نوع التعليق التوضيحي لكل تعليق توضيحي.
إرسال ملاحظات الارتباط ومعالجتها. استخدم is_assignable () و cast () لضمان الوصول الآمن إلى خصائص linkAnNotation.
طباعة تفاصيل التعليق التوضيحي. قم بإخراج فهرس الصفحة والمستطيل (الموقع) لكل رابط.

import aspose.pdf as ap
import sys
from os import path
from aspose.pycore import cast, is_assignable

def extract_link_annotation(infile):

    document = ap.Document(infile)
    link_annotations = [
        a
        for a in document.pages[1].annotations
        if (a.annotation_type == ap.annotations.AnnotationType.LINK)
    ]

    for la in link_annotations:
        if is_assignable(la, ap.annotations.LinkAnnotation):
            annotation = cast(ap.annotations.LinkAnnotation, la)
            print(f"Page: {annotation.page_index}, location: {annotation.rect}")

استخراج الارتباطات التشعبية من ملف PDF

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

هذا مفيد لمهام مثل:

تدقيق الروابط الخارجية في PDF
استخراج الوثائق أو عناوين URL للدعم
اكتشاف الارتباطات التشعبية المعطلة أو القديمة

قم بتحميل وثيقة PDF. افتح الملف باستخدام AP.Document.
احصل على جميع التعليقات التوضيحية للروابط من الصفحة الأولى. قم بتصفية التعليقات التوضيحية لتشمل فقط تلك التي تحتوي على النوع AnnotationType.link.
تحقق من الكتابة ثم قم بالإرسال إلى LinkAnNotation. تأكد من أن كل تعليق توضيحي هو بالفعل LinkAnNotation قبل الوصول إلى خصائصه.
تحقق من نوع إجراء الارتباط. تصفية الروابط التي تستخدم GoTouriAction (أي الروابط إلى عنوان URL على الويب).
قم باستخراج وطباعة URI وفهرس الصفحة. استخدم .uri للحصول على الرابط الخارجي و.page_index للسياق.

import aspose.pdf as ap
import sys
from os import path
from aspose.pycore import cast, is_assignable

def extract_hyperlinks(infile):
    document = ap.Document(infile)
    link_annotations = [
        a
        for a in document.pages[1].annotations
        if (a.annotation_type == ap.annotations.AnnotationType.LINK)
    ]

    for la in link_annotations:
        if is_assignable(la, ap.annotations.LinkAnnotation):
            annotation = cast(ap.annotations.LinkAnnotation, la)
            if is_assignable(annotation.action, ap.annotations.GoToURIAction):
                action = cast(ap.annotations.GoToURIAction, annotation.action)
                print(f"Page {annotation.page_index}, URI:{action.uri}")