Doxygen

J’ai passé un peu de temps à configurer la génération de la documentation complète de Clearbricks, avec doxygen, ce qui permet, comme Dotclear l’est déjà (mais il faut que je vérifie ça) de documenter toutes les méthodes et propriétés publiques de la librairie.

Encore un truc que j’avais pas encore bien fouillé et il en ressort qu’il reste un peu de doc à écrire dans le code, même s’il en existe déjà pas mal. Doxygen est plutôt axé C, C++ mais il fait correctement le job avec du PHP, même si la documentation produite présente quelques bizarreries, finalement pas très gênantes.

Il y a donc un fichier de configuration nouveau, nommé .doxygen.conf, à la racine de Clearbricks, et je ferai idem pour Dotclear ; la génération de la doc, créée dans le répertoire doxygen sera effectuée avec un simple :

doxygen .doxygen.conf

Pour me simplifier la vie sur mon Mac, vu que j’ai installé la version GUI de doxygen (version 1.8.4), j’ai créé un alias côté bash :

alias doxygen='/Applications/Doxygen.app/Contents/Resources/doxygen'

Pour référence, la syntaxe servant à extraire la documentation est expliquée sur le site de doxygen et également sur le site de phpDoc .

Il va falloir que j’évalue aussi phpDoc pour me faire une idée, sauf qu’il impose d’avoir une version de PHP supérieure ou égale à 7.0 pour tourner ; alors qu’on ne demande que la 5.5 pour Dotclear, ça me parait un peu too much, même si l’environnement n’est pas le même.

Ou alors j’attends quelques semaines de changer de mac ou d’OS pour utiliser la version 7.n de PHP vu que j’ai la flemme, ce matin, de mettre à jour mon système :-)

Plugin hljs 0.5 pour Dotclear

Cette version complète la définition de la syntaxe des templates Clearbricks/Dotclear (mise en valeur des noms des balises/variables et des attributs). Ce plugin — qui est une réécriture intégrale du plugin dcHighlight qui n’a pas été mis à jour depuis quelques années — reprend le script  […]

Lire la suite

Journée grise

Lundi matin en gris vaguement clair, je viens d’entendre le boxer passer en bas dans la rue, celui qui repassera dans l’autre sens, tard le soir, comme toujours. De la pluie, prévue, toute la journée, évidemment ; au moins y’aura pas de verglas, c’est toujours ça ! Et puis ça caille… Faut que je  […]

Lire la suite

Plugin hljs 0.4.1 pour Dotclear

Cette version corrige un bug mineur, sans incidence sur son utilisation. Ce plugin — qui est une réécriture intégrale du plugin dcHighlight qui n’a pas été mis à jour depuis quelques années — reprend le script highlight.js de Ivan Sagalaev et l’encapsule pour pouvoir l’utiliser pour colorier la  […]

Lire la suite

Haut de page