SPIP
▻http://autodoc.magraine.net/spip-dev/zora/apis.html
autodoc de SPIP : les API triée par type
-
-
Pourquoi ne pas documenter tout ça dans le glossaire officiel ? ►http://www.spip.net@
-
Tiens, il y a un bug quand on pointe sur le site de Spip (non seulement le site est annoncé en italien, mais en plus, l’arobase n’est pas incorporé au lien. )
-
Parce que c’est un job en cours et qui donc est encore incomplet (mais @marcimat abat un boulot dingue). A terme je crois que ce site devrait prendre place sur quelque chose comme ▻http://doc.spip.org ?
-
Rah, mais qui est-ce qui envoie des liens de trucs en plein chantier ?
C’est un espace qui me permet de tester le phpdoc qu’on met au fur et à mesure dans le code source de SPIP. Et c’est une documentation automatique et non traduite, contrairement à spip.net. Et ça ne documente que les fonctions du code source, par exemple la balise TITRE n’y est pas (puisqu’elle n’a pas de fonction associée).
Enfin, oui, derrière tout ça il y a l’idée de reprendre doc.spip à terme… C’est un peu expliqué là ▻http://blog.smellup.net/spip.php?article59 . L’idée est peut être d’avoir un endroit où tout le code source est documenté (ce que je fais avec autodoc), et un autre, différent et plus construit autour des APIs, permettant une interaction (forum à la php.net), avec une documentation qui ne serait pas uniquement issue du code source
Même si ça avance, c’est long à faire (surtout pour documenter) et d’autre part le logiciel phpDocumentor est une nouvelle fois en pleine refonte (voir ▻https://github.com/phpDocumentor/phpDocumentor2/issues/735) pour intégrer TWIG et pouvoir l’utiliser encore plus facilement. Ce qui va nécessiter une grande reprise du code de ce site (autodoc), mais accélérera fantastiquement sa génération (il utilise déjà Twig, mais avec plein de requêtes xpath() sur un gros XML, c’est assez long).
Voilà ce que je peux en dire.
-
Et enfin, il vaut mieux suivre ▻http://autodoc.magraine.net/spip-dev/zora car c’est sur la branche dev que le phpDoc est intégré pour l’instant.
-
oups ! super désolé : ce lien aurait du rester en mode « private » sur mon delicious et donc ne pas être visible sur seenthis...
Je le vire si tu préfère -
C’est pas grave hein ! Y a une discussion du coup ▻http://thread.gmane.org/gmane.comp.web.spip.devel/63965 pour savoir ce qu’on en fait :)
-
-