From 6357886af8ab9fad7feab6a84dfd0fbd21e759a2 Mon Sep 17 00:00:00 2001 From: Alexis GUYOT Date: Thu, 25 Jan 2024 15:02:18 +0100 Subject: [PATCH] Actualiser docs/Services/pole-scientifique/Onyxia/docs/version.md --- .../pole-scientifique/Onyxia/docs/version.md | 28 +++++++++---------- 1 file changed, 13 insertions(+), 15 deletions(-) diff --git a/docs/Services/pole-scientifique/Onyxia/docs/version.md b/docs/Services/pole-scientifique/Onyxia/docs/version.md index 08fa930..32b9ca2 100644 --- a/docs/Services/pole-scientifique/Onyxia/docs/version.md +++ b/docs/Services/pole-scientifique/Onyxia/docs/version.md @@ -16,9 +16,9 @@ que dans le cadre de projets collaboratifs : * l'utilisateur peut partager ses modifications tout en bénéficiant de celles des autres ; * il devient possible de contribuer à des projets open-source, pour lesquels l'usage de Git est très largement standard. -::: {.callout-warning} -Ce tutoriel vise à présenter comment le contrôle de version peut être facilement implémenté grâce aux outils présents sur le Datalab. Il ne présente pas le fonctionnement de Git et présuppose donc une certaine familiarité avec l'outil. De nombreuses ressources en ligne peuvent servir d'introduction ; l'utilisateur de R pourra par exemple consulter ce guide. Une formation complète à Git sera bientôt proposée dans l'espace formation du Datalab qui sera bientôt ajouter sur notre Datalab Onyxia. -::: +!!! warning + Ce tutoriel vise à présenter comment le contrôle de version peut être facilement implémenté grâce aux outils présents sur le Datalab. Il ne présente pas le fonctionnement de Git et présuppose donc une certaine familiarité avec l'outil. De nombreuses ressources en ligne peuvent servir d'introduction ; l'utilisateur de R pourra par exemple consulter ce guide. Une formation complète à Git sera bientôt proposée dans l'espace formation du Datalab qui sera bientôt ajouter sur notre Datalab Onyxia. + @@ -34,13 +34,13 @@ Bien qu'une utilisation hors-ligne de Git soit possible, tout l'intérêt du con -::: {.callout-warning} -La suite du tutoriel nécessite de disposer d'un compte GitHub. -::: +!!! warning + La suite du tutoriel nécessite de disposer d'un compte GitHub. + + +!!! note + Si l'utilisation du Datalab avec la plateforme GitHub est facilitée, elle n'est en aucun cas obligatoire : il reste tout à fait possible d'utiliser la forge logicielle de son choix pour la synchronisation des projets. Une [forge basée sur GitLab ](https://git.lab.sspcloud.fr)est notamment mise à disposition des utilisateurs du Datalab. -::: {.callout-note} -Si l'utilisation du Datalab avec la plateforme GitHub est facilitée, elle n'est en aucun cas obligatoire : il reste tout à fait possible d'utiliser la forge logicielle de son choix pour la synchronisation des projets. Une [forge basée sur GitLab ](https://git.lab.sspcloud.fr)est notamment mise à disposition des utilisateurs du Datalab. -::: ### Créer un jeton d'accès (_token_) @@ -61,9 +61,8 @@ Il est recommandé d'ajouter ses jetons d'accès à un gestionnaire de mots de p ![Ajouter un jeton d'accès GitHub à un compte utilisateur sur le Datalab](/img/onyxia-git-token.png) -::: {.callout-warning} -Attention à bien utiliser dans les "Informations du compte" l'adresse mail associée à votre compte GitHub, c'est elle qui permet de lier effectivement les _commits_ que vous effectuerez à votre compte GitHub. -::: +!!! warning + Attention à bien utiliser dans les "Informations du compte" l'adresse mail associée à votre compte GitHub, c'est elle qui permet de lier effectivement les _commits_ que vous effectuerez à votre compte GitHub. ## Utiliser Git avec les services du Datalab @@ -91,6 +90,5 @@ Les principaux services de production de code disponibles sur le Datalab dispose * Jupyter : le plugin jupyterlab-git permet un interfaçage (assez sommaire) de Jupyter avec Git ; * VSCode : VSCode propose nativement une interface graphique très bien intégrée avec Git et GitHub. Une documentation détaillée(en Anglais) présente les possibilités de l'outil. -::: {.callout-warning} -Les interfaces graphiques facilitent la prise en main de Git, mais ne remplacent jamais complètement l'usage de l'outil via un terminal du fait d'une intégration nécessairement imparfaite. Il est donc utile de se familiariser avec l'usage de Git via le terminal le plus tôt possible. -::: \ No newline at end of file +!!! warning + Les interfaces graphiques facilitent la prise en main de Git, mais ne remplacent jamais complètement l'usage de l'outil via un terminal du fait d'une intégration nécessairement imparfaite. Il est donc utile de se familiariser avec l'usage de Git via le terminal le plus tôt possible. \ No newline at end of file