Publicité
+ Répondre à la discussion
Page 3 sur 4 PremièrePremière 1234 DernièreDernière
Affichage des résultats 41 à 60 sur 65
  1. #41
    Membre chevronné
    Avatar de iubito
    Homme Profil pro Sylvain Machefert
    Développeur Java
    Inscrit en
    janvier 2003
    Messages
    387
    Détails du profil
    Informations personnelles :
    Nom : Homme Sylvain Machefert
    Âge : 32
    Localisation : France, Haute Loire (Auvergne)

    Informations professionnelles :
    Activité : Développeur Java
    Secteur : Finance

    Informations forums :
    Inscription : janvier 2003
    Messages : 387
    Points : 624
    Points
    624

    Par défaut

    j'capte pas ce que tu veux dire par hiérarchisée.

    Perso j'commence à utiliser phpdocumentor, je le trouve génial !
    Je ne sais pas pour quand est prévue la version suivant (v2) qui devrait apporter énormément de choses... j'ai un peu causé avec Greg, il est bien occupé (il joue dans un quartet et fait des tournées...) et donc il développe en loisir 8)
    Il est bien sérieux et corrige vite les bugs (j'en ai débusqué quelques uns )
    Lé SMS cé kom lé ognon, sa pike lé yeu

  2. #42
    Futur Membre du Club
    Inscrit en
    janvier 2004
    Messages
    25
    Détails du profil
    Informations forums :
    Inscription : janvier 2004
    Messages : 25
    Points : 17
    Points
    17

    Par défaut

    Ben que dès qu'une classe possède des classes filles, un sous-arbe apparaisse, comme ça on voit directement la hiérarchie des classes.

  3. #43
    Membre du Club
    Inscrit en
    juin 2003
    Messages
    97
    Détails du profil
    Informations forums :
    Inscription : juin 2003
    Messages : 97
    Points : 58
    Points
    58

    Par défaut

    Citation Envoyé par -COil-
    J'utilise aussi phpdocumentor , www.phpdoc.org

    C'est génial, assez contraignant au debut, mais quand on a fais la base apres c'est facile de mettre a jour voici 2 docs de ma classe de debug avec 2 skins diffentes :

    --> http://phpdebug.sourceforge.net/docu...dit/index.html

    --> http://phpdebug.sourceforge.net/docu...rty/index.html

    J'ai aussi trouvé une doc avec un skin qui de tueur que je vais essayer de recup

    --> http://dickmann.homeunix.org/pear/ph.../Var_Dump.html

    Au fait c'est un des package officiel de Pear meme s'il peut fonctionner en standalone.
    salut

    je viens de piger

    en fait, ce truc permet de générer dynamiquement ds PHP des sites de documentation ou autres manuels...c'est ça ?

    Mais vous devez qd même tout renseigner où ca va choper les champs, titres... dans la Base ?
    a+

  4. #44
    Membre à l'essai
    Inscrit en
    avril 2004
    Messages
    80
    Détails du profil
    Informations forums :
    Inscription : avril 2004
    Messages : 80
    Points : 21
    Points
    21

    Par défaut

    A mon avis, rien ne vaut la bonne vieille programmation a la main....

  5. #45
    Membre habitué
    Inscrit en
    décembre 2002
    Messages
    89
    Détails du profil
    Informations forums :
    Inscription : décembre 2002
    Messages : 89
    Points : 102
    Points
    102

    Par défaut

    Je suis le créateur d'AutoPhpDoc. Le projet n'est plus maintenu depuis la dernière version qui date d'un peu plus d'un an, il faut simplement que je le dise sur le site

    Le point le plus important de ma démarche était de faire un logiciel utilisable en ligne de commande, sans avoir besoin de faire un script annexe. Si cette fonctionnalité existe sur un autre produit, je suis preneur. Sinon j'essaierai de le reprendre pour qu'il existe quand-même un documenteur qui le permette, quite à simplement écrire une interface CLI à un autre générateur plus suivi (je pense que cette solution est la plus simple).

    P.S: pour ceux chez qui l'install a foiré, si vous avez envie de m'envoyer un bug-report je suis preneur

    Edit: phpDocumentor s'utilise ultra-facilement en ligne de commande. Je l'ai adopté.

  6. #46
    Invité régulier
    Inscrit en
    janvier 2004
    Messages
    5
    Détails du profil
    Informations forums :
    Inscription : janvier 2004
    Messages : 5
    Points : 6
    Points
    6

    Par défaut

    Citation Envoyé par cedricgirard
    Citation Envoyé par Nonothehobbit
    Lol tu te doute bien qu'on ne nous apprend pas que à commenter.
    Je voulais juste dire que l'on ne m'a jamais fait entrer dans le crane de force que un bon code est un code commenté.
    tu veux dire que vous n'utilisez aucun commentaire pendant la phase de production inclus dans le code ?
    et ensuite, une fois le produit définitif livré, aucun commentaire n'est fourni sur le code ?
    pourtant, je crois comprendre que vous mettez tout de même une documentation en place.
    Quelle est la finalité de celle ci ? le client, le programmeur qui rejoint le projet en cours, les techniciens qui auront en charge la maintenance et l'évolution du projet ?
    Celle ci est présentée sous quelle forme ? diagrammes de classes UML, diagrammes de séquence ?

    merci de ta réponse

  7. #47
    Membre du Club
    Inscrit en
    juin 2004
    Messages
    93
    Détails du profil
    Informations forums :
    Inscription : juin 2004
    Messages : 93
    Points : 45
    Points
    45

    Par défaut

    Pour ceux qui se demande à quoi sert une doc automatique et bien c'est simple: à gonfler un rapport de stage

    Enfin je rigole mais ...

  8. #48
    Membre du Club
    Profil pro
    Consultant informatique
    Inscrit en
    novembre 2003
    Messages
    52
    Détails du profil
    Informations personnelles :
    Localisation : France

    Informations professionnelles :
    Activité : Consultant informatique
    Secteur : High Tech - Produits et services télécom et Internet

    Informations forums :
    Inscription : novembre 2003
    Messages : 52
    Points : 40
    Points
    40

    Par défaut

    Citation Envoyé par kileak
    Citation Envoyé par -COil-
    J'utilise aussi phpdocumentor , www.phpdoc.org

    C'est génial, assez contraignant au debut, mais quand on a fais la base apres c'est facile de mettre a jour voici 2 docs de ma classe de debug avec 2 skins diffentes :

    --> http://phpdebug.sourceforge.net/docu...dit/index.html

    --> http://phpdebug.sourceforge.net/docu...rty/index.html

    J'ai aussi trouvé une doc avec un skin qui de tueur que je vais essayer de recup

    --> http://dickmann.homeunix.org/pear/ph.../Var_Dump.html

    Au fait c'est un des package officiel de Pear meme s'il peut fonctionner en standalone.
    salut

    je viens de piger

    en fait, ce truc permet de générer dynamiquement ds PHP des sites de documentation ou autres manuels...c'est ça ?

    Mais vous devez qd même tout renseigner où ca va choper les champs, titres... dans la Base ?
    a+
    Oups !! Desolé pour la réponse tardive !!!

    Et bien oui le but est de générer la doc a partir des sources, aussi bien la doc technique que la doc utilisateur, tout se fait à partir des tags inclus dans le source :

    Exemple :

    --> http://phpdebug.sourceforge.net/docu...debug.php.html

    Voici la derniere version de ma doc pour la derniere version de ma classe, elle inclue FAQ, INSTALLATION, contacts, sources des classes, exemples... donc c'est parfait ! Je la met en ligne et je met exactement la meme donc le packake zip de la derniere version de mon package.

    --> http://phpdebug.sourceforge.net/docu...1.0/index.html

    Vala.

    PS : Je n'ai pas testé d'autres générateurs, celui la me convient amplement, et je suis tres loin d'utiliser toutes les possibilités qu'il offre.

  9. #49
    Membre chevronné Avatar de hansaplast
    Homme Profil pro
    Inscrit en
    septembre 2005
    Messages
    929
    Détails du profil
    Informations personnelles :
    Sexe : Homme
    Âge : 32
    Localisation : France

    Informations professionnelles :
    Secteur : High Tech - Éditeur de logiciels

    Informations forums :
    Inscription : septembre 2005
    Messages : 929
    Points : 609
    Points
    609

    Par défaut

    sur le site de dyoxigen, ils disent que phph n'est pas entieremment supporté, quelles sont les limites stp?

  10. #50
    Invité régulier
    Inscrit en
    décembre 2005
    Messages
    5
    Détails du profil
    Informations forums :
    Inscription : décembre 2005
    Messages : 5
    Points : 6
    Points
    6

    Par défaut

    Bonjour à tous !

    Citation Envoyé par hansaplast
    sur le site de dyoxigen, ils disent que phph n'est pas entieremment supporté, quelles sont les limites stp?
    Je ne sais pas si c'est une limitation de doxygen par rapport à PHP, mais j'aimerais commenter une variable membre de classe d'une certaine manière, c'est-à-dire, déclarer les variables membres en début de classe sans commentaire, puis avant chaque fonctions accesseurs, créer un bloc de commentaire pour expliquer le rôle de la variable correspondante. Par exemple :

    Code :
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
     
    class MaClasse
    {
        protected $foo;
        protected $bar;
        [...]
     
        public function __construct(){}
        [...]
     
        /**
           \var    $foo
           \brief  Variable permettant de stocker ...
     
                    Détail ...
     
           \see   getFoo(), setFoo()
       */
       public function getFoo(){return $this->foo;}
       public function setFoo($foo){$this->foo = foo;}
    }
    Malheureusement, Doxygen (version 1.4.5) me répond : Warning: documented function 'MaClasse::foo' was not defined (il a du mal avec les $). Apparement beaucoup de personne utilise doxygen pour commenter leur code PHP, et pourtant google ne trouve aucun lien vers ce genre de problème. Je me dis que ca ne doit pas être impossible, et que ca doit être moi qui n'est pas tout compris

    J'aimerais donc savoir si quelqu'un sait comment commenter une variable dans un bloc de commentaire indépendant, en utilisant \var (@var) ?

    Merci ^^

    PS (admin/mod) : Veuillez m'excuser si ce message n'a rien à faire dans ce topic, mais j'ai pas trouvé d'autre endroit où le mettre ^^

  11. #51
    Invité de passage
    Inscrit en
    février 2006
    Messages
    4
    Détails du profil
    Informations forums :
    Inscription : février 2006
    Messages : 4
    Points : 1
    Points
    1

    Par défaut

    Bonjour,

    j'utilise pour le moment PHPdoc.org et je me retrouve confronté au Problème avec des variables déclarées en public dans mes classes qui n'apparaissent pas dans la doc.

    Je viens d'ouvrir un billet sur le forum à cette endroit -> http://www.developpez.net/forums/vie....php?p=2575040

    Si des personnes savent la manip à faire pour remonter mes public ça serait super cool...

    Cordialement

  12. #52
    Membre Expert Avatar de stailer
    Homme Profil pro Jean-François CAMBOT
    Développeur informatique
    Inscrit en
    mars 2003
    Messages
    1 053
    Détails du profil
    Informations personnelles :
    Nom : Homme Jean-François CAMBOT
    Âge : 36
    Localisation : France, Hautes Pyrénées (Midi Pyrénées)

    Informations professionnelles :
    Activité : Développeur informatique
    Secteur : High Tech - Éditeur de logiciels

    Informations forums :
    Inscription : mars 2003
    Messages : 1 053
    Points : 1 837
    Points
    1 837

    Par défaut

    Personnellement j'utilise PHPDocumentor, intégré dans le Zend Development Environment.
    Je le trouve très bien, il permet une foule de format de sortie : html avec des frames, sans frame, avec DOM, du pdf...etc, y a pleins de styles installés.
    Personnellement j'utilise le style "phpedit" car il n'inclus pas les codes sources complets mais uniquement la documentation de ses dernières.
    .o0o__St@iLeR__oOo.

    Chef de projet / Développeur

    Silverlight / ASP.NET MVC - MCP ASP.NET 4
    Zend Framework / Ajax (Jquery et ExtJS)
    Adobe Flash Builder (Flex)

    Ma librairie pour faire communiquer PHP et Silverlight "à la" WCF : http://code.google.com/p/phpservices-silverlight/

  13. #53
    Membre éclairé Avatar de XtofRoland
    Inscrit en
    août 2005
    Messages
    357
    Détails du profil
    Informations forums :
    Inscription : août 2005
    Messages : 357
    Points : 363
    Points
    363

    Par défaut

    http://www.microgold.com/version2/ar...HPReverse.html

    je ne l'ai pas utilisé mais ca a l'air interressant

    EDIT je l'ai testé, je n'ai pas vu le php dans la version trial et
    apres désinstalation j'ai du reinstaller word...
    Le but de tout developpeur OO est de devenir une référence.
    Mon avatar est un ambigramme, les curieux peuvent le retourner ;-)
    Aider <> Faire a la place de!!!

  14. #54
    Membre éclairé Avatar de XtofRoland
    Inscrit en
    août 2005
    Messages
    357
    Détails du profil
    Informations forums :
    Inscription : août 2005
    Messages : 357
    Points : 363
    Points
    363

    Par défaut

    Je suis sous easyphp et j'ai mis phpdocumentator dans un repertoire du root.

    la premiere page s'affiche,
    a quoi sert la variable :Working Directory?
    le bouton ...
    me genere une target_blank avec ceci dedans:
    Notice: Undefined variable: root_dir in C:\Program Files\Apache Group\Apache2\htdocs\PhpDocumentor-1.3.0RC4\docbuilder\file_dialog.php on line 52

    Warning: include_once(/phpDocumentor/common.inc.php) [function.include-once]: failed to open stream: No such file or directory in C:\Program Files\Apache Group\Apache2\htdocs\PhpDocumentor-1.3.0RC4\docbuilder\file_dialog.php on line 52

    Warning: ...

    Fatal error: Call to undefined function phpDocumentor_parse_ini_file() in C:\Program Files\Apache Group\Apache2\htdocs\PhpDocumentor-1.3.0RC4\docbuilder\file_dialog.php on line 68
    Choose a config: je laisse don't use a config

    dans Files Directory
    to parse je met le repertoire de mon site

    dans Output Target je met le chemin du repertoire ou je voudrais que ma doc soit générée.

    je click sur create et....
    rien...

    qqn utilises t'il ce generateur?

    EDIT
    J'ai réessayé sur un serveur php5 no problemes...
    super doc.
    Le but de tout developpeur OO est de devenir une référence.
    Mon avatar est un ambigramme, les curieux peuvent le retourner ;-)
    Aider <> Faire a la place de!!!

  15. #55
    Membre Expert
    Avatar de guitou12
    Homme Profil pro Guillaume
    Inscrit en
    juillet 2006
    Messages
    977
    Détails du profil
    Informations personnelles :
    Nom : Homme Guillaume
    Âge : 31
    Localisation : France, Gironde (Aquitaine)

    Informations forums :
    Inscription : juillet 2006
    Messages : 977
    Points : 1 332
    Points
    1 332

    Par défaut

    Pour ma part j'utilise doxygen depuis le début, cependant depuis que je suis passé sous Zend pour développer j'ai un petit souci de compatibilité entre les styles de documentation au niveau de la déclaration des variables (balises spéciales Doxygen et phpdoc sous Zend pour un affichage dynamique de bulles d'aide)

    Quelqu'un aurait réussi à déjouer ces petits soucis en configurant comme il faut doxygen ?

    Voilà la syntaxe que doxygen n'aime pas car il s'attends à une fonction et non une déclaration de membre de classe
    Code :
    1
    2
    3
    4
    5
    6
    /**
    	 * Liste des motifs d'absence
    	 *
    	 * @var Array $l_motifs
    	 */
    	private $l_motifs;
    Ex développeur Php / J2EE.
    Actuellement reconverti à SharePoint 2013

    Mon blog SP 2013

  16. #56
    Nouveau Membre du Club
    Homme Profil pro
    Développeur Web
    Inscrit en
    septembre 2006
    Messages
    23
    Détails du profil
    Informations personnelles :
    Sexe : Homme
    Âge : 25
    Localisation : France

    Informations professionnelles :
    Activité : Développeur Web

    Informations forums :
    Inscription : septembre 2006
    Messages : 23
    Points : 26
    Points
    26

    Par défaut Salut @ tous

    à tous, j'ai lu entièrement les réponse pour ce sujet et je vous pose une grande question avec un grand problème :
    j'ai la dernière version de PhpDocumentor en version stable, je l'ai depuis 1 semaine mais je n'arrive pas du tout à le faire marcher.
    Ca m'affiche des messages d'erreur que je ne comprend pas.
    Contrairement à ce que certains pourrait le croire, je ne suis pas un newbie.

    Je suis depuis 3 mois sur un gros projet et justement il commence vraiment à être très gros et j'ai besoin de documentation (donc d'un générateur).

    Et ce que quelqu'un pourrait m'aider ?

    EDIT
    je pense que j'ai le même problème que XtofRoland.
    Je fonctionne sous la dernière version de php 5.

    PhpDocumentor me retourne ces erreurs :

    ERROR: Converter HTMLSmartyConverter specified by --output command-line option is not a class

    ERROR: No Converters have been specified by --output command-line option

    ERROR: No Converters have been specified by --output command-line option


  17. #57
    Candidat au titre de Membre du Club
    Inscrit en
    mars 2004
    Messages
    15
    Détails du profil
    Informations personnelles :
    Âge : 30

    Informations forums :
    Inscription : mars 2004
    Messages : 15
    Points : 11
    Points
    11

    Par défaut

    J'utilise Doxygen pour générer la docmentation de mes développments en C++ ce qui me convient parfaitement.
    Cependant j'ai un problème avec ce même outil quand je désire générer la doc pour une application php5; je m'explique :
    Doxygen ne me génère la documentation des classes mères, mais pas celle des classes qui en dérive
    Quelqu'un aurai rencontré un problème similaire ???

    Sinon phpDocumentor génère t-il la documentation en français ?

  18. #58
    Nouveau Membre du Club
    Homme Profil pro
    Développeur Web
    Inscrit en
    septembre 2006
    Messages
    23
    Détails du profil
    Informations personnelles :
    Sexe : Homme
    Âge : 25
    Localisation : France

    Informations professionnelles :
    Activité : Développeur Web

    Informations forums :
    Inscription : septembre 2006
    Messages : 23
    Points : 26
    Points
    26

    Par défaut

    désolé baptistoux, je peut pas t'aider mais les personnes d'en haut le peuvent certainement...
    En ce qui concerne PhpDocumentor, la langue de génération dépend de ce que tu écrit dans tes fichiers. Je pense que certains trucs sont en anglais (comme la navigation dans la documentation).

  19. #59
    Invité de passage
    Inscrit en
    août 2004
    Messages
    8
    Détails du profil
    Informations forums :
    Inscription : août 2004
    Messages : 8
    Points : 2
    Points
    2

    Par défaut

    Je n'aime plus trop phpDoc.

    Pour l'avoir utiliser, je le trouvais sympa au départ, mais assez vite j'ai du m'arrêter de l'utiliser.

    D'une part, il n'a pas l'air vraiment bien codé (pour preuve, le tas de notice et warning qu'on trouve dans la ligne de commande quand on a réussi à la faire fonctionner)

    D'autre part, le côté ligne de commande assez sporadique et le côté "t'utilises pas PEAR? ben t'as pas phpDoc".

    J'ai abandonné phpDoc à la sortie de la 1.3 finale simplement à cause de ça, c'est débile car la doc générée est sympa - malgré que <code> ne fait pas ce qu'il devrait faire (ie: du code en ligne).

    Je vais réessayer car, peut-être que le fait d'avoir plusieurs versions n'était pas trop apprécié, mais quand même ...

    Quant à Doxygen : sympa dommage que php soit mal supporté :/

    [edit] alternativement, il faut savoir que php5 avec l'API de réflection permet de chopper les phpdocs des méthodes, fonctions, et propriétés (ça ne fait pas les constantes, dommage).

    [edit] oui donc, après avoir retenté, c'est toujours aussi merdique. la version 1.3 finale refuse carrément de démarrer en ligne de commande sans compter le basar pseudo shell et la jolie erreur du tout début (require_once failed, etc).

    Autant la 1.3RC6 fonctionnait, autant là...

  20. #60
    Nouveau Membre du Club
    Inscrit en
    novembre 2005
    Messages
    46
    Détails du profil
    Informations forums :
    Inscription : novembre 2005
    Messages : 46
    Points : 26
    Points
    26

    Par défaut

    Citation Envoyé par guitou12
    Pour ma part j'utilise doxygen depuis le début, cependant depuis que je suis passé sous Zend pour développer j'ai un petit souci de compatibilité entre les styles de documentation au niveau de la déclaration des variables (balises spéciales Doxygen et phpdoc sous Zend pour un affichage dynamique de bulles d'aide)

    Quelqu'un aurait réussi à déjouer ces petits soucis en configurant comme il faut doxygen ?

    Voilà la syntaxe que doxygen n'aime pas car il s'attends à une fonction et non une déclaration de membre de classe
    Code :
    1
    2
    3
    4
    5
    6
    /**
    	 * Liste des motifs d'absence
    	 *
    	 * @var Array $l_motifs
    	 */
    	private $l_motifs;
    Excusez moi de faire remonter le topic, mais je viens de tester qu'aujourd'hui Doxygen et je dois avouer qu'il me plait bien...

    Pour ton problème, lit la doc de Doxygen, rubrique
    Putting documentation after members
    If you want to document the members of a file, struct, union, class, or enum, and you want to put the documentation for these members inside the compound, it is sometimes desired to place the documentation block after the member instead of before. For this purpose you have to put an additional < marker in the comment block. Note that this also works for the parameters of a function.

    Here are some examples:

    Code :
    int var; /*!< Detailed description after the member */
    This block can be used to put a Qt style detailed documentation block after a member. Other ways to do the same are:

    Code :
    int var; /**< Detailed description after the member */
    En bref, il faut faire la déclaration juste après ta variable. Exemple:
    Code :
    1
    2
    3
    4
    5
     
        var $usersdb = "";    /**<
    	 * the database link for the table USERS
             * @see connect()
    	 */
    Bonne fin de journée ;-)

Liens sociaux

Règles de messages

  • Vous ne pouvez pas créer de nouvelles discussions
  • Vous ne pouvez pas envoyer des réponses
  • Vous ne pouvez pas envoyer des pièces jointes
  • Vous ne pouvez pas modifier vos messages
  •