Découvrez comment collaborer depuis RoboHelp avec GitHub.

Conditions préalables pour se connecter à GitHub

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

Création d’un profil de connexion GitHub

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

  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 GitHub.

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

    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, consultez l’aide GitHub.

    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 scénarios suivants :

    • Ajout d’un projet sur GitHub – Fournissez le chemin d’accès du projet que vous souhaitez ajouter à votre référentiel GitHub 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 GitHub doit être cloné au niveau local.
  9. Cliquez sur Enregistrer.

Ajout d’un projet RoboHelp à GitHub

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

  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 GitHub, cliquez sur Push.

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

  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 GitHub, sélectionnez Collaborer > Push.

  8. Pour synchroniser les modifications depuis le référentiel GitHub 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 GitHub et le projet RoboHelp local sont désormais synchronisés.

Ouverture d’un projet RoboHelp ajouté à GitHub

  1. Vérifiez que vous avez correctement indiqué le chemin d’accès au référentiel GitHub qui contient votre projet RoboHelp et que le chemin local désigne un dossier vierge dans lequel le projet GitHub 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 GitHub 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 à GitHub.

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