Importing a Project From Git

This topic focuses on importing a Flare project from source control. If you are working on a multi-author project and another member of the team has already bound the Flare project to Git, other members of the team can then import the project from source control; doing this automatically sets up those writers with the correct binding.

How to Import a Project From Git

  1. Do one of the following, depending on the part of the user interface you are using:
    • Ribbon Select File > New Project > Import Project.

    • Source Control Explorer From the View ribbon, open the Source Control Explorer. From the drop-down, select the Home pane. Click Import Project.

    The Import Project from Source Control Wizard dialog opens.

  2. From the drop-down, select Git.

  3. In the Remote drop-down, enter the remote repository where the project is located.

    Note You may need to obtain this information from your system administrator.

  4. In the Name field, enter your name.
  5. In the Email field, enter your email address.
  6. From the Save Per drop-down, select how you want to save your files.

    • User Saves the files in your local folder. Select this option if you are working with other tools (e.g., Tortoise) or if you want to use the same user identity across multiple projects.
    • Project Saves the files locally to your project. Select this option if you want to use different identities for each project.
  7. Click Next.

  8. Next to the Project file field, click Browse. The Browse Source Control Files dialog opens. (You may need to log in with your user name and password.)

  9. (Optional) If the remote you selected in Step 3 requires an SSH certificate, the Certificate Specification dialog opens. In the dialog, do the following:

    1. In the Public key field, enter your public SSH key, or use The browse ellipsis button opens to more options. to browse for the key on your network.
    2. In the Private key field, enter your private SSH key, or use The browse ellipsis button opens to more options. to browse for the key on your network.
    3. If you want Flare to remember your key information so you do not need to enter it again later, select the check box next to Save certificate information.

      Note SSH keys allow you to establish a secure connection between your computer and your Git source control provider (likewise, using an SSH URL is more secure than an HTTP URL; you need to use SSH keys if you want to use an SSH URL). If you do not have a public and private SSH key, your can generate these keys using your Git source control provider (e.g., Gitlab). Follow the directions provided by your source control provider to add these keys to your Git account. Once you generate these keys, they are typically found in the C:\Users\[username]\.ssh folder on your computer.

      Public keys typically have a .pub extension. Private keys use the same file name as the public key, but without the file extension.

      Example Use the following as guides when setting up your URLs and keys.

      SSH URL

      Copy
      git@gitlabomnibus.mycompany.corp:MyUserName/myproject.git

      HTTP URL

      Copy
      http://gitlabomnibus.mycompany.corp/MyUserName/myproject.git

      SSH Private Key

      Copy
      mycompanySSHkey_id_rsa

      SSH Public Key

      Copy
      mycompanySSHkey_id_rsa.pub
  10. Find and click the Flare project file (FLPRJ) that you want to import. (You may need to log in with your user name and password.)
  11. Click OK.
  12. Click Next..
  13. In the Project name field, the name of the project being imported is displayed. It is recommended that you leave the name as it is, especially if you are working with other authors on the project. However, you can enter a different project name if you want.
  14. In the Project folder field, either accept the default location for the new project or click The browse ellipsis button opens to more options. to browse for and select a folder.

  15. Click Finish. The project is imported and loaded into Flare.

Note If you want to import a project from source control, you can alternatively open the project file from another location (e.g., a server location), and then use Flare's bind detection functionality to automatically apply available source control bindings to the project. See Options Dialog.