Cách Chuyển Đổi Tài Liệu PDF trong TypeScript

Hướng dẫn này cho thấy cách chuyển đổi nội dung PDF sang các định dạng khác bằng Aspose.PDF FOSS cho TypeScript. Page xuất một trang duy nhất dưới dạng SVG hoặc ảnh raster; Document xuất toàn bộ tệp dưới dạng HTML, Markdown hoặc DOCX, và có thể xác thực và chuyển đổi tài liệu sang PDF/A. Nó yêu cầu Node.js 22 hoặc mới hơn.

Hướng dẫn từng bước

git clone https://github.com/aspose-pdf-foss/Aspose.PDF-FOSS-for-TypeScript.git
cd Aspose.PDF-FOSS-for-TypeScript
npm install
npm run build

import { Document } from '@asposefoss/pdf';

import { Document } from '@asposefoss/pdf';

import { Document } from '@asposefoss/pdf';

const doc = Document.OpenFile('input.pdf');
const svg = doc.Pages[0].ToSvg(); // standalone <svg> string
const png = doc.Pages[0].ToImage({ scale: 2 }); // Uint8Array of PNG bytes @144 DPI

const semanticHtml = doc.ToHtml(); // reflowable markup, all pages
const fixedHtml = doc.ToHtml({ mode: 'fixed', fonts: 'embed' }); // positioned, fonts embedded
const markdown = doc.ToMarkdown(); // GFM Markdown, all pages

const docx = doc.ToDocx(); // .docx bytes, reflowed, images in the package
const fixed = doc.ToDocx({ mode: 'textbox' }); // .docx keeping each page's own geometry

const report = doc.ValidatePdfA('2b');
console.log(report.Passed);

const copy = doc.ExtractPages(doc.Pages.map((_, i) => i + 1));
const conversion = copy.ConvertToPdfA('2b');
console.log(conversion.applied.length, conversion.unresolved.length, conversion.passed);
copy.Save();

Các vấn đề thường gặp và cách khắc phục

Document.ToHtml() mất cấu trúc tiêu đề. Chế độ ngữ nghĩa duyệt cây cấu trúc, vì vậy nó phải chạy sau một lần gắn thẻ — hoặc Document.AutoTag() hoặc gắn thẻ tự viết bằng StructTreeRoot.Append(). ToHtml() trở lại phần thân heuristic khi GetStructTree() returns null.

ConvertToPdfA() thay đổi tệp mà bạn muốn giữ nguyên không chuyển đổi. Thực hiện chuyển đổi trên một bản sao từ Document.ExtractPages(), sau đó lưu bản sao riêng — ConvertToPdfA() thay đổi tài liệu mà nó được gọi trên.

ValidatePdfA() báo cáo các lỗi lần đầu tiên chạy. Một nguyên nhân phổ biến là phông chữ chuẩn chưa được nhúng và một thiếu sót /OutputIntent — kiểm tra report.Passed và các kết quả quy tắc riêng lẻ để xem những điều kiện nào không được đáp ứng.

Page.ToImage() đầu ra trông có độ phân giải thấp. scale được tính dựa trên 72 DPI; tăng nó lên (ví dụ { scale: 2 } cho 144 DPI) để có đầu ra chất lượng in.

Câu hỏi thường gặp

Sự khác nhau giữa xuất HTML ngữ nghĩa và cố định là gì?

Chế độ ngữ nghĩa tái bố cục tài liệu từ cây cấu trúc thành mã đánh dấu đọc tốt trên trình duyệt ở bất kỳ độ rộng nào. Chế độ cố định tái tạo mỗi trang dưới dạng SVG được định vị và văn bản được đặt tuyệt đối, khớp chính xác với bố cục gốc.

Liệu Document.ToDocx() có giữ nguyên bố cục trang gốc không?

Mặc định ToDocx() sẽ tái bố cục nội dung. Gửi { mode: 'textbox' } để giữ lại hình học cố định riêng của mỗi trang.

Làm sao tôi kiểm tra xem một tài liệu có đáp ứng PDF/A hay không trước khi chuyển đổi?

Gọi Document.ValidatePdfA(level) (ví dụ '2b') và kiểm tra ValidationReport được trả về — điều này báo cáo trạng thái hiện tại mà không thay đổi tài liệu.

Tôi có thể chuyển đổi chỉ một phần các trang không?

Có — đầu tiên tạo một tập con Document bằng Document.ExtractPages(), sau đó gọi phương thức chuyển đổi (ToHtml(), ToDocx(), ConvertToPdfA(), và các phần còn lại) trên tập con đó.

Xem thêm

• Core API
• Installation
• FAQ
• API Reference
• Aspose.PDF — Enterprise Knowledge Base