IdentifiantMot de passe
Loading...
Mot de passe oublié ?Je m'inscris ! (gratuit)
Navigation

Inscrivez-vous gratuitement
pour pouvoir participer, suivre les réponses en temps réel, voter pour les messages, poser vos propres questions et recevoir la newsletter

C++ Discussion :

génération de documentation sous forme de wiki


Sujet :

C++

  1. #1
    Membre confirmé

    Inscrit en
    Décembre 2009
    Messages
    164
    Détails du profil
    Informations forums :
    Inscription : Décembre 2009
    Messages : 164
    Points : 490
    Points
    490
    Par défaut génération de documentation sous forme de wiki
    Salut à tous,

    Quelqu'un aurait une idée sur comment générer de la documentation de code sous forme de wiki. Pour l'instant j'utilise doxygen qui génère de l'html et les transformateurs html -> code wiki ne marchent pas très bien.

    Merci d'avance.
    G.

  2. #2
    Expert confirmé

    Homme Profil pro
    Développeur informatique
    Inscrit en
    Septembre 2007
    Messages
    1 895
    Détails du profil
    Informations personnelles :
    Sexe : Homme
    Âge : 47
    Localisation : France, Bouches du Rhône (Provence Alpes Côte d'Azur)

    Informations professionnelles :
    Activité : Développeur informatique
    Secteur : High Tech - Opérateur de télécommunications

    Informations forums :
    Inscription : Septembre 2007
    Messages : 1 895
    Points : 4 551
    Points
    4 551
    Par défaut
    Est-ce qu'il ne serait pas judicieux de faire une sortie XML, et ensuite de faire un petit programme qui va prendre cette sortie XML pour la mettre dans la forme désirée (quitte à écrire le dit programme) ?

    A ma connaissance, il n'y a pas de passerelle doxygen -> wiki, et je ne connais pas de système générant une documentation dans un format wiki. Ca tiens peut-être à l'absence de définition de ce qu'est un format wiki
    [FAQ des forums][FAQ Développement 2D, 3D et Jeux][Si vous ne savez pas ou vous en êtes...]
    Essayez d'écrire clairement (c'est à dire avec des mots français complets). SMS est votre ennemi.
    Evitez les arguments inutiles - DirectMachin vs. OpenTruc ou G++ vs. Café. C'est dépassé tout ça.
    Et si vous êtes sages, vous aurez peut être vous aussi la chance de passer à la télé. Ou pas.

    Ce site contient un forum d'entraide gratuit. Il ne s'use que si l'on ne s'en sert pas.

  3. #3
    Membre expert
    Profil pro
    Inscrit en
    Mars 2007
    Messages
    1 415
    Détails du profil
    Informations personnelles :
    Localisation : France, Paris (Île de France)

    Informations forums :
    Inscription : Mars 2007
    Messages : 1 415
    Points : 3 156
    Points
    3 156
    Par défaut
    Citation Envoyé par Emmanuel Deloget Voir le message
    Est-ce qu'il ne serait pas judicieux de faire une sortie XML, et ensuite de faire un petit programme qui va prendre cette sortie XML pour la mettre dans la forme désirée (quitte à écrire le dit programme) ?
    Tout à fait, c'est d'ailleurs ce qu'ils disent ici.

    De plus Doxygen fournit un parseur XML spécial adapté aux gros volumes de documentation générés.
    Find me on github

  4. #4
    Expert confirmé

    Homme Profil pro
    Développeur informatique
    Inscrit en
    Septembre 2007
    Messages
    1 895
    Détails du profil
    Informations personnelles :
    Sexe : Homme
    Âge : 47
    Localisation : France, Bouches du Rhône (Provence Alpes Côte d'Azur)

    Informations professionnelles :
    Activité : Développeur informatique
    Secteur : High Tech - Opérateur de télécommunications

    Informations forums :
    Inscription : Septembre 2007
    Messages : 1 895
    Points : 4 551
    Points
    4 551
    Par défaut
    XSLT devrait te permettre de transformer tes fichiers XML vers le format Wiki.

    A noter (parce que à force de chercher des choses, on trouve ) une feuille de style XSLT pour transformer du HTML vers le langage de markup de MediaWiki. Pas complet, mais déjà pas mal.
    [FAQ des forums][FAQ Développement 2D, 3D et Jeux][Si vous ne savez pas ou vous en êtes...]
    Essayez d'écrire clairement (c'est à dire avec des mots français complets). SMS est votre ennemi.
    Evitez les arguments inutiles - DirectMachin vs. OpenTruc ou G++ vs. Café. C'est dépassé tout ça.
    Et si vous êtes sages, vous aurez peut être vous aussi la chance de passer à la télé. Ou pas.

    Ce site contient un forum d'entraide gratuit. Il ne s'use que si l'on ne s'en sert pas.

  5. #5
    Membre expert
    Profil pro
    Inscrit en
    Mars 2007
    Messages
    1 415
    Détails du profil
    Informations personnelles :
    Localisation : France, Paris (Île de France)

    Informations forums :
    Inscription : Mars 2007
    Messages : 1 415
    Points : 3 156
    Points
    3 156
    Par défaut
    Oui enfin j'ai déjà essayé XSLT et je préfère me farcir une implémentation à la main parce que XSLT c'est quand même mal branlé et absolument imbitable à rédiger. Et c'est pas faute de m'être battu avec.
    Find me on github

Discussions similaires

  1. génération de documentation sous forme de wiki
    Par kmedghaith dans le forum Langages de programmation
    Réponses: 0
    Dernier message: 23/12/2010, 14h00
  2. [BO XI R2] Document sous forme de graphique
    Par StefKine dans le forum Webi
    Réponses: 6
    Dernier message: 24/10/2008, 12h26
  3. [BO XI R2] Document sous form de graphique
    Par StefKine dans le forum Webi
    Réponses: 1
    Dernier message: 23/10/2008, 18h03
  4. Problème ouverture de document sous forms 10G
    Par squallJ dans le forum Forms
    Réponses: 1
    Dernier message: 22/08/2006, 14h27
  5. Enregister un état sous forme d'un document word
    Par sfaxi dans le forum Access
    Réponses: 5
    Dernier message: 13/04/2006, 23h13

Partager

Partager
  • Envoyer la discussion sur Viadeo
  • Envoyer la discussion sur Twitter
  • Envoyer la discussion sur Google
  • Envoyer la discussion sur Facebook
  • Envoyer la discussion sur Digg
  • Envoyer la discussion sur Delicious
  • Envoyer la discussion sur MySpace
  • Envoyer la discussion sur Yahoo