# 📄 WOT-PDF - Advanced PDF Generation v1.2.5
[](https://badge.fury.io/py/wot-pdf)
[](https://pypi.org/project/wot-pdf/)
[](https://opensource.org/licenses/MIT)
**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} → <label> 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
```bash
pip install wot-pdf
```
### Basic Usage
```bash
# 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
```python
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
```bash
pip install wot-pdf
```
### With Development Tools
```bash
pip install wot-pdf[dev]
```
### With GUI Support
```bash
pip install wot-pdf[gui]
```
### With Documentation Tools
```bash
pip install wot-pdf[docs]
```
## 📋 Requirements
- **Python**: 3.8+
- **System Typst CLI** (recommended): [Install from typst.app](https://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:
```yaml
default_template: technical
output_directory: ./generated/
typst:
enabled: true
timeout: 60
reportlab:
compression: true
embed_fonts: true
```
## 🤝 Contributing
We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
## 📜 License
MIT License - see [LICENSE](LICENSE) file for details.
## 🔗 Links
- 📚 [Documentation](https://wot-pdf.readthedocs.io)
- 🐛 [Issues](https://github.com/work-organizing-tools/wot-pdf/issues)
- 💬 [Discussions](https://github.com/work-organizing-tools/wot-pdf/discussions)
- 🌟 [Source Code](https://github.com/work-organizing-tools/wot-pdf)
---
**Made with ❤️ by the Work Organizing Tools team**
Raw data
{
"_id": null,
"home_page": null,
"name": "wot-pdf",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "pdf, typst, reportlab, markdown, mermaid, diagrams, book, generation, professional, automation",
"author": null,
"author_email": "Work Organizing Tools <info@wot-tools.com>",
"download_url": "https://files.pythonhosted.org/packages/a2/a7/723884ebe1b4e8d6bc08fb2d4cd2e2f196474f817a59078246e84a4123be/wot_pdf-1.2.5.tar.gz",
"platform": null,
"description": "# \ud83d\udcc4 WOT-PDF - Advanced PDF Generation v1.2.5\r\n\r\n[](https://badge.fury.io/py/wot-pdf)\r\n[](https://pypi.org/project/wot-pdf/)\r\n[](https://opensource.org/licenses/MIT)\r\n\r\n**Professional PDF generation with Production Builder v1.2.5 + Enhanced Anchor System + Comprehensive Book Generation**\r\n\r\n## \ud83c\udf89 NEW in v1.2.5 - Comprehensive Book Generation + Enhanced Anchor System\r\n\r\n### \u2705 Major Breakthroughs in v1.2.5\r\n- **\ufffd Comprehensive Book Generation**: Multi-document book creation with automatic TOC\r\n- **\ud83d\udd17 Enhanced Anchor System**: Complete {#anchor} \u2192 <label> conversion with cross-reference navigation\r\n- **\ud83c\udfaf Double Numbering Fix**: Resolved manual+automatic numbering conflicts in academic templates\r\n- **\u26a1 Production Builder**: Enterprise-grade build pipeline with sub-60ms performance\r\n- **\ud83c\udfa8 Professional Code Highlighting**: Native Typst `#raw()` integration with syntax highlighting\r\n- **\ud83c\udf10 Internet Image Support**: Download & cache images from URLs with hash-based system\r\n- **\ud83d\udd27 CLI Auto-Installation**: Intelligent detection & installation of diagram tools (mermaid, dot, d2, plantuml)\r\n\r\n### \ud83d\udcca v1.2.5 vs Previous Versions\r\n- **Book Generation**: Single docs \u2192 **Multi-document books with TOC**\r\n- **Anchor System**: Basic \u2192 **Complete cross-reference navigation** \r\n- **Document Structure**: Manual numbering conflicts \u2192 **Clean automatic numbering**\r\n- **Code Blocks**: Basic \u2192 **Professional Syntax Highlighting**\r\n- **Images**: Local only \u2192 **Internet URLs + Caching** \r\n- **CLI Tools**: Manual install \u2192 **Auto-detection + Install**\r\n- **Build Time**: Variable \u2192 **Consistent < 60ms**\r\n- **Error Handling**: Basic \u2192 **Graceful fallback system**\r\n\r\n## \ud83c\udd95 Previous v1.2.0 Features\r\n- **Advanced Table Processing**: Captions + cross-references + positioning\r\n- **Production Builder**: Hash-based caching system \r\n- **Cross-Reference System**: `@tbl:label`, `@fig:label` support\r\n- **Enhanced Emoji Support**: Full Unicode with professional tables\r\n\r\n## \u2728 Core Features\r\n\r\n\ud83c\udfaf **Production Builder v1.2.1**\r\n- **Professional Code Highlighting**: 8+ languages with Typst native syntax\r\n- **Internet Image Processing**: Auto-download & cache with hash-based system \r\n- **CLI Auto-Installation**: Smart detection for mermaid, dot, d2, plantuml\r\n- **Advanced Table Processing**: Captions + cross-references + positioning\r\n- **Enterprise Performance**: Sub-60ms builds with intelligent caching\r\n\r\n\ud83d\ude80 **Dual PDF Engines** \r\n- **Enhanced ReportLab v3.0**: Performance leader for business documents \u26a1\r\n- **Production Typst Builder**: Quality leader for academic documents \ud83c\udfa8\r\n- **Intelligent Routing**: Automatic engine selection based on content\r\n\r\n\ud83d\udcda **Professional Document Generation**\r\n- Convert markdown to production-ready PDFs\r\n- Complete table of contents with numbering\r\n- Full emoji and Unicode support \ud83d\ude0a\ud83d\ude80\ud83d\udcca\r\n- Professional code blocks with syntax highlighting\r\n- Internet image support with intelligent caching\r\n- Rich CLI interface with auto-setup\r\n- GUI frontend (optional)\r\n\r\n## \ud83d\ude80 Quick Start\r\n\r\n### Installation\r\n\r\n```bash\r\npip install wot-pdf\r\n```\r\n\r\n### Basic Usage\r\n\r\n```bash\r\n# Production Builder with all v1.2.1 enhancements\r\nwot-pdf build document.md --pdf --template technical\r\n\r\n# Generate single PDF from file\r\nwot-pdf generate --input document.md --output result.pdf --template technical\r\n\r\n# Create professional book from directory\r\nwot-pdf book ./docs/ book.pdf --template technical\r\n\r\n# Test all v1.2.1 features \r\nwot-pdf demo --all-features\r\n\r\n# List available templates\r\nwot-pdf templates\r\n\r\n# Show detailed template information\r\nwot-pdf template-info technical\r\n\r\n# GUI mode (if installed)\r\nwot-pdf-gui\r\n```\r\n\r\n### Python API\r\n\r\n```python\r\nfrom wot_pdf import PDFGenerator, generate_book\r\n\r\n# Simple generation\r\ngenerator = PDFGenerator()\r\nresult = generator.generate(\"document.md\", \"output.pdf\")\r\n\r\n# Book generation\r\nresult = generate_book(\r\n input_dir=\"./docs/\",\r\n output_file=\"book.pdf\", \r\n template=\"technical\"\r\n)\r\n```\r\n\r\n## \ud83d\udcd6 Templates\r\n\r\n| Template | Best For | Features |\r\n|----------|----------|----------|\r\n| `academic` | Research papers | Citations, bibliography, equations |\r\n| `technical` | Documentation | Code blocks, diagrams, TOC |\r\n| `corporate` | Business reports | Professional styling, charts |\r\n| `educational` | Learning materials | Exercises, callouts, examples |\r\n| `minimal` | Simple documents | Clean, fast generation |\r\n\r\n## \ud83d\udee0\ufe0f Installation Options\r\n\r\n### Minimal Installation\r\n```bash\r\npip install wot-pdf\r\n```\r\n\r\n### With Development Tools\r\n```bash\r\npip install wot-pdf[dev]\r\n```\r\n\r\n### With GUI Support\r\n```bash\r\npip install wot-pdf[gui]\r\n```\r\n\r\n### With Documentation Tools\r\n```bash\r\npip install wot-pdf[docs]\r\n```\r\n\r\n## \ud83d\udccb Requirements\r\n\r\n- **Python**: 3.8+\r\n- **System Typst CLI** (recommended): [Install from typst.app](https://typst.app)\r\n- **ReportLab**: Automatically installed (fallback engine)\r\n\r\n## \ud83c\udfaf Use Cases\r\n\r\n\u2705 **Technical Documentation**\r\n- API references\r\n- User manuals \r\n- Installation guides\r\n\r\n\u2705 **Academic Publishing**\r\n- Research papers\r\n- Thesis documents\r\n- Conference proceedings\r\n\r\n\u2705 **Business Reports**\r\n- Quarterly reports\r\n- Project documentation\r\n- Presentation materials\r\n\r\n\u2705 **Educational Content**\r\n- Course materials\r\n- Tutorials\r\n- Reference guides\r\n\r\n## \ud83d\udcca Comparison\r\n\r\n| Feature | wot-pdf | pandoc | WeasyPrint |\r\n|---------|---------|--------|------------|\r\n| Typst Integration | \u2705 | \u274c | \u274c |\r\n| Fallback Engine | \u2705 | \u274c | \u274c |\r\n| Professional Templates | \u2705 | Limited | Limited |\r\n| Book Generation | \u2705 | Manual | Manual |\r\n| GUI Interface | \u2705 | \u274c | \u274c |\r\n| CLI Interface | \u2705 | \u2705 | Limited |\r\n\r\n## \ud83d\udd27 Configuration\r\n\r\nCreate `.wot-pdf.yaml` in your project:\r\n\r\n```yaml\r\ndefault_template: technical\r\noutput_directory: ./generated/\r\ntypst:\r\n enabled: true\r\n timeout: 60\r\nreportlab:\r\n compression: true\r\n embed_fonts: true\r\n```\r\n\r\n## \ud83e\udd1d Contributing\r\n\r\nWe welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\r\n\r\n## \ud83d\udcdc License\r\n\r\nMIT License - see [LICENSE](LICENSE) file for details.\r\n\r\n## \ud83d\udd17 Links\r\n\r\n- \ud83d\udcda [Documentation](https://wot-pdf.readthedocs.io)\r\n- \ud83d\udc1b [Issues](https://github.com/work-organizing-tools/wot-pdf/issues)\r\n- \ud83d\udcac [Discussions](https://github.com/work-organizing-tools/wot-pdf/discussions)\r\n- \ud83c\udf1f [Source Code](https://github.com/work-organizing-tools/wot-pdf)\r\n\r\n---\r\n\r\n**Made with \u2764\ufe0f by the Work Organizing Tools team**\r\n",
"bugtrack_url": null,
"license": null,
"summary": "WOT-PDF v1.2.5: Comprehensive PDF Generation with Version Consistency",
"version": "1.2.5",
"project_urls": {
"Documentation": "https://wot-pdf.readthedocs.io/",
"Homepage": "https://github.com/work-organizing-tools/wot-pdf",
"Issues": "https://github.com/work-organizing-tools/wot-pdf/issues",
"Repository": "https://github.com/work-organizing-tools/wot-pdf.git"
},
"split_keywords": [
"pdf",
" typst",
" reportlab",
" markdown",
" mermaid",
" diagrams",
" book",
" generation",
" professional",
" automation"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "0f958058a400b7606dfa193d8774cc520fbdad3ceb60ae8332f8578e0121b5bf",
"md5": "e3770ba51b831a6afb0735be12376162",
"sha256": "69d70f1e1b886515076704c8e0e96c7a638f0613a1c894e8b8858a07dd627aa6"
},
"downloads": -1,
"filename": "wot_pdf-1.2.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e3770ba51b831a6afb0735be12376162",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 239464,
"upload_time": "2025-09-01T00:14:34",
"upload_time_iso_8601": "2025-09-01T00:14:34.130068Z",
"url": "https://files.pythonhosted.org/packages/0f/95/8058a400b7606dfa193d8774cc520fbdad3ceb60ae8332f8578e0121b5bf/wot_pdf-1.2.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "a2a7723884ebe1b4e8d6bc08fb2d4cd2e2f196474f817a59078246e84a4123be",
"md5": "cfc758199583511952c2de53e09d0f47",
"sha256": "ff0adb7a252ab0b66087b30b14b309a4c6f1cfa899de102d69b1236d0d43cb3f"
},
"downloads": -1,
"filename": "wot_pdf-1.2.5.tar.gz",
"has_sig": false,
"md5_digest": "cfc758199583511952c2de53e09d0f47",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 179293,
"upload_time": "2025-09-01T00:14:35",
"upload_time_iso_8601": "2025-09-01T00:14:35.594011Z",
"url": "https://files.pythonhosted.org/packages/a2/a7/723884ebe1b4e8d6bc08fb2d4cd2e2f196474f817a59078246e84a4123be/wot_pdf-1.2.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-01 00:14:35",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "work-organizing-tools",
"github_project": "wot-pdf",
"github_not_found": true,
"lcname": "wot-pdf"
}
JSON
