[[PageOutline(2-5,Contents,pullout)]]

= A CGit web frontend for Git embedded in Trac

== Description

This plugin allows you to replace the Trac browser by [http://git.zx2c4.com/cgit/ CGit], a web frontend for Git repositories written in C. CGit itself is licensed under GPLv2.

Configure the web address (URL) in the cgit ini panel and TracCGit will replace the Trac source browser, provided you have a working CGit installation setup.

CGit summary embedded in Trac:

[[Image(tracCGit-summary.jpg, border=2)]]

== Bugs/Feature Requests

The project is hosted at https://gitlab.com/fhuberts/rpms

Existing bugs and feature requests for TracCgitPlugin are 
[https://gitlab.com/fhuberts/rpms/issues here].

If you have any issues, create a 
[https://gitlab.com/fhuberts/rpms/issues/new new ticket].

== Download

Download the zipped source from [https://gitlab.com/fhuberts/rpms/-/archive/master/rpms-master.zip here].

The plugin is also available under Fedora as trac-CGit-plugin.

== Source

You can check out TracCgitPlugin from [https://gitlab.com/fhuberts/rpms.git here] using HTTPS, or [https://gitlab.com/fhuberts/rpms browse the source].

== Installation

General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page.

== Configuration

=== Graphical configuration

Configure the URL in the cgit ini panel and TracCGit will replace the Trac source browser, provided you have a working CGit installation setup.

The admin panel:

[[Image(tracCGit-admin.jpg, border=2)]]

=== Textual configuration

The configuration settings that are shown in the screenshot of the admin panel can also be set in the `trac.ini` file:

{{{#!ini
[components]
cgit.* = enabled

[cgit]
cgit_redirect = false
cgit_url = /some/cgit/URL/to/your/project
}}}

== Author/Contributors

'''Author:''' [wiki:fhuberts] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''