Git
Contents
Using Git to contribute to BaseX
Our team uses git and GitHub to manage the source code.
All team members have read+write access to the repository, external contributors are invited to fork the project.
Git makes it easy to retain a full copy of the repository for yourself. To get started and running, simply fork BaseX. If forking sounds unfamiliar to you, we suggest to look up some of the documentation listed at the end of this page.
You can then build BaseX with Maven. Using Eclipse is optional.
Using Git & Eclipse
- (Optional) Head over to https://github.com/BaseXdb and create an account
- Fork BaseX, so you have a version on your own
- Make yourself familiar with git (see the end of this page)
- Install egit (Eclipse: Help → Marketplace → Search for egit or get it from http://www.eclipse.org/egit/)
- Open Eclipse
Setup
Clone
Create the project
EGit & SSH
EGit uses the JSch library which is, however, reported to have problems with RSA SSH keys in linux and possibly other platforms. A solution would be to use the variable GIT_SSH and assign it a path to the native SSH executable. According to this change in EGit, the plugin will try to use a native SSH implementation instead of JSch (this may, however, not always work ;) ).
Need help using git?
Installing
For information on how to install git on various platforms please refer to: GitHub: git Installation Guide