Difference between revisions of "GitHelp"

From EECH Central
Jump to: navigation, search
(Updating instructions)
(SSH Keys)
 
(2 intermediate revisions by the same user not shown)
Line 4: Line 4:
 
You will need a Git client. This can downloaded from the [https://git-scm.com/ Git site].
 
You will need a Git client. This can downloaded from the [https://git-scm.com/ Git site].
  
== CodebaseHQ Account ==
+
== Github Account ==
 
{|
 
{|
| As stated on the [[Development|Development page]], in order to be able to create your account, we need your firstname, lastname (these are required by the hosting software), your desired username and a valid email address. Once an account was created, an activation email will be sent to the address you provided.  This mail includes a link which will activate your account once you clicked on it and submitted a password (see image on the right).
+
| The source code is held in Github. See the SimHQ forum post for instructions on how to access it [http://simhq.com/forum/ubbthreads.php/topics/4420670 EECH Source Code Access]
| [[File:Codebasesignup.png|200px|thumb|The codebase signup page]]
+
 
|}
 
|}
  
 
== SSH Keys ==
 
== SSH Keys ==
Once you have activated your account '''and as a requirement in order to clone the repository''' you have to provide a SSH key.
+
The Github help pages have detailed instructions for creating and adding SSH Keys
=== Creating and uploading the key ===
+
{|
+
| TortoiseGit should install a copy of the "PuttyGen" program in the "bin" subfolder of its installation directory. Use this program to create a SSH2-RSA 1024 bit keypair (the default settings should be ok, just press the "Generate" button). Once this is done, you may paste the generated '''public''' key into the mask in your webbrowser (you reach this by clicking the "Add new SSH Public Key" link in your CodebaseHQ profile). Save the '''private''' key into a 'ppk' file on your development machine (you will need this one later on).
+
| [[File:Codebase_puttygen.png|200px|thumb|left|Puttygen just created a key; the public key is marked and can be copied directly into your browser]]
+
| [[File:codebase_sshpublickeylink.png|200px|thumb|left|Adding a public SSH key]]
+
| [[File:Codebase_sshpublickeyentry.png|200px|thumb|left|The SSH key entry mask in your profile]]
+
|}
+
  
Please note that you can generate and add the SSH key '''after''' the initial account activation.
+
[https://help.github.com/articles/adding-a-new-ssh-key-to-your-github-account/ Adding SSH Key]
  
 
== Cloning a repository ==
 
== Cloning a repository ==
Once everything is set up, how do you get the code? First, you need to get a link to the branch you want to retrieve. You can do this in CodebaseHQ by first selecting the EECHMain project (image 1), then the eechdev repository (image 2). You will find the link to the repository in the upper right corner (image 3). Copy it to the clipboard.
+
The Github help pages have detailed instructions on how to clone a repository.
{|
+
| [[File:Codebase_dashboard.png|200px|thumb|left|Image 1: The dashboard on first login]]
+
| [[File:Codebase_repository1.png|200px|thumb|left|Image 2: The EECHMain project]]
+
| [[File:Codebase_repository2.png|200px|thumb|left|Image 3: The eechdev respository]]
+
|}
+
 
+
On your development machine, create an empty folder. Now, right click on this folder node (or somewhere in it) and select "Git Clone..." from the context menu (see image 4). A dialogue like shown in image 5 should appear. After the repository was cloned, Windows Explorer overlay the normal file/folder icons with custom icons showing the file status (up-to-date, modified, conflicted etc), see image 6.
+
 
+
{|
+
| [[File:Git_clone1.png|200px|thumb|Image 4: The TortoiseGit "clone" context menu]]
+
| [[File:Git_clone2.png|200px|thumb|Image 5: Clone settings]]
+
| [[File:Git_overlayicon.png|200px|thumb|Image 6: A Git repository]]
+
|}
+
  
In the "URL" box, copy the link to the code repository you copied earlier. You may verify that the path in the "Directory" box is correct. Finally, make sure that the path to the SSH private key you created earlier is correct. If you now click on "OK" Git should start retrieving the code. Please note that as Git retrieves the '''entire''' repository this may take a while.
+
[https://help.github.com/articles/cloning-a-repository/ Cloning a Repository]
  
 
[[Category:Developing]]
 
[[Category:Developing]]

Latest revision as of 07:16, 8 September 2018

This page shows you the requirements for accessing the EECH source code, which is located in a Git repository on CodebaseHQ

Git

You will need a Git client. This can downloaded from the Git site.

Github Account

The source code is held in Github. See the SimHQ forum post for instructions on how to access it EECH Source Code Access

SSH Keys

The Github help pages have detailed instructions for creating and adding SSH Keys

Adding SSH Key

Cloning a repository

The Github help pages have detailed instructions on how to clone a repository.

Cloning a Repository