Go library for creating EPUB files
- This library provides a high-level, ergonomic API for creating EPUB files (2.0.1).
- It covers all epubcheck validations
go get -u github.com/javiorfo/liber@latestpackage main
import (
"log"
"os"
"github.com/javiorfo/liber"
"github.com/javiorfo/liber/body"
"github.com/javiorfo/liber/ident"
"github.com/javiorfo/liber/lang"
"github.com/javiorfo/liber/reftype"
"github.com/javiorfo/liber/resource"
)
func main() {
f, err := os.Create("book.epub")
if err != nil {
panic(err)
}
defer f.Close()
e := liber.EpubBuilder(
liber.MetadataBuilder("My Book", lang.Spanish, ident.Default()).
Creator("Johan Gambolputty").
Build(),
).
Stylesheet(body.Raw("body {}")).
CoverImage(resource.JpgFile("/path/cats.jpg")).
AddResources(resource.PngFile("/path/cs.png")).
AddContents(
liber.ContentBuilder(body.Raw(
`<h1>Chapter 1</h1>
<h2 id="id01">Section 1.1</h2>
<h2 id="id02">Section 1.1.1</h2>
<h2 id="id03">Section 1.2</h2>`,
), reftype.Text("Chapter 1")).
AddContentReferences(liber.ContentReferenceBuilder("Section 1.1").
AddChildren(liber.ContentReferenceBuilder("Section 1.1.1").Build()).
Build()).
AddContentReferences(liber.ContentReferenceBuilder("Section 1.2").Build()).
AddChildren(
liber.ContentBuilder(body.Raw("<h1>Chapter 2</h1>"), reftype.Text("Chapter 2")).Build(),
liber.ContentBuilder(body.Raw("<h1>Chapter 3</h1>"), reftype.Text("Chapter 3")).
AddChildren(liber.ContentBuilder(body.Raw("<h1>Chapter 4</h1>"), reftype.Text("Chapter 4")).
Build()).
Build(),
).
Build(),
).
Build()
if err := liber.Create(&e, f); err != nil {
os.Remove("book.epub")
log.Fatal(err)
}
}- Every content is a xhtml. Only the body needs to be added as a content (see examples)
- Content (Ex: Chapter) and ContentReference (Ex: Chapter#ref1) could be named with filename and id methods respectively. If none is set, Content will be sequencial c{number}.xhtml (c01.xhtml, c02.xhtml...) and ContentReferences will be id{number} (id01, id02...) corresponding to the Content.
