wot-pdf 1.0.4

Advanced PDF generation with intelligent Mermaid support and dual-engine architecture

📄 WOT-PDF - Advanced PDF Generation

Professional PDF generation with dual-engine architecture (Typst + ReportLab fallback)

✨ Features

🎯 Dual PDF Engines

• Primary: System Typst CLI (superior typography)
• Fallback: ReportLab (100% reliability)

📚 Book Generation

• Convert markdown directories to professional books
• 5 professional templates (Academic, Technical, Corporate, Educational, Minimal)
• Automatic table of contents
• Cross-reference management

🎨 Professional Templates

• Academic papers with citations
• Technical documentation
• Corporate reports
• Educational materials
• Clean minimal design

⚡ Advanced Features

• Batch processing
• Custom styling
• Rich CLI interface
• GUI frontend (optional)
• Professional typography

🚀 Quick Start

Installation

pip install wot-pdf

Basic Usage

# Generate single PDF
wot-pdf --input document.md --output result.pdf

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

# List available templates
wot-pdf templates

# 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

Template	Best For	Features
academic	Research papers	Citations, bibliography, equations
technical	Documentation	Code blocks, diagrams, TOC
corporate	Business reports	Professional styling, charts
educational	Learning materials	Exercises, callouts, examples
minimal	Simple documents	Clean, fast generation

🛠️ 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

Feature	wot-pdf	pandoc	WeasyPrint
Typst Integration	✅	❌	❌
Fallback Engine	✅	❌	❌
Professional Templates	✅	Limited	Limited
Book Generation	✅	Manual	Manual
GUI Interface	✅	❌	❌
CLI Interface	✅	✅	Limited

🔧 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