Addon/de: Difference between revisions

From FreeCAD Documentation
(Created page with "== Verschiedene Typen ==")
No edit summary
(14 intermediate revisions by 3 users not shown)
Line 3: Line 3:
== Einführung ==
== Einführung ==


In FreeCAD und dieser Dokumentation ist ein [[addon/de|Addon]] eine beliebige Komponente, die nicht Teil der Basis-FreeCAD-Installation ist, die aber dem System durch bestimmte Methoden hinzugefügt werden kann.
In FreeCAD und dieser Dokumentation ist eine [[addon/de|Erweiterung]] eine beliebige Komponente, die nicht Teil der Basisinstallation ist, die aber dem System durch bestimmte Methoden hinzugefügt werden kann.


== Verschiedene Typen ==
== Verschiedene Typen ==


Es gibt zwei Arten von Erweiterungen:
<div class="mw-translate-fuzzy">
* [[Macros/de|Makros]]: kurze Schnipsel von [[Python/de|Python]] Code, der ein neues Werkzeug oder eine neue Funktionalität in einer einzigen Datei mit der Endung {{incode|.FCMacro}} bereitstellt.
Es gibt zwei Arten von Addons:
* Modul: eine einzelne Python Quelldatei oder eine Sammlung von Python Dateien, die die Software in irgendeiner Weise erweitert. Module definieren nicht notwendigerweise einen grafischen "Arbeitsbereich", können aber eine unterstützende Funktion bieten, z.B. eine Bibliothek, die die Konvertierung von Formaten durchführt, oder Code, der die grafische [[interface/de|Oberfläche]] modifiziert.
* [[Macros/de|Makros]]: kurze Schnippsel von [[Python/de|Python]]-Code, die ein neues Werkzeug oder eine Funktionalität hinzufügen
* [[External workbenches/de|Arbeitsbereiche]]: Sammlungen von Python Dateien, die verwandte [[Gui_Command/de|Gui Befehle]] (Werkzeuge), die sich auf ein bestimmtes Thema konzentrieren, z.B. Werkzeuge für den Entwurf von Schränken oder Werkzeuge für die Arbeit mit Architektur oder Werkzeuge für den Entwurf von Booten usw. Diese Arbeitsbereiche definieren normalerweise neue Werkzeugleisten, in denen [[Gui_Command/de|Befehle]] als Schaltflächen platziert werden.
* [[External workbenches/de|Externe Arbeitsbereiche]]: Sammlungen von Werkzeugen in Python oder C++, die FreeCAD in einer wichtigen Weise erweitern
</div>


Macros as installed under the user's {{incode|Macro/}} directory, while modules and workbenches are under the {{incode|Mod/}} directory.
Makros wie unter dem {{incode|Macro/}} Benutzerverzeichnis installiert, während Module und Arbeitsbereiche unter dem {{incode|Mod/}} Verzeichnis liegen.
{{Code|lang=bash|code=
{{Code|lang=bash|code=
$HOME/.FreeCAD/Macro/
$HOME/.FreeCAD/Macro/
Line 19: Line 18:
}}
}}


Makros beginnen in der Regel als eine Möglichkeit, die Aufgabe, ein bestimmtes Objekt zu zeichnen oder zu bearbeiten, zu vereinfachen oder zu automatisieren. Wenn viele dieser Makros in einem Verzeichnis gesammelt werden und eine Struktur zur Verfügung gestellt wird, um diese Werkzeuge zu sammeln, dann kann das gesamte Verzeichnis als ein Arbeitsbereich verteilt werden.
<div class="mw-translate-fuzzy">
Makros starten normalerweise als Möglichkeit, eine Zeichnungsaufgabe oder Änderung eines bestimmtes Objekt zu vereinfachen oder zu automatisieren. Wenn viele dieser Makros innerhalb eines Verzeichnisses gesammelt werden, kann das gesamte Verzeichnis als ein neuer Arbeitsbereich verteilt werden.
</div>


Mit anderen Worten: Makros, Module und Arbeitsbereiche sind im Wesentlichen dasselbe, Stücke von Python Code, die die Basisinstallation erweitern. Makros sind in der Regel kurz und auf eine einzige Aufgabe konzentriert, Module stellen in der Regel neue Funktionen oder Schnittstellen zur Verfügung, und Arbeitsbereiche sind Sammlungen von Werkzeugen (Schaltflächen, Menüs) und grafischen Oberflächen zur Ausführung verwandter Aufgaben.
<div class="mw-translate-fuzzy">
In anderen Worten, Makros und Arbeitsbereiche sind im Grunde das gleiche Ding, Code-Stücke, die die Basisinstallation erweitern. Makros sind normalerweise kurze Dienstprogramme fokussiert auf eine einzelne Aufgabe, während Arbeitsbereiche Sammlungen von (organised) Werkzeugen und graphischen Schnittstellen sind, um verwandte Aufgaben zu erledigen.
</div>


