Bridgetown Writebook

A Bridgetown plugin to add WriteBook style books to your static website.

Run this command to add this plugin to your site's Gemfile:

bundle add bridgetown_writebook

After installation, the plugin provides a complete book management system for your Bridgetown site. Books are organized as collections, with each book containing multiple chapters.

1. Set up the books infrastructure (one-time setup):

   bridgetown book setup

   This creates the necessary folder structure and adds the books collection to your Bridgetown configuration.

2. Create a new book:

   bridgetown book new --title "My Awesome Book"

   This creates a folder under src/_books/ with an initial metadata file.

3. Add chapters to your book:

   bridgetown book chapters add --book "My Awesome Book" --title "Introduction"

   Chapters are automatically numbered and added to your book's folder.

Each book consists of:

• A metadata file (00-meta.md) containing title, subtitle, and authors
• Numbered chapter files (e.g., 01-introduction.md, 02-getting-started.md)
• An optional cover image (cover.png in the book's folder)

The plugin automatically generates:

• A books index page at /books/ listing all your books
• Individual book pages at /books/[book-slug]/ showing chapters
• Chapter pages with navigation between previous/next chapters