Aspose.PDF FOSS for TypeScript — 常见问题
许可与开源
什么是 Aspose.PDF FOSS for TypeScript 的许可模式？
Aspose.PDF FOSS for TypeScript 在 MIT 许可证下发布。源代码发布在 GitHub，且没有评估水印、使用限制或需要管理的单独许可证文件。
我可以在商业产品中使用它吗？
可以。MIT 许可证允许在商业产品中使用，无需版税，也无需除保留许可证声明外的署名要求。
安装与要求
我该如何安装 Aspose.PDF FOSS for TypeScript？
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支持哪些 Node.js 版本？
需要 Node.js 22 或更高版本。
还有其他运行时依赖吗？
没有。此软件包零依赖——Node.js 是唯一的运行时要求。
格式支持
哪些格式可以 Aspose.PDF FOSS for TypeScript 读取和写入？
该库可以读取和写入 PDF，也能够读取和写入 Markdown、SVG 和 TIFF。它还可以生成 DOCX、HTML、PNG 和 EPUB 输出，尽管它不再读取这四种格式。
我可以将 PDF 转换为 Markdown 或 HTML 吗？
是的。Document.ToMarkdown() 将整个文档渲染为 GitHub 风格的 Markdown，Document.ToHtml() 将其渲染为独立的语义 HTML。
我可以将 PDF 页面渲染为图像吗？
是的。Page.ToImage() 将单页渲染为光栅 PNG 字节，Page.ToSvg() 将页面渲染为独立的 SVG。
API Usage
处理 PDF 文档的主要入口点是什么？
是 Document 类。Document.OpenFile() 从文件路径打开 PDF，Document.Open() 接受内存中的字节，Document.New() 启动一个空白文档。
我如何从头创建一个新的 PDF？
使用 Document.New() 并提供一个 PageFormat，然后使用诸如 Page.AddText() 和 Document.AddPage() 等方法添加内容：
import { Document, PageFormat } from '@asposefoss/pdf';
const doc = Document.New(PageFormat.A4); // one blank A4 page
doc.Pages[0].AddText('Hello', 72, 720, { fontSize: 14 });
doc.AddPage(PageFormat.A4.landscape()); // append more as you go
doc.WriteTo('scratch.pdf');如何向页面添加批注？
每个 Page 直接公开批注方法，例如 Page.AddHighlight()、Page.AddTextNote()、Page.AddFreeText() 和 Page.AddStamp()。像 MarkupAnnotation 和 StampAnnotation 这样的类型子类公开一个 Flatten() 方法，以将批注嵌入页面内容中。
保存 PDF 时如何加密？
向 Document.WriteTo() 传递一个 encrypt 选项，使用 algorithm: 'aes256' | 'aes128' | 'rc4'，以及可选的用户/所有者密码对，并提供细粒度的 Permissions。
如何在 PDF 中遮蔽敏感内容？
Document.Redact() 和 Document.RedactText() 标记并永久删除敏感区域或匹配的文本；Page.ApplyRedactions() 应用之前添加的标记。两者均通过 RedactOptions 配置。
已知限制
API 稳定吗？
尚未。该软件包当前版本为 0.1.0，正处于积极的早期开发阶段，因此在正式发布之前，API 的签名可能会演变。
该库是否有任何已记录的未实现功能？
截至撰写本文时，库的源代码中未检测到未实现或存根方法。
