[[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.

Configure the 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:'''