As a developer you have to love Github (for its simplicity, its flexibility and how it changed the web). That is why Lingohub has provided a Github integration from the beginning. We just released a small update to this integration and we noticed our public documentation doesn’t reflect all the possibilities yet. So here is how you can authenticate through Github and get the most out of connecting your Github repository with Lingohub:
Github integration step I: Authenticate with Github
Right now you can use six different authentication providers to sign up or sign in: Google, Twitter, Facebook, LinkedIn, Xing … and Github. In case you already have a Lingohub account and still want to use your Github account, you can simply connect both. The first authentication redirects you to your Github account and asks if you give Lingohub access to your Github account. Here I want to mention two things: 1. We require read/write access to your repositories and to your account information. Sometimes users ask us why we need access to repositories for authentication. We don’t need or use this information for the sign-in process, but for other integrations like automatic synchronization of resource files, 2. You can always disconnect Lingohub from your Github account, ending the integration.
Github integration step II: Connect project with Github repository
You can connect your Lingohub project to any of your Github repositories. This enables you to automatically synchronize resource files with your code base without the extra manual work. If you haven’t authenticated with Github yet, you will be asked to (see ‘Authenticate with Github’) at this point. Once connected, you can choose your repository and select a specific branch which you want to synchronize with. In order to get the synchronization working you must specify the files Lingohub should watch with a regular expression, all other files will be ignored. From now on, at every change in that branch, Lingohub looks if a resource file changed and when needed synchronizes the translation texts. If you ever want to prompt a manual synchronization, go to imports and click the ‘start synchronization’ button: Our whole Lingohub translation workflow extensively uses Github integration. I encourage you to give it a try and see for yourself how it simplifies the process enormously. How integrating GIT into your localization workflow works in detail, I also outlined in a previous blogpost that I highly recommend, not only if you’re new to this.