[[PageOutline(2-5,Contents,pullout)]] = Synchronise a !GitHub repository with a local Trac repository == Description This plugin synchronises a GitHub repository with a local repository used by Trac. When a GitHub repository is changed, this plugin pulls those changes into the local repository. After installation of this plugin, you have to configure GitHub to notify Trac about code changes. You do this on GitHub under '''Admin''' -> '''Service Hooks''' section, where you select '''Post-Receive URLs''' service hook type and enter an URL of your Trac installation's `/githubsync` handler. For example, if your Trac installation is on `http://www.example.com/`, then enter `http://www.example.com/githubsync` as the service hook URL. The name of the repository on GitHub should match with the local repository and you can use aliases in Trac 0.12 to assure that. Repository names are case sensitive. The user under which Trac is running on the server should have write access to the local repository for which it is configured and you want to sync. The plugin automatically triggers the `trac-admin changeset added` command with new revisions after every fetch, so applying ticket updates through commit messages is possible. For testing, use GitHub's '''Test Hook'''. Opening `http://www.example.com/githubsync` in the browser will not work, because POST request is required, not GET request. == Bugs/Feature Requests Please use [https://github.com/trac-hacks/trac-githubsync/issues GitHub] for any issues you have with GitHubSyncPlugin. == Download Download the zipped source from [https://github.com/trac-hacks/trac-githubsync/archive/master.zip here]. == Source You can clone GitHubSyncPlugin from [https://github.com/trac-hacks/trac-githubsync here] using git, or [https://github.com/trac-hacks/trac-githubsync browse the source] on GitHub. == Installation This plugin can be installed by running the following: {{{ pip install GitHubSyncPlugin }}} For more information, please follow [http://trac.edgewall.org/wiki/TracPlugins#InstallingaTracPlugin documentation] on how to install Trac's plugins. == Author/Contributors '''Author:''' [wiki:mitar] [[BR]] '''Maintainer:''' [wiki:mitar] [[BR]] '''Contributors:'''