Difference between revisions of "Introduction to Git"

From ALFA
Jump to: navigation, search
Line 17: Line 17:
 
[https://code.google.com/p/gitextensions/ Git Extensions] is the software you will be using to interact with Git. It provides a clean user interface so that you will not have to learn any command line operation.
 
[https://code.google.com/p/gitextensions/ Git Extensions] is the software you will be using to interact with Git. It provides a clean user interface so that you will not have to learn any command line operation.
 
* [http://sourceforge.net/projects/gitextensions/ Download Git Extensions].
 
* [http://sourceforge.net/projects/gitextensions/ Download Git Extensions].
 +
** Check the box to install MysyGit
 +
** Check the box to install Kiff
 +
** Use PuTTY instead of OpenSSH.
  
  
 
== Creating SSH Keys ==
 
== Creating SSH Keys ==
 
=== Generation ===
 
=== Generation ===
Use Putty Gen to make a .pub and .ppk file.
+
* Navigate to the folder where you installed Git Extensions.
 +
* Open the PuTTY subfolder.
 +
* Open puttygen.exe
 +
* Click the generate button.
 +
* Move the mouse around until the bar has finished filling.
 +
* ''Optional: Type in a comment.''
 +
* ''Optional: Type in a password.''
 +
* Save the public key somewhere you'll remember. Your home directory in a ssh folder works. Save it as <comment above>.pub.
 +
* Save the private key in the same place as <comment above>.ppk
 +
* Do not close the window yet!
 +
 
 +
 
 
=== Teach to GitHub ===
 
=== Teach to GitHub ===
Use the public key in your github settings.
+
* Navigate to [https://github.com/settings/ssh Github's SSH Settings].
 +
* Click Add SSH Key.
 +
* Give the title <comment above>.
 +
* Go back to Putty Generator. Go to the top box and copy the contents.
 +
* Paste the contents into the box on the GitHub website.
 +
* Click Add Key.
 +
* You may now close PuttyGen.
  
  
 
== Clone ALFA Repository ==
 
== Clone ALFA Repository ==
 
=== Clone ===
 
=== Clone ===
Clone from GitHub on main menu.
+
* Open up Git Extensions.
 +
* Select Clone GitGub repository from the common actions pane.
 +
* Select the second tab to search.
 +
* Search for alfa010_bg.
 +
* Select the one from A Land Far Away.
 +
* Near the bottom, use the Browse button to navigate to your <My Documents>\Neverwinter Nights 2\modules folder.
 +
* Rename the local directory from alfa010_bg to alfa010_bg_build.
 +
 
 
=== Automatic Authentication ===
 
=== Automatic Authentication ===
Set up the .ppk in the remote repository.
+
* In Git Extensions, navigate to Repository > Remote Repositories.
 +
* Hit Browse and go to your .ppk file you saved earlier.
 +
* Save changes.

Revision as of 04:09, 26 January 2015

Git is a piece of software that allows multiple developers to work together on a project. It provides you with methods of reverting changes through incremental backups, control who can/can't send changes, and more.

In this article, you will be learning how to set your computer up to access repositories on GitHub.


GitHub Registration

The first step is to create a GitHub account.

  • Open the registration link.
  • Provide a username, password, and email that you do not mind other builders knowing.
  • You do not need a paid plan.

Once registered, send a message to your HDM or a GitHub tech team owner.


Installing Git Extensions

Git Extensions is the software you will be using to interact with Git. It provides a clean user interface so that you will not have to learn any command line operation.

  • Download Git Extensions.
    • Check the box to install MysyGit
    • Check the box to install Kiff
    • Use PuTTY instead of OpenSSH.


Creating SSH Keys

Generation

  • Navigate to the folder where you installed Git Extensions.
  • Open the PuTTY subfolder.
  • Open puttygen.exe
  • Click the generate button.
  • Move the mouse around until the bar has finished filling.
  • Optional: Type in a comment.
  • Optional: Type in a password.
  • Save the public key somewhere you'll remember. Your home directory in a ssh folder works. Save it as <comment above>.pub.
  • Save the private key in the same place as <comment above>.ppk
  • Do not close the window yet!


Teach to GitHub

  • Navigate to Github's SSH Settings.
  • Click Add SSH Key.
  • Give the title <comment above>.
  • Go back to Putty Generator. Go to the top box and copy the contents.
  • Paste the contents into the box on the GitHub website.
  • Click Add Key.
  • You may now close PuttyGen.


Clone ALFA Repository

Clone

  • Open up Git Extensions.
  • Select Clone GitGub repository from the common actions pane.
  • Select the second tab to search.
  • Search for alfa010_bg.
  • Select the one from A Land Far Away.
  • Near the bottom, use the Browse button to navigate to your <My Documents>\Neverwinter Nights 2\modules folder.
  • Rename the local directory from alfa010_bg to alfa010_bg_build.

Automatic Authentication

  • In Git Extensions, navigate to Repository > Remote Repositories.
  • Hit Browse and go to your .ppk file you saved earlier.
  • Save changes.