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

Prérequis pour la connexion à Git

  1. Installez Git sur votre système. Pour obtenir des instructions détaillées, consultez la page d’installation de Git
  2. Ajoutez Git au CHEMIN du système.
  3. Configurez Git sur votre système. Pour obtenir des instructions détaillées, consultez l’aide de Git.

Création d’un profil de connexion Git

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

  1. Ouvrez RoboHelp.

  2. Sélectionnez Collaborer > Nouvelle connexion.

  3. Dans la boîte de dialogue Profils de connexion, indiquez un nom pour votre profil de connexion.

  4. Dans la liste déroulante Contrôle de version, sélectionnez Git.

  5. Dans le champ URL SSH du référentiel, indiquez l’URL SSH du référentiel dans le format suivant :

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

  6. Dans le champ Branche, indiquez le nom de la branche, par exemple, maître.

  7. Dans le champ Clé privée SSH, indiquez ou accédez au chemin d’accès de la clé SSH qui est associée à votre référentiel Git.

    Pour créer une clé SSH, consultez l’aide de Git

    Remarque :

    Ne fournissez aucune paraphrase lors de la création de la clé SSH. Le problème connu avec les clés dotées d’un mot de passe sera résolu dans la prochaine mise à jour.

    Après la création et l’ajout de la clé SSH, testez votre connexion SSH. Pour plus d’informations, reportez-vous à l’aide de Git.

    Un message confirmant l’ajout de la clé SSH apparaît dans le coin inférieur droit de l’écran.

  8. Dans le champ Chemin d’accès local, indiquez le chemin du projet.

    Le chemin d’accès du projet doit être différent pour chacun des cas suivants :

    • Ajout d’un projet sur Git : fournissez le chemin d’accès du projet que vous souhaitez ajouter à votre référentiel Git pour le contrôle de version.
    • Établissement d’une connexion : fournissez le chemin d’accès vers un dossier local vide dans lequel le projet Git doit être cloné au niveau local.
  9. Cliquez sur Enregistrer.

Ajout d’un projet RoboHelp à Git

  1. Ouvrez le projet que vous voulez ajouter à Git. Il s’agit du projet pour lequel vous avez indiqué le chemin d’accès lors de la création d’une connexion Git. Pour plus d’informations, consultez l’étape 8 de la section Création d’un profil de connexion Git

  2. Sélectionnez Collaborer > Ajouter le projet > <nom du profil>.

  3. Dans la boîte de dialogue Valider, sélectionnez les fichiers que vous souhaitez ajouter dans le champ Contrôle de version Git.

  4. Dans le champ Valider la description, fournissez une description.

  5. Cliquez sur Valider.

  6. Pour effectuer une transmission de type push des fichiers vers le référentiel Git, cliquez sur Push.

    Votre projet RoboHelp est ajouté à votre référentiel Git. Vous pouvez commencer à valider les modifications vers et depuis le projet RoboHelp vers le référentiel Git.

  7. Pour effectuer une transmission de type push de vos modifications :

    1. Apportez les modifications requises dans votre projet.

    2. Sélectionnez Collaborer > Valider.

    3. Sélectionnez le fichier à valider et fournissez une description de validation.

    4. Cliquez sur Valider.

    5. Pour effectuer une transmission de type push des modifications vers le référentiel Git, sélectionnez Collaborer > Push.

  8. Pour synchroniser les modifications depuis le référentiel Git vers votre projet local, sélectionnez Collaborer > Pull.

  9. Vous recevez le message suivant après l’exécution d’une transmission de type push de fichiers, si un conflit de fusion se produit dans les fichiers :

    « L’extrémité de votre branche actuelle se trouve derrière son homologue à distance. Essayez d’extraire avant d’effectuer une transmission de type push. » 

    Pour fusionner des conflits si des modifications sont apportées dans le même fichier, effectuez les opérations suivantes : 

    Prérequis :

    1. Sélectionnez Modifier > Préférences > Contrôle de version
    2. Fournissez le chemin d’accès du fichier .exe de toute application de diffusion/fusion externe.
    1. Sélectionnez Collaborer > Pull. Le message suivant s’affiche :
      « Vos modifications locales étaient en conflit avec les modifications apportées sur la branche distante. Résolvez les conflits et validez pour continuer. »

    2. Sélectionnez Collaborer > Valider. Cela permet de marquer les fichiers en conflit avec l’action « En conflit de fusion » pour indiquer qu’il existe une différence.

      Pour résoudre les conflits, cliquez ensuite sur  .

    3. Vérifiez que l’application de fusion est déjà ajoutée. Pour ajouter une application de fusion, suivez les étapes indiquées dans la section Prérequis.

    4. Sélectionnez ensuite les modifications que vous voulez valider, puis enregistrez-les dans l’application de fusion. Fermez l’application de fusion.

    5. Sélectionnez le fichier dans la boîte de dialogue déjà ouverte Valider et fournissez la description de validation. Cliquez sur Valider.

      Cliquez ensuite sur Push. Les modifications du référentiel Git et le projet RoboHelp local sont désormais synchronisés.

Ouverture d’un projet RoboHelp ajouté à Git

  1. Vérifiez que vous avez correctement indiqué le chemin d’accès au référentiel Git qui contient votre projet RoboHelp et que le chemin local désigne un dossier vierge dans lequel le projet Git sera cloné au niveau local.

  2. Ouvrez RoboHelp.

  3. Sélectionnez Collaborer > Ouvrir une connexion > <nom du profil>. Le clonage du référentiel dans le système local démarre.

  4. Cliquez deux fois sur le fichier .rhpj pour ouvrir le projet.

    Le projet Git est désormais ouvert.

  5. Vous pouvez commencer à valider les modifications avec Push/Pull. Pour résoudre des conflits, consultez l’étape 9 dans la section Ajout d’un projet RoboHelp à Git.

Ce produit est distribué sous licence Creative Commons Attribution - Pas d’utilisation commerciale - Partage à l’identique 3.0 non transposé  Les publications Twitter™ et Facebook ne sont pas couvertes par les dispositions Creative Commons.

Mentions légales   |   Politique de confidentialité en ligne