Source documentation/fr: Difference between revisions

From FreeCAD Documentation
(Created page with "Une classe pour stocker une collection de coordonnées est définie dans un fichier d'en-tête C++. La partie supérieure du fichier est commentée et quelques mots-clés sont...")
mNo edit summary
Line 72: Line 72:
Une classe pour stocker une collection de coordonnées est définie dans un fichier d'en-tête C++. La partie supérieure du fichier est commentée et quelques mots-clés sont utilisés, tels que {{incode|@class}}, {{incode|@brief}}, {{incode|@sa}} et {{incode|@par}} pour indiquer les parties importantes. Dans la classe, avant l'appel d'une fonction, un bloc de texte commenté explique le rôle de la fonction et ses arguments.
Une classe pour stocker une collection de coordonnées est définie dans un fichier d'en-tête C++. La partie supérieure du fichier est commentée et quelques mots-clés sont utilisés, tels que {{incode|@class}}, {{incode|@brief}}, {{incode|@sa}} et {{incode|@par}} pour indiquer les parties importantes. Dans la classe, avant l'appel d'une fonction, un bloc de texte commenté explique le rôle de la fonction et ses arguments.


*source : [https://github.com/Kitware/VTK/blob/master/Common/Core/vtkArrayCoordinates.h vtkArrayCoordinates.h] défini la classe.
<div class="mw-translate-fuzzy">
* Page de documentation produite par Doxygen pour la classe [http://www.vtk.org/doc/nightly/html/classvtkArrayCoordinates.html de la classe vtkArrayCoordinates]
source : https://github.com/Kitware/VTK/blob/master/Common/Core/vtkArrayCoordinates.h
</div>


{{docnav/fr|[[Extra python modules/fr|Modules Python supplémentaires]]|[[List of Commands/fr|Liste des commandes]]}}
{{docnav/fr|[[Extra python modules/fr|Modules Python supplémentaires]]|[[List of Commands/fr|Liste des commandes]]}}

Revision as of 09:03, 18 July 2019

Le code source de FreeCAD est commenté pour permettre la génération automatique de documentation HTML à l'aide de Doxygen, un système de documentation de code source populaire. Doxygen peut documenter les parties C++ et Python de FreeCAD.

La documentation source en ligne est située sur web. Veuillez noter que cette documentation n'est pas toujours conservée à ce jour. si vous avez des questions urgentes sur le code, veuillez demander dans la section développeurs du FreeCAD forum.

Compilation de la documentation

Si vous avez installé Doxygen, il est très facile de construire la documentation. Installez également Graphviz pour pouvoir produire des diagrammes montrant les relations entre différentes classes et bibliothèques dans le code FreeCAD. Graphviz est également utilisé par graphe de dépendance de FreeCAD pour montrer les relations entre différents objets.

sudo apt install doxygen graphviz

Suivez ensuite les mêmes étapes que pour compiler FreeCAD, comme décrit à la page Compiler sous Unix, et résumées ici pour plus de commodité.

  • Obtenez le code source de FreeCAD et placez-le dans son propre répertoire freecad-source.
  • Créez un autre répertoire freecad-build dans lequel vous compilerez FreeCAD et sa documentation.
  • Configurez les sources avec cmake, en vous assurant d'indiquer le répertoire source et de spécifier les options requises pour votre construction.
  • Déclenchez la création de la documentation avec make.
git clone https://github.com/FreeCAD/FreeCAD.git freecad-source
mkdir freecad-build
cd freecad-build
cmake -DBUILD_QT5=ON -DPYTHON_EXECUTABLE=/usr/bin/python3 ../freecad-source

Pendant que vous êtes dans le répertoire de compilation, émettez les instructions suivantes pour ne créer que la documentation.

make -j$(nproc --ignore=2) DevDoc

Comme mentionné dans Compilation (Accélération), l'option -j définit le nombre de cœurs de processeur utilisés pour la compilation. Les fichiers de documentation résultants apparaîtront dans le répertoire

freecad-build/doc/SourceDocu/html/

Le point d’entrée de la documentation est le fichier index.html, que vous pouvez ouvrir avec un navigateur Web:

xdg-open freecad-build/doc/SourceDocu/html/index.html

La cible DevDoc générera une quantité importante de données, environ 5 Go de nouveaux fichiers, en raison notamment des diagrammes créés par Graphviz.

Une autre version plus petite de la documentation, qui ne nécessite qu'environ 600 Mo, peut être générée avec une cible différente. Ceci est la version affichée sur le site Web de l'API FreeCAD.

make -j$(nproc --ignore=2) WebDoc

Autres versions

Comme alternative, la doc est générée de temps en temps, et est accessible sur sourceforge ici.

FreeCAD 0.16 development documentation construite par qingfeng.xia.

FreeCAD 0.19 development documentation construite par qingfeng.xia.

Intégrer la documentation Coin3D

Sur les systèmes Unix, il est possible de lier la documentation source Coin3D avec FreeCAD. Cela facilite la navigation et complète les diagrammes d'héritage pour les classes dérivées de Coin.

  • Installez le libcoin-doc, libcoin80-doc, ou un paquetage similaire.
  • Décompressez l'archive coin.tar.gz située dans /usr/share/doc/libcoin-doc/html; les fichiers sont peut-être déjà décompressés dans votre système.
  • Générez à nouveau la documentation source.

Si vous n'installez pas le package de documentation pour Coin, les liens seront générés pour accéder à la documentation en ligne à l'adresse BitBucket. Cela se produira si un fichier de balise Doxygen peut être téléchargé au moment de la configuration avec wget.

Comment intégrer doxygen dans le code source de FreeCAD

Ceci est un travail en cours. Voyez Doxygen

Cette section explique comment commenter votre code source afin que Doxygen puisse le traiter pour créer automatiquement la documentation.

Ceci est un exemple de la façon dont le code source est documenté. Il examine le code source de VTK, une bibliothèque de visualisation 3D utilisée pour présenter les résultats de simulations multi-physiques.

Une classe pour stocker une collection de coordonnées est définie dans un fichier d'en-tête C++. La partie supérieure du fichier est commentée et quelques mots-clés sont utilisés, tels que @class, @brief, @sa et @par pour indiquer les parties importantes. Dans la classe, avant l'appel d'une fonction, un bloc de texte commenté explique le rôle de la fonction et ses arguments.