Archives du mot-clé epub 3.0

Conversion d’un epub 2.0 au standard 3.0

Dans cet atelier, nous allons procéder à la conversion d’un epub aux spécifications 2.0 vers 3.0 sous Sigil 0.9.5 et vérifier que tout s’est bien déroulé. Pour cela, nous utiliserons une nouvelle fonctionalité de Sigil, les plugins (greffons).

Installation des greffons epubcheck et ePub3-itizer

1- Télécharger les plugins epubcheck et ePub3-itizer. Ne pas les dézipper.

2- Après avoir ouvert Sigil, menu Greffons (Plugins) —-> Gérer les greffons (Manage plugins). Là, cliquer sur Ajouter (Add) et aller chercher le greffon téléchargé. Puis clicker sur OK. Le greffon est maintenant présent, on peut lui attribuer une icône dans la barre d’outils de Sigil comme dans la capture d’écran ci-dessous avec epubchecker.

Gestion des greffons

Gestion des greffons

 Conversion au standard EPUB 3.0

Ouvrons un epub 2.0 valide (c’est à dire qu’il a passé la vérification avec epubcheck) et dans le menu des greffons est venu s’ajouter une catégorie, Sortie—->ePub3-itizer. Lançons-le pour procéder à la conversion du fichier.

Conversion

Conversion

J’utilise un fichier de test contenant des illustrations et des notes. La conversion se déroule bien. Il faut maintenant ouvrir le fichier epub3 généré. Les en-têtes dans le fichier content.opf reflètent le passage au 3.0 et dans l’arborescence, un fichier nav.xhtml a été créé.

<package prefix="rendition: http://www.idpf.org/vocab/rendition/#" unique-identifier="bookid" version="3.0" xmlns="http://www.idpf.org/2007/opf">
En-tête fichier content.opf

Vérification avec epubcheck

Passons maintenant le fichier à la validation du fichier epub 3.0 à l’aide du second greffon installé, epubcheck.  Un petit problème est detecté car la fenêtre de log epubcheck indique check finished with warnings or errors, visiblement un souci ayant trait avec un identifiant.

Greffon epubcheck

Modification du greffon

Cette erreur est étrange, car ces identifiants sont générés automqtiquements. Serait-ce un bug ? La capture d’écran ci-dessus montre que la version d’epubcheck utilsée pour la vérification est la 3.0.1, pas forcément la dernière si l’on se réfère au site officiel epubcheck affichant 4.0.1. Nous allons donc télécharger la dernière mouture et modifier le plugin epubcheck pour qu’il la prenne en charge. Pour se rendre à l’emplacement où se trouvent les dossiers des greffons, cliquer sur le  bouton — visible sur la première capture d’écran — « Ouvrir l’emplacement des préférences ». C’est également là que se trouvent les recherches sauvegardées, les clips et les préférences de Sigil. Le dossier plugins renferme un dossier epubcheck, notre greffon, qui lui même contient le binaire java que nous allons remplacer et le script python plugin.py qui assure l’exécution du plugin. Ici, en l’occurence, un simple wrapper qui lance epubcheck-3.0.1.jar.

 # define epubcheck command line parameters
    epc_path = os.path.join(plugin_path, 'epubcheck-3.0.1.jar')
    args = ['java', '-jar', epc_path, temp_dir, '-mode', 'exp']
Wrapper

Supprimons epubcheck-3.0.1.jar et son dossier lib et remplaçons les par le contenu de la dernière version que l’on a téléchargée et son dossier lib. Il faut à présent éditer le fichier python plugin.py  (extrait ci-dessus) et modifier l’ancien nom de la cible pour le nom du fichier jar téléchargé. Les modifications faites, relançons le greffon. Miracle, cette fois, la vérification est OK ! Bien entendu, à condition deconnaître python, il est possible de concevoir des tas d’extensions utiles ou originales, comme Borkify, qui modifie le texte pour un rendu audio qui change d’accent.