bookmaker
v1.2.1
Published
Create books from a folder of markdown files
Downloads
15
Readme
bookmaker
Convert a folder of Markdown files into data ready for a pagemaker book
install
$ npm install bookmaker
usage
Each markdown file represents a page of the book and can have front-matter. The values can be used in the book template to show images and play sounds.
An example of a single page .md:
---
title: Page 2
image: images/balloons.png
template: dinosaur
---
This is some markdown
It will be converted to HTML
Take a folder of these with some images and sounds and you can use the following code:
var BookMaker = require('bookmaker')
// the base folder for the book content
var book = BookMaker(__dirname + '/test/book')
// a glob pattern for what .json files to merge into the top level book config
book.loadConfig('*.json', function(err, config){
// the config is an object containing a merge of the *.json files
})
// a glob pattern for what markdown files to load for pages
book.loadPages('*.md', function(err, pages){
// pages is an array of objects each representing a page
pages.forEach(function(page){
// page has .body .html and .attributes
})
})
// a combination of getConfig and getPages
book.load('*.json', '*.md', function(err, book){
// book has a 'pages' property
// we can write the .json to the dest folder
})
// a glob pattern for the files to copy
book.copyFiles('*.{mp3,ogg}', targetFolder, function(err){
// the source files have been copied to the target dir
})
// a glob pattern for the images to resize
book.resizeImages('*.{png,jpg,gif}', targetFolder, '600x400', function(err){
// the source images have been resized and copied to the target dir
})
A simplied version of the above:
var BookMaker = require('bookmaker')
// the base folder for the book content
var book = BookMaker(__dirname + '/test/book')
book.write(__dirname + '/output', {
config:'*.json',
pages:'*.md',
files:'*.{mp3,ogg}',
images:'*.{png,jpg,gif}',
imageSize:'600x400'
}, function(){
// the book has been written to __dirname + '/output'
})
api
var book = BookMaker(src)
Create a new book object passing the folder root for where the markdown pages and other files live
book.loadConfig(glob, callback(err, config){})
Load an object that is the result of merging the files found in the passed file glob.
This object is the top level of the book - the 'pages' property is populated by the markdown files.
Normally a single json file will be used but you can use a glob to merge multiple configs for one book:
var book = BookMaker(src)
book.getConfig('{main,theme}.json', function(err, config){
// config is main.json and theme.json merged
})
book.loadPages(glob, callback(err, pages){})
Process each markdown file found in the glob and return an array of the JSON objects.
book.load(configGlob, pageGlob, callback(err, book){})
A combo of loadConfig and loadPages that returns a single object that is the config with a 'pages' property
book.copyFiles(glob, targetFolder, done(error){})
Copy a glob of files from the book folder to the targetFolder
book.resizeImages(glob, targetFolder, size, done(error){})
Copy and resize the images in the glob. Size can be a string: '100x100' or an object with 'width' and 'height' properties.
cli
You can also install bookmaker globally and use it as a command line script
$ npm install bookmaker -g
$ bookmaker --help
usage: bookmaker [options] sourcefolder destfolder
options:
--config, -c - a glob for the config files
--pages, -p - a glob for the .md pages
--files, -f - a glob for files to copy
--images, -i - a glob for images to resize
--imagesize, -s - the size for resized images
$ bookmaker --config "*.json" --pages "*.md" --images "*.jpg" --imagesize 600x400 ./input ./output
licence
MIT