Guide d'utilisation Annuler

Collaboration à l’aide de Git

Rechercher

Dernière mise à jour le 25 avr. 2024

Robohelp

Ouvrir l’application

Découvrez comment collaborer depuis RoboHelp à l’aide de Git.

Prérequis pour la connexion à Git

Téléchargez et installez Git sur votre système. Cliquez ici pour télécharger Git pour Windows. Pour plus d’informations, reportez-vous à l’aide de Git.
Ajustez votre variable d’environnement CHEMIN pour pouvoir utiliser Git ainsi que les outils UNIX facultatifs à partir de l’invite de commande Windows. Pour cela, sélectionnez cette option dans le programme d’installation de Git :

Votre variable d’environnement CHEMIN doit contenir cette valeur :

C:\Program Files\Git\usr\bin

Remarque :

À partir de la version 1803 de Windows 10, Microsoft a ajouté la prise en charge native de SSH, qui est connue pour provoquer des conflits avec les connexions Git. Si votre version de Windows est ultérieure à 1803, assurez-vous que le chemin vers les fichiers binaires SSH dans l’installation Git (C:\Program Files\Git\usr\bin) a la priorité sur le chemin vers les fichiers binaires SSH fournis par Microsoft (%SystemRoot%\system32). Vous pouvez accéder à la variable d’environnement CHEMIN du système grâce à la boîte de dialogue Propriétés système > ongletAvancé > Variables d’environnement.
Pour vous connecter à Git à partir de macOS, vous devez installer « git-credential-manager » pour les URL de référentiel http/https. Pour plus d’informations, consultez Gestionnaire d’informations d’identification Git.
Enregistrez votre application de diffusion/fusion externe dans RoboHelp. Pour effectuer cette action :
1. Choisissez Édition > Préférences.
2. Dans la boîte de dialogue Paramètres d’application, cliquez sur l’onglet Contrôle de version.
3. Dans le champ Application de diffusion/fusion externe, cliquez sur pour sélectionner votre application de diffusion/fusion externe, comme par exemple p4merge.
  
  Vérifiez que Git prend en charge votre application en exécutant la commande suivante dans l’invite de commande :
  
  git mergetool --tool-help
4. Cliquez sur Terminé.

Création d’un profil de connexion Git

Créez un profil de connexion Git pour connecter RoboHelp avec Git.

Votre serveur Git doit contenir un référentiel auquel vous pouvez vous connecter à partir de RoboHelp. Pour créer un référentiel, suivez les instructions de GitHub, Bitbucket ou celles de votre fournisseur d’hébergement Git.

Remarque :

Si vous souhaitez utiliser le profil de connexion pour télécharger le projet RoboHelp actuellement ouvert sur votre serveur Git, l’URL du nouveau référentiel doit être vide. Lors de la création du référentiel, veillez à ne pas l’initialiser avec un fichier Lisez-Moi.
Dans RoboHelp, sélectionnez Collaboration > Nouvelle connexion.
Dans la boîte de dialogue Profils de connexion, indiquez un nom pour votre profil de connexion.
Dans la liste déroulante Contrôle de version, sélectionnez Git.
Dans le champ URL du référentiel, spécifiez l'URL SSH ou HTTPS du référentiel distant.

L'URL SSH peut être spécifiée dans l'un des formats suivants :
- git@<nomduserveur>:<nomOrg/nomRéférentiel>.git
- ssh://git@<nomduserveur>/<nomOrg/nomRéférentiel>.git
Par exemple, git@github.com:adobe/brackets.git ou ssh://git@github.com/adobe/brackets.git.

L'URL HTTPS est spécifiée sous la forme :

https://<nomduserveur>/<nomOrg>/<nomRéférentiel>.git

Par exemple, https://git@github.com/adobe/brackets.git
Si vous avez fourni une URL https, la liste déroulante des fournisseurs de serveur Git s’affiche. Sélectionnez le fournisseur de serveur applicable pour l’authentification dans la liste déroulante. L’authentification multifacteur est disponible pour les fournisseurs spécifiés dans la liste. L’option Autre implique la prise en charge de l’authentification par mot de passe de base uniquement.

