Installing Helpfile/pt-br: Difference between revisions

From FreeCAD Documentation
(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...")
(Updating to match new version of source page)
 
(10 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{TOCright}}

==Help module==

'''Note:''' The FreeCAD offline help files, described below, are being retired. The help system of FreeCAD is now managed by the [https://github.com/yorikvanhavre/FreeCAD-Help Help Addon], which you can install via the [[Std_AddonMgr|Addon manager]]. The Help Addon is able to access online documentation, without the need to download anything, or an offline, downloadable copy of the documentation, which can also be installed via the Addon manager.


==FreeCAD arquivo de ajuda==
==FreeCAD arquivo de ajuda==


<div class="mw-translate-fuzzy">
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.
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.
</div>


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.
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.
Line 11: Line 18:
Uma documentação off-line de trabalho consiste de pelo menos dois arquivos: {{FileName|freecad.qhc}} o Qt-helpfile-configuration e {{FileName|freecad.qch}} o Qt-helpfile comprimido. Eles são colocados juntos em um arquivo ZIP.
Uma documentação off-line de trabalho consiste de pelo menos dois arquivos: {{FileName|freecad.qhc}} o Qt-helpfile-configuration e {{FileName|freecad.qch}} o Qt-helpfile comprimido. Eles são colocados juntos em um arquivo ZIP.


<div class="mw-translate-fuzzy">
Os arquivos de ajuda podem ser baixados aqui: https://github.com/FreeCAD/FreeCAD/releases/download/0.18.1/FreeCAD.0_18.Offline.Doc.7z
Os arquivos de ajuda podem ser baixados aqui: https://github.com/FreeCAD/FreeCAD/releases/download/0.18.1/FreeCAD.0_18.Offline.Doc.7z
</div>


<div class="mw-translate-fuzzy">
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 [[Std_AddonMgr/pt-br|Gerenciador de Extensões]].
</div>


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


O sistema de documentação do FreeCAD utiliza o Qt Assistant. Você deve instalar este programa primeiro, se você não o tiver.
O sistema de documentação do FreeCAD utiliza o Qt Assistant. Você deve instalar este programa primeiro, se você não o tiver.
Line 25: Line 36:
A fim de tornar ativa outra documentação do FreeCAD, os seguintes passos devem ser aplicados:
A fim de tornar ativa outra documentação do FreeCAD, os seguintes passos devem ser aplicados:


* Click inside FreeCAD in the menu {{MenuCommand|Help Help}}. The program Qt-assistant should open.
* Clique dentro do FreeCAD no menu {{MenuCommand|AjudaAjuda}}. O programa Qt-assistant deve abrir.
* In Qt-assistant click in the menu {{MenuCommand|Editpreferences}}.
* Em Qt-assistant clique no menu {{MenuCommand|Editarpreferências}}.
* In the preferences dialog click on the {{MenuCommand|Documentation}} tab.
* Na janela Preferências Geral clique na aba {{MenuCommand|Documento}}.
* In the list registered documentation select {{incode|org.freecad.usermanual}} and click on the button {{Button|Remove}}.
* Na lista de documentação registrada selecione {{incode|org.freecad.usermanual}} e clique no botão {{Button|Remover}}.
* Close the dialog with {{Button|OK}}, but do not close the Qt-assistant. This is important as otherwise another helpfile will not be registered.
* Feche o diálogo com {{Button|OK}}, mas não feche o Qt-assistant. Isto é importante, pois caso contrário, outro arquivo de ajuda não será registrado.
* Open again the preferences dialog via the menu {{MenuCommand|Editpreferences}}.
* Abra novamente o diálogo de preferências através do menu {{MenuCommand|Editarpreferências}}.
* Select the tab documentation and click the button {{Button|Add...}}
* Selecione a documentação da aba e clique no botão {{Button|Add...}}
* No diálogo, navegue até seu novo arquivo de ajuda e selecione {{FileName|freecad.qch}} feche o diálogo, confirmando sua seleção. Na aba {{MenuCommand|Documento}} nas preferências deve haver agora uma linha com {{incode|org.freecad.usermanual}}.
* In the dialog navigate to your new helpfile and select {{FileName|freecad.qch}}
* Feche a aba {{MenuCommand|Preferências}} com {{Button|OK}}.
* close the dialog by confirming your selection. In the {{MenuCommand|Documentation}} tab in the preferences there should now be a line with {{incode|org.freecad.usermanual}}.
* Agora você deve ter a nova documentação disponível no Qt-assistant, acessível de dentro do FreeCAD.
* Close the {{MenuCommand|Preferences}} with {{Button|OK}}.
* You should now have the new documentation available in the Qt-assistant, which is accessible from within FreeCAD.


<div class="mw-translate-fuzzy">
==A Note About Ubuntu==
==Uma nota sobre o Ubuntu==
Difficulties may arise when trying to install the documentation packages on Ubuntu (for example, {{incode|freecad-doc}} or {{incode|freecad-daily-doc}}). If this is found to be the case, then executing the following steps will enable you to have offline documentation.
Podem surgir dificuldades ao tentar instalar os pacotes de documentação no Ubuntu (por exemplo, {{incode|freecad-doc}} ou {{incode|freecad-daily-doc}}). Se este for o caso, então a execução dos seguintes passos permitirá que você tenha a documentação offline.
* Download the {{FileName|freecad.qhc}} and {{FileName|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 {{FileName|freecad.qhc}} and {{FileName|freecad.qch}} help files from [https://github.com/FreeCAD/FreeCAD/tree/master/src/Doc GitHub]. You will need to [http://man7.org/linux/man-pages/man1/cat.1.html concatenate] the .part files together: {{incode|cat freecad.qch.part00 freecad.qch.part01 freecad.qch.part02 freecad.qch.part03 > freecad.qch}}.
* Baixe os arquivos de ajuda {{FileName|freecad.qhc}} e {{FileName|freecad.qch}} em https://github.com/FreeCAD/FreeCAD/releases/download/0.18.1/FreeCAD.0_18.Offline.Doc.7z e extraia-os usando o 7zip.
* With administrative privileges (e.g., {{incode|sudo}}), copy or move {{FileName|freecad.qhc}} and {{FileName|freecad.qch}} to {{FileName|/usr/share/doc/freecad-doc/}}. If you are using {{incode|freecad-daily}}, this will instead be {{FileName|/usr/share/doc/freecad-daily-doc/}}.
* Alternativamente, você pode obter as versões de desenvolvimento dos arquivos de ajuda {{FileName|freecad.qhc}} e {{FileName|freecad.qch}} de [https://github.com/FreeCAD/FreeCAD/tree/master/src/Doc GitHub]. Você precisará [http://man7.org/linux/man-pages/man1/cat.1.html concatenar] os arquivos .part juntos: {{incode|cat freecad.qch.part00 freecad.qch.part01 freecad.qch.part02 freecad.qch.part03 > freecad.qch}}.
* Com privilégios administrativos (por exemplo, {{incode|sudo}}), copiar ou mover {{FileName|freecad.qhc}} e {{FileName|freecad.qch}} para {{FileName|/usr/share/doc/freecad-doc/}}. Se você estiver usando {{incode|freecad-daily}}, isto será {{FileName|/usr/share/doc/freecad-daily-doc/}}.
</div>





Latest revision as of 20:50, 11 June 2022

Help module

Note: The FreeCAD offline help files, described below, are being retired. The help system of FreeCAD is now managed by the Help Addon, which you can install via the Addon manager. The Help Addon is able to access online documentation, without the need to download anything, or an offline, downloadable copy of the documentation, which can also be installed via the Addon manager.

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.

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:

  • Clique dentro do FreeCAD no menu Ajuda → Ajuda. O programa Qt-assistant deve abrir.
  • Em Qt-assistant clique no menu Editar → preferências.
  • Na janela Preferências Geral clique na aba Documento.
  • Na lista de documentação registrada selecione org.freecad.usermanual e clique no botão Remover.
  • Feche o diálogo com OK, mas não feche o Qt-assistant. Isto é importante, pois caso contrário, outro arquivo de ajuda não será registrado.
  • Abra novamente o diálogo de preferências através do menu Editar → preferências.
  • Selecione a documentação da aba e clique no botão Add...
  • No diálogo, navegue até seu novo arquivo de ajuda e selecione freecad.qch feche o diálogo, confirmando sua seleção. Na aba Documento nas preferências deve haver agora uma linha com org.freecad.usermanual.
  • Feche a aba Preferências com OK.
  • Agora você deve ter a nova documentação disponível no Qt-assistant, acessível de dentro do FreeCAD.

Uma nota sobre o Ubuntu

Podem surgir dificuldades ao tentar instalar os pacotes de documentação no Ubuntu (por exemplo, freecad-doc ou freecad-daily-doc). Se este for o caso, então a execução dos seguintes passos permitirá que você tenha a documentação offline.

  • Baixe os arquivos de ajuda freecad.qhc e freecad.qch em https://github.com/FreeCAD/FreeCAD/releases/download/0.18.1/FreeCAD.0_18.Offline.Doc.7z e extraia-os usando o 7zip.
  • Alternativamente, você pode obter as versões de desenvolvimento dos arquivos de ajuda freecad.qhc e freecad.qch de GitHub. Você precisará concatenar os arquivos .part juntos: cat freecad.qch.part00 freecad.qch.part01 freecad.qch.part02 freecad.qch.part03 > freecad.qch.
  • Com privilégios administrativos (por exemplo, sudo), copiar ou mover freecad.qhc e freecad.qch para /usr/share/doc/freecad-doc/. Se você estiver usando freecad-daily, isto será /usr/share/doc/freecad-daily-doc/.