Skip to content

A simple template and workflow for publishing books with Pandoc

License

Notifications You must be signed in to change notification settings

speedshop/bookbuilder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

A Simple Book Build Pipeline with Pandoc

This repository is a simple build process for making books with Pandoc. It was used to publish The Complete Guide to Rails Performance and The Ruby on Rails Performance Apocrypha.

This configuration creates PDF, EPUB, TXT, and HTML build artifacts.

Usage

Put contents (I use Markdown, but because it's Pandoc, you can use almost any format for input) inside the /content directory. They will be concatenated in alphabetical order to form the book, so I typically use something like the following structure:

content/00_introduction.md 
content/01_first_chapter.md 
content/02_second_chapter.md
...

h1 and h2 will cause a page break, using the CSS I have in the pandoc folder. I like to have "sub sections" in my books, so I use h1 for the section headers and h2 for chapter headers. h3 and below can be used for emphasis but do not appear in the table of contents.

Images go in the img folder.

The pandoc/epub_metadata.md file is a special place for putting epub-specific metadata.

$ make and $ make clean build and delete the build artifacts, respectively.

$ make wordcount will count the words in the content folder.

About

A simple template and workflow for publishing books with Pandoc

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published