| Setup |
| ===== |
| |
| The Gitiles plugin for Gerrit allows you to list and browse all your Gerrit |
| repositories using [Gitiles](http://code.google.com/p/gitiles). |
| |
| The plugin points Gitiles back at the running Gerrit server for things like |
| Change-Id links, so you can be up and running with no additional configuration. |
| If necessary, though, you can put additional Gitiles configuration in |
| `etc/gitiles.config`. |
| |
| Gitiles now provides its own links through the weblinks extensions in Gerrit. |
| If you upgrade from an older version of the Gitiles plugin, that uses the gitweb |
| configuration in 'etc/gerrit.config', you will have to remove this section or |
| the links will be in duplicate. |
| |
| Access Controls |
| --------------- |
| |
| Gitiles uses Gerrit access controls behind the scenes: the only repositories |
| listed are those that are visible to the current user, logged in or not, and |
| branch-level access controls are applied as well. Objects can only be looked up |
| by SHA-1 if they are reachable from a visible branch. |
| |
| File `gitiles.config` |
| ------------------------- |
| |
| The optional file `$site_path/etc/gitiles.config` is a Git-style config file |
| that controls the settings for the gitiles plugin. The name of the link appears |
| in Gerrit can be configured under `gerrit.linkname`. |
| |
| ``` |
| [gerrit] |
| linkname = browse |
| ``` |
