Quy trình Kết xuất

Từ tài liệu đến hình ảnh trang

Giữa OpenDocumentAsync và PNG mà trình duyệt nhận được có hai giai đoạn riêng biệt: giải quyết trình xem (động cơ nào tải tài liệu, quyết định một lần mỗi lần mở) và xử lý trang (những gì xảy ra với mỗi hình ảnh trang trong mỗi yêu cầu). Hiểu cả hai giải thích tại sao một định dạng được kết xuất như vậy — và DefaultRender thực sự chuyển đổi gì.

Giai đoạn 1 — Giải quyết trình xem định dạng

Nhà máy ánh xạ phần mở rộng tệp thành một trình xem thông qua danh mục định dạng, với ba mức ưu tiên:

  1. Trình xem tùy chỉnh trước. Bất kỳ thứ gì bạn đăng ký với DoconutOptions.RegisterViewer(extension, factory, defaultConfig?) đều thắng mọi trình xem tích hợp sẵn.
  2. Trình xem gia đình tích hợp sẵn. Danh mục ánh xạ mỗi phần mở rộng có thể xem thành một họ trình xem — Word, Excel, PowerPoint, Pdf, Cad, Dgn, Image, Tiff, Psd, Email, Visio, Project, Xps, Epub, Txt, Html, Mht, Dcn — mỗi họ có bộ điều hợp động cơ riêng. Nếu một plugin có giấy phép đóng góp một trình xem cho cùng phần mở rộng, trình xem plugin sẽ thay thế trình xem tích hợp sẵn. AddDoconut() xác thực các quyền plugin đã đăng ký khi khởi động; việc nhà máy quay lại trình xem tích hợp sẵn là quy tắc thời gian chạy phòng thủ.
  3. Định dạng chỉ có plugin. Một số phần mở rộng không có trình xem tích hợp sẵn — DICOM (.dcm) chỉ tồn tại qua plugin DICOM. Mở một tệp mà không có khả năng cần thiết sẽ ném lỗi:
text
LicenseException: This document type requires the 'Dicom' plugin license.

Một phần mở rộng không có trình xem nào khai báo sẽ gây ra:

text
FormatNotSupportedException: Document format '<extension>' is not supported.

Sau khi giải quyết, cấu hình được thiết lập: đối tượng cấu hình rõ ràng của bạn nếu bạn đã truyền vào, nếu không thì cấu hình mặc định của định dạng từ danh mục. DocOptions.Password được sao chép vào cấu hình cho tài liệu được bảo vệ.

Giai đoạn 1b — Chế độ chuyển hướng (DefaultRender = false)

Hầu hết các cấu hình theo định dạng đều hiển thị một cờ DefaultRender. Nó chọn giữa hai đường dẫn cơ bản khác nhau:

  • DefaultRender = true — tài liệu được kết xuất một cách nguyên bản, trực tiếp thành hình ảnh trang.
  • DefaultRender = false — tài liệu đầu tiên được chuyển đổi thành PDF trong bộ nhớ, động cơ nguồn được giải phóng, và một trình xem PDF tiếp quản. PDF được tạo nhúng văn bản thực, vì vậy tìm kiếm toàn văn nhận được các tô sáng nguyên bản chính xác tới pixel; quy trình buộc bật AllowSearch và AllowCopy cho PDF chuyển hướng vì việc chuyển đổi không hiển thị với người dùng.

XPS và mặc định danh mục cho MHT sử dụng đường dẫn chuyển hướng. Một phép chiếu PDF có thể cung cấp tìm kiếm nguyên bản cho các định dạng như HTML và Microsoft Project. Nếu PDF kết quả chứa hình ảnh không có lớp văn bản, trình xem tiêu chuẩn không thể tìm kiếm các pixel đó.

Sử dụng chế độ chuyển hướng khi bạn cần một phép chiếu PDF có chứa văn bản — với chi phí là việc chuyển đổi ngay khi tài liệu mở.

Giai đoạn 2 — Quy trình hình ảnh trang

Các trang đã kết xuất được xử lý theo yêu cầu qua một chuỗi cố định:

