Installer ========= GdArt demande seulement **Python 3** (version 3.8 ou plus récente) et un module, **PyYAML**, qui s'installe tout seul au premier lancement. Récupérer GdArt --------------- Deux possibilités : - **avec git** (conseillé : les mises à jour se font en une commande) : .. code-block:: bash git clone https://codeberg.org/hdd-robot/gdart.git - **en téléchargeant l'archive zip** (https://codeberg.org/hdd-robot/gdart/archive/main.zip), puis en la décompressant où vous voulez. Le dossier obtenu contient le programme (``src/``) et des **lanceurs**. Vos données ne seront pas rangées dedans, mais dans un dossier ``GdArt`` de votre dossier personnel (voir :doc:`projets`) : vous pourrez donc mettre l'outil à jour sans risque pour elles. Installer Python et lancer GdArt -------------------------------- .. tab-set:: :sync-group: os .. tab-item:: Linux :sync: linux Python est déjà installé. Ajoutez le module PyYAML : .. code-block:: bash sudo apt install python3-yaml Puis, depuis le dossier de GdArt : .. code-block:: bash ./lancer_linux.sh .. tab-item:: Mac :sync: mac #. Installez Python depuis https://www.python.org/downloads/ ; #. dans le dossier *Applications/Python 3.x*, double-cliquez sur **Install Certificates.command** (sans cela, les connexions aux bases échouent avec le message « certificats SSL absents ») ; #. double-cliquez sur ``lancer_mac.command``. La première fois, macOS peut refuser d'ouvrir un fichier téléchargé : faites un **clic droit**, puis **Ouvrir**. .. tab-item:: Windows :sync: windows #. Installez Python depuis https://www.python.org/downloads/, en cochant **« Add Python to PATH »** pendant l'installation ; #. double-cliquez sur ``lancer_windows.bat``. .. Capture d'écran à insérer : la fenêtre du terminal ouverte par le lanceur au premier lancement. Déposez _static/installation/premier-lancement.png puis décommentez le bloc ci-dessous (retirez le préfixe « .. ») : .. .. image:: _static/installation/premier-lancement.png .. :align: center .. :width: 90% Si PyYAML ne s'installe pas tout seul, installez-le à la main : .. tab-set:: :sync-group: os .. tab-item:: Linux :sync: linux .. code-block:: bash sudo apt install python3-yaml .. tab-item:: Mac :sync: mac .. code-block:: bash python3 -m pip install pyyaml .. tab-item:: Windows :sync: windows .. code-block:: bat py -m pip install pyyaml Mettre GdArt à jour ------------------- - **avec git** : dans le dossier de GdArt, ``git pull`` ; - **avec un zip** : téléchargez la nouvelle archive et décompressez-la à la place de l'ancienne (ou à côté). Vos projets ne sont pas touchés. Si vous venez d'une ancienne version de GdArt, qui rangeait les données dans le dossier de l'outil, voir :doc:`mise_a_jour`.