Repolode
Lulzx

Lulzx/tinypdf

텍스트, 사각형, 선, JPEG 이미지와 링크가 포함된 PDF 파일을 생성하는 의존성 없는 경량 TypeScript 라이브러리입니다.

스타
1,923
포크
76
열린 이슈
0
마지막 커밋
2개월 전

어떤 프로젝트인가요?

tinypdf는 TypeScript와 JavaScript용 경량 PDF 생성 라이브러리입니다. 의존성이 없고 코드가 400줄 미만이며, 크기는 약 3.3 KB입니다. 사용자 지정 글꼴, PNG/SVG, 폼, 암호화, HTML-to-PDF 변환은 의도적으로 제외하고 페이지에 텍스트와 이미지를 배치하는 데 집중합니다.

콜백 기반 API로 문서를 만듭니다. 페이지를 생성하고 텍스트, 사각형, 선, JPEG 이미지와 클릭 가능한 링크를 그린 다음, build()를 호출해 Uint8Array를 얻거나 대용량 파일의 경우 buildStream()을 호출해 ReadableStream을 얻습니다. markdown() 헬퍼는 제목, 목록, 구분선이 포함된 간단한 Markdown을 페이지가 나뉜 PDF로 변환하고, measureText()는 텍스트 너비를 포인트 단위로 반환합니다.

레이아웃이 고정되어 있고 Helvetica 텍스트로 충분한 청구서, 영수증, 보고서, 티켓, 인증서를 생성하는 데 적합합니다. 유니코드 글꼴이나 더 복잡한 PDF 기능이 필요하다면 README에서 jsPDF 또는 pdf-lib를 안내합니다.

핵심 기능

  • 01사용자 지정 크기, 16진수 색상, 정렬을 설정해 Helvetica 텍스트를 그립니다.
  • 02페이지에 채워진 사각형, 선, JPEG 이미지를 추가합니다.
  • 03선택적으로 밑줄을 적용해 클릭 가능한 링크를 만듭니다.
  • 04사용자 지정 크기의 여러 페이지를 지원합니다.
  • 05간단한 Markdown을 페이지가 나뉜 PDF로 변환합니다.
  • 06buildStream()으로 대용량 문서를 스트리밍합니다.

활용 사례

  • 레이아웃이 고정된 청구서와 영수증 생성.
  • 로고와 서명이 들어간 행사 티켓 또는 인증서 제작.
  • Node, Bun 또는 서버 측 JavaScript 앱에서 데이터 보고서를 PDF로 내보내기.
  • 무거운 의존성을 추가하지 않고 HTTP 응답으로 PDF 제공.

빠른 시작

  1. 1

    npm에서 패키지를 설치합니다

    npm install tinypdf
  2. 2

    pdf를 가져오고 문서를 만든 다음 텍스트와 도형이 포함된 페이지를 추가하고 파일을 씁니다

  3. 3

    Bun으로 원하는 예제를 실행합니다

    bun examples/executive-report.ts

사용 전 알아둘 점

  • 텍스트에는 내장 Helvetica 글꼴과 WinAnsi 인코딩만 사용할 수 있습니다. Unicode와 사용자 지정 글꼴은 지원하지 않습니다.
  • 이미지는 JPEG만 지원합니다. PNG, GIF, SVG는 지원하지 않습니다.
  • 양식, 암호화, 압축, HTML-to-PDF 등의 기능은 포함되어 있지 않습니다.

토픽

자주 묻는 질문

tinypdf은(는) 무엇인가요?
텍스트, 사각형, 선, JPEG 이미지와 링크가 포함된 PDF 파일을 생성하는 의존성 없는 경량 TypeScript 라이브러리입니다. tinypdf는 TypeScript와 JavaScript용 경량 PDF 생성 라이브러리입니다. 의존성이 없고 코드가 400줄 미만이며, 크기는 약 3.3 KB입니다. 사용자 지정 글꼴, PNG/SVG, 폼, 암호화, HTML-to-PDF 변환은 의도적으로 제외하고 페이지에 텍스트와 이미지를 배치하는 데 집중합니다.
tinypdf은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
tinypdf은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
tinypdf은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. tinypdf의 마지막 커밋은 2026년 8월 13일입니다.
tinypdf은(는) 어디에 사용할 수 있나요?
레이아웃이 고정된 청구서와 영수증 생성. 로고와 서명이 들어간 행사 티켓 또는 인증서 제작. Node, Bun 또는 서버 측 JavaScript 앱에서 데이터 보고서를 PDF로 내보내기. 무거운 의존성을 추가하지 않고 HTTP 응답으로 PDF 제공.
tinypdf는 어떻게 설치하나요?
npm에서 패키지를 설치합니다: npm install tinypdf pdf를 가져오고 문서를 만든 다음 텍스트와 도형이 포함된 페이지를 추가하고 파일을 씁니다 Bun으로 원하는 예제를 실행합니다: bun examples/executive-report.ts
tinypdf은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Lulzx/tinypdf

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트