Project

epub-rb

0.0
The project is in a healthy, maintained state
epub-rbfnando/epubHomepageDocumentationSource CodeBug Tracker
Create epub files using Ruby.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
918
Stars
3
Forks
0
Watchers
2
 Releases
Current version
0.0.2
Total releases
3
First release
2024-01-26
Latest release
2024-01-26
 Pull Requests
Open Pull Requests
0
Closed Pull Requests
2
Merged Pull Requests
0
Pull Request Acceptance Rate
0%
 Development
Primary Language
Ruby
Licenses
MIT
Average date of last 50 commits
2024-01-26
Reverse Dependencies
0

 Dependencies

Development

minitest
>= 0
minitest-utils
>= 0
pry-meta
>= 0
rake
>= 0
rubocop
>= 0
rubocop-fnando
>= 0
simplecov
>= 0

Runtime

builder
>= 0
nokogiri
>= 0
rubyzip
>= 0
 Project Readme

epub-rb

Tests Gem Gem MIT License

Create epub files using Ruby.

Installation

gem install epub-rb

Or add the following line to your project's Gemfile:

gem "epub-rb"

Usage

require "epub"

epub = Epub.new(
  root_dir: "./book",
  title: "Hello World",
  subtitle: "A Complete Beginner’s Guide to Ruby Programming",
  creators: ["John Doe"],
  publisher: "epub-rb",
  date: "2024-01-24",
  id: "d05f92ea-62f7-44d6-bb48-d94c11e660db",
  copyright: "Copyright 2024 by John Doe",
  identifiers: ["915869090000000000DD", "urn:isbn:9780000000001"],
  contributors: ["Jane Doe"],
  files: [
    "./book/book.css",
    "./book/cover.png",
    "./book/cover.html",
    "./book/toc.html",
    "./book/ch01.html",
    "./book/ch02.html",
    "./book/images/terminal.svg"
  ]
)

epub.save("hello-word.epub")

The epub file is compliant with the EPUB 3.3 specification. You can check it by using epubcheck.

Note

epub-rb makes a few assumptions that you need to follow.

  1. You need to have a file name toc.{xhtml,html}. This file must be compliant with the EPUB 3 spec.
  2. You'll also need a cover image named as cover.{png,jpg,gif}.
  3. You'll also need a companion file called cover.{xhtml,html}.

Generating the Table of Contents (navigation file)

You can use the methods Epub::Navigation.extract(files, root_dir:) and Epub::Navigation.extract_html(files, root_dir:) to generate the toc.html file. A simple way would be using something like this:

navigation = Epub::Navigation.extract_html(
  Dir["./book/**/*.html"],
  root_dir: "./book"
)

File.open("toc.html", "w") do |file|
  file << <<~HTML
    <?xml version='1.0' encoding='utf-8'?>
    <html xmlns="http://www.w3.org/1999/xhtml" xmlns:epub="http://www.idpf.org/2007/ops" xml:lang="en" lang="en">
      <head>
        <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
        <title>Table of Contents</title>
      </head>
      <body>
        #{navigation}
      </body>
    </html>

  HTML
end

Note

Notice that the order of .html/.xhtml files is important. You need to sort files how you'd like them to show up. If you add toc.html lastly, then it'll show up at the end of the ebook.

Consider adding files in this order: cover.html, toc.html, all other html files your epub will have, then other assets (images, css, javascript, etc).

Maintainer

Contributors

Contributing

For more details about how to contribute, please read https://github.com/fnando/epub/blob/main/CONTRIBUTING.md.

License

The gem is available as open source under the terms of the MIT License. A copy of the license can be found at https://github.com/fnando/epub/blob/main/LICENSE.md.

Code of Conduct

Everyone interacting in the epub-rb project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.