1. Produkty
  2.   Aspose.PDF
  3.   Aspose.PDF FOSS for TypeScript

Aspose.PDF FOSS dla TypeScript

Biblioteka TypeScript open-source do tworzenia, edycji, konwersji, adnotacji i zabezpieczania dokumentów PDF — na licencji MIT, bez zależności.

Aspose.PDF FOSS — Biblioteka PDF w TypeScript o otwartym kodzie źródłowym

Aspose.PDF FOSS for TypeScript jest biblioteką open-source służącą do tworzenia, edytowania, konwertowania, i zabezpieczania dokumentów PDF w aplikacjach Node.js (>=22). Klasy Document i Page są centralnymi punktami wejścia: Document.OpenFile() / Document.Open() ładują istniejące pliki lub bajty w pamięci, Document.New() rozpoczyna pusty dokument, a WriteTo() / Save() zapisują wynik, opcjonalnie z kompresją xref-stream. Projekt jest pakietem bez zależności (Node.js jest jedynym wymogiem środowiska uruchomieniowego) i znajduje się w aktywnym wczesnym etapie rozwoju (obecnie wersja 0.1.0).

Poza podstawową edycją dokumentów i stron — dzieleniem, scalaniem, wyodrębnianiem, zmianą kolejności oraz dodawaniem stron przy użyciu Document.Split(), Document.Merge(), Document.ExtractPages() i Document.Append() — biblioteka konwertuje strony i całe dokumenty do innych formatów przy użyciu ToHtml(), ToMarkdown(), ToDocx(), ToSvg(), ToImage() oraz ToEpub(). Obsługa adnotacji obejmuje podświetlenie, podkreślenie, falistą linię, przekreślenie, link, notatkę tekstową, wolny tekst oraz znaczek poprzez metody takie jak Page.AddHighlight() i Page.AddStamp(). Pola AcroForm (tekst, pole wyboru, przycisk radiowy, pole kombinowane, lista i przycisk) są budowane za pomocą klasy Form i jej typowanych podklas Field, a dokumenty mogą być szyfrowane przy użyciu AES-128, AES-256 lub RC4, cyfrowo podpisane przy użyciu Document.Sign() oraz poddane redakcji za pomocą Document.Redact() / Page.ApplyRedactions().

Aspose.PDF FOSS for TypeScript jest udostępniane na licencji MIT bez opłat za środowisko uruchomieniowe ani ograniczeń użytkowania (zobacz sekcję instalacji poniżej). Dla rodziny produktów enterprise, zobacz Aspose.PDF — Enterprise Product Family.

Edycja dokumentu i strony

  • Otwieraj pliki PDF z dysku lub z bajtów w pamięci przy użyciu Document.OpenFile() / Document.Open(), lub rozpocznij od pustego dokumentu za pomocą Document.New()
  • Dziel, łącz, wyodrębniaj, przestawiaj i dołączaj strony przy użyciu Document.Split(), Document.Merge(), Document.ExtractPages(), Document.Reorder(), i Document.Append()
  • Czytaj i aktualizuj metadane dokumentu przy użyciu Document.SetMetadata() / Document.GetMetadata()
  • Zapisz wynik przy użyciu Document.WriteTo(), opcjonalnie skompresowany przy użyciu strumieni xref i strumieni obiektów

Gdzie jest używane

  • Backendowe potoki składania PDF, które dzielą, scalają i zmieniają kolejność przychodzących plików
  • Usługi wyodrębniania stron do podziału rozdziałów lub faktur
  • Zarządzanie metadanymi dokumentów w celu zapewnienia zgodności i archiwizacji
  • Generowanie wyjścia zoptymalizowanego pod kątem przechowywania dla wysokowolumenowych magazynów dokumentów

