Installing Helpfile/de

FreeCAD Hilfedateien
Die FreeCAD Offline Dokumentation wird aus dem FreeCAD Wiki durch die Verwendung von Skripten erstellt. Sie ist auf eine Dateigröße von über 180 MB angewachsen. Diese großen Dateien sind nicht Teil der Installationsprogramme und ausführbaren Dateien von FreeCAD, können aber, wie hier dokumentiert, separat installiert werden.

Übersetzungen aus der Gemeinschaft sind erwünscht, daher ist die Offline Dokumentation jetzt auch in Französisch und Italienisch verfügbar. Andere Sprachen können sich in unterschiedlichen Stadien der Vollständigkeit befinden.

Herunterlanden der Hilfedateien
Eine funktionsfähige lokale Dokumentation besteht aus mindestens zwei Dateien:, die Qt-Hilfedatei-Konfiguration und , die komprimierte Qt-Hilfedatei. Beide sind zusammen in ein ZIP-Archiv gepackt.

Die Hilfedateien können hier heruntergeladen werden: https://github.com/FreeCAD/FreeCAD/releases/download/0.18.1/FreeCAD.0_18.Offline.Doc.7z

Als zukünftige Option sollen sie auch innerhalb von FreeCAD mit dem Erweiterungsverwalter installiert werden können.

Die Hilfedateien haben immer die gleichen Namen: und. Um verschiedene Versionen dieser Hilfsdateien zu haben, müssen sie in unterschiedlichen Verzeichnissen gespeichert werden. Falls die Dokumentation manuell heruntergeladen wird, ist die ZIP-Datei lokal zu speichern und in das gewünschte Dateiverzeichnis zu extrahieren.

Registrieren der Dokumentation
Das Dokumentationssystem von FreeCAD verwendet Qt Assistant. Du solltest dieses Programm zuerst installieren, falls du es noch nicht hast.

Die aktuelle Gliederung der Offline Hilfe erlaubt es, dass nur eine Hilfedatei aktiv sein kann. Es ist daher nicht möglich, gleichzeitig Hilfedateien in verschiedenen Sprachen von FreeCAD aus zugänglich zu machen.

Um eine andere Version der FreeCAD Dokumentation aktiv zu machen, sind die folgenden Schritte anzuwenden:


 * Innerhalb des Programms FreeCAD im Menü klicken. Es sollte sich das Programm Qt-Assistant öffnen.
 * Im Qt-Assistant im Menü klicken.
 * Im Einstellungen-Dialog auf den Reiter 'Dokumentation' klicken.
 * In der Liste registrierte Dokumentation den Eintrag "org.freecad.usermanual" auswählen und auf den klicken.
 * Den Einstellungen-Dialog mit schließen, aber nicht den Qt-Assistant beenden. Dies ist wichtig, da ansonsten eine neue Hilfedatei nicht registriert werden kann.
 * Erneut den Einstellungen-Dialog über das Menü öffnen.
 * Den Reiter 'Dokumentation' wählen und auf klicken.
 * In dem sich öffnenden Dateiauswahldialog zu der neuen Hilfedatei navigieren und auswählen.
 * Den Dateidialog durch Bestätigung der Auswahl schließen. Im Reiter 'Dokumentation' sollte sich jetzt wieder ein Eintrag "org.freecad.usermanual" befinden.
 * Die Einstellungen mit schließen.
 * Es sollte jetzt die neue Dokumentation in dem Qt-Assistant zur Verfügung stehen, so dass darauf aus FreeCAD zugegriffen werden kann.

A Note About Ubuntu
Difficulties may arise when trying to install the documentation packages on Ubuntu (for example, or ). If this is found to be the case, then executing the following steps will enable you to have offline documentation.
 * Download the and  help files from https://github.com/FreeCAD/FreeCAD/releases/download/0.18.1/FreeCAD.0_18.Offline.Doc.7z and extract them using 7zip.
 * Alternatively, you can instead get the development versions of the and  help files from GitHub. You will need to concatenate the .part files together:.
 * With administrative privileges (e.g., ), copy or move and  to . If you are using, this will instead be.