Wenn ein Arbeitsbereich ausreichend entwickelt und gut dokumentiert ist, wird er ggf. als einer der Basis [[workbenches/de|Arbeitsbereiche]] in FreeCAD eingefügt.
<div class="mw-translate-fuzzy">
Wenn ein Arbeitsbereich ausreichend entwickelt und gut dokumentiert ist, wird er ggf. als einer der Basis-[[workbenches/de|Arbeitsbereiche]] in FreeCAD eingefügt.
</div>


== Installation ==
== Installation ==


Beginnend mit FreeCAD 0.17 ist der empfohlene Weg zur Installation von Erweiterungen mit dem
<div class="mw-translate-fuzzy">
[[File:Std_AddonMgr.svg|24px]] [[Std_AddonMgr/de|Erweiterungsverwalter]].
Beginnend mit FreeCAD v.017 ist der empfohlene Weg zur Installation von Addons der [[Addon Manager/de|Addon-Manager]].
</div>


Trotzdem ist manuelle Installation weiterhin möglich.
<div class="mw-translate-fuzzy">
* [[How to install macros/de|Wie Makros installiert werden]]
Manuelle Installation ist weiterhin möglich.
* [[How to install macros/de|Makros installieren]]
* [[Installing more workbenches/de|Weitere Arbeitsbereiche installieren]]
* [[Installing more workbenches/de|Weitere Arbeitsbereiche installieren]]
</div>


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

Revision as of 06:18, 24 September 2020

Einführung

In FreeCAD und dieser Dokumentation ist eine Erweiterung eine beliebige Komponente, die nicht Teil der Basisinstallation ist, die aber dem System durch bestimmte Methoden hinzugefügt werden kann.

Verschiedene Typen

Es gibt zwei Arten von Erweiterungen:

  • Makros: kurze Schnipsel von Python Code, der ein neues Werkzeug oder eine neue Funktionalität in einer einzigen Datei mit der Endung .FCMacro bereitstellt.
  • Modul: eine einzelne Python Quelldatei oder eine Sammlung von Python Dateien, die die Software in irgendeiner Weise erweitert. Module definieren nicht notwendigerweise einen grafischen "Arbeitsbereich", können aber eine unterstützende Funktion bieten, z.B. eine Bibliothek, die die Konvertierung von Formaten durchführt, oder Code, der die grafische Oberfläche modifiziert.
  • Arbeitsbereiche: Sammlungen von Python Dateien, die verwandte Gui Befehle (Werkzeuge), die sich auf ein bestimmtes Thema konzentrieren, z.B. Werkzeuge für den Entwurf von Schränken oder Werkzeuge für die Arbeit mit Architektur oder Werkzeuge für den Entwurf von Booten usw. Diese Arbeitsbereiche definieren normalerweise neue Werkzeugleisten, in denen Befehle als Schaltflächen platziert werden.

Makros wie unter dem Macro/ Benutzerverzeichnis installiert, während Module und Arbeitsbereiche unter dem Mod/ Verzeichnis liegen.

$HOME/.FreeCAD/Macro/
$HOME/.FreeCAD/Mod/

Makros beginnen in der Regel als eine Möglichkeit, die Aufgabe, ein bestimmtes Objekt zu zeichnen oder zu bearbeiten, zu vereinfachen oder zu automatisieren. Wenn viele dieser Makros in einem Verzeichnis gesammelt werden und eine Struktur zur Verfügung gestellt wird, um diese Werkzeuge zu sammeln, dann kann das gesamte Verzeichnis als ein Arbeitsbereich verteilt werden.

Mit anderen Worten: Makros, Module und Arbeitsbereiche sind im Wesentlichen dasselbe, Stücke von Python Code, die die Basisinstallation erweitern. Makros sind in der Regel kurz und auf eine einzige Aufgabe konzentriert, Module stellen in der Regel neue Funktionen oder Schnittstellen zur Verfügung, und Arbeitsbereiche sind Sammlungen von Werkzeugen (Schaltflächen, Menüs) und grafischen Oberflächen zur Ausführung verwandter Aufgaben.

Wenn ein Arbeitsbereich ausreichend entwickelt und gut dokumentiert ist, wird er ggf. als einer der Basis Arbeitsbereiche in FreeCAD eingefügt.

Installation

Beginnend mit FreeCAD 0.17 ist der empfohlene Weg zur Installation von Erweiterungen mit dem Erweiterungsverwalter.

Trotzdem ist manuelle Installation weiterhin möglich.