Intégrer l'audio à un site Dotclear : flux, gabarits de thème et API

Dotclear tient une place discrète mais tenace dans le paysage francophone : ce moteur de blog libre, né en France au milieu des années 2000, fait encore tourner des carnets personnels, des sites d'associations et des blogs professionnels qui apprécient sa légèreté et son indépendance. La question de la version audio s'y pose comme partout ailleurs, mais Dotclear a ses propres logiques, et les ignorer fait perdre du temps. Voici comment procéder concrètement, sans promesse en trop.

Deux façons d'alimenter la sonorisation

Pour produire l'audio d'un article, WeDispatch a besoin d'accéder à son texte. Sur Dotclear, deux chemins existent, et le bon dépend de votre organisation.

Le premier passe par le flux de syndication. Dotclear génère nativement des flux RSS et Atom, pour l'ensemble du blog et par catégorie. C'est le chemin le plus simple : vous fournissez l'adresse du flux, la sonorisation se déclenche à chaque nouvel article détecté, sans rien changer à votre interface d'administration. Nous avons décrit ce principe en détail dans intégrer l'audio par flux RSS, et il vaut pour Dotclear comme pour n'importe quel moteur qui expose un flux propre. La seule précaution tient à un réglage de Dotclear : le flux doit contenir le contenu complet des billets, et non un simple résumé, sinon l'audio ne portera que sur l'accroche. Ce choix se règle dans les préférences du blog, à la ligne qui décide si les flux diffusent le texte intégral ou tronqué.

Le second chemin passe par l'API. Si vous voulez déclencher la génération au moment exact où un rédacteur publie un billet, plutôt qu'à la prochaine relecture du flux, un appel vers l'API de WeDispatch fait le travail. C'est un peu plus de mise en place, mais vous gagnez en réactivité. La page API et CMS détaille ce que l'interface permet, et sur Dotclear cet appel peut vivre dans un petit plugin maison ou dans un script déclenché à la publication.

Placer le lecteur dans le gabarit du thème

C'est ici que Dotclear diffère franchement d'un WordPress. Dotclear repose sur des thèmes composés de fichiers de gabarit (des fichiers au format .html qui décrivent, avec les balises de gabarit propres à Dotclear, comment une page est construite). Pour afficher le lecteur audio en tête de vos billets, vous n'installez pas une extension toute faite : vous ajoutez un fragment dans le gabarit qui rend un billet, en général post.html dans votre thème.

Concrètement, le lecteur WeDispatch s'insère comme un bloc à un endroit choisi du gabarit, le plus souvent juste avant la balise qui affiche le corps du billet. Comme le gabarit est partagé par tous les billets, l'ajout est fait une fois et s'applique partout : pas de manipulation article par article. Un conseil qui évite une mauvaise surprise à la mise à jour : dupliquez d'abord le thème par défaut pour travailler sur une copie, plutôt que de modifier le thème d'origine, afin que votre retouche survive à la prochaine mise à jour du moteur. C'est l'équivalent, chez Dotclear, du thème enfant.

Tirer parti des catégories

Dotclear structure le contenu en catégories, et cette structure est un atout pour l'audio. Vous pouvez décider que seule une partie de vos catégories est sonorisée : les analyses de fond et les dossiers, par exemple, plutôt que les brèves ou les notes de service. En reliant le flux ou l'API à des catégories précises, vous sonorisez ce qui a une vraie durée de vie et une vraie valeur à l'écoute, sans dépenser sur des contenus qui ne s'y prêtent pas. Cette logique se prolonge côté rendu, où chaque catégorie peut recevoir un traitement propre, une voix par exemple : notre fonctionnalité rubriques est pensée pour cela.

Les vraies limites, dites franchement

Dotclear a un système de plugins, mais nous ne publions pas d'extension Dotclear clé en main. Il n'y a donc pas de « module à installer en un clic » comme sur WordPress : l'intégration passe par le flux, par l'API, et par une retouche de gabarit. Pour quelqu'un qui connaît son thème Dotclear, c'est une intervention courte. Pour un site laissé sans maintenance technique depuis longtemps, il faut prévoir l'aide de quelqu'un à l'aise avec les gabarits.

Autre point d'attention : les blogs Dotclear anciens tournent parfois sur des versions datées ou des thèmes très personnalisés. Rien de bloquant, mais cela veut dire qu'il faut regarder votre installation avant d'annoncer un délai. La bonne nouvelle, c'est que le flux de syndication, lui, fonctionne quasi partout, ce qui donne toujours un chemin de repli simple.

Par où commencer

Le plus rapide est de partir du flux pour une première mise en écoute, sans toucher au thème : vous vérifiez la qualité de la voix sur vos vrais billets avant d'investir dans l'intégration du lecteur. Cette étape compte particulièrement pour un site francophone, car c'est la lecture du français qui fait la différence, et c'est le sujet que nous travaillons en priorité, comme l'explique la page text to speech français. Une fois convaincu, vous ajoutez le bloc lecteur au gabarit et, si vous le souhaitez, vous passez à un déclenchement par API pour la réactivité. Chaque étape se teste avant la suivante, et le principe d'installation sans toucher au reste du site est le même que celui décrit sur la page WordPress.

Écoutez vos billets Dotclear dès aujourd'hui

La formule gratuite de WeDispatch vous permet de sonoriser vos contenus avec vos vrais textes : essayez maintenant. Les forfaits sont détaillés sur la page tarifs.

À lire aussi

• Notes de bas de page et appels de note : ce que la synthèse vocale en fait
• Légendes et crédits de photos : ce que la synthèse vocale en fait
• Un lecteur audio dans la page ou dans une iframe : ce que ce choix décide