Matthieu Marcillaud
c73565df86
Maj composer.lock
2 years ago
Matthieu Marcillaud
18baa54ba5
Checkout a été renommé.
2 years ago
Matthieu Marcillaud
672e89d082
C’est exactement l’inverse !
3 years ago
Matthieu Marcillaud
b92024ec84
Le test doit porter sur une révision différente maintenant. L’infériorité de la révision n’a de sens qu’en svn...
3 years ago
Matthieu Marcillaud
fef69aff3d
On recopie une fonction pour retrouver checkout.php ici aussi. Faudrait une méthode statique quelque part.
3 years ago
Matthieu Marcillaud
505801ac59
Les liens vers les bonnes sources pour 'voir en ligne'
3 years ago
Matthieu Marcillaud
fed157d364
Retrouver les informations du VCS Git dans le compilateur de PhpDocumentor.
3 years ago
Matthieu Marcillaud
f8b093677b
Dernières corrections.
3 years ago
Matthieu Marcillaud
59672ff885
Coquille de récupération d’argument.
3 years ago
Matthieu Marcillaud
ab9d54599d
Récupérer correctement révision et branche en git. Si verbose indiquer les commandes checkout
3 years ago
Matthieu Marcillaud
4af40c4fc8
On adapte le générateur à Git, via les commandes Checkout.php
3 years ago
Matthieu Marcillaud
f2ffcdc6c8
On prépare les commandes qu’on souhaite pour générer la documentation autodoc à partir de sources Git.
3 years ago
Matthieu Marcillaud
efab566ee9
Update du composer.json pour bloquer phpdocumentor en version 2...
3 years ago
fecd12c0e4
Indiquer l’url source dans le json de l’autodoc des plugins (Eric)
4 years ago
b368815efd
On remet le préfixe en clé de tableau également
4 years ago
d6672a7d0c
Tentons de génerer un fichier plugins.json pour l’autodoc.
4 years ago
71ad8329e9
Améliorer le rendu des tags @example en comprenant que si le texte commence par ``` c'est bien qu’il était indenté en bloc de code.
6 years ago
ae49a6e7c7
mise à jour d'urls
6 years ago
cf127a82f0
mise à jour d'urls
6 years ago
589f5222b5
Update des urls
6 years ago
a9d24b7e5e
La commande 'which' ne fonctionne pas partout, ni de façon homogène.
...
http://stackoverflow.com/questions/592620/check-if-a-program-exists-from-a-bash-script
Il vaut mieux utiliser 'command -v'.
6 years ago
42951f492d
Un jour on passera à git et on aura droit à --amend ^^
6 years ago
67d0ce1f6c
Si on ne trouve pas svn, tenter svnlite.
6 years ago
98c5e140b9
Obtenir le chemin de la commande SVN du serveur. (le nouveau serveur n'a pas le même chemin).
6 years ago
568b8ed505
La correction sur le ticket https://github.com/phpDocumentor/phpDocumentor2/issues/1677 est intégrée.
...
On peut enlever notre surcharge.
+ une notice PHP en moins
7 years ago
2fa0261859
Pour que les erreurs ne soient pas compatibilisées en double, il faut les créer
...
au moment de la validation, avec des contraintes indiquées par des classes spécifiques.
Une erreur dans phpDocumentor fait que certaines erreurs sur les tags `@param` ne sont
pas compatibilisées et du coup, j'avais une fonction pour les ajouter, mais pas
dans la méthodologie attendue par phpDocumentor, ce qu'il fait qu'elles apparraissent
en double.
Après une (assez longue) analyse, la source du problème qui fait que phpDocumentor
n'analysait pas certaines erreurs est trouvée, et un patch est proposé
(https://github.com/phpDocumentor/phpDocumentor2/issues/1677 )
En attendant son intégration un jour éventuel, on envoie ici,
sous le bon format de quoi trouver les erreurs en question.
Et on nettoie au passage l'ancien mécanisme que j'utilisais.
7 years ago
fbc504ea35
Sur le helper, pouvoir utiliser --force pour forcer l'analyse des fichiers (phpdocumentor a un cache qu'il utilise si le fichier n'a pas été modifié)
7 years ago
3a0947c727
Générer aussi pour les plugins les erreurs de références sur @see ou @uses .
...
Cependant, on tolère de mettre des @see ou @uses vers des fonctions de SPIP.
Dans ce cas là, un lien sera fait vers code.spip.net.
On ne pourra trouver que les fonctions présentes dans code.spip.net,
c'est à dire dans la version de SPIP en développement.
7 years ago
e225889cf8
Le nombre de répertoires était faux. On ne comptait que le répertoire racine :p
7 years ago
380c51b8ec
Une option --force sur l'aide à la génération des docs de plugin, pour générer la doc même si le plugin n'a pas été mis à jour.
7 years ago
c57b1fdce9
Meilleur texte pour les graphiques de statistiques, vu que pour les plugins, si il n'y a pas eu de nouveau commit, la documentation n'est pas régénérée.
7 years ago
00e98413a3
Générer un fichier qui liste toutes les références (fqsen) des fichiers, classes, fonctions et de leurs urls correspondantes.
7 years ago
fe0dea933d
Ajout du nom de la référence manquante sur les @uses ou @see en erreur.
7 years ago
47a1ca8743
Pour générer la page d'accueil avec toutes les descriptions des plugins documentés,
...
il faut récupérer leurs infos (titre, descriptif, etc), même si leur documentation n'a pas
besoin d'être régénérée.
7 years ago
50edb6be80
Pas besoin de préparer un fichier phpdoc.xml si la documentation n'a pas besoin d'être actualisée.
...
(une ligne de log en moins).
7 years ago
4ac7b2fa49
Permettre de générer uniquement un certain prefixe lorsqu'on demande à générer tout un fichier qui liste de documentations (autodoc.txt).
7 years ago
bfc6e66177
Éviter que la description d'une fonction touche l'icone d'api.
7 years ago
93428f3c1d
Logs moins loquaces
7 years ago
8829af6be0
Optimiser la création de la documentation phpdoc des plugins en ne régénérant pas la doc si un plugin n'a pas eu de mise à jour depuis la précédente génération.
7 years ago
f812af9d16
Basculer sur la norme P30-c pour l'intégration de la boussole (_eric_)
7 years ago
51545d0e7d
Pour Éric : gérer un paramètre d'appel supplémentaire sur le helper nommé --avec_boussole_spip qui ajuotera la boussole SPIP sur la documentation générée.
...
De même, alternativement, --topnav=URL ajoutera le js contenu dans l'url indiquée dans le header.
Exemple : `autodoc/bin/autodoc_helper from:file --avec_boussole_spip`
Génère la documentation des plugins de la zone, avec la boussole intégrée.
7 years ago
859f139812
Forcer un test sur le contenu textuel (ce sont des objets ici)
7 years ago
120d876b23
Le fond jaunatre, c'est sympa, mais pas très lisible. Donc, quelques corrections de CSS.
...
Et on évite les shadow, c'est pas très joli.
7 years ago
ccd1b196f0
Réparer enfin les cas des exemples dont il manquait parfois le premier mot.
...
En fait, phpdocumentor attend : @example url [start?] [stop?] [description?]
mais nous on écrit simplement : @example texte d'exemple
qui ne correspond pas à une url. Le premier mot ou suite de caractères avant un espace
est considéré comme l'url (inexistante), et ne fait pas partie de la description.
Donc, on remet l'url fausse, dans la description, avec start et stop (numéro de première ligne et nombre de ligne)
s'ils avaient aussi été capturés par hasard des textes.
7 years ago
a69b8c4c3c
Le tri des filtres est particulier car certains sont nommés 'nn', et d'autres 'filtres_nn'. On trie effectivement sur 'nn'
7 years ago
bd37a3718e
L'identifiant de div ne doit pas être le même pour les erreurs et notices.
7 years ago
b30f41e568
Séparer les graphs d'erreurs des notices. colorier un peu.
7 years ago
23158b7bd6
Ne pas oublier la div qui reçoit le graphique !
7 years ago
525ec6b0d2
Faire un premier graphique de statistiques sur uniquement 30 jours.
...
Quelle ennui en JS pour simplement surcharger une fonction dans une nouvelle classe sans impacter la fonction d'origine de la classe étendue…
7 years ago
2fae088e35
La topnav doit revenir sur l'autodoc si on la demande !
8 years ago
Matthieu Marcillaud
marcimat@rezo.net