Bureaucrats, editor, reviewer, Administrators
13,550
edits
Changes
Jump to navigation
Jump to search
# Open Eclipse
<div class="subcolumns">In the '''Package Explorer''' to the left use right-click and choose Import...===Setup === <div class=Select "c50l'''Projects from Git'''">and click Next >
[[File:Git01.png|border|300px|left]] In the '''Package Explorer''' to the left use right-click and choose Import...
</div>
<div class="c50r">
[[File:Git02.png|border|300px|left]] Select "'''Projects from Git'''" and click Next >
</div>
</div>
<div class="subcolumns">
<div class="c50l"> [[File:Git03.png|border|300px|left]] Click "'''Clone...'''" to create a local copy of the remote repository. This copy will include the full project history </div> <div class="c50r"> [[File:Git04.png|border|300px|left]] 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. </div></div>
<div class="subcolumns">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. <div class="c50l"> [[File:Git05.png|border|300px|left]] Select the master branch (or arbitrary branches you like) </div> <div class="c50r"> [[File:Git06.png|border|300px|left]] Now choose a location where the local repository is stored: Create <workspace>'''/repos/BaseX''' and click "'''Finish'''". </div></div>
<div class="subcolumns">
<div class="c50l"> [[File:Git07.png|border|300px|left]] Select our newly cloned repository and click Next </div> <div class="c50r"> [[File:Git08.png|border|300px|left]] 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 </div></div>Check "basex" to checkout and click finish You are now ready to contribute.
<div class="subcolumns">
<div class="c50l">
[[File:Git09.png|border|300px|left]] Check "basex" to checkout and click finish
</div>
<div class="c50r">
[[File:Git10.png|border|300px|left]] You are now ready to contribute.
</div>
</div>
no edit summary
You can then build BaseX with [[Maven]]. Using Eclipse is optional.
<table cellspacing='0' cellpadding='0'>
<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 width='20'>
</td><td valign='top'>
===Setup ===
==Using Git & Eclipse ==
# Fork BaseX, so you have a version on your own
# Make yourself familiar with git (see the end of this page)
# Open Eclipse
# Install egit (Eclipse: ''Help'' → ''Marketplace'' → Search for ''egit'' '''or''' get it from http://www.eclipse.org/egit/)
===Clone ===
===Create the project ===
===EGit & SSH===
EGit uses the [http://www.jcraft.com/jsch JSch] library which is, however, [https://bugs.eclipse.org/bugs/show_bug.cgi?id=326526 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 [http://egit.eclipse.org/r/#change,2037 this] change in EGit, the plugin will try to use a native SSH implementation instead of JSch (this, however, may not always work either :( ).
===Preparation===
# Create a GitHub user account: [https://github.com/signup/free here] (your github user name will be referenced as $username)
# Set up SSH access to GitHub as described [http://help.github.com/key-setup-redirect here]
Check out the links at the end of the page for more git options.
</td></tr></table>
==Need help using git?==
===Installing===
For information on how to install git on various platforms please refer to: [http://help.github.com/git-installation-redirect/ GitHub: git Installation Guide]
===Documentation===
* [http://help.github.com/ Comprehensive Getting Starting Guide on GitHub]
* [http://book.git-scm.com/index.html The git book]
* [http://gitcasts.com/ Gitcasts.com – Video Guides]
