Installer la documentation sur des ordinateurs continuellement hors ligne

Depuis R2023a

Lorsque vous utilisez MATLAB®, vous accédez par défaut à la documentation du produit en ligne. Pour utiliser la documentation sur un ordinateur qui est continuellement hors ligne, vous pouvez la télécharger, la copier sur l’ordinateur hors ligne et l’installer sur ce dernier.

Si vous utilisez habituellement MATLAB tout en étant connecté à Internet et ne travaillez que rarement hors ligne, reportez-vous à la section Installer la documentation pour une utilisation hors ligne temporaire.

Prérequis

  • Dans cette procédure, vous allez télécharger une image ISO (Windows® et Linux®) ou DMG (macOS) de la documentation et vous allez la monter sur l’ordinateur hors ligne. Une connaissance des concepts informatiques est recommandée mais pas obligatoire.

  • L’ordinateur utilisé pour télécharger la documentation doit disposer d’une connexion Internet.

  • Pour télécharger la documentation, vous devez avoir un compte MathWorks®. L’installation de la documentation sur l’ordinateur hors ligne ne nécessite pas de compte MathWorks.

  • L’ordinateur utilisé pour télécharger la documentation et l’ordinateur hors ligne doivent tous deux disposer de plus de 10 Go d’espace disque pour stocker l’image ISO ou DMG de la documentation.

  • MATLAB doit déjà être installé sur l’ordinateur hors ligne.

Télécharger la documentation (nécessite une connexion Internet)

Pour télécharger la documentation pour R2025b, sélectionnez le système d’exploitation de l’ordinateur hors ligne cible dans la liste Operating Systems ci-dessous. Cliquez ensuite sur Download documentation.

Pour télécharger la documentation des versions antérieures à R2025b, consultez l’article d’aide Comment télécharger et installer la documentation sur des ordinateurs hors ligne ?

Copier la documentation sur l’ordinateur hors ligne

Copiez l’image ISO ou DMG de la documentation téléchargée sur l’ordinateur hors ligne en utilisant un support média amovible ou un emplacement réseau partagé. Sur l’ordinateur hors ligne, montez ensuite l’image ISO ou DMG de la documentation en suivant la procédure standard pour votre plateforme.

Pour en savoir plus, consultez l’article d’aide Comment installer les produits MathWorks à l’aide d'une image ISO ou DMG ?

Installer la documentation sur l’ordinateur hors ligne

Installez la documentation sur l’ordinateur hors ligne avec l’outil mpm exécutable en ligne de commande. mpm est inclus dans l’image ISO ou DMG de la documentation téléchargée.

Remarque

Exécutez les étapes qui suivent à partir de la ligne de commande de votre système d’exploitation. N’exécutez pas ces commandes à partir de MATLAB.

  1. À partir de la ligne de commande du système d’exploitation, accédez au dossier contenant le programme d’installation de la documentation dans l’image montée.

    cd <mountedDocImage>/bin/<arch>

    • <mountedDocImage> est le répertoire racine de l'image ISO ou DMG montée de la documentation.

    • <arch> est le dossier d'architecture du système d'exploitation de l'image ISO, tel que win64, glnxa64, maci64 ou maca64.

  2. Installez la documentation au moyen de la commande mpm install-doc. Spécifiez l’option --matlabroot pour le dossier d’installation de MATLAB sur l’ordinateur hors ligne. Par défaut, mpm installe la documentation dans le dossier racine du Support Package au sein de MATLAB, comme le détermine la fonction matlabshared.supportpkg.getSupportPackageRoot.

    Exemple pour Windows :

    .\mpm.exe install-doc --matlabroot="C:\Program Files\MATLAB\R2025b"

    Exemple pour Linux ou Mac :

    ./mpm install-doc --matlabroot=/home/<username>/matlab

    Pour installer la documentation dans un emplacement personnalisé, indiquez également le chemin complet de cet emplacement au moyen de l'option --destination. Utilisez cette option lorsque vous souhaitez :

    • Installer la documentation sur un lecteur réseau afin que tous les utilisateurs aient accès à la même version.

    • Installer la documentation dans un emplacement partagé sur des ordinateurs accessibles par plusieurs utilisateurs. Ce scénario s’applique uniquement aux plateformes Linux et Mac sur lesquelles la documentation est installée par défaut dans un dossier propre à l'utilisateur. Sous Windows, la documentation est installée par défaut dans un emplacement partagé.

    Exemple pour Windows :

    .\mpm.exe install-doc --matlabroot="C:\Program Files\MATLAB\R2025b" --destination="Z:\Shared\MATLAB Doc"

    Exemple pour Linux ou Mac :

    ./mpm install-doc --matlabroot=/home/<username>/matlab --destination=/usr/local/share/matlab-doc

  3. Démontez l’image ISO ou DMG de la documentation. Si vous devez récupérer l’espace disque, supprimez l’image.

Configurer MATLAB pour utiliser la documentation installée

Mettez à jour les paramètres de MATLAB pour que MATLAB ouvre la documentation installée au lieu de la documentation en ligne. Pour chaque installation de MATLAB amenée à utiliser la documentation :

  1. Ouvrez MATLAB et, à l’invite de commande, saisissez :

    s=settings, s.matlab.help.DocLocation.PersonalValue='INSTALLED';

  2. Si vous avez installé la documentation dans un emplacement personnalisé, mettez à jour la racine de la documentation afin qu’elle pointe MATLAB vers cet emplacement. <custom/doc/install/folder> correspond au chemin de la documentation que vous avez indiqué dans l'option --destination de mpm install-doc.

    docroot('<custom/doc/install/folder>/help')

  3. Vous avez la possibilité d’ajouter les commandes MATLAB précédentes à votre fichier startup.m ou matlabrc.m afin qu’elles s'exécutent à chaque démarrage de MATLAB. Pour plus de détails sur l‘utilisation des fichiers de démarrage de MATLAB, consultez la section Startup Options in MATLAB Startup File.

  4. Redémarrez MATLAB.

Vérifier l’installation locale

Vérifiez que la documentation s’ouvre en local. À l’invite de commande MATLAB, saisissez : doc

Sur la page du navigateur qui s’ouvre alors, vérifiez l’adresse de l’URL.

  • Si l’URL pointe vers une adresse IP et un port locaux (par exemple http://127.0.0.1:12345), cela signifie que MATLAB accède à la documentation installée en local.

  • Si l’URL pointe vers une adresse web (par exemple https://www.mathworks.com/help/...), cela signifie que MATLAB accède encore à la documentation en ligne. Mettez à jour MATLAB pour pointer vers la documentation installée en local comme le décrit la section Configurer MATLAB pour utiliser la documentation installée.

Mettre à jour la documentation sur l’ordinateur hors ligne

Pour mettre à jour la documentation installée après l’ajout ou la suppression de produits ou pour installer la documentation la plus récente, répétez les procédures précédentes.

Voir aussi

Rubriques