Phpmanta suite: classe mdoc pour auto-documenter vos sources php

Soyez le premier à donner votre avis sur cette source.

Vue 4 689 fois - Téléchargée 450 fois

Description

Mdoc est un utilitaire de génération automatique de documentation du même style que le manuel en ligne de php.net.

Mdoc analyse les codes sources PHP et ses commentaires pour construire le manuel d'une classe ou d'une librairie. Une librairie est un fichier de fonctions, une classe est une classe PHP 4 ou PHP 5 valide.

La documentation peut être générée formatée par défaut ou personnalisée selon vos souhaits. La version par défaut est directement inspirée du manuel de php.net. Le format personnalisé est généré grâce à un puissant système de templates et peut être structuré en XML.

Codes Sources

A voir également

Ajouter un commentaire

Commentaires

Messages postés
2
Date d'inscription
vendredi 20 janvier 2006
Statut
Membre
Dernière intervention
21 janvier 2006

Pour les erreurs:

Notice: Undefined variable: force_php4 in e:\Internet\wamp\www\phpManta\Mdoc\view-internals.php on line 6

No such file or directory in e:\Internet\wamp\www\phpManta\Mdoc\view-internals.php on line 12

$force_php4 est défini dans config.php (pour focer le chargement de Mdoc version PHP4, la version PHP5 est en test pour prochgaine version).

Si tu respectes les chemins du Zip (voir ci-dessus), tu ne dvrais avoir aucune erreur (il trouvera le ./config.php et donc le $force_php4 etc.).
Messages postés
2
Date d'inscription
vendredi 20 janvier 2006
Statut
Membre
Dernière intervention
21 janvier 2006

Désolé pour les <? je corrige dans la prochaine version.

Très simple à utiliser:
1- unzipper dans un rep /phpManta sur un serveur PHP
2- ouvrir dans le navigateur: /phpManta/index.php pour tester sur les exemples et Mdoc elle-même
3- pour utiliser sur votre code, il faut modifier le rep des sources en $current_dir dans browse-documentation.php vers ligne 47

Je m'aperçois que le $ref_dir de browse-config.php est inutile (suite à des modifs dûes aux particularités des serveurs SF.net ou $_SERVER['DOCUMENT_ROOT'] est inutilisable).

Je vais améliorer les exemples pour la prochaines versions.

Vous pouvez écrire votre propre "browse-doc" très simplement, voici 2 exemples qui montrent le principe:
http://sourceforge.net/project/screenshots.php?group_id=145292&ssid=24967

Merci de poster un maximum de feedback + ou -
@+
Messages postés
71
Date d'inscription
jeudi 18 novembre 2004
Statut
Membre
Dernière intervention
12 août 2006

Ya marqué dans l'url du screen > phpmanta.sourceforge.net
@+
Messages postés
9433
Date d'inscription
mardi 9 octobre 2001
Statut
Membre
Dernière intervention
13 avril 2007
8
Quelques fichiers débutent par <? au lieu de <?php (config.php, browse-config.php, le reste j'ai pas regardé)

Notice: Undefined variable: force_php4 in e:\Internet\wamp\www\phpManta\Mdoc\view-internals.php on line 6

No such file or directory in e:\Internet\wamp\www\phpManta\Mdoc\view-internals.php on line 12

Il doit manquer des fichiers quelque part... Où as-tu trouvé ce projet ?
Messages postés
9433
Date d'inscription
mardi 9 octobre 2001
Statut
Membre
Dernière intervention
13 avril 2007
8
Salut,

ça m'a l'air génial (genre javadoc). Je vais tester tout ça et je te dis ce que j'en pense après :-)

à tout à l'heure

Vous n'êtes pas encore membre ?

inscrivez-vous, c'est gratuit et ça prend moins d'une minute !

Les membres obtiennent plus de réponses que les utilisateurs anonymes.

Le fait d'être membre vous permet d'avoir un suivi détaillé de vos demandes et codes sources.

Le fait d'être membre vous permet d'avoir des options supplémentaires.