Source documentation/fr

Présentation
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 est hébergée en ligne sur le site web de l'API FreeCAD. 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.

La compilation de la documentation de l'API suit les mêmes étapes générales que la compilation de l'exécutable FreeCAD, comme indiqué dans la page de compilation sous Linux.



Documentation complète
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 le graphe de dépendance de FreeCAD pour montrer les relations entre différents objets.

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.
 * Créez un autre répertoire dans lequel vous compilerez FreeCAD et sa documentation.
 * Configurez les sources avec, 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.

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

Comme mentionné dans Compilation (Accélération), l'option  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

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

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

Documentation réduite
La documentation complète utilise environ 3 Go d'espace disque. 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.

La documentation sur le site Web de l'API FreeCAD est produite automatiquement à partir de https://github.com/FreeCAD/SourceDoc. Tout le monde peut le reconstruire et soumettre un pull request :


 * forkez le repo sur https://github.com/FreeCAD/SourceDoc
 * sur votre machine: clonez le code FreeCAD (si vous ne l'avez pas encore fait), créez un répertoire de construction pour le document et clonez le référentiel SourceDoc ci-dessus à l'intérieur. Ce SourceDoc sera mis à jour lorsque vous reconstruirez le document et vous pourrez valider et pousser les résultats par la suite:


 * Accédez à votre fork en ligne et créez un pull request.

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, , ou un paquetage similaire.
 * Décompressez l'archive située dans ; 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.

Utiliser Doxygen
Voir la page Doxygen pour une explication détaillée sur la façon de commenter le code source C++ et Python afin qu'il puisse être traité par Doxygen pour créer automatiquement la documentation.

Essentiellement, un bloc de commentaires commençant par ou  pour C++, ou  pour Python, doit apparaître avant chaque définition de classe ou de fonction, afin qu’elle soit sélectionnée par Doxygen. De nombreuses commandes spéciales, commençant par ou, peuvent être utilisées pour définir des parties du code et formater la sortie. La syntaxe Markdown est également comprise dans le bloc de commentaires, ce qui facilite la mise en évidence de certaines parties de la documentation.