PROJET AUTOBLOG


IdleBlog

Site original : IdleBlog

⇐ retour index

Fond de tiroir #1 ~ Générateur de doc javascript monofichier

jeudi 1 juin 2017 à 21:30

Si vous êtes un développeur dans l’âme, vous avez déjà eu à faire à cette problématique de la petite idée de projet que vous avez codé en une aprèm puis que vous n’avez jamais eu l’envie le temps de retoucher.

Plus le temps passe et plus le nombre d’idées qui végètent sans but dans votre placard à projet s’accumulent… A la lumière de ce constat, j’ai décidé d’ouvrir une petite rubrique pour partager mes fonds de tiroirs, plusieurs n’en sont qu’aux balbutiements, aussi je les partage sur ce blog avec quelques explications au cas ou quelqu’un souhaiterais les ré-exploiter.

Mon fond de tiroir du jour est un petit fichier php unique permettant de générer une doc minimaliste au format HTML à partir d’un fichier javascript.

Concrètement le PHP parse les commentaires au dessus de chaque fonction javascript et génère une page unique de consultation formatée (nom de la fonction, paramètres, descriptif en commentaire…).

La mise en forme reste volontairement simpliste de manière a pouvoir faire un copier coller sur word ou autres éditeurs répandus n’acceptant pas le javascript/css poussé.

Points forts :

Points faibles:

Le fichier PHP est ici pour ceux que ça intéresse :
Télécharger le bousin

Si vous souhaitez l’améliorer / y accéder via git, vous pouvez trouver le dépôt créé par Chouchen ici :

https://github.com/Chouchen/jsdoc