Macro documentation/fr

Description
Toutes les macros doivent être correctement documentées de la même manière que les commandes Gui Command. Elles doivent avoir une page wiki individuelle et être répertoriés dans l'une des catégories de Recettes Macros.

La page recettes de macro contient une belle sélection de macros créées par des utilisateurs expérimentés, et peuvent être installées directement à partir de l'utilitaire Addon Manager.

Voir le Modèle GuiCommand et les pages de macros comme la Macro Loft et Macro Site From Contours pour voir comment documenter les macros. Au moins deux sections doivent être incluses, une section avec des informations générales sur l’utilisation et une section  pour contenir le code réel de la macro. D'autres sections peuvent être incluses si nécessaire pour expliquer plus en détail l'utilisation de la macro.

Si une macro fournit une fonctionnalité bien définie et est bien documentée, elle pourrait éventuellement être incluse dans un nouvel atelier ou un atelier existant.

Ajouter de nouvelles macros
Créez une nouvelle page pour la macro commençant par le mot, par exemple,. Le lien peut être utilisé sans trait de soulignement sous la forme, ce qui entraîne Excellente modification de macro; les espaces sont automatiquement convertis en traits de soulignement.

Dans la nouvelle page, vous devez utiliser Template:Macro/fr en haut, avec un minimum d'informations:

Vous pouvez ajouter un icône personnalisée s'il ne porte pas le même nom que la macro. vous pouvez également ajouter d'autres champs d'information.

Lors de la traduction de la page, utilisez un modèle localisé. Vous devez spécifier le nom avec le code de langue à deux lettres, et vous devez indiquer l'icône explicitement

ou utilisez le champ


 * Utilisez la page Special:Upload pour télécharger votre icône personnalisée aux formats SVG ou PNG. Il devrait avoir le même nom que la macro.
 * Sinon, par défaut  [[Image:Text-x-python.png|32px]] sera utilisé.

Template:Macro/fr mettra les informations sur l'utilisation et l'installation des macros dans chaque page.



Ajouter la documentation sur la macro

 * Tout comme une Gui Command, expliquez ce que fait la macro, ses entrées, sorties, options et limitations, le cas échéant.
 * Inclure un icône personnalisé au format SVG ou PNG pour votre macro afin que les autres utilisateurs puissent l’inclure dans une barre d’outils personnalisée.
 * Ajoutez une ou plusieurs images pour clarifier l'utilisation de votre outil.
 * Si la macro effectue une tâche complexe, envisagez d'ajouter un fichier GIF animé pour présenter ses fonctionnalités. L'image GIF doit avoir une taille maximale de 500 x 500 pixels; si le GIF est plus grand, l'animation peut ne pas fonctionner. Ne redimensionnez pas le GIF car le wiki ne lira pas les GIF redimensionnés.
 * Mentionnez les macros et les ateliers associés qui complètent la fonction de cet outil.
 * Mentionnez la version de FreeCAD utilisée sur lequel la macro a été créée. Ces informations peuvent être recueillies à partir de.


 * Lorsque cette information est collée, elle ressemble à ceci

Envisagez d'ajouter ces informations dans un bloc de commentaires à l'intérieur du code de la macro.

Ajouter une nouvelle macro
Dans la section, utilisez Template:Code pour placer le code de la macro dans la page. Cela créera un bloc de texte utilisant la police de caractères monospace, ce qui préservera les espaces essentiels pour Python..

Ajouter des informations d'en-tête avant votre code réel.

Ces informations peuvent être utilisées par la macro addons_installer.FCMacro ou par l'utilitaire Plugin Loader, pour installer la macro et vérifier s'il y a de nouvelles versions. À partir de FreeCAD 0.17, ces informations sont également utilisées par le Gestionnaire d’addon, qui télécharge la macro à partir du référentiel FreeCAD-macros.

Ajouter le code d'une macro en dehors du wiki
Si votre macro est trop grosse qui dépasser 64 Ko, elle ne pourra pas être hébergée sur le wiki. Dans ce cas, utilisez le template Template:Codeextralink avec le lien vers l'adresse Web de la page brute du code (page texte du code).

Exemple:

Il sera affiché comme:

Ce modèle doit être placé au début de la page de macro, dans la section. Il doit s'agir du premier bloc de code de la page pour que le Gestionnaire de l'addon puisse le détecter automatiquement et l'importer. Voir Macro CirclePlus pour un exemple d'utilisation.

Ajouter une nouvelle macro au référentiel wiki
Utilisez le template Template:MacroLink inclure une ligne dans la catégorie appropriée dans Recettes Macros; créer une nouvelle catégorie si nécessaire.


 * The first argument is the name of the macro page in the wiki.
 * The second argument is the displayed text, which may be different from the page name. This will create a link to the first argument, showing the second argument as the text.
 * A short description of the macro comes after the colon.

You can also use the optional parameter  to specify the image file that will be placed at the start of the line. The icon should be an SVG or a PNG file, and should have the same name as your macro. If this parameter is not given it will use the default icon for a Python script.

To localize this template, use the appropriate language link in the first argument.

Adding the new macro to the central repository
To make a macro installable from the Addon Manager it should be included in the central FreeCAD-macros repository.

In order to include the macro there, first it must be reviewed by the FreeCAD community in the Python scripting and macros subforum. Once this is done, the FreeCAD-macros repository should be forked, the new macro should be included in a branch, and then the branch should be pushed and merged into the upstream repository.