A lightweight microservice for processing Word document templates with data injection and PDF conversion. Combines the power of docxtpl templating with Gotenberg PDF generation.
🔍 NEW: Integrated Template Linting - All templates are automatically validated before processing with comprehensive error reporting.
- 📄 Process
.docxtemplates with dynamic data - 🔄 Convert results to PDF automatically
- 🚀 Fast REST API built with FastAPI
- 🔍 NEW: Integrated Template Linting with strict validation by default
- 🐳 Docker-ready with compose setup
- ☸️ Kubernetes deployment manifests
- 📚 Comprehensive documentation and examples
# Clone and start with Docker Compose
git clone <repository-url>
cd document-templating-service
docker compose up -d
# Service will be available at http://localhost:8000- 📋 Installation Guide - Complete setup instructions
- 🔧 Usage Guide - Service usage and templating examples
- 🖼️ Image Support Guide - Include inline images in templates
- 🔍 DocX Linter Guide - NEW: Validate Jinja templates in Word documents
- 🐳 Docker Integration Guide - Integrate with existing Docker Compose stacks
- Backend: FastAPI 0.115.6, Python 3.12
- Templating: docxtpl 0.19.0 (Jinja2-based)
- PDF Generation: Gotenberg 8
- Deployment: Docker, Kubernetes
This version includes major dependency updates:
- Python 3.8 → 3.12
- FastAPI 0.68.0 → 0.115.6
- Pydantic 1.8.2 → 2.10.3
- All dependencies updated to latest stable versions
Feel free to open issues and pull requests. Please include a description with your PR.
This project is licensed under the MIT License - see the LICENSE file for details.
Etherisc GmbH (Originally created by M.B.C.M (PapiHack))
💡 Need help? Check the documentation or open an issue!