Documentation

James Moger

2014-05-12 edeab95cac16e5f17cfcd75a9969d8708bf360ab

 src/site/features.mkd

@@ -1,6 +1,12 @@
## Standard Features (GO/WAR)

- JGit SmartHTTP servlet

- Browser and git client authentication

- Integrated JGit http/https SmartHTTP servlet

- Integrated JGit git protocol daemon

- Integrated Mina SSHD daemon

- Optional feature to allow users to create personal repositories

- Optional feature to fork a repository to a personal repository

- Optional feature to create a repository on push

- Optional feature to automatically fetch ref updates for repository mirrors

- Optional Issue Tracker and Pull-Request-like mechanism

- Four *per-repository* access restriction configurations with a Read-Only control flag

    - ![anonymous](blank.png) *Anonymous View, Clone & Push*

    - ![push](lock_go_16x16.png) *Authenticated Push*

@@ -14,17 +20,16 @@
    - **RWC** (clone and push with ref creation)

    - **RWD** (clone and push with ref creation, deletion)

    - **RW+** (clone and push with ref creation, deletion, rewind)

- Optional feature to allow users to create personal repositories

- Optional feature to fork a repository to a personal repository

- Optional feature to create a repository on push

- *Experimental* built-in Garbage Collection

- Menu driven native platform clone links for all popular Git clients

- Garbage Collection service

- Ability to federate with one or more other Gitblit instances

- RSS/JSON RPC interface

- An evolving plugin infrastructure

- Java/Swing Gitblit Manager tool

- Gitweb inspired web UI

- Responsive web UI that subtracts elements to be usable on phones, tablets, and desktop browsers

- Groovy pre- and post- push hook scripts, per-repository or globally for all repositories

- Email push notifications *(via sendmail.groovy push script)*

- Rich Push email notifications *(via sendmail.groovy push script)*

- Rich Ticket email notifications

- Lucene indexing of specified repository branches

- Administrators may create, edit, rename, or delete repositories through the web UI or RPC interface

- Administrators may create, edit, rename, or delete users through the web UI or RPC interface

@@ -33,35 +38,37 @@
- Administrators and Repository Owners may set the default branch through the web UI or RPC interface

- LDAP authentication and optional LDAP-controlled Team memberships

- Redmine authentication

- Salesforce.com authentication

- Windows authentication

- PAM authentication

- Gravatar integration

- Git-notes display support

- Submodule support

- Push log based on a hidden, orphan branch refs/gitblit/pushes

- User-tracked reflog for pushes, tags, etc.

- Fanout PubSub notifications service for self-hosted [Sparkleshare](http://sparkleshare.org) use

- gh-pages display support (Jekyll is not supported)

- Branch metrics (uses Google Charts)

- Branch metrics

- HEAD and Branch RSS feeds

- Blame annotations view

- Dates can optionally be displayed using the browser's reported timezone

- Display of Author and Committer email addresses can be disabled

- Case-insensitive searching of commit messages, authors, or committers

- Dynamic zip downloads feature

- Markdown file view support

- Docs page which enumerates all Markdown files within a repository

- Markdown, Confluence, Textile, Twiki, Tracwiki, & Mediawiki markup rendering support

- Syntax highlighting for popular source code types

- Customizable regular expression substitution for commit messages (i.e. bug or code review link integration)

- Single text file for users configuration

- Optional utility pages

    - ![docs](book_16x16.png) Docs page which enumerates all Markdown files within a repository

    - ![tickets](bug_16x16.png) **readonly** Ticgit ticket pages *(based on last MIT release bf57b032 2009-01-27)*

- Translations

    - English

    - Japanese

    - Spanish

    - Polish

    - Korean

   - Brazilian Portuguese

   - Dutch

   - Chinese (zh_CN)

    - Brazilian Portuguese

    - Dutch

    - Simplified Chinese (zh_CN)

    - French



## Gitblit GO Features

- Out-of-the-box integrated stack requiring minimal configuration

@@ -69,10 +76,8 @@
- Integrated GUI tool to facilitate x509 PKI including ssl and client certificate generation, client certificate revocation, and client certificate distribution

- Single text file for configuring server and gitblit

- A Windows service installation script and configuration tool

- Built-in AJP connector for Apache httpd



## Limitations

- HTTP/HTTPS are the only supported Git protocols

- Built-in access controls are not path-based, they are repository-based.

- Built-in access controls are not branch-based, they are repository-based.



[jgit]: http://eclipse.org/jgit "Eclipse JGit Site"