text
raw page PNG → watermark → rotate/flip → scale → annotation burn → PNG to the response
  • Watermark — được áp dụng từ trạng thái giấy phép (thiếu giấy phép, tạm thời hoặc đăng ký đã hết hạn, miền không hợp lệ, phiên bản sai) và từ DocOptions.Watermark cho văn bản tùy chỉnh của bạn. Ứng dụng có giấy phép hợp lệ — hoặc giấy phép Tạm thời đang hoạt động — không có watermark tùy chỉnh sẽ bỏ qua bước này.
  • Rotate/flip — trạng thái mỗi trang mà người dùng đặt trong widget (90°/180°/270°, lật ngang/dọc) được lưu trong phiên và áp dụng trên mỗi lần kết xuất tiếp theo của trang đó.
  • Scale — các hình thu nhỏ và mức thu phóng được tạo bằng cách thu phóng trang đã kết xuất tới kích thước mục tiêu yêu cầu; 0 có nghĩa là phục vụ ở kích thước gốc.
  • Annotation burn — các chú thích đã lưu được vẽ lên bitmap để các xuất khẩu và hình ảnh trang hiển thị chúng.
  • Encoding — kết quả được mã hoá thành PNG bằng các luồng bộ nhớ chung và ghi trực tiếp vào phản hồi HTTP.

Các lỗi bên trong middleware được trả về dưới dạng hình ảnh lỗi PNG (văn bản đỏ trên nền trắng) thay vì các trang lỗi HTTP, để widget có thể hiển thị chúng trong khu vực trang.

Bộ nhớ đệm trang

BaseConfig.CachePages (mặc định true) giữ các hình ảnh trang đã kết xuất trong bộ nhớ suốt thời gian phiên tài liệu, vì vậy việc truy cập lại một trang sẽ không phải kết xuất lại. BaseConfig.ImageResolution (25–300 DPI, 0 = mặc định định dạng) là bộ điều chỉnh chất lượng/bộ nhớ chính; mặc định của mỗi định dạng được ghi chép trên trang cấu hình của nó.

Kết xuất trên một nút so với nhiều nút

Mọi thứ ở trên mô tả việc kết xuất trên một nút duy nhất theo yêu cầu cho phiên đã mở tài liệu. Một triển khai mà một nút kết xuất và xuất bản toàn bộ bộ artefact, và các nút khác phục vụ các trang đó từ lưu trữ chia sẻ, sử dụng một đường đọc khác — xem Triển khai Phân tán.

Phông chữ trên Linux

Các trang được vẽ bằng các phông chữ đã cài đặt trên máy chủ. Trên Linux, cài đặt thư viện cấu hình phông chữ trước khi tài liệu đầu tiên mở (fontconfig trên RHEL và Fedora):

bash
apt-get update && apt-get install -y libfontconfig1

Nếu không có nó, việc mở tài liệu sẽ thất bại với The system library libfontconfig1 is missing. Install it (Debian/Ubuntu: apt-get install -y libfontconfig1) and see the Linux section of the Doconut documentation.. Đây là gói hệ thống duy nhất mà Doconut cần; libgdiplus không bắt buộc.

Các phụ thuộc của nó mang lại một bộ phông chữ cơ bản (DejaVu), vì vậy các tài liệu được kết xuất ngay từ đầu. Một tài liệu yêu cầu một phông chữ mà máy chủ không có — Calibri, Arial, hoặc Times New Roman trên một hình ảnh Linux điển hình — sẽ nhận phông chữ đã cài đặt gần nhất, do đó văn bản có thể có độ rộng khác và ngắt dòng có thể khác so với Windows. Để đầu ra gần hơn với Windows, cài đặt các thay thế tương thích metric fonts-liberation, fonts-crosextra-carlito, và fonts-crosextra-caladea; thêm fonts-noto-core hoặc fonts-noto-cjk cho các script khác, hoặc sao chép các tệp .ttf/.otf của bạn vào /usr/share/fonts/ và chạy fc-cache -f.

Alpine và các bản phân phối dựa trên musl khác không được hỗ trợ.

Nơi để tinh chỉnh gì

Bạn muốnTinh chỉnh
Trang sắc nét hơnImageResolution on the format config
Tìm kiếm văn bản chính xác trên HTML/EPUB/email/MHT/MPPDefaultRender = false on the format config
Giảm bộ nhớ trên tài liệu lớnCachePages = false, close sessions explicitly
Dấu cá nhân của bạn trên mỗi trangDocOptions.Watermark

Trang này có hữu ích không?