Intégrer Calibre2OPDS dans une #PirateBox

Calibre2opds
Calibre2opds

Cela faisait des mois que je souhaitais intégrer un catalogue dans la PirateBox. J’avais déjà vu cette fonctionnalité dans la PirateBox de l’ami @ruralsmart. A force de chercher, on finit par trouver ! Je vous propose un petit tuto qui, je l’espère, vous facilitera la vie !

Le grand intérêt d’intégrer un catalogue dans la box est de faciliter la recherche de livres mais surtout de la rendre plus esthétique. On peut toujours dire que la longue liste de fichiers présents dans la PirateBox favorise la sérendipité mais c’est quand même assez moche…

Passons aux choses sérieuses

Tout d’abord, commencez par télécharger Calibre et Calibre2opds. Une fois les deux logiciels installés, ouvrez Calibre. La première chose à faire est de constituer une bibliothèque de livres numériques qui ira alimenter la clé usb de la PirateBox.

calibre 1 Après avoir cliqué sur Basculer/créer/déplacer, une nouvelle fenêtre apparaît. Choisissez le dossier qui constituera votre bibliothèque numérique PirateBox. Vous avez trois possibilités, sélectionnez « Créer une bibliothèque vide à cet emplacement ».calibre 2Vous n’avez plus qu’à importer vos ebooks dans votre bibnum :
calibre 3Et vous obtenez ceci :calibre 4Votre Bibnum est constituée. C’était facile, hein ?! On peut commencer  s’amuser (ou pas). Avant de procéder à la phase calibre2opds, assurez-vous que les métadonnées de vos livres sont les plus complètes possibles. En effet, plus l’indexation sera fine, plus il sera évident pour les utilisateurs d’accéder aux livres à travers leurs requêtes. Si vous rencontrez des difficultés pour les métadonnées, il existe des tutos sur le web.

Calibre2opds

Rappel : vous devez avoir téléchargé et installé calibre2opds Pour lancer le logiciel calibre2opds, ne cherchez pas de .exe. Il n’y en a pas, c’est le fichier « rungi » qu’il faut lancer. Calibre2opds s’ouvre et est prêt à vous générer votre catalogue. Mais attention !! Veillez à bien sélectionner le bon type de publication ! Le logiciel vous propose 3 modes de publication qui ne sont pas particulièrement évident à cerner selon moi. Vous avez trois icônes : Calibre, une espèce de boîte noire et une liseuse (un Nook). Ces trois icônes sont cliquables, cliquez sur la boîte noire, celle qui se situe au milieu. C’est très important car c’est ce type de publication qui va nous permettre de générer et d’utiliser le catalogue sur la PirateBox. (C’est la découverte que j’ai faite hier et qui a changé ma vie, j’espère que cela en sera autant pour vous !)calibre2opdsEnsuite, vous devez indiquer à calibre2opds où aller chercher votre bibnum. C’est le champ : « Dossier de la base de données« .

Vous devez aussi remplir le champ « Dossier de destination ». C’est le dossier où sera généré le catalogue avec tous les fichiers (ebooks, couverture…). Il faut sélectionner la clé usb. Mais attention, il faut créer un dossier dédié sur votre clé sinon il supprimera tout ce qui se trouve dessus ! Pour mieux comprendre, regardez la capture ci-dessous :calibre2opds 2Une fois cette étape réalisée, cliquez sur « Options de génération du catalogue« . Il y a quelques paramètres à régler. Assurez-vous que la case « Ne pas générer de catalogue HTML » soit bien décochée auquel cas vous n’aurez pas le catalogue dont vous avez besoin pour la PirateBox. Il y a d’autres options plus ou moins utiles mais je ne les ai pas encore testées. Chaque chose en son temps 😉calibre2opds 3C’est bon vous êtes prêts à générer votre catalogue. Cliquez sur « générer le catalogue« , une nouvelle fenêtre apparaît avec un message assez effrayant. Ne paniquez pas, si vous avez bien créé le dossier sur votre clé usb, il n’y a aucun problème ! Si ce n’est pas le cas, vous avez toujours la possibilité de retourner en arrière. Cliquez sur oui. Le catalogue met plus ou moins de temps à se générer en fonction de la quantité de livres et du poids des fichiers que vous avez dans votre bibnum.calibre2opds 4Bravo, votre catalogue est généré ! Encore un effort, on a presque terminé.

WinSCP

