Instalando o arquivo de ajuda

From FreeCAD Documentation
Revision as of 17:29, 26 July 2021 by Dikluwe (talk | contribs) (Created page with "As traduções da comunidade são encorajadas, portanto, a documentação off-line agora também está disponível em francês e italiano. Outros idiomas podem estar em difere...")

FreeCAD arquivo de ajuda

A documentação offline do FreeCAD é construída a partir do wiki FreeCAD, utilizando scripts. Ele cresceu para um tamanho de arquivo superior a 180 MB. Estes grandes arquivos não fazem parte dos instaladores e executáveis do FreeCAD, mas podem ser instalados separadamente, conforme documentado aqui.

As traduções da comunidade são encorajadas, portanto, a documentação off-line agora também está disponível em francês e italiano. Outros idiomas podem estar em diferentes estágios de completude.

Download arquivo de ajuda

A working offline documentation consist of at least two files: freecad.qhc the Qt-helpfile-configuration and freecad.qch the compressed Qt-helpfile. They are put together in a ZIP-archive.

The helpfiles can be downloaded here: https://github.com/FreeCAD/FreeCAD/releases/download/0.18.1/FreeCAD.0_18.Offline.Doc.7z

As a future option they can be installed from within FreeCAD with the Addon Manager.

The help files do always have the same names: freecad.qhc and freecad.qch. In order to have different version of the helpfiles, these need to be installed in different directories. In case of a manual download, just store the zip-file locally and extract the archive into the wanted directory.

Registro da Documentação=

The documentation system of FreeCAD uses Qt Assistant. You should install this program first, if you don't have it.

The actual organization of the offline help allow only one helpfile to be active. It is therefore not possible to have helpfiles in different languages accessible from FreeCAD at the same time.

In order to make another FreeCAD documentation active the following steps have to be applied:

  • Click inside FreeCAD in the menu Help → Help. The program Qt-assistant should open.
  • In Qt-assistant click in the menu Edit → preferences.
  • In the preferences dialog click on the Documentation tab.
  • In the list registered documentation select org.freecad.usermanual and click on the button Remove.
  • Close the dialog with OK, but do not close the Qt-assistant. This is important as otherwise another helpfile will not be registered.
  • Open again the preferences dialog via the menu Edit → preferences.
  • Select the tab documentation and click the button Add...
  • In the dialog navigate to your new helpfile and select freecad.qch
  • close the dialog by confirming your selection. In the Documentation tab in the preferences there should now be a line with org.freecad.usermanual.
  • Close the Preferences with OK.
  • You should now have the new documentation available in the Qt-assistant, which is accessible from within FreeCAD.

A Note About Ubuntu

Difficulties may arise when trying to install the documentation packages on Ubuntu (for example, freecad-doc or freecad-daily-doc). If this is found to be the case, then executing the following steps will enable you to have offline documentation.

  • Download the freecad.qhc and freecad.qch 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 freecad.qhc and freecad.qch help files from GitHub. You will need to concatenate the .part files together: cat freecad.qch.part00 freecad.qch.part01 freecad.qch.part02 freecad.qch.part03 > freecad.qch.
  • With administrative privileges (e.g., sudo), copy or move freecad.qhc and freecad.qch to /usr/share/doc/freecad-doc/. If you are using freecad-daily, this will instead be /usr/share/doc/freecad-daily-doc/.