PDF terbuka alih-alih terunduh: periksa tautannya

Tentukan dahulu kebutuhan penerima PDF

Anda mengirim program acara dengan tombol Unduh, tetapi dokumen muncul di tab. Orang lain menerima unduhan padahal ingin membaca langsung. Tidak satu pun keadaan ini membuktikan sendiri bahwa tautannya rusak. Sebelum mengganti URL, tentukan apakah Anda ingin memudahkan membaca, memberikan salinan, atau menyediakan keduanya. Lalu periksa apa yang benar-benar terjadi pada perangkat penerima ketika membuka alamat yang dikirim, bukan hanya berdasarkan harapan Anda pada komputer sendiri.

Pertanyaan yang ditinjau menunjukkan dua kebutuhan berbeda: mengunduh PDF eksternal melalui HTML dan menampilkannya meskipun preferensi peramban berbeda. Panduan ini menggunakan program publik sebagai contoh. WikiURL membantu memeriksa respons dan tujuan URL; alat ini tidak mengatur server dokumen atau menggantikan penampil milik pengunjung. Mulailah dengan memisahkan isi yang diminta, petunjuk server yang menyajikannya, dan cara setiap peramban menafsirkan petunjuk tersebut dalam lingkungan penerima yang sebenarnya sebelum menentukan tindakan yang sesuai.

Header respons mengarahkan penyajian berkas

MDN menjelaskan bahwa Content-Disposition menunjukkan penyajian dalam peramban atau perlakuan sebagai lampiran. RFC 6266 mendefinisikan inline dan attachment. Contoh memperlihatkan dua respons alternatif, bukan satu blok yang dikirim bersamaan. Content-Type menyatakan jenis PDF dan filename menyarankan nama. Ini adalah header respons server yang memberikan berkas. Menulis kata-kata tersebut pada tombol atau menambahkannya ke alamat tidak mengatur respons server dan tidak otomatis mengubah perilaku berkas ketika diterima pembaca.

Inline menyatakan maksud menampilkan isi, sedangkan attachment meminta penanganan sebagai unduhan. Hal ini tidak menjamin pengalaman visual yang sama: MDN mencatat pengaruh peramban, pengaturan, dan faktor lain. Unduhan dapat tersimpan otomatis atau terbuka sesudahnya. Minta pengelola hosting memeriksa respons sebenarnya dari berkas akhir. Jangan meminta perubahan global untuk setiap dokumen situs jika hanya perilaku satu program acara yang perlu diselesaikan. Perubahan sebaiknya sesuai kebutuhan konkret dan diperiksa kembali pada berkas yang dimaksud.

Content-Type: application/pdf
Content-Disposition: inline; filename="programa.pdf"

Content-Type: application/pdf
Content-Disposition: attachment; filename="programa.pdf"

Jangan samakan nama tautan dengan isinya

Alamat fiktif pada contoh tidak berfungsi. Ganti example.invalid dengan domain Anda yang sudah dipublikasikan sebelum menguji. Pastikan tujuan memberikan program yang disetujui, bukan halaman pengumuman, akses masuk pribadi, atau kesalahan. Jalur berakhiran .pdf hanya petunjuk, bukan pemeriksaan isi. Mengganti nama URL tidak mengubah HTML menjadi PDF atau memperbaiki berkas rusak. Periksa sumber daya yang benar-benar dikirim sebelum mengubah cara penyajiannya; akhiran alamat tidak dapat menggantikan pemeriksaan dokumen.

Jika mengelola situs, periksa permintaan berkas di alat jaringan peramban dan amati Content-Type serta Content-Disposition pada respons akhir. Jika tidak, berikan URL, perilaku yang diamati, dan hasil yang diharapkan kepada pengelola. Minta pemeriksaan berkas yang tepat tanpa tangkapan layar berisi cookie atau kredensial. Simpan naskah asli yang disetujui: perubahan nama atau header bukan versi isi baru dan tidak membuktikan bahwa tanggal atau informasi dalam program telah diperbarui dengan benar.

