Sorun giderme: yazı tipleri, alt küme oluşturma ve etiketleme

Kapsam

Bu girdiler, NextPDF\Exception\FontNotFoundException ve NextPDF\Exception\FontParsingException tarafından bildirilen yazı tipi çözümleme ve ayrıştırma hatalarını kapsar. Ayrıca Çince, Japonca ve Korece (CJK) kapsamasına yönelik tanılamaları ve etiketli çıktıyı etkileyen yapı ağacı sorunlarını da kapsar. Her girdi, nedeni doğrulayabilmeniz için ilgili istisnayı veya testi açıkça adlandırır.

Girdi: yazı tipi bulunamadı

• Belirti. FontNotFoundException; iletisi Font "<name>" not found. Searched: [<paths>] biçimindedir.
• Olası neden. İstenen yazı tipi ailesi veya dosya yolu mevcut değildir, okunabilir değildir ya da çalışma zamanının erişemediği bir yazı tipi dizininde bulunur. Yazı tipi verileri geçerli olabilir; yine de motor bunlara ulaşamaz.
• Kanıt / tanılama. getContext() şunları döndürür: font_name, search_paths ve fallback_attempted. Motorun denediği her konumu incelemek için search_paths değerini kullanın. Bir geri dönüş denemesinin yapılıp yapılmadığını doğrulamak için fallback_attempted değerini kullanın.
• Çözüm.
  1. İstenen font_name değerini, gerçekten mevcut olan yazı tipi dosyasıyla karşılaştırın.
  2. Yazı tipini içeren dizini yapılandırılmış yazı tipi dizinine ekleyin veya ilettiğiniz yolu düzeltin.
  3. Çalışma zamanı kullanıcısının dosyayı okuyabildiğini doğrulayın.
  4. Çağrıyı yeniden çalıştırın.
• İlgili. İstisna başvurusu.

Girdi: yazı tipi dosyası ayrıştırılamıyor

• Belirti. FontParsingException; iletisi Failed to parse font file "<file>": <reason> biçimindedir.
• Olası neden. Motor yazı tipi dosyasını bulmuştur, ancak içeriğini kullanamaz: kesilmiş bir başlık, geçersiz bir tablo dizini ya da head, hhea veya OS/2 gibi eksik bir zorunlu tablo.
• Kanıt / tanılama. getContext() şunları döndürür: font_file ve parse_error. parse_error yapısal sorunu adlandırır.
• Çözüm.
  1. Yapısal kusuru belirlemek için parse_error değerini okuyun.
  2. Yazı tipi dosyasını aynı yazı tipinin sağlam olduğu bilinen bir kopyasıyla değiştirin.
  3. Çağrıyı yeniden çalıştırın.
• İlgili. İstisna başvurusu.

Girdi: alt küme oluşturma, hatalı biçimlendirilmiş bir yazı tipi tablosunda başarısız oluyor

• Belirti. FontParsingException; font_file değeri font-subset olan ve parse_error değeri Invalid head table: too short, Invalid hhea table: too short, Invalid maxp table: too short veya Failed to unpack font data gibi bir değer içeren bir hatadır.
• Olası neden. Yazı tipi ilk yükleme aşamasını geçmiştir, ancak alt küme oluşturma için gereken bir tablo kesilmiştir veya açılamamaktadır. Alt küme oluşturucu, bozuk bir alt küme üretmek yerine yazı tipini reddeder.
• Kanıt / tanılama. Bir head, hhea veya maxp tablosu çok kısa olduğunda veya bir açma işlemi başarısız olduğunda, src/Typography/FontSubsetter.php bir FontParsingException bildirir; bu istisna, dosya adı olarak sabit font-subset belirtecini içerir. Bu belirteç, hatanın ilk yükleme sırasında değil, alt küme oluşturma sırasında meydana geldiğini gösterir.
• Çözüm.
  1. Kaynak yazı tipini, aynı yazı tipinin tam ve kesilmemiş bir kopyasıyla değiştirin.
  2. Yazı tipini bir derleme aracı oluşturuyorsa, onu yeniden oluşturun ve head, hhea ve maxp tablolarının tam olduğunu doğrulayın.
  3. Derlemeyi yeniden çalıştırın.
• İlgili. PDF/A ve PDF/UA doğrulaması.

Girdi: CJK metni eksik gliflerle işleniyor

• Belirti. Çince, Japonca veya Korece metin boş kutular ya da eksik karakterler şeklinde işlenir ve yazı tipinin CJK kapsaması belirsizdir.
• Olası neden. Seçilen yazı tipi, betiğin gerektirdiği Unicode bloklarını kapsamaz. Her CJK betiği, ortak ideogram bloklarına ek olarak belirli bloklar gerektirir.
• Kanıt / tanılama. src/Typography/CjkFontValidator.php, validateCoverage(FontInfo $font, CjkScript $script) işlevini sağlar. Bu işlev, kapsama yüzdesini ve %50 raporlama eşiğinin altındaki blokları içeren bir CjkCoverageResult döndürür. Doğrulayıcı kod noktalarından örnekleme yapar. Bu, tanılama amaçlıdır ve yazı tipi yüklemesini değiştirmez.
• Çözüm.
  1. Yazı tipi ve hedef betik için CjkFontValidator::validateCoverage() işlevini çalıştırın.
  2. Hangi blokların kapsanmadığını görmek için missingRanges değerini okuyun; örneğin Geleneksel Çince için Bopomofo, Japonca için Hiragana ve Katakana, Korece için Hangul heceleri.
  3. Bu blokları kapsayan bir yazı tipi seçin veya bunları kapsayan bir geri dönüş yazı tipi ekleyin.
  4. İşlemeyi yeniden çalıştırın ve kapsamayı yeniden denetleyin.
