0.1.1 • Published 6 years ago

underscore-ebook-template-ja v0.1.1

Weekly downloads
11
License
-
Repository
-
Last release
6 years ago

Underscore eBook Template

これは Underscore 電子書籍テンプレートを日本語訳向けに改変したものです。

Underscore eBook Template for Japanese translation, by @jiftechnify


Copyright 2016 Underscore Consulting LLP.

Source code licensed under the Apache License 2.0.

Template content licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

Overview

Template for Underscore eBooks, based on Node, Pandoc, and Grunt. See the source code for Creative Scala for a complete example of use.

Configuration Guide

The following settings are supported a book's metadata.yaml:

KeyValue
titleString
authorString, multiple authors represented as: Name and Name
dateString, publication identifier such as: Early Access May 2015
filenameStemString, filename used for HTML, EPUB, PDF output. E.g., essential-play
copyrightString, copyright year or range: 2015 or 2011-2015.
tocDepthInteger, number of levels for table of contents. E.g., 3
coverColorString, colour of PDF cover. E.g., F58B40
pagesArray, list of pages in rendering order
previewPagesArray, list of pages for the preview versions in rendering order.

Setup

This template uses a Docker container to allow setup without (much) agony.

You'll need Docker Machine if you're running on Windows or OS X. Setup a VM to run Docker containers using Docker Machine (you will probably do this as part of the Docker Machine install):

docker-machine create --driver virtualbox default

Check you have a running machine.

docker-machine ls

If you don't have one running, start one and setup the environment.

docker-machine start default
docker-machine env default

Build the image for the book environment

docker build -t underscore/book .

Now copy docker-compose.yml to the root of the book you're working on and run it.

docker-compose run book bash

This will setup a shared filesystem so the material on your local filesystem can be seen by the Docker container and turned into a book, and give a bash prompt to interact with the Docker container.

sbt pdf

to generate a PDF version of the book you're working on.