Matthieu Marcillaud
7f369f9907
dump--
1 year ago
Matthieu Marcillaud
d80e12986e
Générer un index_autodoc.json
1 year ago
Matthieu Marcillaud
0d8ad12835
On range les autres plugins du core comme des plugins standards (eric)
1 year ago
Matthieu Marcillaud
6a3cf48cf3
Coquille
1 year ago
Matthieu Marcillaud
79fd530cf1
Centraliser les paramètres de header (titre, soustitre, topnav)
1 year ago
Matthieu Marcillaud
f05bd743a2
Lien vers la source sur les éléments documentés
1 year ago
Matthieu Marcillaud
2478849386
Un favicon, et ranger dans Externes les projets en dehors de la zone
1 year ago
Matthieu Marcillaud
be4f938596
Une marge sur le contenu gauche et droite, sur l’index
1 year ago
Matthieu Marcillaud
4c1dadb956
Sauvons du CO2 : ne pas repasser par phpdocumentor, si la doc existante est déjà sur le même commit. Sauf si option --force
1 year ago
Matthieu Marcillaud
852b1411da
Permettre d’avoir des docs .rst dans 'docs/' ou 'doc/'. Correction de sourci de préfixe sur from:directory
1 year ago
Matthieu Marcillaud
e5a1dde778
On peut intégrer la barre nav et l’entête dans les docs
1 year ago
Matthieu Marcillaud
e19778ecfa
Intégrer la boussole spip sur l’index
1 year ago
Matthieu Marcillaud
fa7676ebd5
Séparer les plugins-dist des autres plugins core, dans l’index généré.
1 year ago
Matthieu Marcillaud
fef1a8b00d
Permettre de générer SPIP avec ou sans ses plugins-dist. Intégrer la liste de ses plugins dans autodoc.json
1 year ago
Matthieu Marcillaud
1dd54497a7
Utiliser un Template pour centraliser Twig, et ajouter l’extension string de twig
1 year ago
Matthieu Marcillaud
a6f7766dcc
Un semblant de présentation css de l’index
1 year ago
Matthieu Marcillaud
7e9cc6b192
On sait générer un index. Reste à le décorer…
1 year ago
Matthieu Marcillaud
7e6d1bab9a
On utilise twig pour générer le phpdoc.xml
1 year ago
Matthieu Marcillaud
c3354730f1
Réécriture du context pour plus de clarté
1 year ago
Matthieu Marcillaud
3027e1a6ff
Des renommages sur des noms de répertoire
1 year ago
Matthieu Marcillaud
55a9278166
Début de commande pour générer un index
1 year ago
Matthieu Marcillaud
7f9e3dd8ef
On sait générer toutes les documentations depuis un fichier de type autodoc.txt
1 year ago
Matthieu Marcillaud
c741241405
On génère un fichier autodoc.json sur chaque projet.
...
On s’en servira plus tard pour générer un index (html) des différentes documentations
1 year ago
Matthieu Marcillaud
3a11cae0d5
Présenter la version utilisée et les liens vers les documentations
1 year ago
Matthieu Marcillaud
b8f955c750
On surcharge la sidebar du template pour ajouter quelques liens (plugins, documentation, forge, ...)
...
ainsi éventuellement que le slogan.
1 year ago
Matthieu Marcillaud
7328fba326
Transmettre le verbose à phpDocumentor, même si ça semble le faire tout seul ?
1 year ago
Matthieu Marcillaud
b2515ac68e
Déplacement de fichiers d’une première tentative pour ne pas confondre,
...
et petite passe de php-cs-fixer
1 year ago
Matthieu Marcillaud
a8f21974af
from:file pour plus tard, disions nous
1 year ago
Matthieu Marcillaud
6c9d36c26e
Mise à jour vers PhpDocumentor v3
...
Une bonne partie de l’application Autodoc disparait pour plusieurs raisons :
- On cherche à simplifier la maintenance de cette doc en ne créant pas de thème personnalisé,
car effectivement, la syntaxe PHP évolue bien plus vite que le temps disponible
pour adapter les templates aux évolutions. On préfère user juste d’un peu de
cosmétique avec un peu de CSS. Le thème complet d’avant disparait.
- L’application est devenue un .phar et les surcharges sont improbables là où le code
d’origine ne l’a pas explicitement prévu. Je n’ai absolument pas l’énergie
de me replonger à gérer des passes de compilation comme avant pour retrouver
les balises ou pipelines dans le code (je ne sais même pas si c’est faisable sur cette version).
Cette partie disparait aussi.
- On bascule sur du PHP 8.0 minimum.
On s’appuie sur différentes librairies dont toujours symfony/console, mais aussi
symfony/filesystem et League/Pipeline.
On gère les téléchargements et mises à jour Git avec l’outil checkout
(qui est donc nécessaire). Le fichier phpDocumentor.phar est aussi nécessaire
dans le répertoire de travail, tout comme la création d’un répertoire `var`
écrivable.
Une décoration spécifique du thème par défaut (css, svg), est copiée
dans la config générée (var/config/templates), et est alors utilisée
par phpDocumentor (sur le même principe de surcharge que les squelettes SPIP)
Les commandes from:directory, from:git, from:plugin, from:spip sont adaptées.
La commande from:file (lecture d’un fichier archivelist.txt) reste à faire.
1 year 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
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
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
marcimat@rezo.net