Source documentation/fr: Difference between revisions
No edit summary |
No edit summary |
||
Line 4: | Line 4: | ||
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, générant ainsi des pages HTML avec des hyperliens vers chaque fonction et classe documentées. |
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, générant ainsi des pages HTML avec des hyperliens vers chaque fonction et classe documentées. |
||
⚫ | La documentation source hébergée en ligne sur [http://www.freecadweb.org/api/ web]. Veuillez noter que cette documentation n'est pas toujours maintenue à jour. Si vous avez besoin de plus de détails, téléchargez le dernier code source de FreeCAD et compilez vous-même la documentation. Si vous avez des questions urgentes sur le code, veuillez les poser dans la section développeurs du [https://forum.freecadweb.org/index.php FreeCAD forum]. |
||
<div class="mw-translate-fuzzy"> |
|||
⚫ | La documentation source en ligne |
||
</div> |
|||
Compiling the API documentation follows the same general steps as compiling the FreeCAD executable, as indicated in the [[CompileOnUnix|compile on Unix]] page. |
Compiling the API documentation follows the same general steps as compiling the FreeCAD executable, as indicated in the [[CompileOnUnix|compile on Unix]] page. |
Revision as of 17:50, 8 August 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, générant ainsi des pages HTML avec des hyperliens vers chaque fonction et classe documentées.
La documentation source hébergée en ligne sur web. Veuillez noter que cette documentation n'est pas toujours maintenue à jour. Si vous avez besoin de plus de détails, téléchargez le dernier code source de FreeCAD et compilez vous-même la documentation. Si vous avez des questions urgentes sur le code, veuillez les poser dans la section développeurs du FreeCAD forum.
Compiling the API documentation follows the same general steps as compiling the FreeCAD executable, as indicated in the compile on Unix page.
General workflow to compile FreeCAD's programming documentation. The Doxygen and Graphviz packages must be in the system, as well as the FreeCAD source code itself. CMake configures the system so that with a single make instruction the documentation for the the entire project is compiled into many HTML files with diagrams.
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
Cette section explique comment commenter votre code source afin que Doxygen puisse le traiter pour créer automatiquement la documentation.
Essentially, a comment block, starting with /**
or ///
for C++, or ##
for Python, needs to appear before every class or function definition, so that it is picked up by Doxygen. Many special commands, which start with \
or @
, can be used to define parts of the code and format the output. Markdown syntax is also understood within the comment block, which makes it convenient to emphasize certain parts of the documentation.
/**
* Returns the name of the workbench object.
*/
std::string name() const;
/**
* Set the name to the workbench object.
*/
void setName(const std::string&);
/// remove the added TaskWatcher
void removeTaskWatcher(void);
- Démarrer avec FreeCAD
- Installation : Téléchargements, Windows, Linux, Mac, Logiciels supplémentaires, Docker, AppImage, Ubuntu Snap
- Bases : À propos de FreeCAD, Interface, Navigation par la souris, Méthodes de sélection, Objet name, Préférences, Ateliers, Structure du document, Propriétés, Contribuer à FreeCAD, Faire un don
- Aide : Tutoriels, Tutoriels vidéo
- Ateliers : Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test