Introduction to PageForge

PageForge is a powerful document generation library designed to create professional PDFs with consistent styling, logo placement, and proper page numbering. It’s built to be easy to use while offering powerful customization options.

Core Philosophy

PageForge is built on several key principles:

Simplicity: Create professional documents with minimal code
Consistency: Ensure logos, headers, and footers appear consistently across pages
Flexibility: Support various document types and content structures
Integration: Seamlessly work with LLM-generated content

Key Features

Single Logo Support

PageForge allows you to include a single logo image consistently positioned on every page. The current implementation supports:

PNG, JPG/JPEG image formats
Maximum file size of 2MB
Top-right corner positioning by default (customizable)
Consistent rendering across all pages

Page Numbering

Documents can include dynamic page numbering in the footer, with placeholders that are automatically replaced:

{page_number}: Current page number
{total_pages}: Total number of pages

Document Structure

PageForge supports a variety of content sections:

Headers and titles
Paragraphs with formatted text
Tables with customizable styling
Bulleted and numbered lists
Footer text with dynamic page numbers

Multiple Interfaces

API Mode: Generate documents programmatically
CLI Mode: Create documents from the command line
LLM Integration: Accept structured content from language models

Design Principles

PageForge follows SOLID principles:

Single Responsibility: Each class has a focused purpose
Open/Closed: Extend functionality without modifying core code
Liskov Substitution: Components are interchangeable through interfaces
Interface Segregation: Focused interfaces for specific functionality
Dependency Inversion: Depend on abstractions, not implementations

Design patterns used include Strategy Pattern for logo positioning and Factory Pattern for document generation.