Home

Welcome to the write-book-template Wiki

The write-book-template is a complete, automation-ready starter kit for **writing, translating, and publishing books ** across multiple formats. It unifies your entire author workflow, from project setup to final export for platforms like Amazon KDP, Apple Books, or self-hosted releases.

All automation is provided by the manuscripta library, which is installed automatically as a dependency.

---

1. Setup

Get started by creating your base project structure and development environment.

• Project Initialization - Create a ready-to-use book project with the recommended layout.
• Generate Project Structure - Scaffold all folders, templates, and configs automatically.
• How to Write a Book - Learn the conventions for chapters, metadata, and project flow.
• Developer Workflow & Makefile - Standardized commands for building and exporting.

---

2. Create (Writing & Assets)

Write, organize, and enrich your book content with automated tools.

• Chapter File Generator - Instantly generate new chapter templates.
• Generate Images - Use AI to create illustrations and cover art.
• Convert Markdown Images - Clean up or reformat embedded images.
• Bulk Change File Extensions - Rename or re-structure files in batches.
• Restructure Chapters - Reorder, rename, or unify chapters automatically.
• Remove Bold from Markdown Headers - Clean Markdown headers by removing unwanted **bold** markers from titles.

---

3. Translate

Translate your entire manuscript with automated or local AI tools.

• Translate Markdown with DeepL - Cloud-based high-quality translations.
• Translate with LM Studio - Offline/local translation workflows.
• Translation CLI Commands - Fast command-line translation shortcuts.
• Shortcuts for Translation - Reusable automation scripts for translators.

---

4. Export & Publish

Turn your manuscript into publish-ready formats.

• Automatic Book Export - Build all formats (PDF, EPUB, DOCX) at once.
• Export HTML Chapters (Comics) - Special export flow for illustrated projects.
• Export to EPUB 2 - Generate EPUB files for all major e-readers.
• Pandoc Batch Processor - Multi-target Markdown conversion via Pandoc.
• Export HTML Books to PDF (KDP Ready) - Print-ready PDFs optimized for KDP.
• Shortcuts for Export - Streamlined commands for batch exports.

---

5. Enhance (Audio & Automation)

Add advanced features to your publishing pipeline.

• Generate Audiobook - Convert your chapters into audio automatically.
• Shortcuts for Initialization - Rapid project bootstrap for new books.
• Generate AI-ready Tag Messages - Structured release notes for automated tagging.

---

Architecture

This template uses two external libraries:

• manuscripta - Provides all CLI commands for export, translation, audiobook generation, and project management.
• manuscript-tools - Provides manuscript validation, sanitization, and metrics.

The template itself contains only your manuscript content, configuration, and assets. No Python scripts are stored locally. Updates to the pipeline arrive via poetry update.

---

How to Use This Wiki

• Use the sidebar to navigate between major workflows.
• Start with Setup to initialize your project and environment.
• Move through Create -> Translate -> Export for the full publishing pipeline.
• Check Enhance tools to add automation and audio.

---