Διαδικασία Απόδοσης
Από το έγγραφο σε εικόνες σελίδων
Μεταξύ OpenDocumentAsync και του PNG που φθάνει στον περιηγητή υπάρχουν δύο ξεχωριστά στάδια: ανάλυση προβολέα (ποιος κινητήρας φορτώνει το έγγραφο, αποφασίζεται μία φορά ανά άνοιγμα) και επεξεργασία σελίδας (τι συμβαίνει σε κάθε εικόνα σελίδας σε κάθε αίτηση). Η γνώση και των δύο εξηγεί γιατί ένα μορφότυπο αποδίδει όπως αποδίδει — και τι DefaultRender πραγματικά αλλάζει.
Στάδιο 1 — Επίλυση του προβολέα μορφής
Η εργοστασιακή μονάδα αντιστοιχίζει την επέκταση αρχείου σε έναν προβολέα μέσω του καταλόγου μορφών, με τρία επίπεδα προτεραιότητας:
- Πρώτα οι προσαρμοσμένοι προβολείς. Οτιδήποτε καταχωρίσατε με
DoconutOptions.RegisterViewer(extension, factory, defaultConfig?)υπερισχύει όλων των ενσωματωμένων. - Προβολείς οικογένειας ενσωματωμένων. Ο κατάλογος αντιστοιχίζει κάθε επεκτάσιμη επέκταση σε μια οικογένεια προβολέα — Word, Excel, PowerPoint, Pdf, Cad, Dgn, Image, Tiff, Psd, Email, Visio, Project, Xps, Epub, Txt, Html, Mht, Dcn — η καθεμία με τον δικό της προσαρμογέα κινητήρα. Εάν ένα αδειοδοτημένο πρόσθετο συνεισφέρει έναν προβολέα για την ίδια επέκταση, ο προβολέας του πρόσθετου αντικαθιστά τον ενσωματωμένο.
AddDoconut()επικυρώνει τα καταχωρημένα δικαιώματα πρόσθετου κατά την εκκίνηση· η εναλλακτική λύση της εργοστασιακής μονάδας προς τον ενσωματωμένο προβολέα είναι ένας αμυντικός κανόνας χρόνου εκτέλεσης. - Μορφές μόνο με πρόσθετο. Ορισμένες επεκτάσεις δεν έχουν καθόλου ενσωματωμένο προβολέα — DICOM (
.dcm) υπάρχει μόνο μέσω του πρόσθετου DICOM. Το άνοιγμα ενός χωρίς την απαιτούμενη δυνατότητα προκαλεί:
LicenseException: This document type requires the 'Dicom' plugin license.Μία επέκταση που δεν διεκδικείται από κανέναν προβολέα προκαλεί:
FormatNotSupportedException: Document format '<extension>' is not supported.Μετά την επίλυση, η διαμόρφωση καθορίζεται: το ρητό αντικείμενο διαμόρφωσης εάν το περάσατε, διαφορετικά η προεπιλεγμένη διαμόρφωση του μορφότυπου από τον κατάλογο. DocOptions.Password αντιγράφεται στη διαμόρφωση για προστατευμένα έγγραφα.
Στάδιο 1β — Λειτουργία Ανακατεύθυνσης (DefaultRender = false)
Οι περισσότερες διαμορφώσεις ανά μορφότυπο εκθέτουν μια σημαία DefaultRender. Επιλέγει μεταξύ δύο θεμελιωδώς διαφορετικών διαδρομών:
DefaultRender = true— το έγγραφο αποδίδει εγγενώς, απευθείας σε εικόνες σελίδας.DefaultRender = false— το έγγραφο πρώτα μετατρέπεται σε PDF στη μνήμη, η πηγή κινητήρα απελευθερώνεται, και ένας προβολέας PDF αναλαμβάνει. Το παραγόμενο PDF ενσωματώνει πραγματικό κείμενο, έτσι η αναζήτηση πλήρους κειμένου λαμβάνει εικονοστοιχειώδεις εγγενείς επισημάνσεις· η διαδικασία επιβάλλειAllowSearchκαιAllowCopyγια το ανακατευθυνόμενο PDF επειδή η μετατροπή είναι αόρατη στον χρήστη.
Το XPS και η προεπιλογή του καταλόγου για MHT χρησιμοποιούν τη διαδρομή ανακατεύθυνσης. Μια προβολή PDF μπορεί να παρέχει εγγενή αναζήτηση για μορφές όπως HTML και Microsoft Project. Εάν το παραγόμενο PDF περιέχει εικόνες χωρίς στρώση κειμένου, ο τυπικός προβολέας δεν μπορεί να αναζητήσει αυτά τα εικονοστοιχεία.
Χρησιμοποιήστε τη λειτουργία ανακατεύθυνσης όταν χρειάζεστε μια προβολή PDF με κείμενο — με κόστος μιας προκαταρκτικής μετατροπής όταν ανοίγει το έγγραφο.
Στάδιο 2 — Η διαδικασία εικόνας σελίδας
Οι αποδομένες σελίδες επεξεργάζονται ανά αίτηση μέσω μιας σταθερής ακολουθίας:
raw page PNG → watermark → rotate/flip → scale → annotation burn → PNG to the response- Υδατογράφημα — εφαρμόζεται από την κατάσταση της άδειας (έλλειψη άδειας, ληγμένη προσωρινή ή συνδρομητική, μη έγκυρος τομέας, λανθασμένη έκδοση) και από
DocOptions.Watermarkγια το δικό σας προσαρμοσμένο κείμενο. Μια σωστά αδειοδοτημένη εφαρμογή — ή ενεργή προσωρινή άδεια — χωρίς προσαρμοσμένο υδατογράφημα παραλείπει αυτό το βήμα. - Περιστροφή/αναστροφή — η κατάσταση ανά σελίδα που ο χρήστης ορίζει στο widget (90°/180°/270°, οριζόντιες/κάθετες αναστροφές) αποθηκεύεται στη συνεδρία και εφαρμόζεται σε κάθε επόμενη απόδοση εκείνης της σελίδας.
- Κλιμάκωση — μικρογραφίες και επίπεδα ζουμ παράγονται κλιμακώνοντας την αποδομένη σελίδα στο ζητούμενο μέγεθος στόχο·
0σημαίνει εξυπηρέτηση στο αρχικό μέγεθος. - Καψίματος σημειώσεων — οι αποθηκευμένες σημειώσεις σχεδιάζονται πάνω στο bitmap ώστε οι εξαγωγές και οι εικόνες σελίδας να τις εμφανίζουν.
- Κωδικοποίηση — το αποτέλεσμα κωδικοποιείται σε PNG χρησιμοποιώντας δεσμευμένες ροές μνήμης και γράφεται άμεσα στην απάντηση HTTP.
Τα σφάλματα μέσα στο middleware επιστρέφονται ως εικόνες σφάλματος PNG (κόκκινο κείμενο σε λευκό) αντί για σελίδες σφάλματος HTTP, ώστε το widget να μπορεί να τις εμφανίσει στην περιοχή της σελίδας.
Κρυφή μνήμη σελίδων
BaseConfig.CachePages (προεπιλογή true) διατηρεί τις αποδομένες εικόνες σελίδων στη μνήμη για τη διάρκεια της συνεδρίας εγγράφου, ώστε η επανεπίσκεψη μιας σελίδας να μην την αποδίδει ξανά. BaseConfig.ImageResolution (25–300 DPI, 0 = προεπιλογή μορφής) είναι ο κύριος ρυθμιστής ποιότητας/μνήμης· η προεπιλογή κάθε μορφής τεκμηριώνεται στη σελίδα διαμόρφωσής της.
Απόδοση σε έναν κόμβο vs. πολλούς
Όλα τα παραπάνω περιγράφουν την απόδοση σε έναν μόνο κόμβο κατ' απαίτηση για τη συνεδρία που άνοιξε το έγγραφο. Μια ανάπτυξη όπου ένας κόμβος αποδίδει και δημοσιεύει ολόκληρο το σύνολο των τεχνουργημάτων, και άλλοι κόμβοι εξυπηρετούν αυτές τις σελίδες από κοινόχρηστη αποθήκευση, χρησιμοποιεί διαφορετική διαδρομή ανάγνωσης — δείτε Διανεμημένες Αναπτύξεις.
Γραμματοσειρές σε Linux
Οι σελίδες σχεδιάζονται με τις γραμματοσειρές που είναι εγκατεστημένες στον διακομιστή. Σε Linux, εγκαταστήστε τη βιβλιοθήκη διαμόρφωσης γραμματοσειρών πριν ανοίξει το πρώτο έγγραφο (fontconfig σε RHEL και Fedora):
apt-get update && apt-get install -y libfontconfig1Χωρίς αυτήν, το άνοιγμα ενός εγγράφου αποτυγχάνει με The system library libfontconfig1 is missing. Install it (Debian/Ubuntu: apt-get install -y libfontconfig1) and see the Linux section of the Doconut documentation.. Είναι το μόνο πακέτο συστήματος που χρειάζεται το Doconut· libgdiplus δεν απαιτείται.
Οι εξαρτήσεις του φέρνουν ένα βασικό σύνολο γραμματοσειρών (DejaVu), έτσι τα έγγραφα αποδίδουν αμέσως. Ένα έγγραφο που ζητά μια γραμματοσειρά που δεν διαθέτει ο διακομιστής — Calibri, Arial ή Times New Roman σε τυπική εικόνα Linux — λαμβάνει την πλησιέστερη εγκατεστημένη γραμματοσειρά, έτσι το κείμενο μπορεί να έχει διαφορετικό πλάτος και οι αλλαγές γραμμής μπορεί να διαφέρουν από τα Windows. Για έξοδο πιο κοντά στα Windows, εγκαταστήστε τις συμβατές μετρικές εναλλακτικές fonts-liberation, fonts-crosextra-carlito, και fonts-crosextra-caladea· προσθέστε fonts-noto-core ή fonts-noto-cjk για άλλα σενάρια, ή αντιγράψτε τα δικά σας αρχεία .ttf/.otf στο /usr/share/fonts/ και εκτελέστε fc-cache -f.
Οι διανομές Alpine και άλλες βασισμένες σε musl δεν υποστηρίζονται.
Πού να ρυθμίσετε τι
| Θέλετε | Ρύθμιση |
|---|---|
| Πιο καθαρές σελίδες | ImageResolution στη διαμόρφωση μορφής |
| Ακριβής αναζήτηση κειμένου σε HTML/EPUB/email/MHT/MPP | DefaultRender = false στη διαμόρφωση μορφής |
| Μειωμένη μνήμη σε τεράστια έγγραφα | CachePages = false, κλείστε τις συνεδρίες ρητά |
| Η δική σας σφραγίδα σε κάθε σελίδα | DocOptions.Watermark |
Ήταν αυτή η σελίδα χρήσιμη;