https://example.invalid/documentos/programa.pdf

Atribut download bukan perintah universal

Pada halaman yang Anda kendalikan, Anda dapat menyediakan tautan HTML dengan download. MDN membatasi kerjanya pada URL dengan origin yang sama serta kasus blob dan data yang didukung. Untuk URL dari origin lain, atribut diabaikan dan navigasi biasa berlangsung, walaupun server tujuan tetap dapat meminta unduhan melalui Content-Disposition. Jangan menjanjikan perbaikan berkas eksternal hanya dengan menambahkan atribut ini atau mengganti tulisan tombol. Respons pihak yang sebenarnya menyajikan dokumen tetap harus diperiksa.

Tautan pendek menambah tujuan dalam perjalanan, tetapi tidak menjadikan PDF server lain sebagai berkas dari origin Anda sendiri. QR mewakili alamat dan tidak memasang petunjuk unduhan dalam peramban. Jika bergantung pada hosting eksternal, gunakan opsi yang didokumentasikan atau minta pemilik memberikan URL distribusi yang sesuai. Bila respons tidak Anda kendalikan, halaman baca dengan petunjuk jelas dapat lebih berguna daripada tombol yang menjanjikan unduhan otomatis yang tidak dapat dijamin pada perangkat penerima.

Gunakan WikiURL untuk memeriksa jalur publik

Masukkan URL publik program ke pemeriksa URL WikiURL. Tinjau status HTTP dan tujuan akhir yang terdeteksi jika ada pengalihan. Jangan kirim alamat pribadi, tautan administrasi, atau rahasia. Jika hasil berakhir pada halaman masuk atau sumber daya lain, perbaiki tujuan yang dibagikan terlebih dahulu. Status 200 menjelaskan respons pemeriksaan itu; status ini tidak membuktikan bahwa pengunjung telah menyimpan PDF pada perangkatnya atau membaca program yang memang ingin Anda berikan melalui tautan tersebut.

Selanjutnya buka tautan persis yang akan dikirim melalui peramban desktop dan ponsel. Periksa judul program, tanggal, keterbacaan, serta kemampuan menyimpan salinan dengan kontrol yang tersedia. Pemeriksa tidak mereproduksi penampil atau preferensi setiap pembaca. Jika hasil teknis berbeda dari pengalaman peramban, catat kedua hasil beserta konteksnya. Jangan menyatakan bahwa setiap pembaca akan memperoleh pengalaman sama hanya berdasarkan satu pengujian berhasil. Penggunaan nyata menjawab pertanyaan berbeda dan melengkapi pemeriksaan teknis terhadap alamat tujuan.

Nyatakan harapan dengan jelas dan simpan pengujian

Untuk membaca, tulisan Lihat program dalam PDF tidak menjanjikan penyimpanan langsung. Jika menawarkan pilihan unduhan yang telah diuji, jelaskan dokumen yang diberikan dan ukurannya jika diketahui. Anda dapat menambahkan petunjuk singkat untuk menyimpan dari penampil bila penampil terbuka. Jangan mewajibkan perubahan pengaturan umum peramban demi satu program atau menyembunyikan tujuan di balik beberapa tombol ambigu. Tulisan harus sesuai jalur yang benar-benar diuji agar penerima tidak perlu menebak tombol yang menuju dokumen.

Simpan URL akhir, versi dokumen, dan perangkat yang diuji sebelum membuat QR atau membagikan tautan pendek. Ulangi pengujian setelah mengganti hosting atau berkas karena respons untuk peramban dapat berubah. Hasil yang berguna adalah program yang benar, dapat diakses audiens yang dituju, dengan petunjuk jujur untuk membaca atau menyimpan. Membuka tab dan mengunduh merupakan perilaku berbeda. Pesan pada tautan harus mencerminkan perbedaan itu dan menyiapkan penerima menghadapi langkah berikutnya tanpa menjanjikan hasil seragam dalam semua keadaan.