Addon/fr: Difference between revisions

From FreeCAD Documentation
(Created page with "== Différents types ==")
No edit summary
 
(35 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{TOCright}}


== Introduction ==
== Introduction ==


Dans FreeCAD et dans cette documentation, un [[addon/fr|addon]] est un composant qui ne fait pas partie de l'installation de base mais peut être ajouté au système par certaines méthodes.
Dans FreeCAD et dans cette documentation, une [[addon/fr|extension]] est un composant qui ne fait pas partie de l'installation de base mais peut être ajouté au système par certaines méthodes.


<span id="Different_types"></span>
== Différents types ==
== Différents types ==


Il existe environ trois types d'extensions :
<div class="mw-translate-fuzzy">
* [[Macros/fr|Macros]] : petit bout de code en [[Python/fr|Python]] qui fournit un nouvel outil ou une nouvelle fonctionnalité dans un seul fichier se terminant par {{incode|.FCMacro}}.
Il existe deux types d'addons.
* [[External_workbenches/fr|Ateliers]] : collections de fichiers Python qui fournissent des [[Gui_Command/fr|Gui Commands]] (outils) centrés autour d'un sujet particulier, par exemple, des outils pour concevoir des armoires ou des outils pour travailler avec l'architecture, ou des outils pour concevoir des bateaux, etc. Ces ateliers définissent généralement de nouvelles barres d'outils où des [[Gui_Command/fr|commandes]] sont placées sous forme de boutons.
* [[Macros/fr|Macros]]: extraits courts de code [[Python/fr|Python]] fournissant un nouvel outil ou une nouvelle fonctionnalité.
* [[Preference_Packs/fr|Kits de préférence]] : kits de préférences d'utilisateurs. {{Version/fr|0.20}}
* [[External workbenches/fr|External workbches]]: ensemble d’outils programmés en Python ou en C++ qui étend les fonctionnalités de FreeCAD de manière importante.
</div>


== Installation ==
Macros as installed under the user's {{incode|Macro/}} directory, while modules and workbenches are under the {{incode|Mod/}} directory.
{{Code|lang=bash|code=
$HOME/.FreeCAD/Macro/
$HOME/.FreeCAD/Mod/
}}


La méthode recommandée pour installer des extensions est d'utiliser le [[File:Std_AddonMgr.svg|24px]] [[Std_AddonMgr/fr|Gestionnaire des extensions]].
<div class="mw-translate-fuzzy">
Généralement l'utilisation de macros sont un moyen de simplifier ou d'automatiser une tâche de dessin ou d'édition d'un objet particulier. Si plusieurs de ces macros sont collectées dans un répertoire, l'intégralité du répertoire peut être distribué en tant que nouveau plan de travail.
</div>


Mais pour les macros et les ateliers, une installation manuelle est également possible :
<div class="mw-translate-fuzzy">
* [[How_to_install_macros/fr|Comment installer une macro]]
En d'autres termes, les macros et les ateliers sont essentiellement la même chose, des éléments de code qui étendent les fonctionnalités de base. Les macros sont généralement des utilitaires courts axés sur une tâche unique, tandis que les ateliers sont des ensembles d’outils organisés avec interfaces graphiques permettant d’exécuter des tâches connexes.
* [[Installing_more_workbenches/fr|Comment installer un atelier]]
</div>


<span id="Information_for_developers"></span>
<div class="mw-translate-fuzzy">
== Informations pour les développeurs ==
Si un atelier est suffisamment développé et bien documenté, il peut être inclus en tant qu'[[workbenches/fr|atelier]] de base dans FreeCAD.
</div>


Si vous avez développé une macro ou un atelier, et que vous souhaitez qu'il soit inclus dans le gestionnaire des extensions, lisez comment faire sur les pages : ([https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons] et [https://github.com/FreeCAD/FreeCAD-macros/ FreeCAD-macros]). Si vous ajoutez votre macro à la page [[Macros_recipes/fr|Liste des macros]], il n'y a rien d'autre à faire, elle sera automatiquement récupérée par le gestionnaire des extensions.
== Installation ==


Voir aussi :
<div class="mw-translate-fuzzy">
* [[Workbench_creation/fr#Distribution|Distribution d'un atelier Python]]
À partir de FreeCAD 0.17, la méthode recommandée pour installer des addons est d'utiliser: [[Addon Manager/fr|Addon Manager]].
* [[Workbench_creation/fr#Distribution_2|Distribution d'un atelier C++]]
</div>


<div class="mw-translate-fuzzy">
L'installation manuelle est toujours possible.
* [[How to install macros/fr|Comment installer une macro]]
* [[Installing more workbenches/fr|Comment installer un atelier]]
</div>


{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 18:31, 21 November 2023

Introduction

Dans FreeCAD et dans cette documentation, une extension est un composant qui ne fait pas partie de l'installation de base mais peut être ajouté au système par certaines méthodes.

Différents types

Il existe environ trois types d'extensions :

  • Macros : petit bout de code en Python qui fournit un nouvel outil ou une nouvelle fonctionnalité dans un seul fichier se terminant par .FCMacro.
  • Ateliers : collections de fichiers Python qui fournissent des Gui Commands (outils) centrés autour d'un sujet particulier, par exemple, des outils pour concevoir des armoires ou des outils pour travailler avec l'architecture, ou des outils pour concevoir des bateaux, etc. Ces ateliers définissent généralement de nouvelles barres d'outils où des commandes sont placées sous forme de boutons.
  • Kits de préférence : kits de préférences d'utilisateurs. introduit dans la version 0.20

Installation

La méthode recommandée pour installer des extensions est d'utiliser le Gestionnaire des extensions.

Mais pour les macros et les ateliers, une installation manuelle est également possible :

Informations pour les développeurs

Si vous avez développé une macro ou un atelier, et que vous souhaitez qu'il soit inclus dans le gestionnaire des extensions, lisez comment faire sur les pages : (FreeCAD-addons et FreeCAD-macros). Si vous ajoutez votre macro à la page Liste des macros, il n'y a rien d'autre à faire, elle sera automatiquement récupérée par le gestionnaire des extensions.

Voir aussi :