Installing Helpfile/pt-br: Difference between revisions

From FreeCAD Documentation
(Created page with "A fim de tornar ativa outra documentação do FreeCAD, os seguintes passos devem ser aplicados:")
(Created page with "Os arquivos de ajuda têm sempre os mesmos nomes: {{FileName|freecad.qhc}} e {{FileName|freecad.qch}}. Para ter versões diferentes dos arquivos de ajuda, estes precisam ser i...")
Line 15: Line 15:
Como opção futura, eles podem ser instalados de dentro do FreeCAD com o [[Addon Manager/pt-br|Gerenciador de Extensões]].
Como opção futura, eles podem ser instalados de dentro do FreeCAD com o [[Addon Manager/pt-br|Gerenciador de Extensões]].


The help files do always have the same names: {{FileName|freecad.qhc}} and {{FileName|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.
Os arquivos de ajuda têm sempre os mesmos nomes: {{FileName|freecad.qhc}} e {{FileName|freecad.qch}}. Para ter versões diferentes dos arquivos de ajuda, estes precisam ser instalados em diretórios diferentes. No caso de um download manual, basta armazenar o arquivo zip localmente e extrair o arquivo para o diretório desejado.


==Registro da Documentação===
==Registro da Documentação===

Revision as of 17:34, 26 July 2021

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.

Os arquivos de ajuda têm sempre os mesmos nomes: freecad.qhc e freecad.qch. Para ter versões diferentes dos arquivos de ajuda, estes precisam ser instalados em diretórios diferentes. No caso de um download manual, basta armazenar o arquivo zip localmente e extrair o arquivo para o diretório desejado.

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