Source documentation/fr: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
mNo edit summary
Line 2: Line 2:
{{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]]}}


Le code source de FreeCAD est commenté pour permettre la génération automatique de documentation HTML à l'aide de [http://www.doxygen.org Doxygen], un système de documentation de code source populaire. Doxygen peut documenter les parties C++ et Python de FreeCAD.
<div class="mw-translate-fuzzy">
Le code source de FreeCAD est commenté de manière à permettre la génération automatique de la documentation html avec [http://www.doxygen.org Doxygen]. C'est le cas pour les parties C++ et Python du code source FreeCAD.
</div>


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">

Revision as of 08:47, 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 http://www.freecadweb.org/api/

Compilation de la documentation

Si vous avez installé Doxygen, il est très facile de compiler la doc. Accédez au répertoire de compilation de FreeCAD, et configurez vos sources avec CMake comme ceci :

sudo apt install doxygen graphviz

Then follow the same steps you would do to compile FreeCAD, as described on the compile on Unix page, and summarized here for convenience.

  • Get the source code of FreeCAD and place it in its own directory freecad-source.
  • Create another directory freecad-build in which you will compile FreeCAD and its documentation.
  • Configure the sources with cmake, making sure you indicate the source directory, and specify the required options for your build.
  • Trigger the creation of the documentation using 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

While you are inside the build directory issue the following instruction to create only the documentation.

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

et consultez les fichiers HTML résultants à partir de Doc/SourceDocu/html/index.html.

freecad-build/doc/SourceDocu/html/

The point of entrance to the documentation is the index.html file, which you can open with a web browser:

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

La cible DevDoc ci-dessus permettra, si graphviz est installé sur votre système, de générer un volume de données supérieur à 2 Go. Une version alternative plus petite (~ 500 Mo), qui est la version utilisée sur http://www.freecadweb.org/api/ peut également être générée en saisissant à la place :

An alternative, smaller version of the documentation which takes only around 600 MB can be generated with a different target. This is the version displayed on the FreeCAD API website.

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

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

FreeCAD 0.16 development documentation built by qingfeng.xia.

Voici une autre documentation FreeCAD 0.19dev Doxygen ainsi qu'une version précédente 0.16dev_documentation, générée par qingfeng.xia.

Intégrer la documentation Coin3D

Sur les systèmes Unix, il est possible de lier les documents sources Coin3D avec FreeCAD.

Il permet une navigation plus facile dans l'arborescence des diagrammes, pour les classes Coin dérivées.

  • Sur les systèmes Debian et dérivés :
- Installez le paquet libcoin60-doc.
- Décompressez le fichier /usr/share/doc/libcoin60-doc/html/coin.tag.gz.
- Régénérer le source de la documentation.
Vous êtes prêt pour la navigation hors ligne.
  • Si vous ne voulez pas, ou ne pouvez pas installer Coin doc package, les liens seront générés pour accéder à Coin doc en ligne, sur doc.coin3D.org, si le fichier doxygen tag peut être téléchargé au moment de la configuration (wget).

Comment intégrer doxygen dans le code source de FreeCAD

Ceci est un travail en cours. Voyez Doxygen

Exemple de page complète doxygen : (d'un autre projet)

This section explains how to comment your source code so that it can be processed by Doxygen to automatically create the documentation.

This is an example of how source code is documented. It looks into the source code of VTK, a 3D visualization library used to present multi-physics simulation results.

A class to store a collection of coordinates is defined in a C++ header file. The top part of the file is commented, and a few keywords are used, like @class, @brief, @sa, and @par to indicate important parts. Inside the class, before a function is called, a block of commented text explains what the function does, and its arguments.