1. gen-epub-book.js(1)
  2. gen-epub-book.js(1)

NAME

gen-epub-book.js - Generate an ePub book from a simple plaintext descriptor

SYNOPSIS

gen-epub-book IN_FILE OUT_FILE OPTIONS

DESCRIPTION

Generate an ePub book from a simple plaintext descriptor.

OPTIONS

IN_FILE

File to parse, must exist, must comply with the DESCRIPTOR FORMAT.

OUT_FILE

File to write the book to, parent directory needn't exist.

-S --separator SEP

Use SEP as key/value separator.

Default: ":"

-D --free-date

Try to parse non-RFC3339 date formats.

Default: don't.

DESCRIPTOR FORMAT

The descriptor consists of multiple lines in the format "Key: Value", unknown keys are ignored, lines that don't match the format are ignored.

Name

Required: yes
Type: plaintext
Value: e-book's title
Amount: 1

Content

Required: no
Type: file path
Value: relative path to (X)HTML chunk
Amount: any
Remarks: see ADDITIONAL CONTENT PROCESSING

String-Content

Required: no
Type: (X)HTML
Value: (X)HTML string
Amount: any

Image-Content

Required: no
Type: file path
Value: relative path to image to include in e-book
Amount: any

Network-Image-Content

Required: no
Type: file URL
Value: URL of image to include in e-book
Amount: any

Cover

Required: no
Type: file path
Value: relative path to image to use as e-book cover
Amount: 0-1
Remarks: exclusive with Network-Cover

Network-Cover

Required: no
Type: file URL
Value: URL to image to use as e-book cover
Amount: 0-1
Remarks: exclusive with Cover

Include

Required: no
Type: file path
Value: auxilliary file to include in e-book
Amount: any

Network-Include

Required: no
Type: file URL
Value: URL of auxilliary file to include in e-book
Amount: any

Description

Required: no
Type: file URL
Value: relative path to book description
Amount: 0-1
Remarks: exclusive with String-Description and Network-Description

String-Description

Required: no
Type: (X)HTML
Value: book description
Amount: 0-1
Remarks: exclusive with Description and Network-Description

Network-Description

Required: no
Type: file URL
Value: URL of book description
Amount: 0-1
Remarks: exclusive with Description and String-Description

Author

Required: yes
Type: plaintext string
Value: e-book's author
Amount: 1

Date

Required: yes
Type: RFC3339-compliant date
Value: e-book's authoring/publishing date
Amount: 1
Remarks: see FREE DATE FORMAT FEATURE

Language

Required: yes
Type: BCP47-compliant language code
Value: language used in e-book
Amount: 1

ADDITIONAL CONTENT PROCESSING

When adding content using the Content entry, the file will additinally be searched for a comment specifying the its name in the TOC in this format:

<!-- ePub title: "TOC_NAME" -->

Where TOC_NAME is a string not containing the " character.

This will, on e-book readers, allow users to jump directly to the content represented by the document containing this entry.

Optional.

FREE DATE FORMAT FEATURE

With the -D/--free-date flag, you can enable the free date format feature: <https://nabijaczleweli.xyz/content/gen-epub-book/programmer.html#features-free-date-format>.

The supported formats therewith are therefore:

AUTHOR

Written by nabijaczleweli <nabijaczleweli@gmail.com>

REPORTING BUGS

<https://github.com/nabijaczleweli/gen-epub-book.js/issues>

SEE ALSO

<https://github.com/nabijaczleweli/gen-epub-book.js>
<https://nabijaczleweli.xyz/content/gen-epub-book>

  1. gen-epub-book.js developers
  2. December 2018
  3. gen-epub-book.js(1)