RoboLibro

Tools for creating books with markdown

Requires

• Node.js
• Pandoc

General

Basically, you define a list (or glob pattern) of markdown files in a YAML file. RoboLibro takes that and concatenates the markdown files into a single file, inserting chapter headers, and feeds it to pandoc.

Installation

$ npm install -g github:mattmccray/robolibro

Init

Create a YAML file with default values for you to customize for your book.

$ robolibro init path/to/new/book.yaml

Usage

To create a .docx file that is formatted to be easily imported into Vellum:

$ robolibro build path/to/book.yaml

YAML definition example:

title: My Book
subtitle: (Optional)
author: Me
output: manuscript.docx
create_titlepage: false
cleanup: true
input:
  - manuscript/*.md

Nested definition

$ robolibro build path/to/book.yaml --target beta

YAML definition example:

title: My Book
author: Me
output: manuscript.docx
create_titlepage: false
cleanup: true
input:
  - manuscript/*.md

# Nested target inherits all parent config properties
beta: 
  output: manuscript-beta.docx
  create_titlepage: true
  input:
    - manuscript/*.md
    - extra/beta-readers.md