Aspose.PDF FOSS for TypeScript — Часто задаваемые вопросы

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 для TypeScript читать и записывать?

Библиотека читает и записывает PDF, а также может читать и записывать Markdown, SVG и TIFF. Она также может генерировать вывод в форматах DOCX, HTML, PNG и EPUB, хотя не может читать обратно эти четыре формата.

Могу ли я конвертировать PDF в Markdown или HTML?

Да. Document.ToMarkdown() преобразует весь документ в GitHub-flavored 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 при сохранении?

Передайте параметр encrypt в Document.WriteTo() вместе с algorithm: 'aes256' | 'aes128' | 'rc4', необязательной парой паролей пользователя/владельца и детальными Permissions.

Как замаскировать конфиденциальный контент в PDF?

Document.Redact() и Document.RedactText() отмечают и окончательно удаляют чувствительные области или найденный текст; Page.ApplyRedactions() применяет ранее добавленные метки. Оба настраиваются через RedactOptions.


Известные ограничения

Является ли API стабильным?

Пока нет. Пакет сейчас находится на версии 0.1.0 и находится в активной ранней стадии разработки, поэтому подписи API могут измениться до стабильного релиза.

Есть ли у библиотеки какие-либо документированные нереализованные функции?

На момент написания этого текста в исходном коде библиотеки не обнаружено ни не реализованных, ни заглушечных методов.

См. также:

 Русский