Mot-clé - convertisseur - Le blog de Lizzie Crowdagger

Oui, je viens encore vous embêter avec Crowbook, mais, promis, c'est la dernière fois de l'année !

Mais c'est quoi, déjà ?

Pour rappel, Crowbook est un logiciel libre (licence LGPL) qui convertit des fichiers écrits au format Markdown vers du PDF, de l'HTML ou de l'EPUB. Par rapport à d'autres équivalents, Crowbook essaie de faire un peu plus attention à la typographie, particulièrement française.

C'est ce que j'utilise maintenant pour la totalité de mes textes auto-édités, que ce soit pour la version disponible sur ce site, pour les fichiers vendus sur les plate-formes de vente en ligne, ou pour les impressions papier.

Le format Markdown

Un titre de chapitre
============

Ensuite, c'est juste du texte brut. Il y a un peu de syntaxe pour formater un peu,
mais en vrai pour un roman à part les *italiques* on n'a pas besoin de grand chose !

*****

Ah, si, il y a la ligne avec les petites étoiles pour séparer des scènes que j'utilise
pas mal aussi. Voilà, vous connaissez les trois éléments de syntaxe Markdown
nécessaires pour rédiger un roman !

Le « format Crowbook »

Bon, avec ça vous avez un contenu, mais il manque encore des choses pour générer de vrais documents finis, comme donner un nom d'auteur, un titre à l'œuvre, préciser la langue, dire quels formats doivent être générés, éventuellement mettre une image de couverture, etc. Pour ça, il faut passer quelques indications en plus à Crowbook. Pour un texte court, ça peut se faire à l'intérieur du fichier Markdown, en mettant ces indications en en-tête :

---
author: Jean-Pierre Écrivain
title: Ma première Œuvre !
lang: fr

output.html: oeuvre.html
output.pdf: oeuvre.pdf
output.epub: oeuvre.epub
---

Ma première Œuvre !
=============

Voilà ma première Œuvre ! Je suis *super* content ! 
Grâce à Crowbook, je n'ai pas à me prendre la tête 
avec la mise en page, la typographie et tout ce merdier,
c'est fabuleux !

*****

Je vais de ce pas publier sur les plate-formes de vente 
en ligne et devenir riche.

Une fois le texte écrit, il n'y a plus qu'à exécuter une simple ligne de commande, crowbook -s oeuvre.md, pour générer les fichiers HTML, PDF, et EPUB. Évidement, pour un roman, il y aura plusieurs chapitres, et il faudra un fichier différent pour la configuration du livre que pour les chapitres écrits en Markdown, mais ce n'est guère plus compliqué :

author: Jean-Pierre Écrivain
title: Mon premier roman !
lang: fr

output.html: roman.html
output.pdf: roman.pdf
output.epub: roman.epub

- prologue.md
+ chapitre_01.md
+ chapitre_02.md
(...)

Démo et exemples

Si vous voulez voir un peu plus interactivement à quoi ça ressemble et ce que peut donner Crowbook, vous pouvez jouer avec la version de démo en ligne. Pour des exemples plus concrets (avec des options un peu plus complexes utilisées), vous pouvez aussi regarder le dépôt Github contenant mes textes publics.

Installer Crowbook

Si vous voulez installer Crowbook, vous pouvez télécharger les exécutables pour la dernière version :

Vous pouvez aussi regarder les instructions pour le compiler sur la page Github.

Plus d'informations

