Geçiş kılavuzları

Tarifler ve kılavuzlar, yukarı akış depolarında yayımlandıkça burada görünür. Bu sayfa sizi, kaynak depolarda (nextpdf, nextpdf-Laravel, nextpdf-Symfony ve diğer ekosistem paketleri) hazırlanan içeriğe yönlendirir. Bugün mevcut belgeler için Insider_ (35 makale, 17 yerel ayarın tümü) ya da Bir entegrasyon seçin bölümüne bakın.

Geçiş kılavuzları

NextPDF, PHP için bir Taşınabilir Belge Biçimi (PDF) 2.0 motorudur. PDF’leri zaten başka bir kütüphaneyle oluşturuyorsanız, geçiş kılavuzu o kütüphanenin uygulama programlama arabirimini (API) NextPDF’e eşler ve karşılaşacağınız davranışsal farkları belgeler. Bu depolar arası dizin, hangi kılavuzun hangi kütüphaneden geçiş yaptırdığını, her kılavuzun sahibi olan depoyu ve her kılavuzun kullandığı ortak modeli kaydeder.

Bu sayfa bir dizin olduğundan, herhangi bir kılavuz hakkında davranışsal bir iddiada bulunmaz. Her kılavuz kendi deposuna aittir. Toplayıcı, kılavuzu bu siteye çeker; kılavuz yayımlanana kadar bağlantı bir yer tutucuya işaret eder. Her davranışsal iddia, burada değil, kılavuzun kendisinde bulunur ve depo içi bir test ya da sabitlenmiş bir ISO 32000-2 / Basamaklı Stil Sayfaları Çalışma Grubu (CSS WG) maddesiyle desteklenir.

Tek geçiş modeli

Her NextPDF geçiş kılavuzu aynı dürüst modeli kullanır. Her kılavuzu bu modeli göz önünde bulundurarak okuyun:

• Uyumlu, ancak bayt düzeyinde aynı değil. NextPDF ve geçiş yaptığınız kaynak kütüphane bağımsız uygulamalardır. Taşınan bir belge, piksel veya bayt düzeyinde aynılığı değil, işlevsel amacı korur. Hiçbir kılavuz, doğrudan yerine geçme ya da byte-identical uyumluluk iddiasında bulunmaz.
• Kapsam, bir iddia değil, ölçülmüş bir sayımdır. Bir kılavuz, TCPDF adaptörü rakamı gibi bir kapsam sayısı belirttiğinde, bu rakam ISO/IEC 25023 madde 43 anlamında, depo içi bir matristen çıkarılmış işlevsel-eksiksizlik ölçütüdür. Bu, kapsamlı bir garanti değil, kapsanan yöntemlerin ölçülmüş bir sayımıdır.
• Her kılavuz davranışsal farklarını açıkça belirtir. Her kılavuz, açık bir farklar tablosu ve bir “desteklenmiyor / doğrudan karşılığı yok” bölümü içerir. Bir fark, bir kusur değil, belgelenmiş bir motor özelliğidir.
• İşleyici değişikliği yeniden incelemeyi gerektirir. Geçiş, kodu değiştirir ve yeni bir çıktı temel çizgisi gerektirir. Her kılavuz, geçişin nasıl test edileceğini açıklar; görsel kabul her belge için yapılır ve entegrasyonu yapanın sorumluluğunda kalır.

Geçiş biçimleri

Kılavuzlar iki biçime ayrılır. Her biçim, ne kadar kodun değişeceğini size bildirir.

• API yeniden yazımı geçişlerinde uyumluluk katmanı bulunmaz: her çağrı noktası, kılavuzun fiil eşlemesi ve seçenek haritası kullanılarak yeniden yazılır. Köprü Metni İşaretleme Dili’nden (HTML) PDF’e kütüphane geçişleri (dompdf, mpdf) bu biçimi kullanır; doğrudan NextPDF Html ardışık düzenini hedefler.
• Önce-yerleştir-sonra-taşı geçişleri kaynakla neredeyse uyumlu bir adaptör sunar; bu nedenle ilk adım en düşük düzeyde bir bağımlılık değişikliğidir. Bundan sonra çağrı noktalarını kademeli olarak modern API’ye taşır, ardından adaptörü devre dışı bırakırsınız. TCPDF geçişi, nextpdf/compat-legacy adaptörü aracılığıyla bu biçimi kullanır.

Kılavuz ve sahip depo referansı

