Installazione della documentazione su computer permanentemente offline

Da R2023a

Per impostazione predefinita, quando si utilizza MATLAB^®, si accede alla documentazione del prodotto sul web. Per utilizzare la documentazione su un computer permanentemente offline, è possibile scaricare la documentazione, copiarla sulla macchina offline e installarla su tale computer.

Se abitualmente si lavora con MATLAB mentre si è connessi a Internet e si lavora offline solo occasionalmente, vedere Installazione della documentazione per utilizzo offline.

Prerequisiti

Questa procedura prevede il download di un'immagine ISO (Windows^® e Linux^®) o DMG (macOS) della documentazione e il suo montaggio sulla macchina offline. La conoscenza di concetti informatici è consigliata, ma non necessaria.
Il computer che si utilizza per scaricare la documentazione deve disporre di una connessione a Internet.
Per scaricare la documentazione, è necessario disporre di un MathWorks^® Account. L'installazione della documentazione sul computer offline non richiede un MathWorks Account.
Sia il computer che si utilizza per scaricare la documentazione sia il computer offline devono avere più di 10 GB di spazio disponibile su disco, atto a contenere le dimensioni dell'immagine ISO o DMG della documentazione.
MATLAB deve essere già installato sul computer offline.

Download della documentazione (richiede una connessione a Internet)

Per scaricare la documentazione per la release R2024a, nell'elenco Operating Systems mostrato qui, selezionare il sistema operativo per la macchina offline di destinazione. Quindi, fare clic su Download documentation.

Accedi per scaricare la documentazione

Per scaricare la documentazione relativa ad altre release, seguire questi passaggi:

Da MathWorks Downloads, nell'elenco Select Release, selezionare la release che si desidera scaricare.
Dall'elenco I Want To, selezionare Get ISOs and DMGs.
Espandere Get MATLAB and Simulink Product Documentation.
Fare clic sul link Learn more per aprire le istruzioni per il download e l'installazione della documentazione per la release selezionata. Seguire le istruzioni riportate in quella pagina invece che in questa.

Copia della documentazione su una macchina offline

Copiare l'immagine ISO o DMG della documentazione scaricata sulla macchina offline utilizzando un supporto rimovibile o una posizione di rete condivisa. Quindi, sulla macchina offline, montare l'immagine ISO o DMG della documentazione utilizzando la procedura standard per la propria piattaforma. Per ulteriori dettagli, vedere How do I install MathWorks products using an ISO or DMG image? (Come installare i prodotti MathWorks utilizzando un’immagine ISO o DMG?

Installazione della documentazione su una macchina offline

Installare la documentazione sulla macchina offline utilizzando lo strumento della riga di comando mpm. mpm è incluso come parte dell'immagine ISO o DMG della documentazione scaricata.

Nota

Eseguire questi passaggi dalla riga di comando del proprio sistema operativo. Non eseguire questi comandi da MATLAB.

Dalla riga di comando del sistema operativo, spostarsi nella cartella dell'immagine montata che contiene il programma di installazione della documentazione.
```
cd mountedDocImage/bin/arch
```
- mountedDocImage è la radice dell'immagine ISO o DMG della documentazione montata.
- arch è la cartella dell'architettura del sistema operativo dell’immagine ISO o DMG, come win64, glnxa64, maci64 o maca64.
Eseguire il programma di installazione della documentazione utilizzando il comando mpm install-doc. Specificare l'opzione --matlabroot per impostare la cartella in cui MATLAB è installato sulla macchina offline.
Windows
Sintassi:
```
.\mpm install-doc --matlabroot=matlabroot
```
Esempio:
```
.\mpm install-doc --matlabroot="C:\Program Files\MATLAB\R2024a"
```
Se il percorso matlabrootfolder include degli spazi, racchiudere il percorso tra doppie virgolette, come mostrato nell'esempio.
Linux o macOS
Sintassi:
```
./mpm install-doc --matlabroot=matlabrootfolder
```
Esempio:
```
./mpm install-doc --matlabroot=/home/username/matlab
```
Per impostazione predefinita, mpm installare la documentazione nella cartella radice del pacchetto di assistenza all'interno di MATLAB. Per individuare la cartella root del pacchetto di assistenza, utilizzare la funzione matlabshared.supportpkg.getSupportPackageRoot.
Per specificare una posizione diversa per la documentazione, utilizzare l'opzione --destination. Se si monta l'immagine ISO o DMG della documentazione in una posizione diversa da quella in cui è installato MATLAB, ad esempio un drive di rete, utilizzare l'opzione --source per fornire il percorso completo per i file del programma di installazione.
Windows
```
.\mpm install-doc --matlabroot=matlabrootfolder --source=docinstallfolder --destination=destinationfolder
```
Linux o macOS
```
./mpm install-doc --matlabroot=matlabrootfolder --source=docinstallfolder --destination=destinationfolder
```
Nota
Se durante l'installazione viene visualizzato l'errore Conflicting release versions, verificare che l'immagine ISO o DMG della documentazione sia per la stessa release del software MATLAB installato sulla macchina offline. Il nome della release è incluso nel nome del file dell'immagine ISO o DMG.
Smontare l'immagine ISO o DMG della documentazione. Se occorre recuperare lo spazio su disco, cancellare l'immagine.

Configurazione di MATLAB per l'utilizzo della documentazione installata

Aggiornare le preferenze di MATLAB in modo che MATLAB apra la documentazione installata anziché la documentazione web.

Aprire MATLAB.
Nella scheda Home, sezione Environment, fare clic su Preferences.
Nel riquadro sinistro della finestra di dialogo Preferences (Preferenze), fare clic su MATLAB, quindi fare clic su Help.
Alla voce Documentation Location, selezionare Installed locally.
Questo passaggio è necessario solo se la documentazione è stata installata in una posizione diversa da quella predefinita utilizzando il flag --destination.
Aggiornare la radice della documentazione in modo che MATLAB punti alla posizione in cui è stata installata la documentazione.
1. Aprire il file MATLAB startup.m. Se questo file non esiste, crearne uno vuoto con questo nome. I comandi specificati in questo file vengono eseguiti all'avvio di MATLAB. Per ulteriori dettagli sui file startup.m, vedere Startup Options in MATLAB Startup File.
2. Nel file startup.m, aggiungere questa riga per impostare la radice della documentazione sulla nuova posizione. newDocInstallFolder è il percorso della cartella in cui è stata installata la documentazione.
  docroot('newDocInstallFolder/help')
3. Riavviare MATLAB.

Verifica dell'installazione locale

Verificare che la documentazione si apra localmente. Al prompt dei comandi di MATLAB, inserire: doc

Se si apre la pagina iniziale della documentazione, posizionare il cursore su uno dei link di tale pagina e controllare il formato dell'URL che appare nell'angolo in basso a sinistra. Se l'URL è un percorso di file locale (ad esempio, file:///C:/ProgramData/MATLAB/...), allora MATLAB sta aprendo la documentazione locale.
Se si apre una pagina vuota o se gli URL della pagina iniziale della documentazione mostrano percorsi web (ad esempio, https://www.mathworks.com/help/...), allora MATLAB sta ancora aprendo la documentazione web. Aggiornare MATLAB per puntare alla documentazione installata localmente, come descritto in Configurazione di MATLAB per l'utilizzo della documentazione installata.

Aggiornamento della documentazione su una macchina offline

Ripetere le procedure precedenti per aggiornare la documentazione installata dopo l'aggiunta o la rimozione di prodotti, o per installare la documentazione più recente.