📄 WOT-PDF - Advanced PDF Generation v1.2.5

Professional PDF generation with Production Builder v1.2.5 + Enhanced Anchor System + Comprehensive Book Generation

🎉 NEW in v1.2.5 - Comprehensive Book Generation + Enhanced Anchor System

✅ Major Breakthroughs in v1.2.5

• � Comprehensive Book Generation: Multi-document book creation with automatic TOC
• 🔗 Enhanced Anchor System: Complete {#anchor} → conversion with cross-reference navigation
• 🎯 Double Numbering Fix: Resolved manual+automatic numbering conflicts in academic templates
• ⚡ Production Builder: Enterprise-grade build pipeline with sub-60ms performance
• 🎨 Professional Code Highlighting: Native Typst #raw() integration with syntax highlighting
• 🌐 Internet Image Support: Download & cache images from URLs with hash-based system
• 🔧 CLI Auto-Installation: Intelligent detection & installation of diagram tools (mermaid, dot, d2, plantuml)

📊 v1.2.5 vs Previous Versions

• Book Generation: Single docs → Multi-document books with TOC
• Anchor System: Basic → Complete cross-reference navigation
• Document Structure: Manual numbering conflicts → Clean automatic numbering
• Code Blocks: Basic → Professional Syntax Highlighting
• Images: Local only → Internet URLs + Caching
• CLI Tools: Manual install → Auto-detection + Install
• Build Time: Variable → Consistent < 60ms
• Error Handling: Basic → Graceful fallback system

🆕 Previous v1.2.0 Features

• Advanced Table Processing: Captions + cross-references + positioning
• Production Builder: Hash-based caching system
• Cross-Reference System: @tbl:label, @fig:label support
• Enhanced Emoji Support: Full Unicode with professional tables

✨ Core Features

🎯 Production Builder v1.2.1

• Professional Code Highlighting: 8+ languages with Typst native syntax
• Internet Image Processing: Auto-download & cache with hash-based system
• CLI Auto-Installation: Smart detection for mermaid, dot, d2, plantuml
• Advanced Table Processing: Captions + cross-references + positioning
• Enterprise Performance: Sub-60ms builds with intelligent caching

🚀 Dual PDF Engines

• Enhanced ReportLab v3.0: Performance leader for business documents ⚡
• Production Typst Builder: Quality leader for academic documents 🎨
• Intelligent Routing: Automatic engine selection based on content

📚 Professional Document Generation

• Convert markdown to production-ready PDFs
• Complete table of contents with numbering
• Full emoji and Unicode support 😊🚀📊
• Professional code blocks with syntax highlighting
• Internet image support with intelligent caching
• Rich CLI interface with auto-setup
• GUI frontend (optional)

🚀 Quick Start

Installation

pip install wot-pdf

Basic Usage

# Production Builder with all v1.2.1 enhancements
wot-pdf build document.md --pdf --template technical

# Generate single PDF from file
wot-pdf generate --input document.md --output result.pdf --template technical

# Create professional book from directory
wot-pdf book ./docs/ book.pdf --template technical

# Test all v1.2.1 features  
wot-pdf demo --all-features

# List available templates
wot-pdf templates

# Show detailed template information
wot-pdf template-info technical

# GUI mode (if installed)
wot-pdf-gui

Python API

from wot_pdf import PDFGenerator, generate_book

# Simple generation
generator = PDFGenerator()
result = generator.generate("document.md", "output.pdf")

# Book generation
result = generate_book(
    input_dir="./docs/",
    output_file="book.pdf", 
    template="technical"
)

📖 Templates

🛠️ Installation Options

Minimal Installation

pip install wot-pdf

With Development Tools

pip install wot-pdf[dev]

With GUI Support

pip install wot-pdf[gui]

With Documentation Tools

pip install wot-pdf[docs]

📋 Requirements

• Python: 3.8+
• System Typst CLI (recommended): Install from typst.app
• ReportLab: Automatically installed (fallback engine)

🎯 Use Cases

✅ Technical Documentation

• API references
• User manuals
• Installation guides

✅ Academic Publishing

• Research papers
• Thesis documents
• Conference proceedings

✅ Business Reports

• Quarterly reports
• Project documentation
• Presentation materials

✅ Educational Content

• Course materials
• Tutorials
• Reference guides

📊 Comparison

🔧 Configuration

Create .wot-pdf.yaml in your project:

default_template: technical
output_directory: ./generated/
typst:
  enabled: true
  timeout: 60
reportlab:
  compression: true
  embed_fonts: true

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

📜 License

MIT License - see LICENSE file for details.

🔗 Links

• 📚 Documentation
• 🐛 Issues
• 💬 Discussions
• 🌟 Source Code

Made with ❤️ by the Work Organizing Tools team