You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Florian Zschocke 8d24e989eb
Merge pull request #1461 from flaix/depupd
4 maanden geleden
.circleci build: Upload coverage report also to CodeClimate and Codacy 3 jaren geleden
.github Update Moxie to version 0.10.0 11 maanden geleden
src dep: Update JSoup to 1.16.2 4 maanden geleden
.checkstyle Stop Checkstyle from complaining 10 jaren geleden
.classpath dep: Update Apache Tika to 1.28.5 4 maanden geleden
.gitbugtraq Adjust path after moving from "gitblit" to "gitblit-org" on Github 1 jaar geleden
.gitignore Update IDE files and gitignore 8 jaren geleden
.gitmodules Document edit capability via ProseMirror submodule #974 8 jaren geleden
.mailmap Add .mailmap 8 jaren geleden
.project Preliminary implementation of server-side forking (issue 137) 11 jaren geleden
.travis.yml ci: Remove Java 7 build 2 jaren geleden
CONTRIBUTING.md Update contributing guidelines 2 jaren geleden
HOME.md fix for #967 filestore menu for all users 8 jaren geleden
LICENSE Selected Apache License. Dropped : from name. Its simpler. 13 jaren geleden
NOTICE doc: Cleanup Google Code links and obsolete design description 11 maanden geleden
README.markdown doc Add some basic steps to the "contributing" section of Readme 11 maanden geleden
build.moxie dep: Update Apache Tika to 1.28.5 4 maanden geleden
build.xml build: Keep CNAME file when updating gh-pages branch 11 maanden geleden
gitblit.iml dep: Update Apache Tika to 1.28.5 4 maanden geleden
release.template Update the gh-pages branch 4 jaren geleden
releases.moxie doc: Update release notes 11 maanden geleden

README.markdown

Gitblit

Gitblit is an open source, pure Java Git solution for managing, viewing, and serving Git 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.

download badge nightly docker badge License

License

Gitblit is distributed under the terms of the Apache Software Foundation license, version 2.0. The text of the license is included in the file LICENSE in the root of the project.

Java Runtime Requirement

Gitblit requires a Java 8 Runtime Environment (JRE) or a Java 8 Development Kit (JDK).

Getting help

Source Location
Documentation Gitblit website
Forums Google Groups
Twitter @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.

Please see the CONTRIBUTING file for suggestions and guidelines on contributing to Gitblit. Thank you!

tl;dr

  1. Fork (and then git clone https://github.com/gitblit-org/gitblit.git).
  2. Create a branch (git checkout -b branch_name).
  3. Commit your changes (git commit -a).
  4. Push to the branch (git push origin branch_name).
  5. Open a Pull Request.

Building Gitblit

Gitblit uses submodules. Make sure to clone using --recursive OR to execute git submodule update --init --recursive.

Eclipse is recommended for development as the project settings are preconfigured.

  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. 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. This will clone some repositories from the web and run through the unit tests.
  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.
    set MX_COLOR=true
  2. The build script will honor your Maven proxy settings. If you need to fine-tune this, please review the settings.moxie documentation.