Installazione del file della Guida

From FreeCAD Documentation
Jump to navigation Jump to search
This page is a translated version of the page Installing Helpfile and the translation is 65% complete.
Outdated translations are marked like this.
Other languages:
Deutsch • ‎English • ‎español • ‎français • ‎italiano • ‎polski • ‎português do Brasil • ‎русский

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.

File della Guida di FreeCAD

La documentazione offline di FreeCAD è costruita dal wiki di FreeCAD usando gli script. Il file è cresciuto fino a superare i 100 MB. Questi file di grandi dimensioni non fanno parte dei programmi di installazione e degli eseguibili di FreeCAD, ma possono essere installati separatamente come documentato qui.

Le traduzioni della community sono incoraggiate, quindi la documentazione offline è ora disponibile anche in francese e italiano. Altre lingue possono trovarsi in diverse fasi di avanzamento.

Scaricare i file di aiuto

Una documentazione offline funzionante è costituita da almeno due file: freecad.qhc la configurazione Qt del file di aiuto e freecad.qch il file di aiuto Qt compresso. Sono uniti in un archivio ZIP.

In futuro potranno essere installati da FreeCAD con Addon Manager.

I file della guida hanno sempre gli stessi nomi: freecad.qhc e freecad.qch. Per avere una versione diversa dei file della guida, è necessario installarli in directory diverse. In caso di download manuale, è sufficiente archiviare il file zip localmente ed estrarre l'archivio nella directory desiderata.

Registrare la documentazione

Il sistema di documentazione di FreeCAD utilizza Qt Assistant. Nel caso in cui il proprio sistema operativo non abbia Qt Assistant, bisogna installarlo prima.

L'organizzazione attuale della guida offline consente di attivare solo un file della guida. Non è quindi possibile avere file di aiuto in diverse lingue accessibili contemporaneamente da FreeCAD.

Per rendere attiva un'altra documentazione di FreeCAD, è necessario applicare i seguenti passaggi:

  • In FreeCAD fare clic nel menu Aiuto → Aiuto. Dovrebbe aprirsi il programma Qt Assistant.
  • In Qt-assistant cliccare sul menu Modifica → Preferenze.
  • Nella finestra di dialogo delle preferenze fare clic sulla scheda Documentazione.
  • Nell'elenco della documentazione registrata selezionare org.freecad.usermanual e fare clic sul pulsante Rimuovi.
  • Chiudere la finestra di dialogo con OK, ma non chiudere Qt-assistant. Questo è importante, altrimenti non verrà registrato un altro file di aiuto.
  • Aprire nuovamente la finestra di dialogo delle preferenze tramite il menu Modifica → Preferenze.
  • Selezionare la scheda della documentazione e fai clic sul pulsante Aggiungi....
  • Nella finestra di dialogo, cercare il nuovo file della guida freecad.qch e selezionarlo.
  • Chiudere la finestra di dialogo confermando la selezione. Ora la scheda Documentazione nelle preferenze dovrebbe avere di nuovo una riga con org.freecad.usermanual.
  • Chiudere le Preferenze con OK.
  • Ora si dovrebbe avere la nuova documentazione disponibile nell'assistente Qt, accessibile da 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.19.2/FreeCAD.0_19.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/.