epub ~dub-optional-dependencies

epub: make epubs in D

This is a little library to create ebooks in epub format in D.

Getting it

Add "epub": "~>1.0.1" to your dub.json.

Using it

To create an epub, you first assemble your book, then call toEpub on it.

A quick example:

import epub;
void main()
{
    auto book = new Book;
    book.title = "Grunthos the Flatulent";
    book.author = "Ode to a Small Lump of Green Putty";

    book.coverImage = Attachment(
        // file ID
        "cover",
        // filename
        "cover.png",
        // MIME type
        "image/png",
        // content
        import("cover.png"));

    book.chapters ~= Chapter(
        // title
        "The Putty",
        // show in table of contents?
        true,
        // body as XHTML document
        import("poem.xhtml"));
    book.toEpub("putty.epub");
}

If you don't want to emit directly to a file, you can call toEpub with a ZipArchive from std.zip instead of a filename.

Cover images

If you link gtk-d (for libcairo), you can generate a cover.

First, create a Cover object:

import epub.cover;
Cover cover = {
    book: myAwesomeBook,
    generator: "lovely-epub-gen-2.0.7",
    width: 1600,
    height: 2560,
    fontPreferences: ["Brioso Pro", "Garamond"],
    format: Cover.Format.png
};

Then render it:

book.coverImage = cover.render;

License

This project is licensed under the Microsoft Public License. If you wish to include this in a project you are working on and its license is incompatible, please file an issue detailing your project and what license you need.