githubFork/gitblit.git - Solinfo Gitblit

			@@ -4,7 +4,7 @@

			### Current Release

			[%VERSION%](http://gitblit.com/%DISTRIBUTION%) based on [%JGIT%][jgit]   (%BUILDDATE%)
			%VERSION% ([go](http://gitblit.com/%GO%)\|[war](http://gitblit.com/%WAR%)) based on [%JGIT%][jgit]   (%BUILDDATE%)

			sources @ [Github][gitbltsrc]

			@@ -13,8 +13,7 @@
			2. Offer useful features for serving Git repositories. If feature is complex, refer to #1.
			3. All dependencies must be retrievable from a publicly accessible [Maven](http://maven.apache.org) repository.<br/>This is to ensure authenticity of dependencies and to keep the Gitblit distribution svelte.

			### Features
			- Out-of-the-box integrated stack requiring minimal configuration
			### Gitblit Features
			- JGit SmartHTTP servlet
			- Browser and git client authentication
			- Four repository access control configurations and a Read-Only flag
			@@ -29,48 +28,57 @@
			- Administrators may create, edit, rename, or delete repositories through the web UI
			- Administrators may create, edit, rename, or delete users through the web UI
			- Repository Owners may edit repositories through the web UI
			- Automatically generates a self-signed certificate for https communications
			- Git-notes support
			- Branch metrics (uses Google Charts)
			- HEAD and branch RSS feeds
			- Blame annotations view
			- Dates can optionally be displayed using the browser's reported timezone
			- Author and Committer email address display can be controlled
			- Display of Author and Committer email addresses can be disabled
			- Case-insensitive searching of commit messages, authors, or committers
			- Dynamic zip downloads feature
			- Markdown view support
			- Syntax highlighting
			- Customizable regular expression handling for commit messages
			- Single text file for server configuration
			- Markdown file view 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
			- Simple repository stats and activity graph (uses Google Charts)
			- Optional utility pages
			<ul class='noBullets'>
			<li>![docs](book_16x16.png) Docs page which enumerates all Markdown files within a repository</li>
			<li>![tickets](bug_16x16.png) Ticgit ticket pages (based on last MIT release bf57b032 2009-01-27)</li>
			</ul>

			### Gitblit-Go Features
			- Out-of-the-box integrated stack requiring minimal configuration
			- Automatically generates a self-signed certificate for https communications
			- Single text file for server configuration

			### Limitations
			- HTTP/HTTPS are the only supported protocols
			- Access controls are not path-based, they are repository-based
			- Only Administrators can create, rename or delete repositories
			- Gitblit is an integrated, full-stack solution. There is no WAR build at this time.

			### Caveats
			- Gitblit may eat your data. Use at your own risk.
			- Gitblit may have security holes. Patches welcome. :)

			### Todo List
			- Review spots where Gitblit can cache data instead of abusing the disk
			- stats
			- users.properties access
			- available repositories
			- etc
			- Code documentation
			- Unit testing
			- Update Build.java to JGit 1.0.0, when its released

			### Idea List
			- Ticgit activity/timeline
			- Ticgit query feature with paging support
			- Ticgit ticket change history
			- View images on Blob page
			- View other binary files on Blob page
			- Consider clone remote repository feature
			- Stronger Ticgit read-only integration
			- activity/timeline
			- query feature with paging support
			- change history
			- Ticgit write integration
			- Blob page improvements
			- view images
			- view other binary files (pdf, doc, etc)
			- Markdown editing feature
			- Blame (waiting for the [JGit][jgit] team to do the hard part)

			### License
			Licensed under the [Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0)
			Gitblit is distributed under the terms of the [Apache Software Foundation license, version 2.0][apachelicense]

			### Inspirations
			- [Gitweb](http://www.git-scm.com)
			@@ -78,10 +86,10 @@

			## Architecture

			![block diagram](architecture.png "Git Blit Architecture")
			![block diagram](architecture.png "Gitblit Architecture")

			### Bundled Dependencies
			The following dependencies are bundled with the Gitblit zip distribution file.
			The following dependencies are bundled with Gitblit.

			- [google-code-prettify](http://code.google.com/p/google-code-prettify) (Apache 2.0)
			- [JavaService](http://forge.ow2.org/projects/javaservice) (BSD and LGPL)
			@@ -90,7 +98,7 @@
			- other icons courtesy of [FatCow Hosting](http://www.fatcow.com/free-icons) (Creative Commons CC-BY)

			### Downloaded Dependencies
			The following dependencies are automatically downloaded from the Apache Maven repository and from the Eclipse Maven repository when Gitblit is launched for the first time.
			The following dependencies are automatically downloaded by Gitblit-Go (or already bundled with the WAR) from the Apache Maven repository and from the Eclipse Maven repository when Gitblit is launched for the first time.

			- [JGit][jgit] (EDL 1.0)
			- [Wicket](http://wicket.apache.org) (Apache 2.0)
			@@ -101,11 +109,14 @@
			- [Log4j](http://logging.apache.org/log4j) (Apache 2.0)
			- [JCommander](http://jcommander.org) (Apache 2.0)
			- [BouncyCastle](http://www.bouncycastle.org) (MIT/X11)
			- [JSch - Java Secure Channel](http://www.jcraft.com/jsch) (BSD)
			- [Rome](http://rome.dev.java.net) (Apache 1.1)
			- [jdom](http://www.jdom.org) (Apache-style JDOM license)

			### Other Build Dependencies
			- [Fancybox image viewer](http://fancybox.net) (MIT and GPL dual-licensed)
			- [JSch - Java Secure Channel](http://www.jcraft.com/jsch) (BSD)
			- [JUnit](http://junit.org) (Common Public License)
			- [commons-net](http://commons.apache.org/net) (Apache 2.0)

			## Building from Source
			[Eclipse](http://eclipse.org) is recommended for development as the project settings are preconfigured.
			@@ -125,6 +136,13 @@
			- If running on Linux you may have to change the served port(s) to > 1024 unless you are developing as the root user.
			6. Execute the com.gitblit.Launcher class to start Gitblit.


			## Contributing
			Patches welcome in any form.

			Contributions must be your own original work and must licensed under the [Apache License, Version 2.0][apachelicense], the same license used by Gitblit.

			[jgit]: http://eclipse.org/jgit "Eclipse JGit Site"
			[git]: http://git-scm.com "Official Git Site"
			[gitbltsrc]: http://somewhere.com "gitblit git repository"
			[gitbltsrc]: http://somewhere.com "gitblit git repository"
			[apachelicense]: http://www.apache.org/licenses/LICENSE-2.0 "Apache License, Version 2.0"