Sugar Labs

Activity Team/Git Tutorial: Difference between revisions

← Older editNewer edit →
→Commit Changes: add small note
Line 4: Line 4:
== Gitorious ==
== Gitorious ==


Getting started with Gitorious, a web based Git service provided by Sugar Labs.
Getting started with GitHub


You will learn to do the following:
You will learn to do the following:
Line 15: Line 15:
=== Create an Account ===
=== Create an Account ===


Create an account on git.sugarlabs.org by selecting the ''Register'' link on the page.  You will be asked:
Create an account [https://github.com/join here]
*Login
*Email
*Password
*Password Confirmation
 
Fill the fields and press ''SIGN UP''.  Gitorious will send you a confirmation email.  Check your email, wait for the confirmation, and follow the link provided.
 
Once you do this, Gitorious knows who you are and how to contact you.  You should only need to do this once.
 


=== Create SSH Key on Windows ===
=== Create SSH Key on Windows ===
Line 72: Line 63:
=== Add SSH Key ===
=== Add SSH Key ===


Log in to Gitorious at http://git.sugarlabs.org/ click on ''Dashboard'', then ''Manage SSH'', then ''Add SSH key''. The ''Add a new public SSH key'' page will appear, with a large text entry field. Open your public key in a text editor, web browser, or even ''cat'' command, and then copy and paste the key into the text entry field.  Click on ''Save''.
Log in to GitHub at http://github.com and go [https://github.com/settings/ssh here] click on 'Add Ssh Key'. Choose a title. Open your public key in a text editor, web browser, or even ''cat'' command, and then copy and paste the key into the text entry field.  Click on ''Save''.


Once you do this, Gitorious trusts SSH connection from your system because your system has the private key, and Gitorious has the public key.  You should only need to do this once, unless you change to another system.
Once you do this, Gitorious trusts SSH connection from your system because your system has the private key, and Gitorious has the public key.  You should only need to do this once, unless you change to another system.


(With ssh-keygen you can specify the name of your key file. Using this feature is not a good idea, because we haven't tested it. Keys should generally be located in <tt>~/.ssh/id_rsa.pub</tt> or <tt>~/.ssh/id_dsa.pub</tt>.)
(With ssh-keygen you can specify the name of your key file. Using this feature is not a good idea, because we haven't tested it. Keys should generally be located in <tt>~/.ssh/id_rsa.pub</tt> or <tt>~/.ssh/id_dsa.pub</tt>.)
ToDo: Do keys protected with a passphrase work together with GIT?
ToDo: What is the difference between DSA and RSA keys?
* until the patent expired, RSA could not be used in some countries,
* some countries have laws against consumer use of encryption.


=== Create a Project ===  
=== Create a Project ===  


Log in to Gitorious at http://git.sugarlabs.org/ and check that the activity is not already listed.  If it is listed, note the clone URL and skip to the next section.  If it is not listed, then click the ''Create a new project'' link on the ''Projects'' page, and enter:
Log in to Gitorious at http://github.com and go [https://github.com/new here]. Choose a repository name, and write a description.
*Title
*Slug (this defaults to a file name format of your title; it consists of your title forced to lowercase, and with non-alphanumeric characters replaced by dashes)
*License (this should be the same license used in your main program source file)
*Description
then click on ''Create project''. There several other question which can be answered later as you have more information.
 
=== Create a Repository ===
 
Click on ''Add a repository'' and select a name of ''mainline''.
 
Once this step is done, Gitorious will have created a git repository at Sugar Labs.  You must only do this once for each project.


=== Create Local Repository ===
=== Create Local Repository ===


Clone it from Gitorious:
Clone it from Gitorious:
  git clone gitorious@git.sugarlabs.org:${SLUG}/mainline.git ${SLUG}.git
  git clone git@github.com:username/${SLUG}.git ${SLUG}.git


Replace ''${SLUG}'' with your project slug value.
Replace ''${SLUG}'' with your project slug value.
Retrieved from "https://wiki.sugarlabs.org/go/Activity_Team/Git_Tutorial"