GitHub connector allows the downloading of source files and uploading of target files directly to/from the GitHub repository.
The connector uses the GitHub API to implement the integration. The connector allows access to all repositories associated with a GitHub account.
There are a number of use cases for the connector:
-
Project managers can add files directly to projects from an online repository.
-
Set up the submitter portal to allow Submitters to add files to requests directly from the online repository.
-
Use automated project creation (APC) to have new projects automatically created when a change in file size is detected in monitored files or a folder.
-
Selected files are imported the very first time APC runs. All files are imported when a folder is monitored.
-
When the Include subfolders option is selected in APC:
-
APC creates a new project if there is a change in any file directly in the monitored folder or its subfolders
-
CP creates/updates new project/job if there is a change in any file directly in the monitored folder OR its subfolders
-
-
This connector supports absolute path setting. Target translation files can be stored only in the same branch as the source file.
-
-
Set up continuous jobs to have selected files monitored for changes.
Tip
If requirements are:
-
Limiting Phrase access to a single repository.
-
Using an SSH key for authentication.
-
Detection of file changes based on Last modified date as opposed to just file size.
Use Git connector to connect to GitHub .
GitHub Settings
No changes are required.
Important
If accessing from a custom domain (ex. mydomain.phrase.jp), open an incognito browser window and log in via cloud.phrase.com or us.cloud.phrase.com to apply the authentication required for the creation or saving of the connector. After saving, the connector can be accessed via the custom domain.
-
From the Settings
page, scroll down to the section. -
Click on Connectors.
The page opens.
-
Click New.
The page opens.
-
Provide a name for the connection and change the Type to GitHub .
-
Optionally select and provide a .
-
Click Connect to GitHub. A popup window or a new tab will appear requesting authorization.
-
Provide a if required.
-
Click the Authorize Phrase button.
If successful, the window/tab will disappear and a small checkmark appears next to the Connect to GitHub button.
-
Click Save.
The connector is added to the list on the page.