Konwersja formatu

  • Renderuj całe dokumenty do HTML za pomocą Document.ToHtml() oraz do Markdown w stylu GitHub przy użyciu Document.ToMarkdown()
  • Generuj wyjście .docx w formacie reflowable lub fixed-layout za pomocą Document.ToDocx() / Page.ToDocx()
  • Renderuj pojedyncze strony do samodzielnych plików SVG przy użyciu Page.ToSvg() lub do rastrowych bajtów PNG/TIFF za pomocą Page.ToImage()
  • Eksportuj do formatu EPUB przy użyciu Document.ToEpub() w celu dystrybucji na czytniki e-booków

Gdzie jest używane

  • Potoki publikacji, które zamieniają pliki PDF w gotowe do publikacji w sieci HTML lub Markdown
  • Tworzenie miniatur i podglądów dla systemów zarządzania dokumentami
  • Archiwizowanie plików PDF jako edytowalne dokumenty Word
  • Przepływy pracy dystrybucji e-booków

Adnotacje i znacznikowanie

  • Dodaj oznaczenia tekstu przy użyciu Page.AddHighlight(), Page.AddUnderline(), Page.AddSquiggly() i Page.AddStrikeOut()
  • Dołącz notatki samoprzylepne i tekst wolno stojący przy użyciu Page.AddTextNote() oraz Page.AddFreeText()
  • Umieść adnotacje w postaci pieczątek przy użyciu Page.AddStamp() oraz klikalne odnośniki przy użyciu Page.AddLink()
  • Spłaszcz dowolną adnotację do treści strony przy użyciu metody Annotation.Flatten(), dostępnej w typowanych podtypach, takich jak MarkupAnnotation i StampAnnotation

Gdzie jest używany

  • Narzędzia do przeglądu dokumentów i wprowadzania poprawek
  • Współpraca przy oznaczaniu i komentowaniu w przepływach pracy
  • Umieszczanie pieczęci zatwierdzającej w przepływach podpisywania
  • Publikowanie tylko do odczytu wcześniej interaktywnego oznaczania

AcroForms

  • Dodaj pola tekstowe, pola wyboru, pola radiowe, pola combo box, pola list box i pola push-button przy użyciu klasy Form (AddTextField(), AddCheckbox(), AddRadioGroup(), AddComboBox(), AddListBox(), AddPushButton())
  • Stylizuj i odśwież wygląd pól za pomocą SetStyle() i GenerateAppearance() w typowanych klasach pól, takich jak TextField, ChoiceField i ButtonField
  • Powiąż zachowanie pól za pomocą SetActions() na dowolnym Field
  • Spłaszcz wypełniony formularz do statycznej zawartości strony za pomocą Document.FlattenForm()

Gdzie jest używane

  • Wypełnialne formularze rządowe, podatkowe i rejestracyjne
  • Programowe wstępne wypełnianie formularzy z rekordów bazy danych
  • Spłaszczanie przesłanych formularzy przed długoterminowym archiwizowaniem
  • Interaktywne ankiety i dokumenty przyjęcia

Bezpieczeństwo, podpisywanie i redakcja

  • Zabezpiecz hasłem i zaszyfruj wyjście przy użyciu AES-128, AES-256 lub RC4 za pomocą opcji encrypt metody Document.WriteTo(), z szczegółowymi Permissions
  • Cyfrowo podpisz dokumenty przy użyciu Document.Sign() i zweryfikuj podpisy przy użyciu Document.VerifySignatures()
  • Dodaj zaufane znaczniki czasu przy użyciu Document.AddDocumentTimestamp()
  • Trwale zamaskuj wrażliwe obszary lub dopasowany tekst przy użyciu Document.Redact(), Document.RedactText() i Page.ApplyRedactions()

Gdzie jest używane

  • Dystrybucja poufnych raportów z hasłami indywidualnymi dla odbiorców
  • Cyfrowo podpisane i opatrzone znacznikiem czasu umowy
  • Redakcja danych osobowych (PII) w celu zapewnienia zgodności przed publikacją
  • Ścieżki audytu odporne na manipulacje dla regulowanych branż

Konwertuj PDF na HTML, Markdown i DOCX

