Menggabungkan PDF Tanpa Meratakan Semuanya Menjadi Imej
Gabungan PDF yang betul merangkaikan aliran halaman: fon, vektor, dan penanda buku kekal utuh. Meraster setiap halaman menjadi imej ialah kerja yang lebih rugi.
"Gabungkan lima PDF ini" boleh bermakna dua pipeline. Satu merangkaikan objek halaman sedia ada menjadi satu fail. Satu lagi mencetak setiap halaman ke bitmap lalu mengemas imej tersebut ke dalam PDF baharu. Kedua-duanya menghasilkan satu lampiran. Hanya yang pertama mengekalkan teks yang boleh dipilih dan vektor yang tajam.
Apa yang dilakukan oleh gabungan struktur
Di PDF123, Gabungkan PDF menggabungkan dua atau lebih PDF dengan menyambungkan objek halaman setiap fail. Laluan pelayan menjalankan qpdf dengan asas kosong dan --pages ke atas input: aliran halaman berpindah sebagai halaman, bukan sebagai tangkapan skrin. Fon tertanam, vektor, dan penanda buku sedia ada turut berpindah bersama halaman tersebut. Tiada apa-apa dalam laluan itu yang meraster halaman menjadi imej, jadi fail digital itu masih boleh dicari dan disalin selepas gabungan.
Susunan muat naik ialah susunan keluaran secara lalai. Borang HTTP menerima bahagian fileInput berulang dalam satu permintaan; saiz kelompok dihadkan oleh had muat naik, bukan oleh had tetap dua fail. Pilihan sortType=byFileName menyusun semula input mengikut nama fail sebelum gabungan. Penanda buku daripada setiap sumber boleh bertahan; gabungan tidak mencipta pokok rangka yang sempurna jika input tidak pernah memilikinya.
Muat naik satu fail ialah laluan terus tanpa perubahan bagi PDF itu. Dua fail atau lebih menjadi satu merged.pdf yang halamannya ialah gabungan input dalam susunan yang dipilih. ID operasi yang sama itulah yang didedahkan oleh OpenAPI, MCP, dan pdfx merge, supaya skrip dan klik pelayar tidak berselisih secara senyap tentang erti "merge."
Bila orang meraster secara tidak sengaja
Sesetengah aliran kerja "combine" mengeksport ke imej terlebih dahulu (gateway faks, aplikasi imbasan, print-to-PDF pada resolusi skrin) atau meratakan anotasi menjadi bitmap sebelum menggabungkan. Saiz fail melonjak, OCR mungkin diperlukan semula, dan zoom menunjukkan tepi piksel.
Utamakan gabungan aliran apabila sumbernya sudah PDF digital. Utamakan OCR hanya apabila input ialah imbasan tanpa teks yang boleh digunakan, dan ingat bahawa OCR di sini memulangkan Markdown (text/markdown), bukan PDF yang dilapisi semula dengan lapisan teks tersembunyi. Meraster kemudian menjalankan OCR ialah laluan produk yang berbeza daripada menggabungkan fail digital.
Jika anda memerlukan imej halaman, itu tugasan tukar format (PDF ke imej), bukan gabungan. Mencampurkan niat itu menyebabkan fail "merged" menjadi album foto dokumen berbilang megabait. Mampatkan PDF selepas gabungan struktur masih boleh mengecilkan aliran (Mampatkan PDF); ia tidak membatalkan perataan raster yang sudah tertanam.
Apa yang tidak dijanjikan oleh merge
Gabungkan PDF tidak menormalkan saiz halaman, menyatukan fon merentas fail, atau membina semula senarai kandungan daripada kosong. Ia tidak menyahsulitkan input yang disulitkan untuk anda; buka kunci dahulu jika sumbernya dilindungi kata laluan. Ia tidak menggantikan format bekas portfolio/pakej yang dijangka oleh sesetengah portal mahkamah; ia menghasilkan satu PDF berbilang halaman yang biasa.
Had tersebut sama sama ada anda menggunakan pelayar, REST, MCP, atau pdfx. Skop operasi ini sengaja dikecilkan supaya outputnya kekal boleh diramal untuk automasi. Jika anda memerlukan kerja berbilang langkah yang tersusun (merge, kemudian watermark, kemudian compress), gunakan POST /api/v1/pipeline dengan senarai steps yang tersusun, daripada mencipta bendera "smart merge" yang kedua.
Cara menjalankannya
Gabungkan PDF dalam pelayar, atau POST /api/v1/general/merge-pdfs dengan bahagian fileInput berulang (Pembangun). Daripada shell:
pdfx merge a.pdf b.pdf -o merged.pdf
Atau terhadap asas yang dihoskan atau self-host:
pdfx --cloud --api-base "$API_BASE" --api-key "$KEY" merge a.pdf b.pdf -o merged.pdf
Panggilan katalog tanpa nama tidak memerlukan kunci di tapak awam; kunci diperlukan untuk identiti automasi yang stabil dan untuk pelayan self-host yang dikawal. Untuk operasi yang sama melalui curl dan MCP juga, lihat Operasi sama, empat klien.