Web görüntüleyici sorun giderme

Görüntüleyici bir belgeyi açamadığında kendi mesajını gösterir; vive-error de aynı nedeni sayfana bir kod olarak verir. Mesajdan başla: aşağıdaki bölümler onu izliyor.

“Dosya indirilemedi”

Kod network. Sık görülen nedenler:

• PDF başka bir sitede ve o site sayfanın onu okumasına izin vermiyor. O sitenin dosyayla birlikte Access-Control-Allow-Origin göndermesi gerekir; bkz. başka sitedeki PDF’ler. Tarayıcının konsolu eksik başlığın adını verir.
• İçerik Güvenliği Politikan PDF’in sitesini connect-src içinde saymıyor. Konsol bir CSP ihlali gösterir; siteyi güvenlik politikası bölümündeki gibi ekle.
• Adres bir oturum istiyor ve tarayıcı o siteye oturum bilgisini göndermiyor, ya da adres bir giriş sayfasına yönlendiriyor.

“Dosya bulunamadı”

Kod not-found: sunucu src içindeki adres için 404 döndü. Göreli bir adres betiğe göre değil sayfana göre okunur; yani /blog/yazi/ sayfasındaki src="rapor.pdf" /blog/yazi/rapor.pdf dosyasını arar. Emin olmak için adresi / ile başlat.

“Görüntüleyici başlatılamadı”

Kod engine: PDF motoru indirilemedi ya da çalışmasına izin verilmedi.

• İçerik Güvenliği Politikası varsa script-src içinde 'wasm-unsafe-eval', worker-src ve connect-src içinde görüntüleyicinin kaynağı olduğuna bak.
• npm ve bir paketleyiciyle kullanıyorsan görüntüleyicinin dosyaları herkese açık bir klasöre kopyalanmalı ve assets oraya göstermeli; bkz. kurulum. Ağ sekmesi hangi dosyanın 404 döndüğünü gösterir.
• Kendi barındırdığın zip ile kullanıyorsan dist’teki bütün dosyaları vivepdf.js ile aynı klasörde tut.

“Dosya bozuk”

Kod damaged: dosya PDF değil ya da bozuk. Adresin gerçekten PDF’i döndürdüğüne, bir HTML hata ya da giriş sayfası döndürmediğine bak. Dosya başka yerde açılıyor ama burada açılmıyorsa, paylaşabiliyorsan dosyayla birlikte bildir.

Görüntüleyici boş ya da yüksekliği yok

sized modunda görüntüleyici, CSS başka bir yükseklik vermedikçe 600 piksel yüksekliğindedir. Yüzde olarak verilen yükseklik yalnızca üst öğenin bir yüksekliği varsa çalışır. Onu sıkıştıran bir flex ya da grid düzenindeyse bir min-height ver. lightbox tasarım gereği yer kaplamaz: show() çağır.

Bazı harfler kutucuk ya da eksik

PDF o metin için kendi fontlarını taşımıyor. Japonca, Korece, Çince, Kiril, Yunanca, Vietnamca, İbranice ve Arapça için yedek fontları kendi fontu olmayan PDF’ler için fontlar bölümündeki gibi kur.

Büyük dosyalar yavaş

Ağ sekmesinde PDF isteklerinin 206 Partial Content döndürdüğüne bak. 200 dönüyorsa sunucu her seferinde dosyanın tamamını gönderiyor; aralık isteklerini aç, başka bir siteyse Content-Range’i açtır. Ayrıntısı performans sayfasında.

Çiz düğmesi yok

Çizim araçları, öğede annotate özniteliği olana kadar kapalıdır. Öznitelik var ama düğme hâlâ yoksa ağ sekmesine bak: çizim araçları görüntüleyicinin diğer dosyalarının yanında ayrı bir dosya olarak gelir ve engellenmemelidir.

Vurgulama bir sayfada çalışmıyor

Vurgulama, altını çizme ve üstünü çizme PDF’te metin ister. Taranmış bir sayfa bir resimdir; kalemi ya da fosforlu kalemi kullan, ya da önce vivePDF uygulamasında OCR ile metni seçilebilir yap.

Yeniledikten sonra çizimler gitti

Görüntüleyici hiçbir şey saklamaz. Ziyaretçiler işaretlerini PDF’i indirerek tutar; siten onları annotations() ile saklayıp setAnnotations() ile geri koyabilir, sunucuna kaydetme bölümündeki gibi.

Metotlar not-ready ile reddediyor

annotations(), setAnnotations() ve save() açık bir belge ister. Onları vive-ready’den sonra çağır. Diğer metotlar kendileri bekler.

Çatılar

• React 19 öznitelikleri özel öğelere olduğu gibi geçirir; vive- olaylarını bir ref ve addEventListener ile dinle.
• Vue, vive-pdf isCustomElement içinde listelenene kadar onun bilinmeyen bir bileşen olduğu uyarısını verebilir.
• Sunucuda oluşturma: görüntüleyiciyi yalnızca tarayıcıda içe aktar. Öğe sunucunun HTML’inde durabilir; betik çalışınca başlar.

Her biri için örnekler kurulum sayfasında.

Hâlâ takıldın mı?

GitHub’da bir konu (issue) aç: tarayıcıyı ve sürümünü, görüntüleyicinin sürümünü, hata kodunu ve mümkünse PDF’i ya da sorunu gösteren bir sayfayı yaz.