Instalando o arquivo de ajuda

From FreeCAD Documentation
Revision as of 17:34, 26 July 2021 by Dikluwe (talk | contribs) (Created page with "A fim de tornar ativa outra documentação do FreeCAD, os seguintes passos devem ser aplicados:")

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

Uma documentação off-line de trabalho consiste de pelo menos dois arquivos: freecad.qhc o Qt-helpfile-configuration e freecad.qch o Qt-helpfile comprimido. Eles são colocados juntos em um arquivo ZIP.

Os arquivos de ajuda podem ser baixados aqui: https://github.com/FreeCAD/FreeCAD/releases/download/0.18.1/FreeCAD.0_18.Offline.Doc.7z

Como opção futura, eles podem ser instalados de dentro do FreeCAD com o Gerenciador de Extensões.

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=

O sistema de documentação do FreeCAD utiliza o Qt Assistant. Você deve instalar este programa primeiro, se você não o tiver.

A organização real da ajuda offline permite que apenas um arquivo de ajuda esteja ativo. Não é possível, portanto, ter arquivos de ajuda em diferentes idiomas acessíveis a partir do FreeCAD ao mesmo tempo.

A fim de tornar ativa outra documentação do FreeCAD, os seguintes passos devem ser aplicados:

  • 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/.