C’est chouette on a notre catalogue sur notre clé usb mais maintenant faut l’implémenter dans notre CommonsBox (pas mal ce nom, non ?!). Pour y parvenir, nous allons réutiliser WinSCP, on s’en était servi pour la personnalisation de la PirateBox. Pour que votre catalogue puisse être interrogé quand les utilisateurs se connectent à la PirateBox, il faut le placer dans votre dossier « Shared« . Vous avez ainsi votre dossier d’ebooks et votre catalogue comme sur l’image ci-dessous :winscpOn avance mais ce n’est pas encore fini. En l’état actuel, l’utilisateur ne tombe pas sur le catalogue. Il existe plusieurs possibilités pour l’amener sur le catalogue. La plus simple consiste à appeler la page qui représente le catalogue depuis la page d’accueil de la PirateBox. Pour cela, il est nécessaire d’éditer votre fichier index.html qui se situe dans /opt/piratebox/www/ et vous pouvez rajouter, par exemple, la ligne suivante  : « <p>Pour consulter <a href= »/Shared/ebooks/_catalog/index.html »>le catalogue d’ebooks cliquez ici</a></p> ». Vous enregistrez votre fichier modifié et vous aurez le plaisir de voir ceci : [slideshow_deploy id=’558′]

Voilà votre catalogue est intégré à votre PirateBox et en plus c’est responsive design ! Bien évidemment, vous pouvez changer certains aspects du catalogue, je vous laisse adopter en fonction de vos besoins/goûts. En théorie, un catalogue calibre2opds génère des liens pour chaque ebook vers Wikipédia, Google, Amazon…  Mais puisque la PirateBox est déconnectée d’internet, cela ne sert à rien de conserver cette fonctionnalité. Enfin, la manière de faire n’est peut-être pas la plus orthodoxe, je suis conscient de mes limites. D’ailleurs si certains ont une méthode plus appropriée, n’hésitez pas à la partager ! Néanmoins, cela a le mérite de me permettre de dépasser une des limites que j’avais avec la PirateBox et de répondre à mon besoin. Il y a certainement un moyen de mieux intégrer le catalogue mais on verra dans un second temps. 🙂

Bonus

Pirate ta BD ! V2
Pirate ta BD ! V2

J’en profite pour vous signaler, si vous ne la connaissez pas, l’opération Pirate ta BD ! organisée par BDZmag. Ce magazine organise un gros travail de négociations auprès d’auteurs ou d’éditeurs de BD pour les encourager à placer certaines de leurs œuvres sous Creative Commons pour pouvoir les partager librement à travers tous les canaux possibles (mail, P2P, téléchargement direct…). Je vous laisse allez voir le site de BDZmag pour en savoir plus sur l’opération qui a été récemment relayée par ActuaLitté. Je voudrais revenir plus précisément sur l’association Pirate ta BD ! et les BiblioBox. En effet, BDZmag propose aux bibliothèques qui disposent d’une BiblioBox d’alimenter leur boîte de partage avec des BD ! A ce titre, je vous invite à rejoindre le groupe BiblioBox sur Facebook où BDZmag annonce les nouvelles BD disponibles et publient les liens pour pouvoir les télécharger. Bien évidemment, cela ne s’adresse pas uniquement aux bibliothèques. Toute personne disposant d’une PirateBox est fortement invitée à venir y glaner quelques bd et les partager à son tour.