Sélectionner un fournisseur de serveur Git

Remarque :

Si vous avez spécifié une URL HTTPS, RoboHelp vous invite à entrer les informations d’identification lors de la première connexion au serveur. L’invite est spécifique au fournisseur de serveur Git configuré dans le profil de connexion ou à une invite de mot de passe générique si l’autre option est sélectionnée.

Les informations d’identification sont enregistrées dans le Gestionnaire d’informations d’identification/trousseau système pour une utilisation ultérieure.

L’enregistrement contient la chaîne suivante :

https://<nomduserveur>

Si vous avez récemment modifié les informations d'identification, supprimez ou mettez à jour l’enregistrement correspondant dans le Gestionnaire d’informations d’identification pour éviter les invites d’erreur d'authentification. Si RoboHelp ne trouve pas d’enregistrement correspondant dans le Gestionnaire d’informations d’identification, il demande à nouveau les informations d'identification. Pour plus d’ informations sur le Gestionnaire d’informations d’identification du système (Windows), consultez l’aide de Microsoft.

Saisir les informations d’identification pour le fournisseur
Dans le champ ID utilisateur, indiquez le nom du compte d’utilisateur qui dispose d’un accès en lecture/écriture au référentiel Git spécifié.
Dans le champ Branche, indiquez le nom de la branche sur le serveur. Le nom de branche par défaut est maître.
Si vous avez spécifié une URL SSH à l'étape 5, le champ de la clé privée SSH est visible. Dans le champ Clé privée SSH, indiquez ou accédez au chemin de la clé privée SSH que vous utilisez pour vous connecter au référentiel sur votre serveur Git. Pour créer une nouvelle connexion SSH à votre serveur Git, voir l’article Configuration d’une connexion SSH.

Remarque :

Si la clé SSH spécifiée contient une phrase secrète, RoboHelp vous invite à la saisir et l’enregistre dans le Gestionnaire d’informations d’identification pour une utilisation ultérieure. L’enregistrement est stocké au format :
git@<nomduserveur>:<nomOrg/nomRéférentiel>/<utilisateur>
Si vous utilisez une nouvelle clé SSH pour la connexion au même référentiel, mais avec une phrase secrète différente, supprimez ou mettez à jour l’enregistrement correspondant dans le Gestionnaire d’informations d’identification du système. Si RoboHelp ne trouve pas d’enregistrement correspondant dans le Gestionnaire d’informations d’identification, il demande à nouveau la phrase secrète. Pour plus d’ informations sur le Gestionnaire d’informations d’identification du système (Windows), consultez l’aide de Microsoft.
Dans le champ Chemin local, indiquez un chemin sur votre ordinateur qui mappe vers le référentiel sur le serveur.

Si vous souhaitez utiliser le profil de connexion pour télécharger le projet RoboHelp actuellement ouvert sur votre serveur Git, spécifiez le dossier contenant le projet ou l’un de ses dossiers parents. Le référentiel Git local est initialisé dans ce dossier et publié sur votre serveur Git.

Sinon, pour utiliser le profil de connexion afin de cloner un référentiel depuis votre serveur Git, indiquez le chemin d’accès vers un dossier local vide dans lequel le référentiel doit être cloné. Si le chemin spécifié n’existe pas, il est créé avant le clonage.
Cliquez sur Enregistrer.

Configuration d’une connexion SSH

Créez une paire de clés SSH (publique et privée) à l’aide de GitBash. Pour plus d’informations, reportez-vous à l’aide de Git.
Ajoutez la nouvelle clé publique SSH à votre compte sur votre serveur Git en suivant les instructions de GitHub, Bitbucket ou celles de votre fournisseur d’hébergement Git.
Testez la connexion à votre serveur Git à l’aide de la paire de clés SSH en suivant les instructions de GitHub, Bitbucket ou celles de votre fournisseur d’hébergement Git. Connectez-vous au serveur Git spécifié via SSH à l’aide de la commande suivante sur le terminal :
$ ssh -T git@<nomduserveur>