Otwórz plik PDF i wyświetl go w kilku formatach wyjściowych w jednym przebiegu.

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';
const doc = Document.OpenFile('in.pdf');
const svg = doc.Pages[0].ToSvg();          // standalone <svg> string
// fs.writeFileSync('page1.svg', svg);
const png = doc.Pages[0].ToImage({ scale: 2 }); // Uint8Array of PNG bytes @144 DPI
// fs.writeFileSync('page1.png', png);
const html = doc.ToHtml();                 // standalone semantic HTML, all pages
// fs.writeFileSync('out.html', html);
const md = doc.ToMarkdown();               // GFM Markdown, all pages
// fs.writeFileSync('out.md', md);
const docx = doc.ToDocx();                 // .docx bytes, reflowed, images in the package
// fs.writeFileSync('out.docx', docx);
const fixed = doc.ToDocx({ mode: 'textbox' });  // .docx keeping each page's own geometry
// fs.writeFileSync('fixed.docx', fixed);

Edytuj strony i metadane, a następnie zapisz

Wczytaj plik PDF, edytuj jego strony i metadane oraz zapisz go ponownie z kompresją.

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

// Open from disk (or Document.Open(uint8array) for in-memory data)
const doc = Document.OpenFile('input.pdf');

// Inspect and edit pages
console.log(doc.Pages.length);
doc.Pages[0].Rotate = 90;
doc.RemovePage(2);                 // 1-based page number
doc.Reorder([3, 1, 2]);

// Metadata
doc.SetMetadata({ title: 'Report', author: 'Jane', custom: { Dept: 'R&D' } });

// Save
doc.WriteTo('output.pdf');         // or: const bytes = doc.Save();
doc.WriteTo('small.pdf', { compressed: true }); // xref stream + object streams

Utwórz nowy PDF od podstaw

Rozpocznij pusty dokument, dodaj tekst w określonej pozycji i dołącz kolejną stronę.

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');

Zabezpiecz hasłem i zaszyfruj plik PDF

Zaszyfruj istniejący plik PDF przy użyciu pary haseł użytkownika/właściciela i AES-256, ograniczając kopiowanie i modyfikację.

import { Document } from '@asposefoss/pdf';
const doc = Document.OpenFile('in.pdf');
doc.WriteTo('locked.pdf', {
  encrypt: {
    userPassword: 'open-me',       // required to open (default '')
    ownerPassword: 'full-rights',  // default: same as userPassword
    algorithm: 'aes256',           // 'aes256' (default) | 'aes128' | 'rc4'
    permissions: { copying: false, modifying: false },
    encryptMetadata: true,
  },
});

Najczęściej Zadawane Pytania

Jaki jest model licencjonowania dla Aspose.PDF FOSS for TypeScript?

Aspose.PDF FOSS for TypeScript jest wydany na licencji MIT, co pozwala na darmowe użycie w produktach komercyjnych bez opłat za czas wykonywania. Kod źródłowy jest publicznie dostępny na GitHub.

Jak zainstalować Aspose.PDF FOSS for TypeScript?

Pakiet jest przeznaczony dla Node.js 22 i nowszych oraz nie ma innych zależności w czasie wykonywania. Zobacz sekcję instalacji powyżej, aby uzyskać bieżące polecenie instalacji.

Jakie formaty plików obsługuje Aspose.PDF FOSS for TypeScript?

Biblioteka odczytuje i zapisuje PDF, Markdown, SVG oraz TIFF, a także może generować DOCX, HTML, PNG i EPUB.

Jak utworzyć nowy dokument PDF?

Użyj Document.New(PageFormat.A4), aby utworzyć pusty dokument, a następnie dodaj strony i zapisz przy użyciu Document.WriteTo().

Czy klucz licencyjny jest wymagany do użycia Aspose.PDF FOSS for TypeScript?

Nie wymaga klucza licencyjnego ani kroku aktywacji. Biblioteka działa w pełni nie licencjonowana bez kosztów na licencji MIT.

  

Zasoby Wsparcia i Nauki

 Polski