Aşağıdaki her kılavuz, sahip deponun docs/public/ dizininde bulunur ve toplayıcı onu bu siteye çeker. Sahip depo, o kılavuzun davranışsal iddiaları için yetkili kaynaktır; bu dizin yalnızca yönlendirmeyi kaydeder.

Kaynak	Kılavuz	Biçim	Sahip depo	Sayfa
Dompdf	Dompdf → NextPDF Html ardışık düzeni	API yeniden yazımı	nextpdf (core)	Dompdf kılavuzu dompdf (yukarı akışta planlanmış)
mPDF	mPDF → NextPDF core	API yeniden yazımı	nextpdf (core)	mPDF kılavuzu mpdf (yukarı akışta planlanmış)
TCPDF 6.x	TCPDF → compat-legacy adaptörü aracılığıyla NextPDF	Önce-yerleştir-sonra-taşı	nextpdf-compat-tcpdf deposu, paket nextpdf/compat-legacy	TCPDF kılavuzu tcpdf-compat (yukarı akışta planlanmış)

İlgili dompdf ve mpdf kılavuzları, core motor API’lerini hedefledikleri için core deposunda bulunur ve core examples/ dizini onları destekler. tcpdf-compat kılavuzu compat-tcpdf deposunda bulunur; çünkü nextpdf/compat-legacy paketi, TCPDF davranışsal yüzeyinin ve kılavuzu destekleyen adaptör testlerinin sahibidir. Bu dizin, depolar arası kapsamı nedeniyle docs deposuna özgüdür ve herhangi bir tek kılavuz hakkında davranışsal bir iddiada bulunmaz.

Her kılavuzun amacı

• Dompdf → NextPDF (dompdf (yukarı akışta planlanmış)) — sunucu tarafında dompdf/dompdf kullanan kod tabanları için. loadHtml/render/output ile Options anahtarlarını NextPDF Html ardışık düzenine eşler ve CSS özellik beklentilerini yalnızca doğrulanmış CSS destek matrisine bırakır. Dompdf sınıfı için bir uyumluluk katmanı yoktur; her çağrı noktasını yeniden yazarsınız.
• mPDF → NextPDF (mpdf (yukarı akışta planlanmış)) — mpdf/mpdf kullanan kod tabanları için. WriteHTML/Output/AddPage ile yapıcı yapılandırma dizisini core API’ye eşler; tek bir yazı tipi işleme farkıyla: NextPDF yazı tiplerini tek bir yazı tipi dizini ile CSS eşleştirmesi üzerinden çözer ve her zaman alt küme oluşturur. Mpdf sınıfı için bir uyumluluk katmanı yoktur.
• TCPDF → NextPDF (compat-legacy) (tcpdf-compat (yukarı akışta planlanmış)) — ilk değişikliğin mümkün olduğunca küçük olmasını isteyen TCPDF 6.x kod tabanları için. Adaptörü kurun, gerçek yüzeyinizi sıkı kipte depo içi kapsam matrisine göre denetleyin, çağrı noktalarını adaptörden taşıyın, ardından üzerine TCPDF’in hiçbir zaman sahip olmadığı bir yetenek olan PDF/Evrensel Erişilebilirlik (PDF/UA-2) etiketli yapısını ekleyin. Adaptör hedef değil, bir geçiş iskelesidir ve doğrudan yerine geçme garantisi değildir.

Kılavuz bağlantıları nasıl çözümlenir

Yukarıdaki her [[…]] yer tutucusu, sahip deponun docs/public/migration/ dizininde bulunan bir sayfaya işaret eder ve toplayıcı o sayfayı bu siteye çeker. Hedef kısa adlar tek bir kurala uyar:

/migration/<source>/

İlgili <source> belirteci, geçiş yaptığınız kütüphanenin kısa adıdır: yukarıdaki kılavuz referans tablosunda listelendiği gibi dompdf, mpdf veya tcpdf-compat değerlerinden biridir. Bir hedef sayfa toplanana kadar bağlantısı bir yer tutucu olarak kalır ve çözümlenmez. Bu dizin, herhangi bir hedef kılavuz hakkında davranışsal bir iddiada bulunmaz; yalnızca yönlendirmeyi ve ortak geçiş modelini kaydeder.

Ayrıca bkz.

• CSS destek matrisi — dompdf ve mpdf kılavuzlarındaki CSS özellik beklentileri için yalnızca doğrulanmış yetkili kaynak.
• Entegrasyon tarif kitabı — ekosistem entegrasyon paketlerine yönelik depolar arası dizin. Farklı bir konuyu kapsar: motora geçmeyi değil, motoru bağlamayı.