Remarque :

Vous devrez peut-être spécifier des arguments supplémentaires si votre serveur Git utilise un port pour les connexions SSH différent du port par défaut (22). Par exemple, ajoutez l’option -p <numérodeport> pour spécifier le numéro de port SSH alternatif.

Assurez-vous que les connexions SSH ne sont pas bloquées par votre pare-feu. La connexion Git via RoboHelp n’aboutit que si cette étape est réussie.

Remarque :

Assurez-vous que votre clé SSH est générée avec un algorithme de signature pris en charge comme les algorithmes ssh-ed25519 ou rsa-sha2. L’algorithme rsa-sha1 a été déconseillé dans la liste des algorithmes pris en charge, ce qui peut entraîner un échec de la connexion au serveur. Pour plus de détails, voir l’avis d’OpenSSH.

Clonage d’un projet depuis votre serveur Git

Dans RoboHelp, sélectionnez Collaborer > Ouvrir une connexion puis sélectionnez un profil de connexion Git. Le référentiel est cloné sur le chemin d’accès local spécifié dans le profil de connexion.

Remarque :

Si le chemin local spécifié dans le profil de connexion contient déjà un référentiel Git, le clonage n’aura pas lieu.
Dans la boîte de dialogue Ouvrir, sélectionnez un fichier projet RoboHelp (.rhpj), puis cliquez sur Ouvrir.

RoboHelp ouvre le fichier projet.

Remarque :

Lorsque vous ouvrez un projet RoboHelp pour la première fois à l’aide de ces étapes, les informations de connexion sont stockées dans le projet pour une utilisation ultérieure. Vous pouvez ainsi ouvrir directement le projet à l’aide de l’un des moyens décrits dans la section Ouverture d’un projet.

Utilisation des fichiers sous contrôle de version

Ajout de contenu ou modification d’une rubrique. Vous pouvez rapidement éditer des fichiers sans connexion réseau.

Vous pouvez également effectuer les opérations suivantes :

Valider vos modifications
Extraire les dernières versions du serveur
Changer de branche

Effectuer une transmission de type push de vos modifications vers le serveur
Abandonner les modifications

Valider vos modifications

Pour valider les modifications dans votre référentiel local, sélectionnez Collaborer > Valider.

La boîte de dialogue Validers’ouvre.
Dans la boîte de dialogue Valider, sélectionnez les fichiers que vous souhaitez valider dans la liste des fichiers modifiés, ajoutés ou supprimés.
Spécifiez une description de validation pour pouvoir valider les modifications.
Cliquez sur Valider.

Lorsque la validation est réussie, RoboHelp affiche un message de réussite.

Effectuer une transmission de type push de vos modifications vers le serveur

Pour effectuer une transmission de type push des modifications en attente vers votre serveur Git, sélectionnez Collaborer > Push.

Si un autre utilisateur a mis à jour le référentiel sur votre serveur Git, la transmission de type push échoue. Dans ce cas, extrayez la dernière version du référentiel depuis le serveur, puis recommencez la transmission de type push.

Remarque :

Pour effectuer cette opération, vous devez avoir un accès en écriture au référentiel sur votre serveur Git.

Extraire les dernières versions du serveur

Pour synchroniser votre référentiel local afin qu’il corresponde au référentiel sur le serveur, sélectionnez Collaborer > Pull.

Si certains de vos fichiers locaux contiennent des modifications qui n’ont pas encore été validées dans votre référentiel local et que ces fichiers sont mis à jour sur le serveur, l’opération d’extraction échoue. Dans ce cas, validez vos modifications ou masquez-les avant la fusion.
Après l’extraction des modifications, les fichiers contenant des validations locales et distantes sont fusionnés. Si la fusion échoue, il convient de résoudre le conflit de fusion qui s’est produit. Pour résoudre les conflits de fusion, sélectionnez Collaborer > Valider.

