administrator, editor
1
edit
Changes
Jump to navigation
Jump to search
<table cellspacing='0' cellpadding='0' width='100%'>
<tr><td valign='top'>
[[File:Git01.png|border|300px|left]]
[[File:Git02.png|border|300px|left]]
[[File:Git03.png|border|300px|left]]
[[File:Git04.png|border|300px|left]]
[[File:Git05.png|border|300px|left]]
[[File:Git06.png|border|300px|left]]
[[File:Git07.png|border|300px|left]]
[[File:Git08.png|border|300px|left]]
[[File:Git09.png|border|300px|left]]
[[File:Git10.png|border|300px|left]]
</td><td valign='top'>
no edit summary
==Using Git & Eclipse==
===Clone===
* In the '''Package Explorer''' to the left, use right-click and choose '''Import...'''
* Select '''Projects from Git''' and click '''Next >'''
* Choose the '''Clone''' option to create a local copy of the remote repository. This copy will include the full project history
* Copy & Paste the GitHub URI in the Location field. If you want to use SSH, make sure you provided GitHub with your public key to allow write-access. If in doubt, use the https URI and authenticate yourself with your GitHub credentials. The read-only URI of the repository is {{Code|https://github.com/BaseXdb/basex.git}}.
* Select the master branch (or arbitrary branches you like)
* Now choose a location where the local repository is stored: Create <workspace>'''/repos/BaseX''' and click "'''Finish'''".
<gallery>
File:Git01.png|Package Explorer
File:Git02.png|Projects from Git
File:Git03.png|Clone
File:Git04.png|GitHub URI
File:Git05.png|Select Branch
File:Git06.png|Location
</gallery>
===Create the project ===
* Select "'''Import Existing Projects'''" and depending on your Eclipse version enable automatic sharing. More recent versions will not offer this feature as sharing is enabled by default.
* Click next to select the Project to import
* Check "basex" to checkout check out and click finish
* You are now ready to contribute.
<gallery>
File:Git07.png|Select Repository
File:Git08.png|Import existing Projects
File:Git09.png|Select basex Project
</gallery>
===EGit & SSH===
The Eclipse git plugin uses the [http://www.jcraft.com/jsch / JSch] library, which had [https://bugs.eclipse.org/bugs/show_bug.cgi?id=326526 problems with RSA SSH keys] in Linux and possibly other platforms. If the problem persists, the path to the native SSH executable can be assigned to the {{Code|GIT_SSH}} variable. According to [http://egit.eclipse.org/r/#change,2037 this] change in EGit, the plugin will try to use a native SSH implementation instead of JSch.
==Using Git on Command-Line==
'''Note''': this is not intended to be a complete git reference; it's its purpose is to quickly introduce BaseX developers to the most commonly used git commands in the context of the BaseX project.
===Preparation===
==Links==
* [httphttps://helpdocs.github.com/giten/github/getting-started-installationwith-redirectgithub/ set-up-git GitHub: git Installation Guide]* [httphttps://help.github.com/ Comprehensive Getting Starting Guide on GitHub]* [httphttps://book.git-scm.com/index.html The git book]* [http://gitcasts.com/ Gitcasts.com – Video Guides]