• İlgili. İstisna başvurusu.

Girdi: önceden tanımlı CMap, CJK betiğiyle eşleşmiyor

• Belirti. CJK metni yanlış gliflere eşlenir veya belge, belgenin diliyle eşleşmeyen önceden tanımlı bir CMap kullanır.
• Olası neden. Algılanan betik, Adobe önceden tanımlı CMap adını belirler. Yalnızca ortak ideogram bloğunu kapsayan ancak betiğe özgü bloğu bulunmayan bir yazı tipi, tasarım gereği Basitleştirilmiş Çince olarak algılanır.
• Kanıt / tanılama. CjkFontValidator::detectScript() algılanan betiği döndürür ve resolvePredefinedCMapName() bunu şu şekilde eşler: Basitleştirilmiş Çince için UniGB-UTF16-H, Geleneksel Çince için UniCNS-UTF16-H, Japonca için UniJIS-UTF16-H ve Korece için UniKS-UTF16-H. Betiğe özgü bir blok bulunmuyorsa, algılama Basitleştirilmiş Çince değerine geri döner.
• Çözüm.
  1. Yazı tipinin betiğe özgü bloğu içerdiğini doğrulayın: Geleneksel Çince için Bopomofo, Japonca için Hiragana veya Katakana, Korece için Hangul.
  2. Belge Geleneksel Çince ise ancak yazı tipinde Bopomofo bloğu yoksa, algılamanın amaçlanan betik olarak çözümlenmesi için bunu içeren bir yazı tipi seçin.
  3. İşlemeyi yeniden çalıştırın.
• İlgili. İstisna başvurusu.

Girdi: etiketli içerik kullanılabilir bir yapı ağacı üretmiyor

• Belirti. Etiketli bir derleme hiçbir yapı üretmez veya sonraki bir erişilebilirlik denetimi boş ya da eksik bir yapı ağacı bildirir.
• Olası neden. Derleme, içeriği etiketleme yolunun dışında ürettiği için hiçbir yapı öğesi oluşturmaz. Yapı ağacı boş kalır.
• Kanıt / tanılama. src/Accessibility/StructureTree.php ve src/Accessibility/TaggedContentEmitter.php, yapı ağacını etiketli içerikten oluşturur. tests/Integration/Accessibility/EmptyTaggedPdfDoesNotAdvertisePdfUa2Test.php testi, boş bir yapı ağacının PDF/UA-2 olarak bildirilmediğini doğrular.
• Çözüm.
  1. Yapı öğelerinin oluşturulabilmesi için içeriğin etiketleme yolu üzerinden üretildiğini doğrulayın.
  2. Her işaretli içerik dizisinin bir yapı öğesine eşlendiğini doğrulayın.
  3. Derlemeyi yeniden çalıştırın ve yapı ağacını inceleyin.
• İlgili. PDF/A ve PDF/UA doğrulaması.

Girdi: yapı öğesi dil etiketi reddediliyor

• Belirti. Bir yapı öğesindeki ya da belgedeki dil değeri geçerli bir etiket olmadığı için derleme başarısız olur.
• Olası neden. Sağlanan dil, geçerli bir BCP-47 etiketi değildir. Doğrulayıcı, hatalı biçimlendirilmiş etiketleri üretmek yerine reddeder.
• Kanıt / tanılama. src/Accessibility/Bcp47Validator.php etiketi doğrular. Geçersiz bir etiket src/Accessibility/InvalidBcp47TagException.php bildirir. tests/Unit/Conformance/PdfUa2Section844LangStrictTest.php, katı PDF/UA-2 dil gereksinimini sınar.
• Çözüm.
  1. Dil değerini en-US, de-DE veya zh-Hant-TW gibi geçerli bir BCP-47 etiketiyle değiştirin.
  2. Bir bölüm belge dilinden farklı olduğunda, dili ilgili yapı öğesi üzerinde ayarlayın.
  3. Derlemeyi yeniden çalıştırın.
• İlgili. PDF/A ve PDF/UA doğrulaması.

Sınır durumları ve dikkat edilecek noktalar

• FontNotFoundException ve FontParsingException farklı hataları bildirir. Bulunamadı hatası, dosyaya ulaşılamadığı anlamına gelir. Ayrıştırma hatası, dosyaya ulaşıldığı ancak baytlarının kullanılamadığı anlamına gelir. Hangi hatanın oluştuğunu belirlemek için sınıfı okuyun.
• font-subset değeri, font_file içinde gerçek bir yol değil, alt küme oluşturma aşaması için bilinçli olarak yerleştirilmiş bir işarettir. font-subset adlı bir dosya aramayın.
• CjkFontValidator, her kod noktasını denetlemek yerine kod noktalarından örnekleme yapar; bu nedenle kapsama değeri, bayt düzeyinde tam bir denetim değil, yazı tipi seçimine yönelik bir tahmindir.
• Boş bir yapı ağacı, tasarım gereği PDF/UA-2 olmayan çıktı olarak bildirilir. Bu bir kusur değil, belgelenmiş motor davranışıdır.

Ayrıca bakınız

• İstisna başvurusu
• PDF/A ve PDF/UA doğrulaması
• Bilgi tabanı dizini

Sözlük: yazı tipi alt küme oluşturma · CJK kapsaması · yapı ağacı