Skip to content

cyril-lamotte/epub

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

EPUB

Documentation

Conteneur EPUB

Fichier OPF (Open Packaging Format)

Lié via container.xml

  • <metadata> : centralise les métadonnées de la publication (Auteur, éditeur, ISBN...)
  • <manifest> : liste exhaustive des fichiers composant la publication (html, css, images, table des matières...)
  • <spine> : "Colonne vertébrale", liste d'ID définissant l'ordre des contenus

Fixed layout

Notation EPUB3 à insérer dans <metadata> :

  <meta property="rendition:layout">pre-paginated</meta>
  <meta property="rendition:spread">auto</meta>
  <meta property="rendition:orientation">auto</meta>
  <meta property="rendition:viewport">width=500, height=500</meta>

Dans chaque fichier HTML, indiquer les dimensions du viewport :

<meta name="viewport" content="width=500, height=500" />

Fonctionnalités EPUB

Notes de pied page

<a href="chapter.xhtml#note-01" epub:type="noteref">EPUB</a>
<aside id="note-01" epub:type="footnote">Electronic Publication</aside>

Note : L'utilisation des attributs "epub:type" nécessite l'inclusion du namespace epub sur la balise html :

<html xmlns="http://www.w3.org/1999/xhtml" xmlns:epub="http://www.idpf.org/2007/ops">

Couverture

<!--Cover-->
<item id="img-01" href="Images/cover.jpg" media-type="image/jpeg" properties="cover-image" />

Images

Dans les epubs flow, il est recommandé de définir la taille des images via son conteneur :

<div class="image-container">
  <img src="images/bears.jpg" alt="three bears peer at goldie locks"/>
</div>
img { width: 100%; }
.image-container { width: 90%; }

XHTML

Les entités HTML comme &nbsp; ne peuvent pas être utlisées. EPUB est basé sur XHTML qui ne définit pas ces entités. Les entités XHTML (Numériques) sont utlisables :

prime -> #824
Prime -> #8243
ldquo -> #8220
rdquo -> #8221
lsquo -> #8216
rsquo -> #8217
mdash -> #8212
ndash ->#8211
copy -> #169
trade -> #8482
deg -> #176
aacute -> #225
eacute -> #233
oacute -> #243
ntilde -> #241
iuml -> #239
ecirc -> #234
nbsp -> #160

JavaScript

  • Utiliser JS pour déclencher les intéractivités mais utiliser CSS pour les animations.
  • Utiliser les transformations 3D en CSS à la place du positionnement top/right/bottom/left. Les animations seront plus douces parce qu'elle disposent d'une accélération matérielle.
  • Utiliser preventDefault pour éviter de déclencher l'affichage des menus.

Générer un epub

Le fichier mimetype doit être le premier de l'archive et ne doit pas être compressé.

zip -Xr9D filename.epub mimetype META-INF OEBPS

Valider un epub avec epubcheck

Télécharger le jar : https://github.com/IDPF/epubcheck

C:> java -jar D:\epubcheck-3.0.1\epubcheck-3.0.1.jar L:\epub-to-validate.epub

About

Documentation sur le format epub

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published