18 commentaires à propos de “Intégrer Calibre2OPDS dans une #PirateBox”

  1. Rétroliens : Lumière sur la LibraryBox V.2 ! | Biblio Numericus

  2. Rétroliens : Metti un catalogo di ebook nella tua Piratebox | Software libero & TD

  3. Salut, je suis sur LibraryBox 2.0 et mon fichier index.html (qui est un raccourci d’ailleurs) dans opt/librarybox/www est un fichier de redirection que je ne comprends pas trop. Du coup est-ce que tu sais où est le html de la page d’accueil ? Aussi, je ne comprends pas trop ce que je dois mettre dans Shared/text : le catalogue généré dans la clé USB (donc l’ensemble du dossier nouvellement créé ?)

    PS: peut-être tu pourrais faire un topic/post sur Bibliobox.net avec ce genre de tutos ? Comme c’est l’endroit de référence pour aller chercher des infos…

    Merci pour tout ton travail en tout cas !

    • Salut,

      Si tu veux modifier la page d’accueil, il faut aller ici /opt/piratebox/www/content et ensuite tu peux modifier le fichier index.html. Sinon pour répondre à la seconde question, oui tu dois placer ta bibliothèque générée via Calibre2OPDS dans le dossier Shared/text de ta clé USB. Cela permet de rendre visible les livres numériques dans ton dossier. J’espère avoir répondu à tes questions.

      Thomas

  4. Alors question très con j’en conviens, mais comment on se connecte via WinSCP ? Je suis bloquée à cette étape… J’ai mis protocole SCP, hôte 192.168.1.1, port 22, mais les nom d’utilisateur/mdp, il faut les définir auparavant ? Comment ?

    Merci d’avance ^^

    • Aucune question n’est bête ! ^^

      Il faut que tu mettes l’adresse ip de ta box 192.168.1.1 et ensuite que tu mettes le mdp que tu as paramétré (quand t’es passé par CMD, je pense).

      Tu réutilises la même configuration que Putty.

  5. Connectée ! Merci bcp je pense que je suis pas assez patiente en fait ^^ Par contre je retrouve pas mon dossier ebooks à copier ds l’arborescence :….(

  6. Bon j’avance par étape mais j’avance ^^ Hier j’ai réussi à copier mon dossier ebooks, à intégrer un lien depuis la page d’accueil vers le catalogue (dans /opt/piratebox/www/content/index.html par contre, dans le fichier /opt/piratebox/www/index.html cela ne fonctionnait pas). Par contre le lien ne renvoie vers… rien -_- Ca me ramène à la page d’accueil… Tu sais d’où peut venir le pb ?

    Et merci pour la hotline 😉

  7. Est-ce que vous connaissez un moyen qui permettrait de réaliser un catalogue opds sur tous les types de ressources (livres, musiques, films, logiciels) contenues dans la biblioblox ?

  8. Bonjour,
    Ce tuto est-il encore valable pour la bibliobox V2?
    – Si oui faut-il créer le dossier qui doit accueillir le catalogue à la racine de la clef USB où se trouve déjà les fichiers et dossiers de la bibliobox ou directement dans un sous dossier de Shared?
    – Je ne comprends pas bien la manip avec le terminal dans le dossier /opt/piratebox/www/shared/? Il faut y déposer quelque chose? Si oui quoi?
    – Pour ajouter un onglet pointant vers le catalogue je modifie le fichier index.html dans le dossier librarybox/content/ sur la clef, non?
    Merci de votre aide
    Christophe

    • Bonjour,

      Oui ce tuto est encore valable pour la V2. Il fonctionne, je l’ai testé et approuvé ;-).

      Il faut effectivement créer un dossier sur la clé usb qui accuillera la bibliothèque numérique et le catalogue généré via calibre2opds. C’est important de créer un dossier et d’indiquer le chemin du dossier dans calibre2opds sinon cela écrasera toutes les données de la clé usb. Une fois que cela est fait vous pouvez déplacer le dossier dans Shared/ ebook.
      La commande avec le terminal sert juste à déplacer le dossier nouvellement créé pour le mettre dans le dossier shared. Mais comme je l’ai indiqué plus haut vous pouvez le faire à la main en copiant collant le dossier.
      Enfin pour pointer vers le catalogue, il faut modifier le fichier index.html. vous pouvez tout à fait le changer depuis la clé usb en allant dans le dossier librarybox/content/.

      J’espère avoir répondu clairement à vos questions.

      Bon courage!

      Thomas

      • Bonsoir,
        Merci bcp pour vos réponses!
        Je suis entrain de générer le catalogue en ce moment même.
        2 questions:
        – Ma base se trouve sur un disque dur externe. Est-ce que j’aurai pu générer le catalogue sur ce même disque dur mais dans un autre dossier?
        – Savez-vous si je peux ajouter des zip ou des mp3 (livres audio) dans calibre et si Calibre2opds les prendra en charge?
        En tous les cas merci
        Christophe

        • Pour répondre à la première question, vous auriez pu générer le catalogue dans un autre dossier de votre disque dur externe. Il suffit d’indiquer le chemin du dossier à créer via calibre2opds.
          Malheureusement calibre2opds ne gère pas les autres formats de fichiers. Il faudrait trouver un équivalent. Pour la vidéo il y a ant movie catalogue.

          Thomas

Répondre à rhein Annuler la réponse

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *

*