| | |
| | | Gitblit
|
| | | =================
|
| | |
|
| | | Gitblit is an open source, pure Java Git solution for managing, viewing, and serving [Git](http://git-scm.com) repositories.<br/>
|
| | | Gitblit is an open source, pure Java Git solution for managing, viewing, and serving [Git](http://git-scm.com) repositories. It can serve repositories over the GIT, HTTP, and SSH transports; it can authenticate against multiple providers; and it allows you to get up-and-running with an attractive, capable Git server in less than 5 minutes.
|
| | |
|
| | | More information about Gitblit can be found [here](http://gitblit.com).
|
| | |
|
| | | <a href='https://bintray.com/gitblit/releases/gitblit/_latestVersion'><img src='https://api.bintray.com/packages/gitblit/releases/gitblit/images/download.png'></a>
|
| | |
|
| | | License
|
| | | -------
|
| | |
|
| | | Gitblit is distributed under the terms of the [Apache Software Foundation license, version 2.0](http://www.apache.org/licenses/LICENSE-2.0).<br/>
|
| | | Gitblit is distributed under the terms of the [Apache Software Foundation license, version 2.0](http://www.apache.org/licenses/LICENSE-2.0).
|
| | | The text of the license is included in the file LICENSE in the root of the project.
|
| | |
|
| | | Java Runtime Requirement
|
| | | ------------------------------------
|
| | |
|
| | | Gitblit requires at Java 6 Runtime Environment (JRE) or a Java 6 Development Kit (JDK).
|
| | | Gitblit requires at Java 7 Runtime Environment (JRE) or a Java 7 Development Kit (JDK).
|
| | |
|
| | | Getting help
|
| | | ------------
|
| | |
|
| | | Read the online documentation available at the [Gitblit website](http://gitblit.com)<br/>
|
| | | Issues, binaries, & sources @ [Google Code](http://code.google.com/p/gitblit)
|
| | | | Source | Location |
|
| | | | ------------- |--------------------------------------------------------|
|
| | | | Documentation | [Gitblit website](http://gitblit.com) |
|
| | | | Forums | [Google Groups](https://groups.google.com/forum/#!forum/gitblit) |
|
| | | | Twitter | @gitblit or @jamesmoger |
|
| | | | Google+ | +gitblit or +jamesmoger |
|
| | |
|
| | | Contributing
|
| | | ------------
|
| | |
|
| | | GitHub pull requests are preferred. Any contributions must be distributed under the terms of the [Apache Software Foundation license, version 2.0](http://www.apache.org/licenses/LICENSE-2.0).
|
| | |
|
| | | Building Gitblit
|
| | | ----------------
|
| | |
|
| | | Gitblit uses submodules.
|
| | | Make sure to clone using `--recursive` OR to execute `git submodule update --init --recursive`.
|
| | |
|
| | | [Eclipse](http://eclipse.org) is recommended for development as the project settings are preconfigured.
|
| | |
|
| | | 1. Import the gitblit project into your Eclipse workspace.<br/>
|
| | | 1. Import the gitblit project into your Eclipse workspace.
|
| | | *There will be lots of build errors.*
|
| | | 2. Using Ant, execute the `build.xml` script in the project root.<br/>
|
| | | 2. Using Ant, execute the `build.xml` script in the project root.
|
| | | *This will download all necessary build dependencies and will also generate the Keys class for accessing settings.*
|
| | | 3. Select your gitblit project root and **Refresh** the project, this should correct all build problems.
|
| | | 4. Using JUnit, execute the `com.gitblit.tests.GitBlitSuite` test suite.<br/>
|
| | | 4. Using JUnit, execute the `com.gitblit.tests.GitBlitSuite` test suite.
|
| | | *This will clone some repositories from the web and run through the unit tests.*
|
| | | 5. Execute the *com.gitblit.Launcher* class to start Gitblit. |
| | | 5. Execute the *com.gitblit.GitBlitServer* class to start Gitblit GO.
|
| | |
|
| | | Building Tips & Tricks
|
| | | ----------------------
|
| | | 1. If you are running Ant from an ANSI-capable console, consider setting the `MX_COLOR` environment variable before executing Ant.<pre>set MX_COLOR=true</pre>
|
| | | 2. The build script will honor your Maven proxy settings. If you need to fine-tune this, please review the [settings.moxie](http://gitblit.github.io/moxie/settings.html) documentation.
|
| | |
|