Documentation – Bekerja dengan Tautan PDF di Python

Python-Net: Buat Tautan PDF di Python

Fri, 12 Jun 2026 00:00:00 +0000

Tautan dalam Dokumen PDF

Menurut spesifikasi PDF 1.7 (ISO 32000-1:2008), sebuah Link annotation dapat memicu beberapa jenis aksi yang menentukan apa yang terjadi ketika anotasi tersebut diaktifkan. Berikut adalah aksi utama yang didukung:

GoTo – Menavigasi ke tujuan dalam dokumen yang sama.
GoToR – Melompat ke tujuan di file PDF lain (go-to remote).
URI – Membuka uniform resource identifier, biasanya sebuah tautan web.
Launch – Meluncurkan aplikasi atau membuka file (tergantung platform dan sering dibatasi untuk keamanan).
Named – Menjalankan aksi yang telah ditentukan, seperti pergi ke halaman berikutnya atau mencetak dokumen.
JavaScript – Menjalankan kode JavaScript yang tertanam (digunakan dengan hati-hati karena masalah keamanan).
SubmitForm – Mengirim data formulir ke URL yang ditentukan.
ResetForm – Mengatur ulang bidang formulir ke nilai defaultnya.
ImportData – Mengimpor data ke dalam dokumen dari file eksternal.

Dengan menambahkan tautan ke aplikasi ke dalam dokumen, dimungkinkan untuk menautkan ke aplikasi dari sebuah dokumen. Ini berguna ketika Anda ingin pembaca melakukan tindakan tertentu pada titik tertentu dalam tutorial, misalnya, atau untuk membuat dokumen yang kaya fitur.

Untuk membuat tautan aplikasi dengan ‘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)

Buat Tautan Dokumen PDF dalam File PDF

Menggunakan GoToRemoteAction

Potongan kode ini menunjukkan cara menambahkan anotasi tautan ke halaman tertentu dari dokumen PDF menggunakan perpustakaan Python PDF.

Buka dokumen PDF
Pilih halaman kedua dari dokumen (indeks 1)
Buat anotasi tautan:
Diposisikan pada koordinat (10, 580, 120, 600)
Berwarna hijau
Tautan ke ‘sample.pdf’ pada halaman pertamanya
Tambahkan anotasi tautan ke halaman
Simpan dokumen yang dimodifikasi ke jalur file output

Untuk membuat tautan dokumen PDF menggunakan ‘GoToRemoteAction’:

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)

Menggunakan GoToAction

Kode ini menunjukkan cara menambahkan anotasi tautan ke halaman tertentu dari dokumen PDF menggunakan Aspose.PDF untuk Python. Tautan muncul sebagai persegi panjang berwarna hijau dengan batas garis putus-putus dan memungkinkan pengguna untuk menavigasi ke halaman lain dalam PDF yang sama. Untuk membuat tautan dokumen PDF menggunakan ‘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)

Menerapkan GoToURIAction

Contoh berikut menunjukkan cara menambahkan anotasi tautan ke dokumen PDF menggunakan Aspose.PDF for Python. Tautan tersebut muncul sebagai area berwarna hijau yang dapat diklik pada halaman pertama, dan ketika diklik, itu membuka dokumentasi Aspose.PDF for Python di peramban web melalui GoToURIAction.

Fungsionalitas ini berguna untuk menyematkan referensi eksternal yang membantu, dokumentasi, atau tautan dukungan secara langsung di dalam PDF Anda.

Muat Dokumen PDF. Buka file PDF yang ada menggunakan ap.Document.
Akses Halaman Pertama. Gunakan document.pages[1] untuk mengakses halaman pertama (Aspose menggunakan indeks berbasis 1).
Buat Anotasi Tautan. Buat objek LinkAnnotation dan tentukan area persegi panjang yang dapat diklik menggunakan ap.Rectangle.
Atur Penampilan Anotasi. Atur warna anotasi menjadi hijau menggunakan link.color = ap.Color.green.
Tetapkan Tindakan URI. Gunakan GoToURIAction untuk menautkan anotasi ke URL eksternal.
Tambahkan Anotasi ke Halaman. Tambahkan anotasi tautan yang telah dikonfigurasi ke koleksi anotasi halaman pertama.
Simpan Dokumen yang Dimodifikasi. Simpan dokumen PDF yang diperbarui ke jalur keluaran yang ditentukan.

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)

Topik Tautan Terkait

Python-Net: Perbarui Tautan PDF di Python

Fri, 12 Jun 2026 00:00:00 +0000

Perbarui Warna Teks LinkAnnotation

Contoh ini menunjukkan cara mendeteksi semua anotasi tautan pada halaman pertama PDF menggunakan Aspose.PDF for Python, kemudian menyorot teks di dekat setiap tautan dengan mengubah warna fontnya menjadi merah. Ini menggunakan TextFragmentAbsorber dengan area yang sedikit diperluas di sekitar setiap persegi panjang tautan untuk menemukan dan memodifikasi teks di sekitarnya.

Ini dapat digunakan untuk:

Menandai tautan secara visual dalam dokumen
Meningkatkan aksesibilitas dengan menekankan konten yang terhubung
Pra-pemrosesan file PDF sebelum peninjauan atau ekspor

Untuk setiap anotasi tautan ini, skrip mengambil batas persegi panjangnya dan sedikit memperluas wilayah tersebut untuk menyertakan teks di sekitarnya, memungkinkan identifikasi visual yang lebih luas. Kemudian skrip menerapkan TextFragmentAbsorber pada area yang diperluas ini untuk mengekstrak semua fragmen teks yang berada di dalamnya. Fragmen yang ditangkap tersebut diubah dengan mengubah warna font menjadi merah, secara efektif menandai teks di sekitarnya untuk penekanan dan peninjauan. Setelah semua pembaruan ini diterapkan, dokumen yang dimodifikasi disimpan ke jalur output, mempertahankan anotasi yang disorot serta teks yang terkait.

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)

Perbarui Bingkai

Skrip ini berfokus pada halaman pertama dokumen dan menyaring semua anotasi, memilih hanya yang berjenis LINK—biasanya ini mewakili elemen interaktif, seperti tautan hiperteks atau pemicu navigasi. Untuk setiap anotasi tautan ini, kode mengubahnya menjadi tipe LinkAnnotation dan memperbarui properti warna mereka menjadi merah, menyorotnya secara visual agar menonjol dari konten lainnya. Setelah semua anotasi tautan dimodifikasi, dokumen yang diperbarui disimpan ke lokasi output yang telah ditentukan, menjaga gaya baru tersebut.

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)

Perbarui Tujuan Web

Setelah jalur-jalur berada di tempatnya, dokumen asli dimuat menggunakan perpustakaan Aspose.PDF, membuat isinya dapat diakses untuk dimodifikasi. Skrip kemudian memfokuskan pada halaman pertama dokumen, menyaring semua anotasi dan memilih hanya yang berjenis tautan, biasanya mewakili area yang dapat diklik atau hyperlink. Untuk menghindari kesalahan tipe dan memastikan penanganan yang aman, setiap anotasi diperiksa dengan is_assignable dan kemudian di‑cast ke tipe LinkAnnotation yang sesuai. Jika tautan terkait dengan GoToURIAction, artinya menunjuk ke alamat web, skrip memperbarui URI tersebut untuk mengarahkan pengguna ke “https://www.aspose.com”. Akhirnya, setelah semua perubahan yang diinginkan diterapkan, dokumen yang dimodifikasi disimpan ke jalur output yang ditentukan.

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)

Topik Tautan Terkait

Python-Net: Ekstrak Tautan PDF dalam Python

Fri, 12 Jun 2026 00:00:00 +0000

Ekstrak Tautan dari File PDF

Contoh ini menunjukkan cara mengiterasi semua anotasi tautan pada halaman pertama PDF menggunakan Aspose.PDF for Python. Ia menyaring anotasi untuk mengidentifikasi yang bertipe LinkAnnotation, melakukan casting secara aman, dan kemudian mencetak indeks halaman serta posisi persegi panjangnya pada halaman.

Ini dapat digunakan untuk debugging, analitik, atau pembaruan otomatis pada anotasi tautan yang ada dalam PDF.

Muat dokumen PDF. Gunakan ap.Document(path_infile) untuk membuka file.
Akses anotasi dari halaman pertama. Gunakan document.pages[1].annotations untuk mengambil semua anotasi.
Saring hanya tipe LinkAnnotation. Periksa annotation_type setiap anotasi.
Lakukan casting dan proses LinkAnnotations. Gunakan is_assignable() dan cast() untuk memastikan akses yang aman ke properti LinkAnnotation.
Cetak detail anotasi. Keluarkan indeks halaman dan persegi panjang (lokasi) dari setiap tautan.

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}")

Ekstrak HyperLink dari File PDF

Kode ini menunjukkan cara mengekstrak semua objek LinkAnnotation dari halaman pertama dokumen PDF menggunakan Aspose.PDF for Python, dan kemudian mengidentifikasi yang mengandung GoToURIAction. Untuk setiap tautan semacam itu, ia mencetak indeks halaman dan URI target.

Ini berguna untuk tugas seperti:

Mengaudit tautan eksternal dalam PDF
Mengekstrak URL dokumentasi atau dukungan
Mendeteksi hyperlink yang rusak atau kedaluwarsa

Muat dokumen PDF. Buka file menggunakan ap.Document.
Dapatkan semua anotasi tautan dari halaman pertama. Saring anotasi untuk hanya menyertakan yang berjenis AnnotationType.LINK.
Periksa tipe dan lakukan casting ke LinkAnnotation. Pastikan setiap anotasi memang merupakan LinkAnnotation sebelum mengakses propertinya.
Periksa tipe aksi tautan. Saring tautan yang menggunakan GoToURIAction (yaitu, tautan ke URL web).
Ekstrak dan cetak URI serta indeks halaman. Gunakan .uri untuk mendapatkan tautan eksternal dan .page_index untuk konteks.

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}")