Sphinx est-il déjà adapté à la documentation C++? [fermé]

Question

Sphinx est-il déjà adapté à la documentation C++? [fermé]

je veux essayer des générateurs de documentation pour un nouveau projet en C++. Je pense que mes options sont soit Doxygen ou Sphinx. Puisque j'ai des projets en Python pour lesquels J'aimerais utiliser Sphinx, je me demande si Sphinx est aussi le bon choix pour C++. Le site Sphinx indique que C++ est supporté, mais je n'ai pas pu trouver de document pour me lancer avec la documentation C++.

une question similaire a déjà été discuté le Stackoverflow et la réponse principale conclut:

pas encore entièrement utilisable,

mais continuez à regarder

puisque la discussion est bien plus d'un an , je me demande si cette conclusion est encore valide. Dois-je choisir Doxygen plutôt que Sphinx pour ma documentation C++?

35

c++ documentation doxygen python-sphinx

demandé sur Community 2012-10-17 16:03:26

2 réponses

score 18 · Answer 1

Sphinx ne peut pas extraire la documentation des sources C++ en elle-même. Cependant, il existe des extensions , notamment Breathe , qui utilisent Doxygen pour extraire de la documentation du C++. Je n'ai pas testé l'un de ces.

score 0 · Answer 2

Pour le C++ Doxygen est très bonne, le Sphinx de support de C++ se fait via Doxygen (à l'aide de Respirer ).

Vous voulez avoir un seul outil pour les deux langues, pour améliorer la maintenabilité. Doxygen peut générer une documentation à partir du code Python , donc je vous conseille D'utiliser Doxygen pour les deux sources, si possible. voici un tutoriel pour Doxygen et Python .

Las etiquetas más populares

Sphinx est-il déjà adapté à la documentation C++? [fermé]

2 réponses