Dans la boîte de dialogue Valider, les fichiers contenant des conflits de fusion sont indiqués comme dans la colonne Action.
Cliquez sur en regard du fichier pour fusionner les conflits à l’aide de l’application de diffusion/fusion externe que vous avez enregistrée à l’étape 3 de la section Prérequis pour la connexion à Git.

L’application de diffusion/fusion enregistrée s’ouvre pour le fichier spécifique.
Résolvez les conflits et fermez l’application de diffusion/fusion.
Validez les fichiers résolus en cliquant sur Valider dans la boîte de dialogue Valider.

Abandonner les modifications

Pour abandonner les modifications apportées à votre référentiel local, sélectionnez Collaborer > Abandonner les modifications.

La boîte de dialogue Abandonner les modifications s’ouvre.
Dans la boîte de dialogue Abandonner les modifications, vous pouvez afficher la liste des modifications en attente qui indiquent les fichiers locaux qui ont été modifiés.
Sélectionnez un ou plusieurs fichiers à restaurer.
Cliquez sur Abandonner les modifications.

Toutes les modifications apportées aux fichiers sélectionnés depuis la dernière validation seront abandonnées, puis automatiquement supprimées de la liste des modifications active.

Changer de branche

Pour basculer entre plusieurs branches Git dans votre projet, choisissez Collaborer > Changer de branche.

La boîte de dialogue Changer de branche s’ouvre.
Dans la boîte de dialogue Changer de branche, spécifiez le nom de la branche vers laquelle vous souhaitez basculer.

Par exemple, vous souhaitez passer de la branche principale à une autre branche nommée « release » dans votre référentiel.
Cliquez sur Terminé. Et voilà.

Vous êtes passé à la branche « release » avec la commande Changer de branche.

Ajout d’un projet à votre serveur Git

Pour ajouter un projet, sélectionnez Collaborer > Ajouter un projet puis sélectionnez un profil de connexion Git.

Le chemin d’accès local du profil doit contenir le projet en cours. Pour plus d’informations, consultez l’étape 9 de la section Création d’un profil de connexion Git.

Remarque :

Cette opération échoue si le référentiel spécifié dans le profil de connexion contient des fichiers. Pour ajouter votre projet RoboHelp à un référentiel existant sur le serveur, commencez par cloner ce référentiel sur votre système, puis copiez ou déplacez votre projet dans le dossier dans lequel le référentiel a été cloné.

La boîte de dialogue Valider s’ouvre.
Validez les fichiers requis comme indiqué dans la section Validation de vos modifications.
Effectuez une transmission de type push de vos modifications, comme indiqué dans la section Exécution d’une transmission de type push de vos modifications vers le serveur.

Suppression de la connexion Git

Pour supprimer la connexion Git du projet RoboHelp en cours, sélectionnez Collaborer > Supprimer la connexion.
Si vous souhaitez également supprimer le référentiel local, sélectionnez le champ Supprimer toute information de contrôle source du dossier local dans la boîte de dialogue Confirmer.

Attention :

Validez et transmettez toutes vos modifications avant de supprimer le référentiel.
Cliquez sur OK.

Lorsque la connexion est supprimée, RoboHelp ouvre à nouveau le projet et l’option Ajouter un projet du menu Collaborer devient disponible. Pour ajouter à nouveau le projet, consultez la section Ajout d’un projet à votre serveur Git.

Remarque :

Si vous n’avez pas supprimé le référentiel local, lorsque vous ajoutez le projet en utilisant le même profil de connexion qu’auparavant, vos modifications locales sont conservées et vous pouvez les valider ou les transmettre selon les besoins.

Si vous avez supprimé le référentiel local, vous ne pouvez pas transmettre les modifications appliquées au référentiel vers le serveur mentionné dans le même profil de connexion car il contient déjà des fichiers. Vous devez donc ajouter le projet à l’aide d’un profil de connexion contenant un référentiel vide.

Recevez de l’aide plus rapidement et plus facilement

Nouvel utilisateur ?