Pour plus d'informations, consultez la la page Github ou le guide d'utilisation (pour l'instant, les deux sont uniquement en anglais).

Quoi de neuf, docteur ?

Bon, et du coup, cette version 0.11.0, elle apporte quoi de nouveau ? Eh, bien, pas mal de choses, à vrai dire, mais les plus importantes sont les suivantes :

Gestion des parties

C'était un truc qui me bloquait encore pour passer un texte ou deux à Crowbook (notamment L'énième Prophétie, même si ce n'est pas franchement le texte que je trouvais le plus urgent de republier, mais ça pourrait concerner aussi Une autobiographie transsexuelle (avec des vampires) – mais comme celui-ci a trouvé un éditeur ce n'est plus moi qui m'occupe de sa mise en page – ou La chair & le sang – mais il faudrait d'abord que je finisse de l'écrire) : la gestion des parties, au-dessus des chapitres donc. Maintenant que c'est fait, ça veut dire que je vais pouvoir finir de passer mes livres sous Crowbook (c'est en cours pour L'Énième Prophétie, qui était le seul à ne pas y être passé et à qui il ne manque plus qu'une relecture).

Des corrections et ajouts de fonctionnalités mineures

Cette version corrige aussi un certain nombre de choses (comme des petits soucis dans la table des matières EPUB si vous vouliez afficher plus que les chapitres), ajoute des petites fonctionnalités (comme la possibilité d'utiliser des nombres romains pour numéroter les chapitres, ou encore celle de mettre une favicon pour les documents HTML). Rien de majeur cependant, mais des petits trucs en plus.

Un petit nettoyage de printemps hiver

Même si ça n'est pas forcément le truc le plus voyant, il y aussi eu un boulot de fait pour nettoyer l'« interface », c'est à dire à la fois le nom des options qu'on peut passer à Crowbook, mais aussi celui des fonctions qu'on peut appeler (puisque Crowbook est aussi utilisable comme bibliothèque, c'est d'ailleurs comme ça que la version de démo en ligne fonctionne). Tout ça n'est pas en soit très intéressant mais devrait permettre de publier une version 1.0 d'ici, j'espère, pas trop longtemps. J'en profite pour dire aux personnes qui seraient intéressées par ce logiciel que c'est le bon moment pour faire des retours si vous trouvez des noms mal choisis, parce que ce sera plus dur à modifier après la version 1.0 :)

Bilan et perspectives

Au départ Crowbook n'était qu'un petit projet expérimental sur lequel je ne pensais pas passer autant de temps. C'est devenu un peu plus gros que ce à quoi je m'attendais. Ça correspond maintenant bien à mes besoins, puisque je l'utilise pour tous mes romans et nouvelles (et, à vrai dire, je souffre maintenant quand je dois écrire un billet de blog sous Dotclear et essayer de foutre des espaces insécables à la main si je ne veux pas que mes guillemets et mes points d'interrogation se retrouvent seuls en début de ligne).

Si ça peut aussi convenir à d'autres personnes, j'en serai très heureuse, mais il y a encore du boulot à faire pour rendre ça un peu accessible, et notamment pour améliorer la documentation et en proposer une version française, puisque je pense que Crowbook a surtout de l'intérêt pour les auteurs et autrices francophones. Il y a aussi un travail de polissage à faire, améliorer la mise en page proposée par défaut, corriger des bugs, etc.

Bref, si vous testez Crowbook et que ça correspond à vos attentes, j'en serai très contente, si vous testez Crowbook et que ça ne correspond pas à vos attentes, n'hésitez pas à faire un bug report pour expliquer ce qui ne va pas.

Et sur ce et même si ce n'est pas forcément le meilleur article de blog pour conclure sur ça, bonne année et meilleurs vœux !

Pour me permettre de pouvoir continuer à diffuser des textes (et des logiciels !) librement, vous pouvez vous abonner sur Tipeee à partir d'1€ par mois, ce qui vous donnera accès à mes prochains textes de fiction en avant-première.

Comme ça fait quelques mois que je n'en avais pas parlé, je me suis dit qu'il pouvait être intéressant de faire un petit billet à l'occasion de la sortie de la version 0.10.3 de Crowbook.

Rappel

Pour rappel, Crowbook est un logiciel libre qui convertit des fichiers écrits au format Markdown vers du PDF, de l'HTML ou de l'EPUB. C'est ce que j'utilise maintenant pour la quasi-totalité des textes disponibles sur ce site.

L'intérêt du format Markdown pour des textes de fiction, c'est que c'est essentiellement du texte brut et qu'on peut taper à la chaîne sans se poser de questions : c'est le convertisseur qui s'occupe de tout. Si vous voulez voir à quoi ça ressemble, vous pouvez regarder le dépôt Github contenant mes textes publics, jouer avec la version de démo en ligne de Crowbook.

Il y a pas mal de convertisseurs Markdown qui existent. Si j'ai commencé à développer celui-ci, en plus d'une certaine envie de réinventer la roue, c'est parce que, bien souvent, ceux-ci ne géraient pas les règles de typographie française, comme ces (foutus) espaces insécables (j'avais d'ailleurs écrit un article sur ce sujet).

Comme j'ai déjà parlé de Crowbook dans différents billets de blog, un premier pour présenter ce logiciel et un second à l'occasion de la version 0.7.0, je ne vais pas revenir en détail sur le fonctionnement et plutôt me contenter de rappeler :

que vous pouvez télécharger les exécutables (pour Linux, Windows et OS X, mais surtout testé sous Linux), ou regarder les instructions pour le compiler sur la page Github ;
qu'il y a un guide d'utilisation (pour l'instant uniquement en anglais) disponible en HTML, PDF ou EPUB ;
que c'est du logiciel libre et que c'est gratuit, donc vous ne prenez pas de risque à essayer (d'accord, à part qu'un bug efface l'intégralité du contenu de votre disque dur, mais normalement ça ne devrait pas arriver, je ne bosse pas chez Steam).

Quoi d'neuf, doc ?

Mais voyons plutôt les changements depuis la dernière fois que j'en ai parlé.

Il y a maintenant une version de démo en ligne, si vous voulez voir à quoi ça ressemble sans rien avoir à installer sur votre ordinateur.
J'ai enfin eu l'occasion d'avoir un PC sous Windows sous la main pendant les vacances, et j'ai pu tester un peu ce que ça donnait, donc maintenant les versions pour Windows devraient marcher à peu près (ce qui, hum, n'était pas trop le cas avant). Du moins, tant que vous n'essayez pas de générer du format EPUB (où vous aurez besoin de la commande zip) ou, pire, du PDF (où vous aurez besoin d'une installation fonctionnelle de LaTeX, ce qui d'après ce qu'on m'en a dit, vous fera entrer dans un monde de douleur pour l'installer comme il faut sous Windows).
Crowbook est maintenant traduit en français (mais pas encore le guide d'utilisation ; ça va venir, promis).
Niveau typographie, les apostrophes ' et les guillemets anglais " sont maintenant remplacés par leurs équivalents “typographiques” plus ‘jolis’. Et il y a une option, si vous galérez sur votre clavier pour taper les guillemets « français » ou les tirets cadratins (—) – ou semi-cadratins – pour pouvoir utiliser à la place les chaînes de caractères <<, >>, --- et -- (comme avec LaTeX).
Il est maintenant possible de générer des versions de relecture, qui peuvent souligner les répétitions et même utiliser un détecteur grammatical (ce qui vous demandera d'installer et de lancer LanguageTool). Bon, là on sort un peu du convertisseur Markdown et en pratique c'est un peu compliqué à utiliser, mais c'est des fonctionnalités que je trouve utiles en tant qu'écrivaine alors je me disais autant les y rajouter.
Des bugs corrigés, et sans doute de nouveaux bugs ajoutés. Pour plus de détails, vous pouvez regarder le ChangeLog.
Ah et il y a un logo, maintenant :

Le blog de Lizzie Crowdagger